কম্পিউটার টিউটোরিয়াল

পাইথন কোড প্যাকেজিং ও পাবলিশিং (Packaging and Publishing Python Code)

পাইথন প্যাকেজ তৈরি ও পাবলিশ করার খুব সহজ পদ্ধতি প্রদান করে।

পাইথনে প্যাকেজ ম্যানেজমেন্ট বিভিন্ন টুলের মাধ্যমে উপলব্ধ:

  • Pip- এটি সবচেয়ে পছন্দনীয় চয়েস কারণ এটি সফটওয়্যার প্যাকেজের ম্যানুয়াল ইনস্টল ও আপডেট প্রায় সম্পূর্ণরূপে দূর করে। এটি প্যাকেজের পূর্ণ তালিকা ও তাদের ভার্সন নম্বর ম্যানেজ করে, যা আলাদা এনভায়রনমেন্টে পুরো প্যাকেজ গ্রুপকে প্রিসাইজলি ডুপ্লিকেট করতে সাহায্য করে।

  • Python Package Index (PyPI) হল ইউজার-সাবমিটেড প্যাকেজের একটি পাবলিক রিপোজিটরি যা pip দিয়ে ইনস্টল করা যায়: pip install package_name।

নিচে প্যাকেজ আপলোড করার ধাপে ধাপে প্রক্রিয়া দেওয়া হলো।

ধাপ ১: আপলোড করার জন্য একটি প্যাকেজ থাকতে হবে

আমি অনুমান করছি আপনার প্যাকেজ পাবলিশ করার জন্য রেডি। যদি না থাকে, নিচের প্রক্রিয়া অনুসরণ করে পাইথন প্যাকেজ বা মডিউল তৈরি করুন, খুব সহজ:

  • আপনার কোড সহ একটি পাইথন ফাইল তৈরি করুন, নাম দিন myfirstPackage.py বা myPackageName.py। এটি একটি মডিউল। একটি ফাইল (myfirstPackage.py) যার ভিতরে ডেটা রয়েছে। আমরা এটি ইম্পোর্ট করতে পারি বা যা ইচ্ছা করতে পারি।

  • এটিকে প্যাকেজ বানান:

শুধু একটি খালি __init__.py ফাইল যোগ করুন। 
echo >> __init__.py বা touch কমান্ড ব্যবহার করুন 
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              . 
08-04-2019  05.44 PM              .. 
08-04-2019  02.25 PM                47 myFirstPackage.py 
08-04-2019  05.44 PM                13 __init__.py

উপরে দেখুন firstPackage ডিরেক্টরির ভিতরে দুটি ফাইল রয়েছে।

এটাই হলো, একটি ডিরেক্টরির ভিতরে দুটি ফাইল (__init__.py এবং myfirstPackage.py) থাকলেই সেটি একটি প্যাকেজ (myHelloModule) कहলায়।

প্রজেক্ট প্যাকেজিং

প্রথমে স্যাম্পল প্রজেক্ট ক্লোন করুন এবং আপনার মডিউলের নাম দিন:

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

পাইথন কোড প্যাকেজিং ও পাবলিশিং (Packaging and Publishing Python Code)

গুরুত্বপূর্ণ ফাইলগুলো:

  • Setup.py – এটি প্রজেক্ট কনফিগারেশন স্পেসিফাই করতে এবং প্যাকেজিং কমান্ড রান করতে দেয়: উদাহরণস্বরূপ, এই কমান্ড চেষ্টা করুন: python setup.py --help

  • Setup.cfg হল একটি INI ফাইল যাতে setup.py কমান্ডের অপশন ডিফল্ট থাকে।

  • README.rst reStructuredText-এ প্রজেক্টের লক্ষ্য বর্ণনা করে।

নতুন ফোল্ডারের ভিতরে আপনার মডিউল(গুলো) কপি করুন এবং বিদ্যমান "sample" মডিউলটি রিমুভ করুন:

└───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.

আসল প্যাকেজিং ধাপগুলো

এনভায়রনমেন্টে setuptools ও wheel প্যাকেজ ইনস্টল বা আপডেট করুন।

>pip install wheel twine setuptools --upgrade

প্রথমে সোর্স ডিস্ট্রিবিউশন তৈরি করুন। এই ধরনের "ডিস্ট্রিবিউশন" (অর্থাৎ প্যাকেজ) pip দিয়ে ইনস্টল করার সময় বিল্ড স্টেপ প্রয়োজন।

>python setup.py sdist

এখন একটি "wheel" (বিল্ট প্যাকেজ) ইনস্টল করুন যা সোর্স ডিস্ট্রিবিউশনের চেয়ে দ্রুত ইনস্টল হয়।

>python setup.py bdist_wheel

আশা করি প্যাকেজ বিল্ড হয়েছে এবং আপনার firstpackage ফোল্ডারের dist ডিরেক্টরিতে 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 list চালিয়ে বর্তমান এনভায়রনমেন্টের সব প্যাকেজের লিস্ট দেখুন।

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

এখন PyPI-এ প্যাকেজ পাবলিশ করার পালা, যাতে সেটি পাবলিকলি উপলব্ধ হয়।

প্রথমে setup.py থাকা পাথে যান এবং twine প্যাকেজ ইনস্টল বা আপডেট করুন।

>pip install --upgrade twine

শেষে, 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 …

উপরে শুধু ইউজারনেম ও পাসওয়ার্ড দিতে হবে, তারপর আপনার প্যাকেজ আপলোড শুরু হয়ে যাবে।

  1. পাইথন ম্যাথ অপারেটর: একটি গাইড

  2. পাইথন ইন্টারপ্রেটার: ধাপে ধাপে গাইড

  3. পাইথনে =+ এবং += অপারেটরের পার্থক্য

  4. পাইথন মডিউল এবং পাইথন প্যাকেজের পার্থক্য