पायथन कोड की पैकेजिंग और प्रकाशन?

पायथन पैकेज बनाने या प्रकाशित करने का एक बहुत ही सरल तरीका प्रदान करता है।

पायथन में पैकेज प्रबंधन विभिन्न उपकरणों के माध्यम से उपलब्ध है-

• पिप- यह पसंदीदा विकल्पों में से एक बना हुआ है क्योंकि यह ऑपरेटिंग सिस्टम में सॉफ़्टवेयर पैकेज के किसी भी मैन्युअल इंस्टॉल और अपडेट को वस्तुतः समाप्त कर देता है। यह पैकेजों की पूरी सूची और उनके संगत संस्करण संख्याओं का प्रबंधन करता है, जो एक अलग, अलग वातावरण में संपूर्ण पैकेज समूहों के सटीक दोहराव को बढ़ावा देता है।

• पायथन पैकेज इंडेक्स (पीपीआई) उपयोगकर्ता द्वारा प्रस्तुत पैकेजों का एक सार्वजनिक पैकेज भंडार है जिसे पाइप का उपयोग करके स्थापित किया जा सकता है। pip install package_name.

पैकेज को अपलोड करने के तरीके के बारे में चरण-दर-चरण प्रक्रिया नीचे दी गई है।

चरण 1:अपलोड करने के लिए एक पैकेज रखें

मुझे लगता है कि आपके पास पैकेज प्रकाशित होने के लिए तैयार है। यदि आपके पास नहीं है, तो कृपया पायथन पैकेज या मॉड्यूल बनाने के लिए नीचे दी गई प्रक्रिया का पालन करें, अच्छी बात यह है कि यह बहुत आसान है-

• अपने कोड के साथ एक पायथन फ़ाइल बनाएं, इसे myfirstPackage.py या myPackageName.py कहें। यह एक मॉड्यूल है। एक फ़ाइल (myfirstPackage.py) जिसमें डेटा है। हम इसे आयात कर सकते हैं या जो चाहें कर सकते हैं।

• इसे एक पैकेज बनाएं:

Just add an empty __init__.py file to it.

echo >> __init__.py

or use touch command

touch __init_.py

$dir
Volume in drive C has no label.
Volume Serial Number is 8CD6-8D39

Directory of c:\Python\Python361\firstPackage

08-04-2019 05.44 PM <DIR> .
08-04-2019 05.44 PM <DIR> ..
08-04-2019 02.25 PM 47 myFirstPackage.py
08-04-2019 05.44 PM 13 __init__.py

आप देख सकते हैं कि ऊपर दो फाइलें फर्स्टपैकेज डायरेक्टरी के अंदर हैं।

यही है, दो फाइलों वाली निर्देशिका (__init__.py और myfirstPackage.py) को पैकेज (myHelloModule) कहा जाता है।

अपने प्रोजेक्ट की पैकेजिंग करना

सबसे पहले, नमूना प्रोजेक्ट को क्लोन करें और इसे अपने मॉड्यूल का नाम दें-

git clone https://github.com/pypa/sampleproject firstPackage

महत्वपूर्ण फाइलें हैं-

• Setup.py - यह हमें अपने प्रोजेक्ट कॉन्फ़िगरेशन को निर्दिष्ट करने और पैकेजिंग कमांड चलाने की अनुमति देता है:उदाहरण के लिए, इस कमांड को आज़माएं:python setup.py --help

• Setup.cfg एक INI फ़ाइल है जिसमें setup.py कमांड के लिए विकल्प डिफ़ॉल्ट होते हैं

• README.rst reStructuredText का उपयोग करके परियोजना के लक्ष्य का वर्णन करता है।

अपने मॉड्यूल को इस नए फ़ोल्डर के अंदर कॉपी करें और मौजूदा "नमूना" मॉड्यूल को हटा दें-

└───firstPackage
│ LICENSE.txt
│ MANIFEST.in
│ myFirstPackage.py
│ README.md
│ setup.cfg
│ setup.py
│ tox.ini
│ __init__.py

नाम, संस्करण, विवरण कॉन्फ़िगर करें

अपने पायथन पैकेज के बारे में बुनियादी जानकारी रखने के लिए setup.py संपादित करें−

setup.py

import setuptools

with open("README.md", "r") as fh:
long_description = fh.read()

setuptools.setup(
   name="firstPackage",
   version="0.0.1",
   author="Rajesh Joshi",
   author_email="callraj.joshi@gmail.com",
   description="my First Package",
   long_description=long_description,
   long_description_content_type="text/markdown",
   url="https://github.com/pypa/sampleproject",
   packages=setuptools.find_packages(),
   classifiers=[
      "Programming Language :: Python :: 3",
      "License :: OSI Approved :: MIT License",
      "Operating System :: OS Independent",
   ],
)

और आपकी लाइसेंस फाइल कुछ इस तरह होगी-

MIT License

Copyright (c) [2019] [firstPackage]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

. README के ​​लिए

## firstPackage
This is a sample package to learn the steps of creating and publishing package.

वास्तविक पैकेजिंग चरण

वातावरण में सेटअपटूल और व्हील पैकेज इंस्टाल या अपडेट करें।

>pip install wheel twine setuptools –upgrade

सबसे पहले, एक स्रोत वितरण बनाएं। इस तरह के "वितरण" (यानी पैकेज) को पाइप द्वारा स्थापित किए जाने पर एक बिल्ड चरण की आवश्यकता होती है।

>python setup.py sdist

अब हम एक "व्हील" (एक निर्मित पैकेज) स्थापित करना चाहते हैं जो एक स्रोत वितरण की तुलना में स्थापित करने के लिए अधिक मोटा है।

>python setup.py bdist_wheel

उम्मीद है, पैकेज बनाया जाना चाहिए और आप setup.py फ़ाइल के बगल में अपने पहले पैकेज फ़ोल्डर में डिस्ट निर्देशिका में पैकेज की संपीड़ित फ़ाइल देख सकते हैं।

अपना पैकेज अपलोड कर रहा है

अब अपनी पसंद के किसी अन्य स्थान पर एक नया आभासी वातावरण बनाएं और इसे नीचे की तरह सक्रिय करें-

c:\Users\rajesh>virtualenv myPackage
Using base prefix 'c:\\python\\python361'
New python executable in c:\Users\rajesh\myPackage\Scripts\python.exe
Installing setuptools, pip, wheel...done.

c:\Users\rajesh\myPackage>.\Scripts\activate

(myPackage) c:\Users\rajesh\myPackage>

ऊपर बनाई गई ज़िप फ़ाइल को अपने नए परिवेश में कॉपी करें।

>pip install firstPackage-0.0.1.tar.gz

यह सत्यापित करने के लिए कि आपका पैकेज आपके सक्रिय वातावरण में स्थापित है, अपने वर्तमान परिवेश में सभी पैकेजों की सूची दिखाने के लिए बस pip सूची चलाएँ।

>pip list
Package      Version
------------ -------
firstPackage  0.0.1
pip           19.0.3
setuptools    41.0.0
wheel         0.33.1

अब पैकेज को PyPI में प्रकाशित करने का समय आ गया है, ताकि यह सार्वजनिक रूप से उपलब्ध हो सके।

पहले उस पथ पर जाएं जहां setup.py मौजूद है और फिर ट्विन पैकेज इंस्टॉल या अपडेट करें।

>pip install --upgrade twine

अंत में, अपने पैकेज को ट्विन के माध्यम से PyPI पर प्रकाशित करें,

>twine upload dist/*
Enter your username: callraj.joshi
Enter your password:
Uploading distributions to https://upload.pypi.org/legacy/
Uploading firstPackage-0.0.1-py2.py3-none-any.whl
…

ऊपर हमें केवल उपयोगकर्ता नाम और पासवर्ड दर्ज करने की आवश्यकता है, फिर यह हमारे पैकेज को अपलोड करना शुरू कर देगा।