Sobre o projeto
Copier-python é um template Copier para criar novos projetos Python com uma toolchain moderna e opinativa já configurada. Ele é utilizado via linha de comando para gerar um projeto em um caminho escolhido, em vez de ser uma biblioteca de runtime.
Início rápido
- Instale os pré-requisitos: mise-en-place para gestão da toolchain e o próprio Copier (por exemplo, via `mise use -g copier` ou `uv tool install copier`).
- Gere um projeto com `copier copy "gh:smkent/copier-python" /caminho/do/novo/projeto`.
- O site de documentação abrange os requisitos e mais detalhes de uso.
Ferramentas incluídas
- mise-en-place ("mise") para gerenciar a toolchain de desenvolvimento.
- O conjunto de ferramentas Astral: uv, ruff e ty.
- prek, fornecendo git hooks compatíveis com pre-commit.
- pytest como framework de teste, com suporte ao codecov.io.
- Zensical para documentação do projeto, com implantação automática no GitHub Pages.
Automação de atualização e release
- Atualizações de projeto são suportadas através do Renovate juntamente com `copier update`, permitindo que projetos gerados incorporem alterações do template.
- A automação de release abrange a publicação de um pacote PyPI e a construção de uma imagem de container, impulsionada por GitHub Actions.
Créditos
O template afirma ter sido inspirado por pawamoy/copier-uv e ritwiktiwari/copier-astral. É distribuído sob uma licença incluída no repositório e também publicado no PyPI como copier-python.
Para quem é indicado
Desenvolvedores que desejam um ponto de partida repetível para pacotes e aplicações Python, com gestão de dependências, linting/formatação, git hooks, testes, documentação e releases via CI configurados desde o início, e que desejam manter esses projetos gerados atualizáveis quando o template for alterado.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.