Treść książki

Przejdź do opcji czytnikaPrzejdź do nawigacjiPrzejdź do informacjiPrzejdź do stopki
Ponadtonależyzachowaćszczególnąostrożność,umieszczająckod
wpliku__init__.py.Tenplikzostaniewywołanyiwykonanyprzypierwszym
załadowaniudanegomodułu.Umieszczenieniewłaściwegokoduwpliku
__init__.pymożepociągaćzsobąniepożądaneskutkiuboczne.Wrzeczy-
wistościpliki__init__.pylepiejzregułypozostawićpuste,chybażewiemy,
corobimy.Jednaknienależycałkowicieusuwaćplików__init__.py,gdyż
wprzeciwnymwypadkuniebędziemożnawogólnezaimportowaćmodułu
Pythona:wjęzykuPythonkatalogmusizawieraćplik__init__.py,abymógł
byćtraktowanyjakpodmoduł.
Numerowaniewersji
Wersjeoprogramowaniamuszązostaćoznaczonetak,abyużytkownicywie-
dzieli,którawersjajestnajnowsza.Wkażdymprojekcieużytkownicymuszą
miećmożliwośćopracowanialiniiczasowejdlaewoluującegokodu.
Istniejenieskończonaliczbasposobóworganizowanianumerówwersji.
JednakspecykacjaPEP440wprowadzaformatwersji,którynależystosować
wkażdympakieciePythona,anajlepiejwkażdejaplikacji,abyinneprogramy
ipakietymogłyłatwoitrafnieokreślać,którawersjapakietujestpotrzebna.
PEP440deniujenastępującąpostaćwyrażeniaregularnegodonume-
rowaniawersji:
N[.N]+[{a|b|c|rc}N][.postN][.devN]
Towyrażenieobsługujestandardowenumerowanie,takiejak
1.2
czy
1.2.3
.Wartozwrócićuwagęnakilkaszczegółów:
Wersja
1.2
toodpowiednik
1.2.0
,a
1.3.4
toodpowiednik
1.3.4.0
,itd.
Wersjepasującedowyrażenia
N[.N]+
stanowiąwydaniaostateczne.
Wersjeopartenadacie,takiejak
2013.06.22
,sąuznawanezanieprawi-
dłowe.Automatycznenarzędzia,zaprojektowanezmyśląowykrywaniu
numerówwersjiwformaciePEP440,zgłoszą(bądźpowinnyzgłosić)
błąd,jeśliwykryjąnumerwersjiwiększylubrówny
1980
.
Ostatniskładnikmożerównieżmiećnastępującyformat:
N[.N]+aN
(np.
1.2a1
)oznaczawydaniealfa,czyliwersję,któramoże
niebyćstabilnalubmożeniezawieraćpewnychfunkcji.
N[.N]+bN
(np.
2.3.1b2
)oznaczawydaniebeta,czyliwersję,któramoże
oferowaćwszystkiefunkcje,alerównieżzawieraćpewnebłędy.
N[.N]+cN
lub
N[.N]+rcN
(np.
0.4rc1
)oznaczakandydatadowydania,
czyliwersję,któramożezostaćwydanajakoproduktostateczny,oile
nieujawniąsięjakieśistotneproblemy.Przedrostki
rc
oraz
c
mająto
samoznaczenie,alejeśliwystępująoboksiebie,wydania
rc
uznawane
sązanowszeniżwydania
c
.
Rozpoczynanieprojektu
5