Tóg wheel Python lasmuigh den líonra agus foilsigh istigh é

Tá post tógála agat cheana a tháirgeann wheel, agus stór príobháideach ar cheart dó é a fháil. Is é an botún ligean do dhara post atógáil ó bhrainse agus an toradh a thabhairt mar an eisiúint chéanna. Bog an comhad a tástáladh, ainmnigh de réir an achoimre é, agus coinnigh an creidiúnaí uaslódála istigh. Leanann an siúlóid thíos aon déantán ó rithneoir CI poiblí go foilsitheoir inmheánach.

Tóg san áit a bhfuil an fhoinse cheana

Rith an tógáil sa phost a bhfuil an fhoinse, an tslabhra uirlisí agus an tsraith tástála aige cheana. Ní éilíonn aon rud faoi stór príobháideach go sroichfeadh an post sin é. Suiteáil frontend na tógála sa timpeallacht a úsáideann an tionscadal cheana, ansin táirg an dá fhormáid dáilte má sheachadann an tionscadal an dá cheann.

python -m build --sdist --wheel --outdir dist
python -m twine check dist/*

Coinnigh an chomhadlann aschuir beag agus indiúscartha. Is iad na comhaid a fhoilseoidh an chéad phost eile, mar aon lena n-achoimrí, na rudaí amháin ar fiú iad a iompar ar aghaidh. Is féidir gach rud eile, lena n-áirítear timpeallachtaí fíorúla agus taisce, a atógáil ón leasú foinse a taifeadadh. Tá déantán caol níos éasca le hathbhreithniú freisin, mar is comhad é gach comhad ann ar féidir le duine é a iniúchadh.

Taifead cad a tháirg iad: ainm agus leagan an phacáiste ó ainmneacha na gcomhad, leasú na foinse, agus rith an tsreafa oibre a chruthaigh iad. Ní aithníonn teaghrán leagain amháin comhad, mar is féidir an leagan céanna a thógáil faoi dhó ó choimiteanna éagsúla. Scríobh an leasú in aice ainmneacha na gcomhad i dtuairisc an déantáin, agus caith leis an taifead sin mar chuid den aistriú.

Bog bearta, ní treoracha chun atógála

Is táirge eile é dara tógáil. Is féidir le stampaí ama, spleáchais atá cuachta agus leaganacha uirlisí na bearta a athrú ar fad, mar sin teastaíonn a fhianaise tástála féin agus a athbhreithniú féin ó atógáil. Cothaigh na comhaid a athbhreithníodh ina ionad sin.

Uaslódáil na comhaid dáilte chuig an stór déantán a sholáthraíonn do phlatfhoirm CI, agus tabhair tagairt don phost inmheánach don déantán sin go sonrach seach ainm brainse.

sha256sum dist/*.whl dist/*.tar.gz
# keep the digests beside the run id in the artifact description

Má thacaíonn do phlatfhoirm le bunús sínithe, iarr uirthi an déantán a dheimhniú agus an stór, an sreafa oibre agus leasú na foinse a bhfuiltear ag súil leo a fhíorú níos déanaí. Cuireann doiciméadú deimhniúcháin GitHub síos ar éilimh den fhoirm sin. Is fianaise bhunúis í síniú bailí, ní scanadh leochaileachta é agus ní cinneadh údaraithe é.

Fíoraigh istigh sula n-uaslódálann tú

Tosaíonn an post inmheánach trí sheiceáil gurb é an comhad a fuarthas an comhad a ceadaíodh. Cuir na hachoimrí i gcomparáid leis an taifead ón bpost tógála, ní le luach a athríomhadh ó cibé a tháinig.

sha256sum -c digests.txt
python -m twine check dist/*

Ansin léigh na meiteashonraí. Ba cheart ainm an phacáiste, an leagan agus na spleáchais a dearbhaíodh a bheith ag teacht leis an athbhreithniú a cheadaigh tú. Is pacáiste eile é wheel a bhfuil a ainm ceart le feiceáil ach a bhfuil a phionnaí spleáchais athraithe, agus an lipéad céanna air. Má bhog na meiteashonraí, caith leis an déantán mar rud neamhcheadaithe agus faigh amach cé acu tógáil a tháirg é.

Mura n-oireann na hachoimrí, stad. Ná huaplódáil, agus ná deisigh an comhad trína atógáil ina áit; scriosann sé sin an fhianaise gur athraigh rud éigin ar an mbealach. Ciallaíonn neamhréir go bhfuil an stór déantán, an chéim íoslódála nó an taifead mícheart, agus tá mínithe tuillte ag gach ceann acu sula bhfoilseofar eisiúint.

Déileáil le freagra an leagain dhúbailte

De ghnáth diúltaíonn stóir phríobháideacha leagan atá ann cheana a fhorscríobh, agus is gné í an diúltú sin. Nuair a theipeann ar uaslódáil toisc go bhfuil an leagan ann, scrúdaigh taifead an stóir don leagan sin agus cuir na comhaid atá aige i gcomparáid leis na hachoimrí a bhí ar intinn agat a fhoilsiú.

Is féidir le leagan atá ann cheana a bheith ina chiall go n-éirigh le huaslódáil níos luaithe agus gur cailleadh an freagra, nó gur fhoilsigh duine éigin ábhar difriúil faoin uimhir chéanna.

Ná scrios an leagan, agus ná ceap uimhir nua chun dul thar an earráid. Socraigh le húinéir na heisiúna an bhfuil an t-ábhar stóráilte inghlactha, ansin taifead an toradh. Má tá an t-ábhar difriúil, tá fadhb leagain agat, ní fadhb píblíne.

Coinnigh an creidiúnaí uaslódála ar aon taobh amháin

Ní theastaíonn creidiúnaithe stóir ach ón bhfoilsitheoir inmheánach, agus gan ach ar feadh ré na huaslódála. Cuir teorainn leis an tokain leis an stór sprice agus le hoibríochtaí uaslódála, coinnigh i stór rún an chórais inmheánaigh é, agus fág amach as an bpost tógála é ar fad. Má tá an post tógála in ann foilsiú, ansin tá aon duine ar féidir leis an tógáil a athrú in ann foilsiú.

Cuir teorainn freisin le cé na sreafaí oibre inmheánacha a fhéadfaidh an foilsitheoir a thosú. Is réamhshocrú réasúnach d'eisiúintí é truicear láimhe le ceadú riachtanach; ní hea push chuig aon bhrainse.

Ba cheart go bhfágfadh an eisiúint chríochnaithe trí rud ina diaidh: na comhaid dáilte, a n-achoimrí mar aon le leasú na foinse, agus taifead stóir a thaispeánann an leagan céanna.