# Référence : ligne de commande

> Description neutre de la commande `turbo-go`, de ses options et de l'environnement qu'elle lit.

## Synopsis

```
turbo-go [options] [fichier...]
```

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.

## Options

| Option | Type | Défaut | Description |
| --- | --- | --- | --- |
| `-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. |
| `-list-themes` | booléen | `false` | Affiche chaque thème chargeable avec sa description, puis le répertoire de thèmes utilisateur, et quitte. |
| `-no-lsp` | booléen | `false` | Ne démarre pas de serveur de langage. La coloration et l'édition sont inchangées. |
| `-version` | booléen | `false` | Affiche `Turbo Go <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). |
| `-load-config <url>` | chaîne | aucune | Copie le répertoire `.turbo-go` 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-go` existe déjà. L'éditeur n'est pas lancé. |
| `-h`, `-help` | booléen | `false` | Affiche la liste des options et quitte. |

## Environnement

| Variable | Lue par | Effet |
| --- | --- | --- |
| `TURBO_GO_THEME_DIR` | chargement des thèmes | Répertoire des thèmes utilisateur, à la place du répertoire de configuration de la plateforme. |
| `TERM` | tcell | Description de terminal à utiliser. |
| `GOBIN`, `GOPATH`, `HOME` | recherche de gopls | Consultées, dans cet ordre, quand `gopls` n'est pas dans le `PATH`. |

## Fichiers

| Chemin | Rôle |
| --- | --- |
| `$TURBO_GO_THEME_DIR/*.toml` | Thèmes utilisateur, quand la variable est définie. |
| `./.turbo-go/settings.toml` | Les réglages de ce projet, lus une fois au démarrage. Voir [réglages de projet](project-settings.md). |
| `./.turbo-go/` (écrit) | Créé par `-load-config` à partir de la copie d'un dépôt, quand le projet n'en a pas encore. |
| `~/.config/turbo-go/themes/*.toml` | Thèmes utilisateur sous Linux (`os.UserConfigDir`). |
| `~/Library/Application Support/turbo-go/themes/*.toml` | Thèmes utilisateur sous macOS. |
| `<module>/go.mod` | Trouvé en remontant depuis le premier fichier ; son répertoire devient la racine du serveur de langage. |

## Code de sortie

| Code | Signification |
| --- | --- |
| `0` | L'éditeur s'est terminé normalement, ou une option d'information a été utilisée. |
| `1` | Le terminal n'a pas pu être ouvert ou initialisé. La raison est écrite sur la sortie d'erreur. |

## Cibles make

À exécuter depuis un clone.

| Cible | Ce qu'elle lance |
| --- | --- |
| `make help` | Liste les cibles. C'est la cible par défaut. |
| `make test` | `go test ./...` |
| `make test-verbose` | `go test -v ./...` |
| `make cover` | `go test -cover ./...` |
| `make build` | `go build -o bin/turbo-go .` |
| `make install` | `scripts/install.sh` — compile et installe dans le PATH |
| `make uninstall` | `scripts/install.sh --uninstall` |
| `make run FILE=x.go` | `make build`, puis `./bin/turbo-go x.go` |
| `make fmt` | `go fmt ./...` |
| `make vet` | `go vet ./...` |
| `make check` | `fmt`, puis `vet`, puis `test` |
| `make clean` | Supprime `bin/` |

## Exemples

```bash
turbo-go                              # une fenêtre vide
turbo-go main.go go.mod               # deux fenêtres
turbo-go -theme turbo-dark main.go    # un autre thème
turbo-go -no-lsp main.go              # sans serveur de langage
turbo-go -list-themes                 # quels thèmes existent
turbo-go -load-config https://rickub.com/turbo-editors/configs/tree/main/golang-init  # partir d'une configuration partagée
```

## Installateur

`scripts/install.sh`, également accessible via `make install`.

| Option | Description |
| --- | --- |
| `-p`, `--prefix RÉP` | Installer dans `RÉP` au lieu de `$GOBIN` ou `$GOPATH/bin`. |
| `--with-gopls` | Installer aussi `gopls`, s'il n'est pas déjà présent. |
| `--uninstall` | Retirer un `turbo-go` installé, puis s'arrêter. |
| `-h`, `--help` | Afficher les options, puis s'arrêter. |

| Code de sortie | Signification |
| --- | --- |
| `0` | Installé, retiré, ou aide affichée. |
| `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. |

## Erreurs

| Message | Cause |
| --- | --- |
| `turbo-go: opening the terminal: …` | tcell n'a pas pu ouvrir le terminal ; en général `TERM` est absent ou inconnu. |
| `turbo-go: initialising the terminal: …` | Le terminal a été ouvert mais n'a pas pu être mis en mode brut. |
| `Cannot open` (dans une boîte) | Le chemin est un répertoire, ou n'est pas lisible. |
| `Cannot save` (dans une boîte) | Le répertoire n'existe pas, ou n'est pas accessible en écriture. |
| `turbo-go: configrepo: the project already has a configuration directory: …` | `-load-config` dans un projet qui a déjà `.turbo-go`. Déplacez-le d'abord. |
| `turbo-go: configrepo: git is not installed` | `-load-config` a besoin de la commande `git` dans le `PATH`. |
| `turbo-go: configrepo: no configuration directory at that path: …` | Le dépôt existe mais ne contient pas de `.turbo-go` là où l'URL pointe. |
| `turbo-go: 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é. |