Mojo Academy · पाठ

सार्वजनिक API और संरचना

तय कीजिए कि क्या उपलब्ध कराना है।

पाठ 3, कुल 4 में से13 चरण

सार्वजनिक API और संरचना, CoddyKit पर Mojo Academy का एक निःशुल्क पाठ है। यह 4 में से 3वाँ पाठ है। इस अध्ययन पथ के 3 तक कोई भी पाठ पूरा पढ़ना निःशुल्क है — इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ व्यावहारिक अभ्यास भी उपलब्ध कराता है। यह Mojo Academy सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। Mojo Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

आप क्या दिखाते हैं, यह महत्वपूर्ण है

किसी अच्छी लाइब्रेरी का मूल्यांकन उसके बाहरी हिस्से से होता है। क्या दिखाना है, यह तय करने से आपका API उपयोग करना कितना आसान होगा, यह तय होता है। 🚪

आपका सार्वजनिक API

अन्य कोड जिन फ़ंक्शन और टाइप को कॉल करने के लिए बनाए गए हैं, वे आपका सार्वजनिक API बनाते हैं। यह वह वादा है जिसे आप उपयोगकर्ताओं से निभाते हैं।

आंतरिक भाग छिपे रहते हैं

आपके API का समर्थन करने वाला, लेकिन कॉल करने वालों के लिए न बनाया गया सहायक कोड आंतरिक होता है। इसे छिपाने से आपका बाहरी हिस्सा छोटा रहता है।

छोटा बाहरी हिस्सा, कम जोखिम

आप जितने कम नाम दिखाते हैं, लाइब्रेरी सीखना उतना आसान होता है और बाद में आंतरिक भागों को उतनी स्वतंत्रता से बदला जा सकता है।

init से पुनः निर्यात करें

किसी पैकेज का __init__.mojo महत्वपूर्ण नामों को आयात कर सकता है, ताकि उपयोगकर्ता गहरी फ़ाइलों में जाने के बजाय सीधे पैकेज से उन तक पहुँच सकें।

from .core import add, subtract

साफ़ प्रवेश-द्वार

__init__ में आयात एकत्र करके आप कॉल करने वालों को लंबे और नाज़ुक मॉड्यूल पथों के बजाय एक स्पष्ट प्रवेश बिंदु देते हैं।

from mypkg import add

आंतरिक संरचना छिपाएँ

उपयोगकर्ता आपकी फ़ाइलों से नहीं, पैकेज से आयात करते हैं। इससे आप उनका कोड तोड़े बिना आंतरिक मॉड्यूलों को पुनर्व्यवस्थित कर सकते हैं।

नाम स्पष्ट रखें

सार्वजनिक नाम अपने अर्थ को स्पष्ट करने वाले होने चाहिए। स्पष्ट और स्थिर नाम उस अनुबंध का हिस्सा है जिसे आप बदलना नहीं चाहेंगे।

बाहरी हिस्से का दस्तावेज़ बनाएँ

हर सार्वजनिक फ़ंक्शन और टाइप में डॉकस्ट्रिंग जोड़ें। अच्छा दस्तावेज़ कॉल करने वालों को API का सही उपयोग करना बताते है।

fn add(a: Int, b: Int) -> Int:
    """Return the sum of a and b."""
    return a + b

स्थिर वादे

अपने सार्वजनिक API को एक अनुबंध मानें। इसे बदलने से उपयोगकर्ताओं का कोड टूट सकता है, इसलिए इसे छोटा रखें और बढ़ाने से पहले सोचें।

बाहर से भीतर की ओर डिज़ाइन करें

पहले कल्पना करें कि कॉल करने वाला आपकी लाइब्रेरी का उपयोग कैसे करना चाहता है, फिर उस सहज अनुभव को पूरा करने के लिए आंतरिक भाग बनाएँ। 🎨

त्वरित जाँच

आइए सोचें कि API को बनाए रखना आसान कैसे रखा जाए।

इंटरैक्टिव पाठ में इसका उत्तर दें

पुनरावलोकन

एक छोटा और स्पष्ट सार्वजनिक API दिखाएँ, महत्वपूर्ण नामों को __init__ में पुनः निर्यात करें, आंतरिक भाग छिपाएँ और साझा की गई चीज़ों का दस्तावेज़ बनाएँ। 🎯

शुरुआत निःशुल्क

एआई शिक्षक के साथ Mojo सीखें — निःशुल्क

अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।

पाठ्यक्रम: 30
पाठ: 120

निःशुल्क सीखना शुरू करें पूरा पाठ्यक्रम देखें

अक्सर पूछे जाने वाले प्रश्न

क्या “सार्वजनिक API और संरचना” पाठ निःशुल्क है?

हाँ — Mojo Academy अध्ययन पथ के 3 तक कोई भी पाठ, जिसमें “सार्वजनिक API और संरचना” भी शामिल है, यहाँ वेब पर पूरा पढ़ना निःशुल्क है। इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ इंटरैक्टिव अभ्यास भी उपलब्ध कराता है। Mojo Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

“सार्वजनिक API और संरचना” में मैं क्या सीखूँगा?

तय कीजिए कि क्या उपलब्ध कराना है। आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ Mojo Academy का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।

क्या Mojo Academy शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?

पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर Mojo Academy शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 3वाँ पाठ है।

“सार्वजनिक API और संरचना” पाठ पूरा करने में कितना समय लगता है?

CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।

क्या मैं इस Mojo Academy पाठ में कोड लिख और चला सकता हूँ?

हाँ। हर Mojo Academy पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।

इस पाठ्यक्रम के सभी पाठ

← Mojo Academy पर वापस जाएँ