.
├── app
│   ├── __init__.py
│   └── main.py
```

Dans le fichier `main.py`, vous avez votre application **FastAPI** :


{* ../../docs_src/app_testing/app_a_py310/main.py *}

### Fichier de test { #testing-file }

Vous pourriez alors avoir un fichier `test_main.py` avec vos tests. Il pourrait vivre dans le même package Python (le même répertoire avec un fichier `__init__.py`) :

``` hl_lines="5"
.
├── app

### Simuler un fichier { #simulate-a-file }

Dans cet exemple, nous simulons un fichier avec `io.BytesIO`, qui est un objet de type fichier résidant uniquement en mémoire, mais qui permet d'utiliser la même interface.

Par exemple, nous pouvons itérer dessus pour en consommer le contenu, comme nous le ferions avec un fichier.

/// tip | Astuce

Un fichier commençant par un point (`.`) est un fichier caché dans les systèmes de type Unix, comme Linux et macOS.

Mais un fichier dotenv n'a pas forcément exactement ce nom de fichier.

///

2. Définir le répertoire de travail courant sur `/code`.

    C'est là que nous placerons le fichier `requirements.txt` et le répertoire `app`.

3. Copier le fichier des dépendances vers le répertoire `/code`.

    Copier **uniquement** le fichier des dépendances en premier, pas le reste du code.

Diffuse de façon asynchrone un fichier comme réponse.

Prend un ensemble de paramètres différent à l'instanciation par rapport aux autres types de réponse :

- `path` - Le chemin du fichier à diffuser.
- `headers` - D'éventuels en-têtes personnalisés à inclure, sous forme de dictionnaire.
- `media_type` - Une chaîne donnant le media type. Si non défini, le nom du fichier ou le chemin sera utilisé pour en déduire un media type.

* Traiter des données :
    * Par exemple, si vous recevez un fichier qui doit passer par un traitement lent, vous pouvez retourner une réponse « Accepted » (HTTP 202) puis faire le traitement en arrière-plan.

## Utiliser `BackgroundTasks` { #using-backgroundtasks }

- `swagger_js_url` : l’URL où la page HTML de Swagger UI peut récupérer le fichier **JavaScript**. C’est l’URL du CDN personnalisé.
- `swagger_css_url` : l’URL où la page HTML de Swagger UI peut récupérer le fichier **CSS**. C’est l’URL du CDN personnalisé.

Et de même pour ReDoc ...

{* ../../docs_src/custom_docs_ui/tutorial001_py310.py hl[2:6,11:19,22:24,27:33] *}

/// info

Dans la fonction `open()`, le `mode="a"` signifie « append » (ajouter) ; la ligne sera donc ajoutée après ce qui se trouve déjà dans ce fichier, sans écraser le contenu précédent.

///

/// tip | Astuce

Notez que dans ce cas, nous utilisons une fonction Python standard `open()` qui interagit avec un fichier.

Mais vous pouvez configurer explicitement l’application à utiliser.

## Configurer le `entrypoint` de l’application dans `pyproject.toml` { #configure-the-app-entrypoint-in-pyproject-toml }

Vous pouvez configurer l’endroit où se trouve votre application dans un fichier `pyproject.toml` comme suit :

```toml
[tool.fastapi]

```
.
├── app
│   ├── __init__.py
│   ├── main.py
│   └── test_main.py
```

Le fichier `main.py` contiendrait :

{* ../../docs_src/async_tests/app_a_py310/main.py *}

Le fichier `test_main.py` contiendrait les tests pour `main.py`, il pourrait maintenant ressembler à ceci :

{* ../../docs_src/async_tests/app_a_py310/test_main.py *}