Estruture o Repo
Você construiu algo real nos projetos finais anteriores: um copilot de suporte, um extrator de documentos, um portão de avaliação. Agora ele provavelmente vive como um monte de células ou um script longo. Um gerente de contratação que abre isso tem que adivinhar onde as coisas estão, e um recrutador que o clona e não vê uma forma óbvia de executá-lo apenas fecha a aba. A única coisa de maior impacto que você pode fazer para um projeto de portfólio é dar a ele um layout chato e convencional para que qualquer pessoa possa se localizar em 30 segundos.
Nota honesta logo de cara: este módulo é sobre o repo, não um deploy em nuvem ao vivo. Não podemos subir um servidor ou enviar para um host de dentro do seu navegador, e não vamos fingir que podemos. O que você can aprender e provar aqui é a estrutura, os testes e a execução de um comando que tornam um deploy trivial depois. As notas de deploy no final são exatamente isso -> notas, marcadas como não avaliadas.
O layout com o qual quase todo projeto Python converge:
my_project/
README.md # what it is + how to run it
pyproject.toml # name, version, dependencies
.env.example # the shape of the secrets (NEVER the real ones)
src/
my_project/ # the importable package
__init__.py
__main__.py # runs on `python -m my_project`
core.py # your actual code
tests/
test_my_project.py # pytest finds these by the test_ prefix
Duas coisas para notar. Primeiro, o pacote vive sob src/ em uma pasta nomeada após o projeto -> esse é o "src layout", e ele impede que seus testes importem acidentalmente a pasta local em vez do pacote instalado. Segundo, o nome do diretório do pacote rastreia o nome do projeto: um projeto chamado triage recebe src/triage/, um projeto chamado copilot recebe src/copilot/. Não existe uma única resposta selada -> a árvore é uma função do nome.
Seu trabalho é escrever essa função. build_manifest(name) recebe um nome de projeto e retorna a list of files que o repo deve conter, como uma sorted list of path strings. Ela deve incluir README.md, pyproject.toml, um diretório de pacote sob src/<name>/ contendo __init__.py e um arquivo de módulo, e um arquivo tests/test_*.py. Normalize o nome para um diretório de pacote válido (minúsculas, e transforme espaços e hifens em underscores, já que doc-extractor não é um nome de módulo importável mas doc_extractor é).
Este é o manifesto que um script de scaffolding criaria no disco. Não estamos escrevendo arquivos no grader -> estamos verificando se você consegue descrever a árvore correta para qualquer nome de projeto. Pressione Run para imprimir o layout para um projeto chamado triage.
Escreva build_manifest(name) que retorna a árvore de arquivos do repositório para um projeto como uma sorted lista de strings de caminho. Deve incluir README.md, pyproject.toml, o diretório do pacote sob src/<pkg>/ com um __init__.py, um __main__.py (aquele arquivo é o que faz o python -m <pkg>, o comando de execução na lição 3, funcionar) e pelo menos um outro arquivo de módulo .py, e um arquivo de teste chamado tests/test_<pkg>.py. Normalize name no diretório do pacote (minúsculas, espaços e hífens viram underscores) para que um nome de projeto diferente produza uma árvore diferente.
Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição
Este exercício abre em breve
Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.
Este navegador está bloqueando cookies para learn.floati.life, então as lições que você terminou aqui não podem abrir em ordem. Permita cookies para este site e recarregue.