Template Generation Fails Due to Firewall Blocking

[gembleman]

When running loco new -v DEBUG, I encountered the following error:

✔ ❯ App name? · myapp
2024-11-02T23:13:15.176884Z DEBUG loco: generate template args args="ArgsPlaceholder { lib_name: \"myapp\", db: None, bg: None, assets: None, template: None }"
2024-11-02T23:13:15.177301Z DEBUG loco_cli::git: cloning loco repo_url="https://github.com/loco-rs/loco.git" clone_folder="C:\\Users\\{user_name}\\AppData\\Local\\Temp\\6SSA0DVgEIl0Pu1jrN3T"
2024-11-02T23:13:15.548366Z DEBUG loco_cli::git: loco project path: "C:\\Users\\{user_name}\\AppData\\Local\\Temp\\6SSA0DVgEIl0Pu1jrN3T"
2024-11-02T23:13:15.548453Z DEBUG loco_cli::generate: collecting starters template path="C:\\Users\\{user_name}\\AppData\\Local\\Temp\\6SSA0DVgEIl0Pu1jrN3T\\starters"
🙀 failed to read directory `C:\Users\{user_name}\AppData\Local\Temp\gTa8DoBEWvsyaypfdG8x\starters`

Root Cause

CLI attempts to replicate the Loco-RS repository to get the template file while creating a project. However, if the firewall blocks the connection to the Github, this process may fail. I was a bit confused because this operation was not clearly documented in the Loco Guide.

Solution

1. Manually downloading the loco-rs repository
2. Setting the STARTERS_LOCAL_PATH environment variable to point to your local copy

$env:STARTERS_LOCAL_PATH="C:\Users\{user_name}\Downloads\loco-master\loco-master"
loco new