Repolode
gabrielcnr

gabrielcnr/pytest-datadir

Um plugin do pytest que copia diretórios de dados de teste para pastas temporárias, permitindo que os testes leiam e modifiquem arquivos de fixture com segurança.

Estrelas
277
Forks
28
Issues abertas
8
Último commit
há 4 dias

O que é?

pytest-datadir dá aos testes acesso a arquivos de dados armazenados junto deles. Por padrão, um módulo de teste chamado test_hello.py pode usar um diretório correspondente test_hello/ por meio da fixture datadir, enquanto uma pasta data/ no nível superior fica disponível por meio da fixture shared_datadir. Ambas as fixtures retornam objetos pathlib.Path, permitindo que os testes usem operações padrão de caminho para ler arquivos.

O conteúdo do diretório de dados é copiado para um local temporário em cada teste. Assim, os testes podem gravar ou modificar arquivos sem afetar as fixtures originais nem outros testes. As fixtures lazy_datadir e lazy_shared_datadir, adicionadas na versão 1.7.0, copiam os arquivos somente quando são acessados por meio de joinpath ou do operador /, evitando copiar diretórios grandes que o teste não usa.

Recursos principais

  • 01Disponibiliza um diretório de dados específico do módulo por meio da fixture datadir.
  • 02Disponibiliza um diretório de dados compartilhado por meio da fixture shared_datadir.
  • 03Copia os dados para uma pasta temporária para manter os arquivos originais inalterados.
  • 04Oferece lazy_datadir e lazy_shared_datadir para copiar arquivos apenas quando são acessados.
  • 05Retorna objetos pathlib.Path pelas fixtures.

Casos de uso

  • Armazenar arquivos de entrada de exemplo ou fixtures para testes de parsers e de processamento de arquivos.
  • Escrever testes que criam ou modificam arquivos sem mexer nas fixtures de origem.
  • Compartilhar dados de teste comuns entre vários módulos usando uma única pasta global de dados.

Antes de usar

  • Os metadados do repositório indicam que a licença é NOASSERTION, enquanto o README informa MIT. Verifique a licença antes de usar.

Em coleções

Tópicos

Perguntas frequentes

O que é pytest-datadir?
Um plugin do pytest que copia diretórios de dados de teste para pastas temporárias, permitindo que os testes leiam e modifiquem arquivos de fixture com segurança. pytest-datadir dá aos testes acesso a arquivos de dados armazenados junto deles. Por padrão, um módulo de teste chamado test_hello.py pode usar um diretório correspondente test_hello/ por meio da fixture datadir, enquanto uma pasta data/ no nível superior fica disponível por meio da fixture shared_datadir. Ambas as fixtures retornam objetos pathlib.Path, permitindo que os testes usem operações padrão de caminho para ler arquivos.
pytest-datadir é gratuito? Qual é a licença?
pytest-datadir é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
pytest-datadir ainda é mantido?
Manutenção ativa. O último commit de pytest-datadir foi em 3 de nov. de 2026.
Para que posso usar pytest-datadir?
Armazenar arquivos de entrada de exemplo ou fixtures para testes de parsers e de processamento de arquivos. Escrever testes que criam ou modificam arquivos sem mexer nas fixtures de origem. Compartilhar dados de teste comuns entre vários módulos usando uma única pasta global de dados.
Onde consigo pytest-datadir?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/gabrielcnr/pytest-datadir

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados