Stel die Repo op
Jy het iets regtigs gebou in die vorige capstones: 'n support copilot, 'n doc extractor, 'n eval gate. Nou woon dit waarskynlik as 'n stapel selle of een lang script. 'n Werwingsbestuurder wat dit oop maak moet guess waar dinge is, en 'n werwer wat dit klonseer en geen duidelike manier sien om dit te hardloop nie, sluit net die tab. Die een ding met die hoogste impak wat jy vir 'n portfolioprojek kan doen is om dit 'n boring, conventional layout te gee sodat enigeen binne 30 sekondes kan uitvind waar alles is.
Eerlike nota vooraf:hierdie module gaan oor die repo, nie 'n lewendige wolk-ontplooiing nie. Ons kan nie 'n bediener opstel of na 'n gasheer stoot vanaf binne jou bl brasileiros nie, en ons gaan nie maak asof ons dit doen nie. Wat jy kan leer en bewys hier is die struktuur, die toetse, en die een-opdrag-lêring wat 'n ontplooiing later eenvoudig maak. Die ontplooiingsnotas aan die einde is presies dit -> notas, gemerk as nie gegradeer nie.
Die uitleg wat byna elke Python-projek na toe beweeg:
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
Twee dinge om op te let. Eerstens woon die pakket onder src/ in 'n vouer genoem na die projek -> dit is die "src layout", en dit keer dat jou programmee per ongeluk die plaaslike vouer in plaas van die geïnstalleerde pakket inlaai. Tweedens volg die pakketverwysing die projeknaam: 'n projek genaamd triage kry src/triage/, 'n projek genaamd copilot kry src/copilot/. Daar is nie een vaste antwoord nie -> die boom is 'n funksie van die naam.
Jou werk is om daardie funksie te skryf. build_manifest(name) neem 'n projeknaam en gee die lys van lêers wat die repo moet bevat terug, as 'n sorted lys van pad-strings. Dit moet README.md, pyproject.toml, 'n pakketvergrooting onder src/<name>/ wat __init__.py en 'n modulelêer hou, en 'n tests/test_*.py lêer insluit. Normaliseer die naam na 'n geldige pakketvergrooting (kleinletters, en verander spasies en koppelte in onderstrekes, aangesien doc-extractor nie 'n invoerbare modulenaam is nie maar doc_extractor is).
Dit is die manifest wat 'n scaffolding script op die skink plaat sou skep. Ons skryf nie lêers in die grader nie -> ons kontroleer dat jy die regte boom vir enige projeknaam kan beskryf. Druk Run om die uitleg vir 'n projek genaamd triage.
Skryf build_manifest(name) wat die repo lêerboom vir 'n projek as 'n sorted lys van pad-strings teruggee. Dit moet README.md, pyproject.toml, die pakketvergrooting onder src/<pkg>/ met 'n __init__.py, 'n __main__.py (daardie lêer is wat python -m <pkg>, die run-opdrag in les 3, laat werk) en ten minste een ander module .py lêer, en 'n toetslêer genaamd tests/test_<pkg>.py insluit. Normaliseer name in die pakketvergrooting (kleinletters, spasies en koppelte word onderstrekings) sodat 'n ander projeknaam 'n ander boom produseer.
Sien jy 'n probleem in hierdie les? Rapporteer dit · Vra oor hierdie les
Hierdie oefening open binnekort
Voltooi die lesie voor dit en hierdie een sal ontvanklik wees. Die hele kursus is gratis, geen rekening nodig nie, en jy kan hierdie les nou lees.
Hierdie blutser blokkeer koekies vir learn.floati.life, so lesse wat jy hier voltooi het kan nie in volgorde oopgaan nie. Laat koekies vir hierdie webwerf toe en laai nuut.