Library — Współdzielony kod między aplikacjami

System bibliotek Pytigona dostarcza uporządkowany sposób współdzielenia kodu między aplikacjami wewnątrz projektu. Biblioteki są wykrywane i ładowane automatycznie w czasie działania — wystarczy utworzyć właściwy katalog i umieścić w nim moduły Pythona.

Trzy lokalizacje bibliotek

Pytigon szuka bibliotek w trzech lokalizacjach, z jasną hierarchią:

1. Biblioteki aplikacji: [app]/applib/

Kod specyficzny dla pojedynczej aplikacji, ale zorganizowany jako osobne moduły:

myapp/
├── applib/
│   ├── __init__.py
│   ├── utils.py          # Współdzielone funkcje narzędziowe
│   ├── validators.py     # Niestandardowe walidatory
│   └── reports.py        # Logika generowania raportów
├── models.py
└── views.py

2. Biblioteki projektu: [PRJ]/prjlib/

Kod współdzielony między wszystkimi aplikacjami w projekcie. Są automatycznie dodawane do ścieżki Pythona:

[PRJ]/
├── prjlib/
│   ├── __init__.py
│   ├── common_utils.py   # Narzędzia używane przez wiele aplikacji
│   └── base_views.py     # Współdzielone klasy widoków bazowych
├── myapp/
└── settings_app.py

3. Biblioteki systemowe (zainstalowane przez PIP): [DATA]/[PRJ]/prjlib/

Pakiety zainstalowane przez ptig pip install trafiają tu. To zależności specyficzne dla projektu, które nie zaśmiecają globalnego środowiska Pythona.

4. Rozszerzenia kompilowane: [DATA]/[PRJ]/syslib/

Rozszerzenia C, C++, Nim i Zig kompilowane automatycznie podczas instalacji ze źródeł. Omijają GIL Pythona dla operacji krytycznych wydajnościowo.

Automatyczne wykrywanie i import

Biblioteki są importowane automatycznie przy starcie. Mechanizm importu:

  1. Skanuje wszystkie zarejestrowane katalogi aplikacji w poszukiwaniu applib/
  2. Skanuje katalog główny projektu w poszukiwaniu prjlib/
  3. Dodaje je do sys.path
  4. Importuje moduły znalezione w tych katalogach

Możesz importować z dowolnej lokalizacji biblioteki używając standardowych importów Pythona:

# Z biblioteki aplikacji
from applib.utils import my_function

# Z biblioteki projektu (importowane też jako 'prjlib')
from prjlib.common_utils import shared_constant

# Bezpośredni import też działa
import applib.validators

Wbudowane biblioteki (pytigon_lib)

Sam Pytigon jest zorganizowany jako zbiór bibliotek. Główne biblioteki dostępne w każdym projekcie to:

Biblioteka Przeznaczenie
schdjangoext Rozszerzenia Django — JSONModel, FastForm, pola, widgety
schviews Ogólne widoki — TableView, FormView, TreeView
schhtml Silnik renderowania — generowanie HTML/PDF/ODF
schfs Abstrakcja wirtualnego systemu plików
schindent Preprocesor szablonów .ihtml
schtable Struktury danych tabel
schtasks Planowanie zadań w tle
schparser Narzędzia parsowania HTML
schspreadsheet Przetwarzanie arkuszy (ODF/XLSX)
schtools Rozmaite narzędzia — obrazy, szyfrowanie, instalacja
schhttptools Klient HTTP, klient REST, narzędzia WebSocket
schandroid Komponenty klienta Android/Kivy

Najlepsze praktyki organizacji

  • Trzymaj applib/ skupione — Jeśli kod jest używany przez wiele aplikacji, awansuj go do prjlib/
  • Używaj prjlib/ dla współdzielonej logiki biznesowej — Walidatory, klasy bazowe, funkcje narzędziowe
  • Zarezerwuj PIP dla pakietów zewnętrznych — Nie umieszczaj własnego kodu w katalogach instalowanych przez PIP
  • Wrzucaj kod krytyczny wydajnościowo do rozszerzeń kompilowanych — Katalog syslib/ obsługuje moduły C, Nim i Zig, które kompilują się automatycznie przy instalacji
?: Library ?: Library