A documentação da API usa **Swagger UI** e **ReDoc**, e cada um deles precisa de alguns arquivos JavaScript e CSS.

Por padrão, esses arquivos são fornecidos por um <abbr title="Content Delivery Network – Rede de Entrega de Conteúdo: Um serviço, normalmente composto por vários servidores, que fornece arquivos estáticos, como JavaScript e CSS. É comumente usado para providenciar esses arquivos do servidor mais próximo do cliente, melhorando o desempenho.">CDN</abbr>.

`UploadFile` tem os seguintes métodos `assíncronos`. Todos eles chamam os métodos de arquivo correspondentes por baixo dos panos (usando o `SpooledTemporaryFile` interno).

* `write(data)`: Escreve `data` (`str` ou `bytes`) no arquivo.

Um arquivo começando com um ponto (`.`) é um arquivo oculto em sistemas tipo Unix, como Linux e macOS.

Mas um arquivo dotenv não precisa ter exatamente esse nome de arquivo.

///

O Pydantic tem suporte para leitura desses tipos de arquivos usando uma biblioteca externa. Você pode ler mais em <a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic Settings: Dotenv (.env) support</a>.

Por exemplo, no arquivo `app/main.py`, você poderia ter uma linha como:

```
from app.routers import items
```

///

* O diretório `app` contém todo o código da aplicação. Ele possui um arquivo `app/__init__.py` vazio, o que o torna um "pacote Python" (uma coleção de "módulos Python"): `app`.

labels.target=Alvo
labels.token=Token
labels.synonymFile=Arquivo de sinônimos
labels.stopwordsFile=Arquivo de stopwords
labels.stemmerOverrideFile=Arquivo de substituição do Stemmer
labels.mappingFile=Arquivo de mapeamento
labels.protwordsFile=Arquivo Protwords
labels.kuromojiFile=Arquivo Kuromoji
labels.elevateWordFile=Arquivo de palavras elevadas
labels.badWordFile=Arquivo de palavras ruins
labels.urlExpr=Condição

errors.failed_to_upload_kuromoji_file = Não foi possível carregar o arquivo Kuromoji.
errors.failed_to_download_protwords_file = Não foi possível baixar o arquivo Protwords.
errors.failed_to_upload_protwords_file = Não foi possível carregar o arquivo Protwords.
errors.failed_to_download_stopwords_file = Não foi possível baixar o arquivo de stopwords.
errors.failed_to_upload_stopwords_file = Não foi possível carregar o arquivo de stopwords.

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

No arquivo `main.py` você tem sua aplicação **FastAPI**:


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

### Arquivo de teste { #testing-file }

Então você poderia ter um arquivo `test_main.py` com seus testes. Ele poderia estar no mesmo pacote Python (o mesmo diretório com um arquivo `__init__.py`):

``` hl_lines="5"
.
├── app
│   ├── __init__.py
│   ├── main.py

* `path` - O caminho do arquivo que será transmitido
* `headers` - quaisquer cabeçalhos que serão incluídos, como um dicionário.
* `media_type` - Uma string com o media type. Se não for definida, o media type é inferido a partir do nome ou caminho do arquivo.
* `filename` - Se for definido, é incluído no cabeçalho `Content-Disposition`.

<div class="termy">

```console
$ python myapp.py
```

</div>

mas não é chamado quando outro arquivo o importa, como em:

```Python
from myapp import app
```

#### Mais detalhes { #more-details }

Digamos que seu arquivo se chama `myapp.py`.

Se você executá-lo com:

<div class="termy">

2. Defina o diretório de trabalho atual para `/code`.

    Esse é o diretório onde colocaremos o arquivo `requirements.txt` e o diretório `app`.

3. Copie o arquivo com os requisitos para o diretório `/code`.

    Copie **somente** o arquivo com os requisitos primeiro, não o resto do código.