Python este al treilea limbaj de programare cel mai folosit, bazat pe un sondaj Stackoverflow din 2023. Acest scop general poate fi utilizat în știința datelor, dezvoltarea web, învățarea automată, ingineria software și calculul științific.
Un pachet Python este unul dintre termenii pe care îi veți întâlni pe măsură ce învățați și interacționați cu limbajul Python. Ce sunt pachetele Python și cum le puteți crea?
Acest articol va;
- Definiți pachetele Python
- Explicați importanța pachetelor Python în programare
- Demonstrați cum să creați pachete Python
- Demonstrați cum să utilizați și să testați pachetele Python
- Demonstrați cum să încărcați pachete Python
Cuprins
Ce sunt pachetele Python?
Pachetele Python sunt blocuri de bază esențiale în programare. Fără pachete, dezvoltatorii ar putea scrie totul de la zero, făcând din programare un proces lung și stresant. Pachetele Python sunt colecții de module Python, practic o colecție de cod reutilizabil.
Un modul în Python este un fișier care conține cod Python care poate fi importat în alte programe Python. Pentru a crea un pachet Python, trebuie să stocați codul într-un director care conține un fișier __init__.py.
Un pachet Python poate conține alte pachete (cuibări), iar mii de pachete Python sunt disponibile online. Unele dintre aceste pachete sunt oficiale, în timp ce altele nu. Majoritatea pachetelor Python sunt disponibile pe https://pypi.org/.
Django, un cadru web Python, este un exemplu de pachet pe care îl puteți folosi pentru a construi aplicații web. Scikit-learn, PyTorch și TensorFlow sunt pachete populare în domeniul învățării automate.
Importanța pachetelor Python
De ce să nu creezi totul de la zero ca programator? Avem nevoie de pachete Python? Acestea sunt câteva dintre motivele pentru care pachetele Python sunt importante;
- Economisește timp: pachetul Python vă oferă acces la codul pre-scris care rezolvă problemele comune. Puteți folosi pachetele Python în loc să reinventați roata ori de câte ori doriți să scrieți un script Python.
- Facilitează distribuirea codului: colaborarea este foarte comună în programare. Puteți crea un pachet Python pe care membrii echipei dvs. îl pot importa oricând atunci când colaborează la un proiect.
- Reutilizarea codului: dacă există un bloc de cod pe care trebuie să îl scrieți întotdeauna în programele dvs. Python, îl puteți împacheta și îl puteți importa în aplicațiile dvs.
- Organizarea codului: pachetele Python vă permit să vă organizați codul în module logice. O astfel de abordare facilitează citirea și întreținerea codului dvs. Python.
Cum să creezi primul tău pachet Python
Am afirmat deja că Python este un limbaj de uz general. Puteți crea diferite tipuri de pachete ca programator.
De exemplu, puteți avea un pachet care automatizează anumite sarcini, un pachet care vă ajută să bugetați sau chiar să învățați o nouă limbă. Cu toate acestea, înainte de a începe să creați primul pachet, aveți nevoie de următoarele;
Cerințe preliminare;
- Python este instalat pe mașina dvs. locală. Dacă utilizați Linux, Python este instalat implicit cu sistemul de operare. Puteți folosi această comandă python –version sau python3 –version pentru a verifica dacă Python este instalat. Dacă Python este instalat, veți vedea ceva de genul acesta pe terminalul dvs.;
Dacă nu aveți Python, îl puteți descărca de la https://www.python.org/downloads/.
- Înțelegerea lui Python. Trebuie să înțelegeți cum să scrieți clase, module și funcții Python.
- Un manager de pachete. Vom folosi pip pentru această demonstrație. Puteți verifica dacă pip este instalat folosind această comandă;
pip --version
Dacă este instalat, veți vedea ceva similar pe terminalul dvs.
Cerințele pot varia în funcție de natura pachetului pe care doriți să îl instalați.
Voi crea un pachet Python simplu pentru această demonstrație care verifică dacă un număr este prim. Puteți urmări de-a lungul;
- Pasul unu: creați un folder de proiect. Îl voi numi pe al meu drept primechecker.
- Pasul doi: Creați un alt folder în dosarul primechecker și numiți-l prime.
- Pasul trei: creați un fișier în directorul creat la pasul doi și denumiți-l prime.py. Puteți combina cei trei pași folosind această comandă;
mkdir primechecker && cd primechecker && mkdir prime && cd prime && touch prime.py
- Pasul trei: deschideți proiectul în editorul de cod. Puteți adăuga apoi acest cod în fișierul prime.py care verifică dacă un număr este un număr prim;
def is_prime(number): if number < 2: return False for i in range(2, int(number ** 0.5) + 1): if number % i == 0: return False return True
- Pasul patru: în folderul principal, creați un fișier nou și denumiți-l __init__.py. Acest fișier îl face pe Python să recunoască folderul proiect pe care l-am creat ca pachet.
Puteți folosi această comandă;
touch prime/__init__.py
- Pasul cinci: Testează-ți codul. Putem crea un script într-un fișier test.py în folderul rădăcină care verifică dacă un număr este prim. Navigați înapoi la folderul principal și utilizați această comandă;
touch test.py
Apoi puteți adăuga acest cod la acest fișier;
from prime.prime import is_prime
number = int(input("Enter a number: "))
result = is_prime(number)
print(f"{number} is prime: {result}")
Rulați această comandă pentru a vă verifica codul;
python3 test.py
Acum puteți introduce un număr și puteți verifica dacă este prim.
De exemplu, am verificat dacă 5 și 1 sunt numere prime și am obținut următoarele;
Cum să încărcați pachetul online
Puteți găzdui pachetul pe care l-ați creat pe PyPI (Python Package Index). Acesta este un depozit central care transportă mii de pachete Python. Accesați https://pypi.org/ și creați un cont dacă nu aveți unul.
Puteți urma acești pași acum pentru a vă încărca pachetul online;
- Pasul 1: Creați un fișier nou în folderul rădăcină (al meu este primechecker) și numiți-l setup.py.
- Pasul 2: Modificați conținutul fișierului setup.py pentru a conține informații despre pachetul pe care doriți să îl încărcați.
Codul pentru acest fișier ar trebui să fie după cum urmează;
from setuptools import setup, find_packages setup( name="primechecker", version='1.0.0', author="Your Name", author_email="[email protected]", description='A package for checking prime numbers', packages=find_packages(), )
Schimbați numele, autorul, adresa de e-mail al autorului și descrierea pentru a se potrivi cu detaliile pachetului dvs.
- Pasul 3: Construiește-ți pachetul. Rulați această comandă în timp ce încă în folderul rădăcină;
python3 setup.py sdist bdist_wheel
Dacă verificați folderul proiectului, puteți vedea două foldere noi (build și dist) în folderul rădăcină.
- Pasul 4: Instalați sfoară. Acesta este pachetul necesar pentru a încărca pachete în PyPI.
Utilizați această comandă;
pip install twine
- Pasul 5: Încărcați pachetul
Utilizați această comandă;
twine upload dist/*
Vi se va solicita să introduceți numele de utilizator și parola. Dacă numele pachetului dvs. nu este deja luat, pachetul va fi publicat online și veți primi un link pe terminalul dvs.
Pachetul pe care tocmai l-ați publicat va fi disponibil publicului. Oricine dorește să folosească pachetul îl poate descărca folosind pip.
De exemplu, pachetul pe care l-am publicat poate fi descărcat ca;
pip install primechecker==1.0.0.
Cele mai bune practici pentru crearea pachetelor Python
- Acordați atenție standardelor de ambalare Python: chiar dacă sunteți liber să decideți asupra tipului de pachet pe care să îl creați, amintiți-vă întotdeauna că pachetele Python au standarde pe care ar trebui să le respectați. Verificați aceste standarde pe https://packaging.python.org/ înainte de a începe să scrieți codul.
- Testați pachetul înainte de implementare: erorile sunt comune în programare. Creați scripturi pentru generarea de teste automate, mai ales atunci când construiți pachete mari. O astfel de abordare vă asigură că încărcați pachete fără erori.
- Versiune: Un pachet adecvat ar trebui să urmeze versiunea semantică. Pachetul pe care l-am creat în demonstrația noastră avea aceste numere 1.0.0. Primul bit (1) este versiunea majoră, al doilea bit (0) este versiunea minoră, iar ultimul bit este Patch.
- Specificați toate dependențele: în funcție de nevoile dvs., este posibil să aveți diferite dependențe sau alte pachete în pachetul dvs. Ar trebui să menționați toate dependențele în descrierea pachetului dvs. în timpul încărcării. Puteți folosi instrumente precum setuptools sau poezie pentru a adăuga și gestiona aceste dependențe.
- Utilizați controlul versiunilor: Programarea este un proces continuu. Puteți continua să actualizați sau să îmbunătățiți pachetul pentru a adăuga noi funcții sau pentru a-l face mai eficient. Poate doriți să invitați și colaboratori. Puteți încărca codul pachetului pe platforme precum GitHub sau GitLab pentru a vă face codul accesibil și pentru a permite colaborarea.
- Documentați-vă codul: pachetul pe care l-am creat a fost în scop demonstrativ. Cu toate acestea, dacă intenționați să partajați un astfel de pachet publicului sau membrilor echipei, trebuie să generați documentație care să ghideze utilizatorii. Puteți folosi instrumente precum Pydoc sau Sphinx pentru a vă genera documentele.
Unde mai pot încărca pachete Python?
Chiar dacă Python Package Index (PyPI) este depozitul oficial pentru pachetele Python, aceasta nu înseamnă că aveți restricții în utilizarea acestuia. Unii factori de luat în considerare atunci când determinați unde să încărcați pachetul dvs. Python sunt dimensiunea fișierelor, natura pachetului, nivelul de suport necesar și publicul țintă.
Acestea sunt alte zone în care vă puteți încărca pachetele Python;
- GitHub: GitHub este cea mai mare platformă de găzduire a codurilor. Puteți crea un depozit și puteți adăuga pachetul dvs. Python ca fișier zip pentru redistribuire.
- Conda: Conda este un manager de pachete pe care îl puteți folosi pentru pachetele dvs. Python. Această platformă este renumită printre oamenii de știință de date. Creați un cont pe Conda și începeți să vă încărcați pachetele pentru redistribuire.
- Oglinzi PyPI: Există multe oglinzi PyPI care oglindesc conținutul platformei PyPI. Alegeți unul care se potrivește nevoilor dvs. pentru a vă găzdui pachetul.
Concluzie
Acum aveți pașii de a crea pachete Python și de a le publica online. Exemplul nostru a fost simplu, dar puteți să vă jucați și să creați pachete complexe. Cu toate acestea, creați întotdeauna structura corectă de foldere atunci când construiți pachete Python.