DocsPremiers pas
Mise en place
Exigences
| Exigence | Pourquoi |
|---|---|
| Python 3.12+ | requires-python dans pyproject.toml ; aucun compilateur C nécessaire, Windows inclus |
| uv | crée le projet, installe ses packages et exécute Nexy |
| Node.js 18+ | uniquement pour un framework client (React, Vue, Svelte, Solid, Preact) |
Un projet sans framework client n'a pas besoin de Node.js du tout.
Installez d'abord uv
uvx n'est pas un outil séparé : il est fourni avec uv, alors installez uv avant toute autre chose.
# macOS and Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh # Windows (PowerShell)powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Vérifiez-le avec uv --version et uvx --version.
Créer un projet
uvx nexy new my-appuvx exécute Nexy dans un environnement temporaire et ne laisse rien derrière lui. Cela suffit pour créer un projet (new, init) et rien de plus : l'environnement temporaire contient Nexy et aucun autre package. nexy new crée le propre environnement virtuel du projet, .venv, et y installe ses packages.
nexy new my-app pose quatre questions : routeur (basé sur des fichiers ou modulaire), type de projet (web ou API), framework client, ORM. L'installation des dépendances Python et Node s'effectue alors avec une ligne par étape et sa durée. Voir CLI.
Ignorez les invites avec un modèle enregistré :
uvx nexy new my-app --template <name>Travailler dans l'environnement virtuel du projet
Toutes les autres commandes (nexy dev, nexy build, nexy migrate...) doivent s'exécuter dans l'environnement virtuel du projet. C'est là que vivent vos propres packages : votre ORM, vos bibliothèques et le Nexy avec lequel le projet a été construit. En dehors de cela, un projet qui a besoin de sqlmodel échoue avec ModuleNotFoundError: No module named 'sqlmodel'.
Activez-le une fois par terminal, depuis le dossier du projet :
| Coquille | Commande |
|---|---|
| PowerShell, cmd (Windows) | .venv\Scripts\activate |
| macOS, Linux | source .venv/bin/activate |
L'invite commence alors par (.venv). A partir de là :
cd my-app.venv\Scripts\activate # Windows; on macOS and Linux: source .venv/bin/activatenexy devOuvrez http://localhost:3000.
Pour ignorer l'activation, laissez uv le faire pour une seule commande : uv run nexy dev.
Ajouter Nexy à un projet existant
Exécutez-le depuis l'environnement virtuel du projet, avec Nexy parmi ses packages (uv add nexy) :
nexy init