Müfredat 250 dersinden 240. · Final Proje: Gönder (Projeni Paketle)
Final Proje: Gönder (Projeni Paketle)

Depoyu Düzenle

Önceki bitirme projelerinde gerçek bir şeyler inşa ettin: bir destek copilotu, bir doküman çıkarıcı, bir eval kapısı. Şu an muhtemelen bir hücre yığını veya uzun bir script olarak duruyor. Onu açan bir işe alım yöneticisi guess nelerin nerede olduğunu tahmin etmek zorunda kalır ve onu klonlayıp çalıştırmanın açık bir yolunu görmeyen bir işe alım uzmanı sekmeyi kapatır. Bir portfolyo projesi için yapabileceğin en yüksek etkili şey ona sıkıcı, geleneksel bir düzen vermektir, böylece herkes 30 saniyede yolunu bulabilir.

Dürüst bir not:bu modül repo hakkında, canlı bir bulut dağıtımı değil. Tarayıcınızın içinden bir sunucu başlatamayız veya bir ana makineye gönderim yapamayız, bunu yapıyormuş gibi de davranmayacağız. Burada öğrenebileceğin ve kanıtlayabileceğin şeyler yapı, testler ve daha sonra dağıtımı kolaylaştıran tek komutluk çalıştırmadır. Sondaki dağıtım notları tam olarak odur -> notlar, notlandırılmamış olarak işaretlendi.

Neredeyse her Python projesinin üzerinde birleştiği düzen:

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

Dikkat etmen gereken iki şey var. İlk olarak, paket src/ içinde proje adıyla isimlendirilmiş klasöründe yer alır -> bu "src düzenidir" ve testlerinin yanlışlıkla yüklü paket yerine yerel klasörü içe aktarmasını engeller. İkinci olarak, paket dizini adı proje adını takip eder: triage adlı bir proje src/triage/ alır, copilot adlı bir proje src/copilot/ alır. Tek bir sabit cevap yok -> ağaç isimden kaynaklanan bir fonksiyondur.

Görevin o fonksiyonu yazmak. build_manifest(name) bir proje adı alır ve deponun içermesi gereken dosyaların listesini, sıralanmış yol dizisi listesi olarak döndürür. README.md, pyproject.toml, src/<name>/ altında __init__.py ve bir modül dosyası içeren bir paket dizini ve bir tests/test_*.py dosyası içermelidir. Adı geçerli bir paket dizinine dönüştür (küçük harf yap ve boşluklar ile tireleri alt çizgiye çevir, çünkü doc-extractor içe aktarılabilir bir modül adı değil ama doc_extractor öyle).

Bu, bir iskele kurma betiğinin disk üzerinde oluşturacağı manifesttir. Değerlendirici içinde dosya yazmıyoruz -> herhangi bir proje adı için doğru ağacı tanımlayabildiğini kontrol ediyoruz. triage adlı bir proje için düzeni yazdırmak için Run tuşuna bas.

Senin sıran

Bir proje için repo dosya ağacını path dizisi olarak sorted şeklinde döndüren build_manifest(name) yaz. README.md, pyproject.toml, src/<pkg>/ altındaki bir __init__.py ile paket dizini, bir __main__.py (bu dosya python -m <pkg>, yani 3. dersteki çalıştırma komutunu çalıştıran dosyadır) ve en az bir başka modül .py dosyası ile tests/test_<pkg>.py isimli bir test dosyası dahil olmalı. Farklı bir proje adının farklı bir ağaç üretmesi için name'yi paket dizinine normalize et (küçük harf, boşluklar ve tireler alt çizgiye dönüşsün).

Bu derste bir sorun mu fark ettin? Bildir · Bu ders hakkında soru sor

Bu alıştırma yakında açılacak

Bu dersi bitirince bu ders açılacak. Kursun tamamı ücretsiz, hesap gerekmiyor ve bu dersi hemen şimdi okuyabilirsin.