Donner ses propres réglages à un projet

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

# Donner ses propres réglages à un projet

Ce guide montre comment fixer un thème et activer la sauvegarde automatique pour un projet, afin que tous ceux qui l'ouvrent aient le même éditeur. Il suppose Turbo Python déjà installé.

## Créer le fichier de réglages

Lancez l'éditeur **depuis le dossier du projet**, puis choisissez **Options ▸ Create project settings**.

Cela écrit `.turbo-python/settings.toml`, rempli avec le thème que vous utilisez à cet instant, et l'ouvre pour édition — coloré, puisque Turbo Python colore le TOML :

```toml
# turbo-python project settings.
#
# These apply to everyone who opens this project in turbo-python. Delete this file
# and the editor falls back to its own defaults.

[editor]

# The colour theme to start in. `turbo-python -list-themes` lists them all.
# A -theme flag on the command line overrides this.
theme = "turbo-classic"

# Write modified files by themselves, a short while after you stop typing.
# On, because a project that has gone to the trouble of having a settings file
# has said what it wants; set it to false and save, and it stops at once.
autosave = true

# How long that while is. Any Go duration: "500ms", "2s", "1m".
autosave_delay = "2s"
```

Le fichier est lu au démarrage de l'éditeur, et **de nouveau à chaque fois que vous l'enregistrez** — une modification est donc en vigueur dès que vous appuyez sur `F2`. La barre d'état le confirme : `Applied .turbo-python/settings.toml — autosave on (2s)`.

Cela vaut pour les réglages que ce fichier contient, pas pour le thème : **Options ▸ Theme** est la façon vivante de le changer, et y réécrit votre choix pour vous.

L'entrée de menu que vous venez d'utiliser est maintenant grisée, et **Options ▸ Project settings…** à côté d'elle ne l'est plus. C'est la règle pour les trois fichiers du projet : vous pouvez créer celui que vous n'avez pas, et ouvrir celui que vous avez.

## La sauvegarde automatique

Elle est déjà active : le fichier qu'on vient de vous donner dit `autosave = true`.

Tout fichier qui a un nom est écrit deux secondes après que vous ayez cessé de taper. La barre d'état affiche `Saved main.py` au moment où cela arrive. Rien n'est écrit tant que vous tapez : chaque frappe repousse l'attente.

Deux choses changent en conséquence, toutes deux voulues :

- **Fermer une fenêtre ne demande plus** s'il faut enregistrer. Le fichier allait l'être de toute façon.
- **Quitter l'éditeur ne demande plus** non plus, pour la même raison.

Un fichier qui n'a jamais reçu de nom fait exception : la sauvegarde automatique n'ouvre jamais de dialogue, donc une fenêtre sans titre garde son `*` et la question est toujours posée à la fermeture.

Pour la désactiver, mettez `autosave` à `false` et enregistrez ; la barre d'état répond `autosave off`, et cela s'arrête à l'instant. Pour attendre plus ou moins longtemps, changez `autosave_delay` :

```toml
autosave_delay = "500ms"
```

## Fixer le thème

Donnez à `theme` un nom parmi ceux de `turbo-python -list-themes`, ou choisissez-en un simplement avec **Options ▸ Theme** : dès lors qu'un fichier de réglages existe, choisir un thème l'y écrit pour vous, en conservant vos commentaires et votre mise en page.

## Essayer un autre thème sans toucher au fichier

Passez `-theme` sur la ligne de commande. Il l'emporte sur le choix du projet, le temps de cette exécution seulement :

```bash
turbo-python -theme turbo-dark main.py
```

## Modifier le fichier plus tard

**Options ▸ Project settings…** le rouvre. L'entrée est grisée dans un projet qui n'en a pas.

## Variantes

- **Vous lancez l'éditeur depuis un sous-dossier.** Les réglages ne sont pas trouvés : seul `./.turbo-python` est consulté, sans remontée vers la racine du projet. Lancez depuis le dossier du projet, ou passez `-theme` pour cette fois.
- **Le fichier contient une erreur.** L'éditeur le signale sur la sortie d'erreur et s'ouvre avec ses valeurs par défaut — vous pouvez donc corriger le fichier dans l'éditeur lui-même.
- **Vous partagez le projet.** `.turbo-python/settings.toml` est un fichier ordinaire : versionnez-le pour convenir d'un thème en équipe, ou ajoutez-le à `.gitignore` pour le garder pour vous.

## Voir aussi

- Chaque clé, avec son type et sa valeur par défaut : [Référence des réglages de projet](../reference/project-settings.md)
- Pourquoi le fichier n'est pas cherché dans les dossiers parents, et pourquoi l'autosave attend : [Réglages de projet](../explanation/project-settings.md)
- Écrire un thème à fixer : [Écrire son propre thème](write-a-theme.md)