| 📦 Turbo Rust 713ea5c k33g yesterday | 1 | # Référence : ligne de commande |
| 2 | |
| 3 | > Description neutre de la commande `turbo-rust`, de ses options et de l'environnement qu'elle lit. |
| 4 | |
| 5 | ## Synopsis |
| 6 | |
| 7 | ``` |
| 8 | turbo-rust [options] [fichier...] |
| 9 | ``` |
| 10 | |
| 11 | Chaque `fichier` est ouvert dans sa propre fenêtre. Un fichier qui n'existe pas encore est ouvert comme un tampon vide associé à ce chemin. Sans aucun fichier, une seule fenêtre vide sans titre est ouverte. |
| 12 | |
| 13 | ## Options |
| 14 | |
| 15 | | Option | Type | Défaut | Description | |
| 16 | | --- | --- | --- | --- | |
| 17 | | `-theme <nom>` | chaîne | celui du projet, sinon `turbo-classic` | Thème de démarrage, l'emportant sur celui du projet. Un nom inconnu retombe sur le thème par défaut sans erreur. | |
| 18 | | `-list-themes` | booléen | `false` | Affiche chaque thème chargeable avec sa description, puis le répertoire de thèmes utilisateur, et quitte. | |
| 19 | | `-no-lsp` | booléen | `false` | Ne démarre pas de serveur de langage. La coloration et l'édition sont inchangées. | |
| 20 | | `-version` | booléen | `false` | Affiche `Turbo Rust <version>` sur une ligne, avec le commit et la date de build quand le build les a enregistrés, puis quitte. Voir [le numéro de version](versioning.md). | |
| 📦 Turbo Rust f69efbe k33g 13h ago | 21 | | `-load-config <url>` | chaîne | aucune | Copie le répertoire `.turbo-rust` trouvé à l'URL d'un dépôt — rickub, GitHub, GitLab ou Codeberg, l'URL du dossier telle que le navigateur l'affiche — dans le répertoire courant, affiche ce qui est arrivé, et quitte. Nécessite `git`. Refuse si `./.turbo-rust` existe déjà. L'éditeur n'est pas lancé. | |
| 📦 Turbo Rust 713ea5c k33g yesterday | 22 | | `-h`, `-help` | booléen | `false` | Affiche la liste des options et quitte. | |
| 23 | |
| 24 | ## Environnement |
| 25 | |
| 26 | | Variable | Lue par | Effet | |
| 27 | | --- | --- | --- | |
| 28 | | `TURBO_RUST_THEME_DIR` | chargement des thèmes | Répertoire des thèmes utilisateur, à la place du répertoire de configuration de la plateforme. | |
| 29 | | `TERM` | tcell | Description de terminal à utiliser. | |
| 30 | | `GOBIN`, `GOPATH`, `HOME` | recherche de rust-analyzer | Consultées, dans cet ordre, quand `rust-analyzer` n'est pas dans le `PATH`. | |
| 31 | |
| 32 | ## Fichiers |
| 33 | |
| 34 | | Chemin | Rôle | |
| 35 | | --- | --- | |
| 36 | | `$TURBO_RUST_THEME_DIR/*.toml` | Thèmes utilisateur, quand la variable est définie. | |
| 37 | | `./.turbo-rust/settings.toml` | Les réglages de ce projet, lus une fois au démarrage. Voir [réglages de projet](project-settings.md). | |
| 📦 Turbo Rust f69efbe k33g 13h ago | 38 | | `./.turbo-rust/` (écrit) | Créé par `-load-config` à partir de la copie d'un dépôt, quand le projet n'en a pas encore. | |
| 📦 Turbo Rust 713ea5c k33g yesterday | 39 | | `~/.config/turbo-rust/themes/*.toml` | Thèmes utilisateur sous Linux (`os.UserConfigDir`). | |
| 40 | | `~/Library/Application Support/turbo-rust/themes/*.toml` | Thèmes utilisateur sous macOS. | |
| 41 | | `<module>/Cargo.toml` | Trouvé en remontant depuis le premier fichier ; son répertoire devient la racine du serveur de langage. | |
| 42 | |
| 43 | ## Code de sortie |
| 44 | |
| 45 | | Code | Signification | |
| 46 | | --- | --- | |
| 47 | | `0` | L'éditeur s'est terminé normalement, ou une option d'information a été utilisée. | |
| 48 | | `1` | Le terminal n'a pas pu être ouvert ou initialisé. La raison est écrite sur la sortie d'erreur. | |
| 49 | |
| 50 | ## Cibles make |
| 51 | |
| 52 | À exécuter depuis un clone. |
| 53 | |
| 54 | | Cible | Ce qu'elle lance | |
| 55 | | --- | --- | |
| 56 | | `make help` | Liste les cibles. C'est la cible par défaut. | |
| 57 | | `make test` | `cargo test` | |
| 58 | | `make test-verbose` | `go test -v ./...` | |
| 59 | | `make cover` | `go test -cover ./...` | |
| 60 | | `make build` | `go build -o bin/turbo-rust .` | |
| 61 | | `make install` | `scripts/install.sh` — compile et installe dans le PATH | |
| 62 | | `make uninstall` | `scripts/install.sh --uninstall` | |
| 63 | | `make run FILE=x.go` | `make build`, puis `./bin/turbo-rust x.go` | |
| 64 | | `make fmt` | `go fmt ./...` | |
| 65 | | `make vet` | `cargo clippy --all-targets` | |
| 66 | | `make check` | `fmt`, puis `vet`, puis `test` | |
| 67 | | `make clean` | Supprime `bin/` | |
| 68 | |
| 69 | ## Exemples |
| 70 | |
| 71 | ```bash |
| 72 | turbo-rust # une fenêtre vide |
| 73 | turbo-rust main.rs Cargo.toml # deux fenêtres |
| 74 | turbo-rust -theme turbo-dark main.rs # un autre thème |
| 75 | turbo-rust -no-lsp main.rs # sans serveur de langage |
| 76 | turbo-rust -list-themes # quels thèmes existent |
| 📦 Turbo Rust f69efbe k33g 13h ago | 77 | turbo-rust -load-config https://rickub.com/turbo-editors/configs/tree/main/golang-init # partir d'une configuration partagée |
| 📦 Turbo Rust 713ea5c k33g yesterday | 78 | ``` |
| 79 | |
| 80 | ## Installateur |
| 81 | |
| 82 | `scripts/install.sh`, également accessible via `make install`. |
| 83 | |
| 84 | | Option | Description | |
| 85 | | --- | --- | |
| 86 | | `-p`, `--prefix RÉP` | Installer dans `RÉP` au lieu de `$GOBIN` ou `$GOPATH/bin`. | |
| 87 | | `--with-rust-analyzer` | Installer aussi `rust-analyzer`, s'il n'est pas déjà présent. | |
| 88 | | `--uninstall` | Retirer un `turbo-rust` installé, puis s'arrêter. | |
| 89 | | `-h`, `--help` | Afficher les options, puis s'arrêter. | |
| 90 | |
| 91 | | Code de sortie | Signification | |
| 92 | | --- | --- | |
| 93 | | `0` | Installé, retiré, ou aide affichée. | |
| 94 | | `1` | Go absent ou trop ancien, échec de compilation, ou destination non accessible en écriture. Rien n'est installé et une installation existante reste intacte. | |
| 95 | |
| 96 | ## Erreurs |
| 97 | |
| 98 | | Message | Cause | |
| 99 | | --- | --- | |
| 100 | | `turbo-rust: opening the terminal: …` | tcell n'a pas pu ouvrir le terminal ; en général `TERM` est absent ou inconnu. | |
| 101 | | `turbo-rust: initialising the terminal: …` | Le terminal a été ouvert mais n'a pas pu être mis en mode brut. | |
| 102 | | `Cannot open` (dans une boîte) | Le chemin est un répertoire, ou n'est pas lisible. | |
| 103 | | `Cannot save` (dans une boîte) | Le répertoire n'existe pas, ou n'est pas accessible en écriture. | |
| 📦 Turbo Rust f69efbe k33g 13h ago | 104 | | `turbo-rust: configrepo: the project already has a configuration directory: …` | `-load-config` dans un projet qui a déjà `.turbo-rust`. Déplacez-le d'abord. | |
| 105 | | `turbo-rust: configrepo: git is not installed` | `-load-config` a besoin de la commande `git` dans le `PATH`. | |
| 106 | | `turbo-rust: configrepo: no configuration directory at that path: …` | Le dépôt existe mais ne contient pas de `.turbo-rust` là où l'URL pointe. | |
| 107 | | `turbo-rust: configrepo: no repository answered: …` | Aucune adresse de clone pour cette URL n'a répondu : l'URL, le réseau, ou un dépôt privé. | |