د Python ویل له شبکې بهر جوړ کړئ او دننه خپور یې کړئ

تاسو دمخه د جوړولو یوه دنده لرئ چې ویل تولیدوي، او یو شخصي زېرمه چې باید ترلاسه یې کړي. تېروتنه دا ده چې یوه بله دنده له یوې څانګې څخه بیا جوړه کړي او پایله یې هماغه خپرونه ونوموي. هغه فایل انتقال کړئ چې ازمویل شوی، د ډایجسټ په نوم یې ونوموئ، او د پورته کولو اعتبارنامه دننه وساتئ. لاندې لارښود یو اثر له عامه CI چلونکي څخه داخلي خپرونکي ته تعقیبوي.

هلته جوړ کړئ چې سرچینه دمخه پکې ده

جوړونه په هغه دنده کې چل کړئ چې دمخه سرچینه، د وسایلو ټولګه او د ازموینو سیټ لري. شخصي زېرمه دې ته اړتیا نه لري چې دا دنده ورته ورسیږي. د جوړونې مخکینۍ برخه په هغه چاپېریال کې نصب کړئ چې پروژه دمخه کاروي، بیا دواړه د ویش بڼې تولید کړئ که پروژه دواړه وړاندې کوي.

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

د وتنې لارښود کوچنی او یوځل کارېدونکی وساتئ. یوازینی شی چې د لېږدولو ارزښت لري هغه فایلونه دي چې بله دنده به یې خپروي، او د هغوی هشونه. نور هر څه، په شمول مجازي چاپېریالونو او کیشونو، د ثبت شوې سرچینې بیاکتنې څخه بیا جوړېدای شي. وړوکی اثر بیاکتنه هم اسانه کوي، ځکه چې هر فایل پکې داسې فایل دی چې یو څوک یې کتلی شي.

ثبت کړئ چې څه یې تولید کړل: د بستې نوم او نسخه له فایل نومونو څخه، د سرچینې بیاکتنه، او هغه workflow چې هغوی یې جوړ کړل. یوازې د نسخې تار فایل نه پېژني، ځکه چې هماغه نسخه دوه ځله له بېلابېلو کمېټونو څخه جوړېدای شي. بیاکتنه د فایل نومونو ترڅنګ د اثر په تفصیل کې ولیکئ او دا ثبت د لاس ورکولو برخه وګڼئ.

بایټونه انتقال کړئ، نه د بیا جوړولو لارښوونې

دوهمه جوړونه دوهم محصول دی. وخت نښې، ګډې شوې تګلارې او د وسایلو نسخې ټولې بایټونه بدلولی شي، نو بیا جوړونه خپل د ازموینې شواهد او خپله بیاکتنه غواړي. پرځای یې بیاکتل شوي فایلونه وړاندې کړئ.

د ویش فایلونه هغه اثر زېرمه ته پورته کړئ چې ستاسو د CI پلیټ فارم برابروي، او داخلي دندې ته د هماغه ځانګړي اثر حواله ورکړئ، نه د څانګې نوم.

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

که ستاسو پلیټ فارم لاسلیک شوی اصل ملاتړ کوي، له هغه وغواړئ چې اثر تصدیق کړي او وروسته تمه شوې زېرمه، workflow او د سرچینې بیاکتنه تایید کړي. د GitHub د تصدیق لیکنه د دې بڼې ادعاوې بیانوي. سم لاسلیک د اصل شاهد دی، نه د زیانمنتیا سکن او نه د اجازې پرېکړه.

د پورته کولو دمخه دننه تایید کړئ

داخلي دنده په دې پیل کیږي چې وګوري هغه فایل چې ترلاسه شوی هماغه فایل دی چې تصویب شوی. ډایجسټونه د جوړونې دندې له ثبت سره پرتله کړئ، نه له هغه ارزښت سره چې د راغلي شي څخه بیا محاسبه شوی.

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

بیا میټاډاټا ولولئ. د بستې نوم، نسخه او اعلان شوې تګلارې باید هغه بیاکتنې سره سمون ولري چې تاسو تصویب کړې. هغه ویل چې نوم یې سم ښکاري خو د تګلارو پینونه یې بدل شوي، بېله بسته ده چې هماغه نښه لري. که میټاډاټا بدله شوې، اثر ناتصویب شوی وګڼئ او ومومئ چې کومې جوړونې تولید کړ.

که ډایجسټونه سره سمون نه لري، ودرېږئ. پورته یې مه کوئ او فایل مه په خپل ځای کې بیا جوړولو سره سمومئ؛ دا هغه شاهد له منځه وړي چې په لار کې یو څه بدل شوي. ناسمون د دې معنا ده چې اثر زېرمه، د ډاونلوډ ګام یا ثبت غلط دی، او هر یو یې د خپرونې دمخه توضیح غواړي.

د تکراري نسخې ځواب سره مخ شئ

شخصي زېرمې معمولا له موجودې نسخې څخه د بیا لیکلو انکار کوي، او دا انکار یوه ځانګړنه ده. کله چې پورته کول په دې ناکام شي چې نسخه شتون لري، د هماغې نسخې لپاره د زېرمې ثبت وګورئ او هغه فایلونه چې لري یې د هغو ډایجسټونو سره پرتله کړئ چې تاسو یې د خپرولو اراده لرله.

موجوده نسخه کېدای شي معنا دا وي چې پخوانی پورته کول بریالي شول او ځواب ورک شو، یا چې یو چا د هماغه شمېر لاندې بېل مینځپانګه خپره کړه.

نسخه مه ړنګوئ او د تېروتنې تېرولو لپاره نوی شمېر مه جوړوئ. د خپرونې له خاوند سره پرېکړه وکړئ چې زېرمه شوې مینځپانګه منونکې ده که نه، بیا پایله ثبت کړئ. که مینځپانګه بېله وي، تاسو د نسخې ستونزه لرئ، نه د پایپ لاین ستونزه.

د پورته کولو اعتبارنامه په یوه خوا کې وساتئ

یوازې داخلي خپرونکي د زېرمې اعتبارنامې ته اړتیا لري، او یوازې د پورته کولو تر مودې پورې. ټوکن یوازې هدف زېرمې او د پورته کولو عملیاتو ته محدود کړئ، په داخلي سیستم د رازونو زېرمه کې یې وساتئ، او په بشپړ ډول له جوړونې دندې بهر یې پرېږدئ. که د جوړونې دنده خپرولی شي، نو هر څوک چې جوړونه بدلولی شي خپرولی هم شي.

دا هم محدود کړئ چې کومې داخلي workflow ګانې خپرونکی پیلولی شي. د اړین تصویب سره لاسي پیل د خپرونو لپاره مناسبه پیش فرض ده؛ هرې څانګې ته push نه ده.

بشپړه خپرونه باید درې شیان پرېږدي: د ویش فایلونه، د هغوی ډایجسټونه د سرچینې بیاکتنې سره، او یو زېرمه ثبت چې هماغه نسخه ښیي.