Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
82 changes: 22 additions & 60 deletions src/content/docs/fr/recipes/bun.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,21 +22,12 @@ Si vous rencontrez des problèmes lors de l'utilisation de Bun, veuillez [signal
Créez un nouveau projet Astro avec Bun en utilisant la commande `create-astro` suivante :

```bash
bunx create-astro@latest mon-projet-astro-utilisant-bun
bun create astro mon-projet-astro-utilisant-bun
```

:::tip
Vous pouvez également [créer un nouveau projet Astro à partir d'un dépôt Astro existant sur GitHub](/fr/install-and-setup/#installer-à-partir-de-lassistant-cli) en utilisant l'option `--template` :
```bash
bunx create-astro@latest mon-projet-astro-utilisant-bun --template eliancodes/brutal
```
:::

## Installer les dépendances

Si vous démarrez un nouveau projet en utilisant `bunx create-astro`, le CLI utilisera automatiquement Bun pour installer les dépendances et vous pouvez sauter cette étape.

Sinon, vous devrez installer vos dépendances avec Bun :
Si vous avez ignoré l’étape « Installer les dépendances ? » dans l’assistant CLI, assurez-vous d’installer vos dépendances avant de continuer.

```bash
bun install
Expand All @@ -52,79 +43,50 @@ Installez `@types/bun` en utilisant la commande suivante :
bun add -d @types/bun
```

## Utiliser les intégrations Astro

Vous pouvez également utiliser n'importe laquelle des intégrations officielles d'Astro avec la commande `astro add` :

```bash
bunx astro add react
```

## Exécuter Astro avec Bun

:::note
Utilisez l'option [`--bun`](https://bun.sh/docs/cli/bunx#shebangs) avant chaque commande `astro` pour utiliser le propre environnement d'exécution de Bun à la place de Node.
:::
## Options d'installation de la CLI

### Exécuter le serveur de développement
### Utiliser des intégrations

Pour lancer le serveur de développement en utilisant Bun comme environnement d'exécution, utilisez la commande suivante :
Vous pouvez également utiliser l'une des intégrations officielles d'Astro avec la commande `astro add` :

```bash
bunx --bun astro dev
bun astro add react
```

### Compiler votre site avec Bun
### Utiliser un thème ou un modèle de démarrage

Pour compiler votre site en utilisant Bun comme environnement d'exécution, utilisez la commande suivante :
Vous pouvez démarrer un nouveau projet Astro reposant sur un [exemple officiel](https://github.com/withastro/astro/tree/main/examples) ou la branche principale de n'importe quel dépôt GitHub en passant un argument `--template` à la commande `create astro`.

```bash
bunx --bun astro build
```

Astro produira votre site dans le répertoire `dist/`. Ensuite, vous pouvez servir votre site en utilisant la commande `preview` :
Exécutez la commande suivante dans votre terminal, en remplaçant le nom officiel du modèle de démarrage d'Astro ou le nom d'utilisateur GitHub et le dépôt du thème que vous souhaitez utiliser :

```bash
bunx --bun astro preview
# créer un nouveau projet avec un exemple officiel
bun create astro@latest --template <nom-exemple>
# créer un nouveau projet reposant sur la branche principale d'un dépôt GitHub
bun create astro@latest --template <nom-utilisateur-github>/<depot-github>
```

## Ajouter SSR avec Bun
## Développer et compiler

Puisque Bun est [compatible avec l'API de Node.js](https://bun.sh/docs/runtime/nodejs-apis), vous pouvez utiliser n'importe quel adaptateur Astro pour [un rendu à la demande](/fr/guides/on-demand-rendering/) de votre projet Astro :
Pour exécuter le serveur de développement, utilisez la commande suivante :

```bash
bunx astro add vercel
bun run dev
```

## Tester dans Bun

Bun est livré avec un programme de test rapide, intégré et compatible avec Jest, via la commande `bun test`. Si vous souhaitez l'utiliser, lisez [la documentation sur `bun test`](https://bun.sh/docs/cli/test).

Cependant, il est également possible d'utiliser Cypress ou Playwright pour une approche moderne des tests d'applications web.

### Cypress
### Compiler et prévisualiser votre site

Cypress est un outil de test frontend dont la mission est de « rendre l'expérience de test agréable et de rendre les développeurs heureux ». Il vous permet d'écrire des tests de bout en bout pour votre site Astro.

Installez Cypress avec la commande suivante :
Pour compiler votre site, utilisez la commande suivante :

```bash
bun add cypress --dev
bun run build
```

Pour le reste de la configuration et pour lancer votre premier test, suivez le reste de la procédure Cypress dans le [Guide de test d'Astro](/fr/guides/testing/#configuration).

### Playwright

Playwright est un framework de test de bout en bout qui vous permet de tester votre code Astro sur tous les moteurs de rendu modernes, y compris Chromium, WebKit et Firefox.
Une fois la compilation terminée, exécutez la commande d'aperçu appropriée (par exemple `bun run preview`) dans votre terminal et vous pourrez afficher la version compilée de votre site localement dans la même fenêtre d'aperçu du navigateur.

Installez Playwright à l'aide de la commande suivante :

```bash
bun create playwright
```
## Tests

Pour créer votre premier test Playwright, suivez les instructions pour le reste du processus Playwright dans le [Guide de test d'Astro](/fr/guides/testing/#créer-votre-premier-test-playwright).
Bun est fourni avec un exécuteur de tests rapide, intégré et compatible avec Jest via la [commande `bun test`](https://bun.sh/docs/cli/test). Vous pouvez également utiliser d’autres [outils de test pour Astro](/fr/guides/testing/).

## Ressources officielles

Expand Down