# Démarrer { #first-steps }

Le fichier **FastAPI** le plus simple possible pourrait ressembler à ceci :

{* ../../docs_src/first_steps/tutorial001_py310.py *}

Copiez cela dans un fichier `main.py`.

Démarrez le serveur en direct :

<div class="termy">

```console
$ <font color="#4E9A06">fastapi</font> dev

  <span style="background-color:#009485"><font color="#D3D7CF"> FastAPI </font></span>  Starting development server 🚀

**Remarque** : Vous devez vous assurer de mettre « fastapi[standard] » entre guillemets pour garantir que cela fonctionne dans tous les terminaux.

## Exemple { #example }

### Créer { #create-it }

Créez un fichier `main.py` avec :

```Python
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")

<span style="color: green;">INFO</span>:     Uvicorn running on http://0.0.0.0:80 (Press CTRL+C to quit)
```

</div>

/// note | Remarque

La commande `uvicorn main:app` fait référence à :

* `main` : le fichier `main.py` (le « module » Python).
* `app` : l'objet créé dans `main.py` avec la ligne `app = FastAPI()`.

C'est équivalent à :

```Python
from main import app
```

///

/// 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.

///

- `write(data)` : écrit `data` (`str` ou `bytes`) dans le fichier.
- `read(size)` : lit `size` (`int`) octets/caractères du fichier.
- `seek(offset)` : se déplace à la position d'octet `offset` (`int`) dans le fichier.
    - Par ex., `await myfile.seek(0)` irait au début du fichier.

labels.target=Cible
labels.token=Jeton
labels.synonymFile=Fichier de synonymes
labels.stopwordsFile=Fichier de mots vides
labels.stemmerOverrideFile=Fichier de remplacement de racinisation
labels.mappingFile=Fichier de mappage
labels.protwordsFile=Fichier de mots de protection
labels.kuromojiFile=Fichier Kuromoji
labels.elevateWordFile=Fichier de mots à élever
labels.badWordFile=Fichier de mots incorrects
labels.urlExpr=Condition

│   └── 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
│   ├── __init__.py
│   ├── main.py

* trouver le module `dependencies` (un fichier imaginaire `app/routers/dependencies.py`)...
* et en importer la fonction `get_token_header`.

Mais ce fichier n'existe pas, nos dépendances sont dans un fichier `app/dependencies.py`.

Rappelez-vous à quoi ressemble la structure de notre app/fichiers :

### 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.

errors.invalid_design_jsp_file_name = Fichier JSP non valide.
errors.design_jsp_file_does_not_exist = Le fichier JSP n'existe pas.
errors.design_file_name_is_not_found = Le nom de fichier n'est pas spécifié.
errors.failed_to_write_design_image_file = Échec du téléversement d'un fichier image.
errors.failed_to_update_jsp_file = Échec de la mise à jour du fichier JSP.