अपनी पहली पायथन लाइब्रेरी बनाना सीखें! पोस्ट की इस श्रृंखला में, हम पोएट्री का उपयोग करके पायथन लाइब्रेरी बनाने और प्रकाशित करने की प्रक्रिया में आपका मार्गदर्शन करेंगे। आइए एक छोटे कैलकुलेटर एप्लिकेशन का निर्माण शुरू करें, जिसमें प्रारंभिक कॉन्फ़िगरेशन से लेकर बुनियादी कार्यों के कार्यान्वयन और परीक्षण तक सब कुछ शामिल है। इस श्रृंखला के अंत में, आपकी लाइब्रेरी PyPI पर दुनिया के साथ साझा करने के लिए तैयार होगी।

कविता क्या है?

कविता पायथन परियोजनाओं के लिए एक निर्भरता प्रबंधन और पैकेजिंग उपकरण है। यह कई कार्यों को स्वचालित करके पुस्तकालयों और अनुप्रयोगों को बनाने और बनाए रखने की प्रक्रिया को सरल बनाता है जिनके लिए पारंपरिक रूप से कई उपकरणों की आवश्यकता होती है। कविता उन सभी उपकरणों के साथ आती है जिनकी आपको अपनी परियोजनाओं को निश्चित रूप से प्रबंधित करने के लिए आवश्यकता हो सकती है। कविता के कुछ मुख्य लाभ यहां दिए गए हैं:

• प्रोजेक्ट बनाएं: एक ही कमांड से आसानी से अपने प्रोजेक्ट बनाएं और पैकेज करें।
• अपना काम साझा करें: अपने काम को PyPI पर प्रकाशित करके अवगत कराएं।
• अपनी निर्भरता की स्थिति जांचें: केवल एक आदेश के साथ अपने प्रोजेक्ट की निर्भरता का दृश्य प्राप्त करें।
• निर्भरता समाधान: कविता एक संपूर्ण निर्भरता समाधानकर्ता के साथ आती है, जो मौजूद होने पर हमेशा एक समाधान ढूंढेगा।
• अलगाव: कविता कॉन्फ़िगर किए गए आभासी वातावरण का उपयोग करती है या आपके सिस्टम से हमेशा अलग रहने के लिए अपना स्वयं का वातावरण बनाती है।
• सहज ज्ञान युक्त सीएलआई: कविता आदेश सहज और उपयोग में आसान, डिफ़ॉल्ट-संवेदनशील फिर भी विन्यास योग्य हैं।

इन फायदों के साथ, पोएट्री पायथन परियोजनाओं को विकसित करने के लिए एक शक्तिशाली और कुशल उपकरण के रूप में सामने आती है।

अपनी पायथन लाइब्रेरी शुरू करने से पहले हमें क्या चाहिए?

कोड लिखना शुरू करने से पहले, हमें अपना विकास परिवेश स्थापित करना होगा। यह सुनिश्चित करने के लिए चरण दिए गए हैं कि आपके पास सब कुछ तैयार है:

पायथन संस्करण की जाँच करें

सबसे पहले, हमें यह सुनिश्चित करना होगा कि आपके पास पायथन का नवीनतम संस्करण स्थापित है। अपने सिस्टम पर स्थापित पायथन के संस्करण की जांच करने के लिए, टर्मिनल में निम्नलिखित कमांड चलाएँ:

python --version

यदि आपके पास पहले से Python इंस्टॉल नहीं है या आपको इसे अपडेट करने की आवश्यकता है, तो आप इसे आधिकारिक Python वेबसाइट से डाउनलोड और इंस्टॉल कर सकते हैं।

कविता स्थापित करना

यह सुनिश्चित करने के बाद कि आपके पास पायथन का नवीनतम संस्करण स्थापित है, अगला कदम पोएट्री स्थापित करना है। आप आधिकारिक दस्तावेज़ में विस्तृत निर्देशों का पालन करके पोएट्री इंस्टॉल कर सकते हैं। यहां इंस्टालेशन के लिए एक त्वरित आदेश दिया गया है:

curl -sSL https://install.python-poetry.org | python3 -

अपनी लाइब्रेरी शुरू करना: पहला कदम

चरण 1: कविता के साथ प्रोजेक्ट बनाना

अब जब हमारे पास पायथन और पोएट्री स्थापित है, तो यह हमारे कैलकुलेटर प्रोजेक्ट को शुरू करने का समय है। कविता एक साधारण आदेश के साथ एक नया प्रोजेक्ट बनाना आसान बनाती है।

उस निर्देशिका पर नेविगेट करें जहां आप अपना प्रोजेक्ट बनाना चाहते हैं और टर्मिनल में निम्नलिखित कमांड चलाएँ:

poetry new calculator
cd calculator

यह कमांड आपके लिए एक नई प्रोजेक्ट संरचना बनाता है, जिसमें आवश्यक फ़ोल्डर्स और फ़ाइलें शामिल हैं।

calculator/
├── README.md
├── calculator
│   └── __init__.py
├── pyproject.toml
└── tests
    └── __init__.py

आइए उत्पन्न संरचना को समझें:

• README.md: आपके प्रोजेक्ट का वर्णन करने के लिए एक दस्तावेज़ीकरण फ़ाइल।
• कैलकुलेटर/: एक फ़ोल्डर जिसमें आपके एप्लिकेशन का स्रोत कोड होता है।
• परीक्षण/: आपके यूनिट परीक्षणों के लिए एक फ़ोल्डर।
• pyproject.toml: कविता के लिए मुख्य कॉन्फ़िगरेशन फ़ाइल।

चरण 2: कैलकुलेटर कार्यों को लागू करना

अब कैलकुलेटर/कैलकुलेटर.py फ़ाइल के भीतर कैलकुलेटर फ़ंक्शन बनाएं।

calculator/
├── calculator.py
├── __init__.py

कैलकुलेटरहोम फ़ाइल खोलें और बुनियादी कैलकुलेटर फ़ंक्शन लागू करें:

def add(a, b):
    return a   b

def subtract(a, b):
    return a - b

def multiply(a, b):
    return a * b

def divide(a, b):
    if b == 0:
        raise ValueError("Não é possível dividir por zero")
    return a / b

चरण 3: कैलकुलेटर कार्यों का परीक्षण

सॉफ़्टवेयर गुणवत्ता की गारंटी, बग फिक्स और कोड विकास में विश्वसनीयता प्रदान करने के लिए परीक्षण आवश्यक है। इस उदाहरण में, हम अपने कैलकुलेटर कार्यों को मान्य करने के लिए यूनिट परीक्षणों का उपयोग करेंगे। आइए परीक्षण वातावरण स्थापित करें और यह सुनिश्चित करने के लिए कुछ परीक्षण मामले लिखें कि गणितीय संक्रियाएँ सही ढंग से काम करती हैं।

परीक्षण वातावरण को कॉन्फ़िगर करना

पाइस्टेस्ट को विकास निर्भरता के रूप में जोड़ना प्रारंभ करें:

poetry add --dev pytest

अब, परीक्षण फ़ोल्डर के अंदर test_calculator.py नामक एक फ़ाइल बनाएं:

import pytest
from calculator.calculator import add, subtract, multiply, divide

def test_add():
    assert add(2, 3) == 5
    assert add(-1, 1) == 0
    assert add(0, 0) == 0
    assert add(-1, -1) == -2

def test_subtract():
    assert subtract(5, 2) == 3
    assert subtract(0, 0) == 0
    assert subtract(-1, 1) == -2
    assert subtract(-1, -1) == 0

def test_multiply():
    assert multiply(2, 3) == 6
    assert multiply(5, 0) == 0
    assert multiply(-1, 1) == -1
    assert multiply(-2, -3) == 6

def test_divide():
    assert divide(6, 2) == 3
    assert divide(5, 2) == 2.5
    assert divide(-10, 2) == -5
    with pytest.raises(ValueError):
        divide(4, 0)

अंत में, बस निम्नलिखित आदेश के साथ परीक्षण चलाएं:

poetry run pytest

चरण 4: GitHub पर प्रकाशन

अब जब हमारा एप्लिकेशन परीक्षणों से ढका हुआ है, तो आइए इसे GitHub पर साझा करने के लिए तैयार करें। अपने प्रोजेक्ट को GitHub में जोड़ने के लिए नीचे दिए गए चरणों का पालन करें:

1. GitHub पर एक रिपॉजिटरी बनाएं: GitHub पर जाएं और अपने कैलकुलेटर के लिए एक नई रिपॉजिटरी बनाएं।

2. अपना प्रोजेक्ट रिपॉजिटरी में जोड़ें:

• यदि आपकी प्रोजेक्ट निर्देशिका में Git रिपॉजिटरी पहले से प्रारंभ नहीं हुई है, तो उसे प्रारंभ करें:

git init

• सभी फ़ाइलें Git में जोड़ें और पहली प्रतिबद्धता बनाएं:

git add .
git commit -m "Initial commit"

• अपने स्थानीय रिपॉजिटरी को GitHub पर रिमोट रिपॉजिटरी से कनेक्ट करें:

git remote add origin 

• अपनी फ़ाइलें GitHub पर अपलोड करें:

git push -u origin main

अब आपका प्रोजेक्ट GitHub पर है और अन्य डेवलपर्स के साथ साझा और सहयोग करने के लिए तैयार है।

चरण 5: पिप या पोएट्री के माध्यम से स्थापित करना

अपनी लाइब्रेरी को सीधे स्थापित करने के लिए, बस निम्नलिखित कमांड का उपयोग करें:

• पिप के माध्यम से:

pip install git https://github.com/seu_usuario/seu_repositorio.git

• कविता के माध्यम से:

poetry add git https://github.com/seu_usuario/seu_repositorio.git

आगे क्या आता है?

ट्यूटोरियल के इस पहले भाग में, हम पोएट्री का उपयोग करके पायथन लाइब्रेरी बनाने के लिए आवश्यक बुनियादी बातों को शामिल करते हैं। हमने विकास परिवेश स्थापित करके शुरुआत की, पाइटेस्ट का उपयोग करके यूनिट परीक्षणों के साथ एक बुनियादी कैलकुलेटर लागू किया, और सहयोग के लिए प्रोजेक्ट को GitHub पर साझा किया।

इस ट्यूटोरियल के अगले भाग में, हम यह पता लगाएंगे कि अपनी लाइब्रेरी को PyPI, मानक पायथन पैकेज रिपॉजिटरी में कैसे प्रकाशित किया जाए, और सीखेंगे कि इसे सीधे PyPI से पोएट्री या पाइप का उपयोग करके कैसे इंस्टॉल किया जाए। इससे न केवल आपकी लाइब्रेरी अन्य डेवलपर्स के लिए उपयोग में आसान हो जाएगी, बल्कि यह आपको पायथन समुदाय के साथ एकीकृत करने में भी मदद करेगी।

यहां तक ​​पहुंचने के लिए बधाई! मुझे आशा है कि आप अपनी पायथन लाइब्रेरी बनाने का आनंद ले रहे हैं। टिप्पणियों में प्रश्न या सुझाव बेझिझक साझा करें। आइए अब भाग II की ओर बढ़ें और पायथन समुदाय के साथ सहयोग की अपनी यात्रा जारी रखें।

संदर्भ

• कैनाल एडुआर्डो मेंडेस (@Dunossauro) स्क्रैच से एक पायथन पैकेज बनाना: आवश्यकताओं से तैनाती तक
• काव्य दस्तावेज़ीकरण
• कविता: पायथन पैकेज बनाना आसान तरीका