पाठ्यक्रम 250 में से पाठ 240 · कैपस्टोन: भेज दें (अपना प्रोजेक्ट पैक करें)
कैपस्टोन: भेज दें (अपना प्रोजेक्ट पैक करें)

repo का ढाँचा बनाएँ

आपने पहले के कैपस्टोन में कुछ असली बनाया: एक support copilot, एक दस्तावेज़ निकालने वाला, एक eval द्वार। अभी यह शायद cells के ढेर या एक लंबी script के रूप में है। इसे खोलने वाले hiring manager को अंदाज़ा लगाना पड़ता है कि चीज़ें कहाँ हैं, और जो recruiter इसे clone करके चलाने का कोई साफ़ तरीका नहीं देखता वह बस tab बंद कर देता है। portfolio प्रोजेक्ट के लिए आप जो सबसे ज़्यादा असर वाली अकेली चीज़ कर सकते हैं वह है उसे एक उबाऊ, पारंपरिक ढाँचा देना ताकि कोई भी 30 सेकंड में रास्ता ढूँढ ले।

पहले ही एक ईमानदार बात: यह मॉड्यूल repo के बारे में है, live cloud deploy के बारे में नहीं। हम आपके ब्राउज़र के अंदर से कोई server नहीं चला सकते या किसी host पर push नहीं कर सकते, और हम दिखावा नहीं करेंगे। आप यहाँ जो सीख और साबित कर सकते हैं वह ढाँचा, टेस्ट, और एक-command वाला दौर है जो बाद में deploy को मामूली बना देते हैं। अंत के deploy नोट्स ठीक वही हैं -> नोट्स, बिना ग्रेड के चिह्नित।

वह ढाँचा जिस पर लगभग हर Python प्रोजेक्ट पहुँचता है:

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

दो बातों पर ध्यान दें। पहली, package src/ के नीचे प्रोजेक्ट के नाम वाले folder में रहता है -> यह "src layout" है, और यह आपके टेस्ट को ग़लती से install किए package के बजाय local folder import करने से रोकता है। दूसरी, package directory का नाम प्रोजेक्ट नाम के पीछे चलता है: triage नाम के प्रोजेक्ट को src/triage/ मिलता है, copilot नाम वाले को src/copilot/। कोई एक तय जवाब नहीं -> पेड़ नाम का एक फ़ंक्शन है।

आपका काम वह फ़ंक्शन लिखना है। build_manifest(name) एक प्रोजेक्ट नाम लेता है और repo में होने वाली फ़ाइलों की सूची लौटाता है, path स्ट्रिंग की sort की हुई सूची के रूप में। इसमें README.md, pyproject.toml, src/<name>/ के नीचे एक package directory जिसमें __init__.py और एक module फ़ाइल हो, और एक tests/test_*.py फ़ाइल होनी चाहिए। नाम को एक मान्य package directory में सामान्य करें (छोटे अक्षर, और ख़ाली जगह और डैश को अंडरस्कोर में बदलें, क्योंकि doc-extractor import होने लायक module नाम नहीं है पर doc_extractor है)।

यह वह manifest है जो एक scaffolding script डिस्क पर बनाती। हम ग्रेडर में फ़ाइलें नहीं लिख रहे -> हम जाँच रहे हैं कि आप किसी भी प्रोजेक्ट नाम के लिए सही पेड़ बता सकते हैं। triage नाम के प्रोजेक्ट का ढाँचा print करने के लिए Run दबाएँ।

आपकी बारी

build_manifest(name) लिखें जो एक प्रोजेक्ट का repo फ़ाइल पेड़ path स्ट्रिंग की sort की हुई सूची के रूप में लौटाए। इसमें README.md, pyproject.toml, src/<pkg>/ के नीचे package directory जिसमें एक __init__.py, एक __main__.py (यही फ़ाइल python -m <pkg>, पाठ 3 का run command, काम कराती है) और कम से कम एक और module .py फ़ाइल हो, और tests/test_<pkg>.py नाम की एक test फ़ाइल होनी चाहिए। name को package dir में सामान्य करें (छोटे अक्षर, ख़ाली जगह और डैश अंडरस्कोर बनते हैं) ताकि अलग प्रोजेक्ट नाम अलग पेड़ बनाए।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।