Pylerno
سۆرانی

بڵاوکردنەوە و بەردەوامیی پشتیوانیی پاکێج

وەشانێکی ئامادەی بڵاوکردنەوەی TaskFlow لە ئامێرەکەت دروست بکە. دەقی یارمەتیی فەرمانێک باشتر دەکەیت، وەشانەکە بە 1.0.1 دیاری دەکەیت، wheel دروست دەکەیت و دڵنیادەبیتەوە کە ئەرکی پاشەکەوتکراوی بەکارهێنەرێکی پێشوو هێشتا کار دەکات. لە کۆتاییدا فایلێکی تاقیکراوەت هەیە کە دەتوانیت بڕیار بدەیت بڵاوی بکەیتەوە.

لەم پەڕەیەدا

گۆڕانکارییەکە بە وردی دیاری بکە

لە کۆپییەکی ڕاهێنانی app/taskflow/cli.py بەشی شیکەرەوەی فەرمانی add بدۆزەرەوە. هێڵی ئارگومێنتەکە بگۆڕە بۆ add.add_argument("title", help="Task title to add"). ئەمە دەرئەنجامی add --help دەگۆڕێت. ڕەفتاری چاوەڕوانکراو لە تاقیکردنەوەیەکدا تۆمار بکە تا ئەو کەسەی دواتر پشتیوانیی پاکێجەکە دەکات بزانێت بۆچی ئەو دەقە زیاد کراوە.

ئەم تاقیکردنەوەیە بۆ فایلی tests/test_cli.pyی پڕۆژەکە زیاد بکە. فەنکشنی run_cli پێشتر لە هەمان فایلدا پێناسە کراوە.

python
def test_add_help_describes_title(tmp_path):
    data = tmp_path / "tasks.json"
    result = run_cli(data, "add", "--help")
    assert result.returncode == 0
    assert "Task title to add" in result.stdout
    assert not data.exists()

بەهای version لە pyproject.toml و __version__ لە taskflow/__init__.py بگۆڕە بۆ 1.0.1. هەموو تاقیکردنەوەکان جێبەجێ بکە. لە تێبینیی وەشانەکەدا ئەو گۆڕانکارییە بنووسە کە بەکارهێنەر دەیبینێت، وەشانی پایتۆنی پشتگیریکراو و کاریگەریی لەسەر فایلە کۆنەکانیش دیاری بکە. لەم وەشانەدا شێوەی داتای هەڵگیراو هەر وەشانی 1 دەمێنێتەوە.

وەشانە ئامادەکراوەکە دروست بکە و دایبمەزرێنە

لە بوخچەی appی کۆپیی ڕاهێنان، بەو ژینگەی دروستکردنەی پێشتر ئامادەت کرد فەرمانەکانی خوارەوە جێبەجێ بکە. لە ویندۆز فایلی پایتۆنی هەمان ژینگە لە ناو Scripts بەکار بهێنە. هەمان wheel ـی نوێ لە ژینگەیەکی تازە دابمەزرێنە، تا دامەزراندنێکی پێشوو فایلی ونبوو نەشارێتەوە.

sh
.build-env/bin/python -m pytest -q tests
.build-env/bin/python -m build --wheel --outdir candidate
python3 -m venv .release-env
.release-env/bin/python -m pip install candidate/taskflow_learning-1.0.1-py3-none-any.whl

فایلێکی وەشانی پێشوو تاقی بکەوە

ئەم سکریپتە بە ناوی verify_release.py پاشەکەوت بکە. لە app بە .release-env/bin/python -I verify_release.py جێبەجێی بکە. هەڵبژاردەی -I وەرگێڕەکە لە بوخچەی سکریپتەکە جیا دەکاتەوە تا کۆپیی گەشەپێدان هاوردە نەکات. بوخچە کاتییەکە داتایەکی ئامادەی وەشانی یەکی تێدایە. بە ئەنقەست ناسنامەی داهاتوو دوورترە لە دوا ناسنامەی هەڵگیراو.

python
from importlib.metadata import version
import json
from pathlib import Path
import subprocess
import sys
from tempfile import TemporaryDirectory

import taskflow

assert version("taskflow-learning") == taskflow.__version__ == "1.0.1"
with TemporaryDirectory() as folder:
    path = Path(folder) / "saved.json"
    existing = {"id": 4, "title": "From version 1.0.0", "done": True}
    path.write_text(json.dumps({
        "schema_version": 1, "next_id": 8, "tasks": [existing]
    }), encoding="utf-8")
    base = [sys.executable, "-I", "-m", "taskflow", "--data", str(path)]
    subprocess.run(base + ["add", "New task"], check=True, cwd=folder)
    saved = json.loads(path.read_text(encoding="utf-8"))
    assert saved["tasks"] == [existing, {"id": 8, "title": "New task", "done": False}]
    assert saved["next_id"] == 9
print("Release candidate passed")

دەبێت سەرەتا Added task 8. و دواتر Release candidate passed چاپ بکرێت. تاقیکردنەوەکە نیشان دەدات کە بەرنامە داتای پێشوو دەخوێنێتەوە، لە نووسینەوەدا ناوەڕۆکەکە دەپارێزێت و ناسنامە نوێیەکان لە بەهای ژمێرەری پاشەکەوتکراوەوە بەردەوام دەبن.

تۆماری پشتیوانیی وەشانەکە بپارێزە

ناسنامەی گۆڕانکاریی سەرچاوە، ناوی فایلی wheel، ئەنجامی تاقیکردنەوەکان و ڕێگایەک بۆ ناسینەوەی وەشانی دامەزراو تۆمار بکە. پەنجەمۆری SHA-256 ڕێگە بە هاوکارێکت دەدات کۆپیی خۆی بەو wheel ـە بەراورد بکات کە تاقی کراوەتەوە. پەنجەمۆرەکە بۆ هەمان فایلی تاقیکراوە حساب بکە. دووبارە دروستکردنەوە لە هەمان سەرچاوە دەکرێت بایتەکانی ئەرشیفەکە بگۆڕێت.

sh
python -m zipfile -l candidate/taskflow_learning-1.0.1-py3-none-any.whl
python -c "from pathlib import Path; import hashlib; p = Path('candidate/taskflow_learning-1.0.1-py3-none-any.whl'); print(hashlib.sha256(p.read_bytes()).hexdigest())"

بۆ ڕاهێنان وەشانی شێوەی داتای نموونەکە بکە بە 99. چاوەڕێی کۆدێکی دەرچوونی جیاواز لە سفر بە، و بایتەکانی فایلەکە پێش و دوای فەرمانەکە بەراورد بکە. ئینجا لە تێبینیی وەشانەکەدا دەتوانیت بە وردی بنووسیت کە بەرنامە لە بەرامبەر فۆرماتێکی پشتگیرینەکراو چ ڕەفتارێک دەکات.

خۆت تاقی بکەرەوە

کام نموونە گونجانی خوێنەری نوێ لەگەڵ داتای کۆن دەپشکنێت؟

یەک وەڵام هەڵبژێرە

گەڕان لە وانەکان

ئەم پەڕەیە هاوبەش بکە