ساخته‌شده روی زرین: چهار بسته برای امتحان

چهار ابزار کوچک، برای هر اکوسیستم یکی، که روی زرین همان‌طور منتشر شده‌اند که شما بستهٔ خودتان را منتشر می‌کنید. کدشان در مخزن‌های زرین زیر [arvand](/arvand) است، و هر کدام با یک دستور و با همان ابزاری که دارید، از هر جایی نصب می‌شود: ابزار نصب هر فایل را با هش آن می‌سنجد. ```diagram type: cards title: چهار بسته، چهار اکوسیستم --- 🐍 | بستهٔ tinyhash · پایتون | اثرانگشت‌های کوتاه و پایدار برای فایل‌ها و پوشه‌ها: چیزی عوض شده؟ این همان فایل درست است؟ 📦 | بستهٔ @arvand/envguard · npm | فایل ‎.env شما در برابر ‎.env.example: کلیدهای جاافتاده، مقدارهای خالی، رازهایی که به نمونه نشت کرده‌اند 🦀 | بستهٔ portcheck · Rust | این پورت آزاد است؟ آن یکی در دسترس است؟ و صبر تا در دسترس شود ⚡ | بستهٔ humanize · Zig | بایت‌ها، مدت‌ها، شمارش‌ها و «چند وقت پیش» به شکلی که آدم‌ها می‌خوانند، بدون allocator ``` ## امتحانشان کنید ```bash # tinyhash (Python) pip install --index-url https://api.zaryn.xyz/v1/packages/pypi/all/simple/ tinyhash tinyhash --tree data/ # @arvand/envguard (npm) npx --@arvand:registry=https://api.zaryn.xyz/v1/packages/npm/ @arvand/envguard npx @arvand/envguard --ci # portcheck (Rust) cargo install --index sparse+https://api.zaryn.xyz/v1/packages/cargo/index/ portcheck portcheck --wait db:5432 # humanize (Zig) zig fetch --save https://api.zaryn.xyz/v1/packages/zig/humanize/humanize-0.1.0.tar.gz ``` صفحهٔ هر بسته: [tinyhash](/packages/pypi/tinyhash) · [envguard](/packages/npm/@arvand/envguard) · [portcheck](/packages/cargo/portcheck) · [humanize](/packages/zig/humanize) همین دستورها در [صفحهٔ بسته‌ها](/packages#made-on-zaryn) با دکمهٔ کپی هم هستند. ```diagram type: flow title: راهی که هر کدام رفت --- کد | یک مخزن زرین: zev init، zev commit، zev push | accent | 📁 ~ آزمون‌ها می‌گذرند ساخت | دستورهای python -m build، npm pack، cargo package، یک tarball برای zig | | 🔨 ~ یک توکن فقط برای انتشار انتشار | دستورهای twine upload، npm publish، cargo publish، بارگذاری بایگانی zig، به رجیستری زرین | good | 🚀 ~ هر کسی، از هر جایی نصب | ابزارهای pip، npx، cargo، zig fetch: هر فایل با هشش سنجیده می‌شود | good | ✅ ``` ## بستهٔ tinyhash (پایتون) اثرانگشت‌های کوتاه BLAKE2b، در base32، برای فایل‌ها و پوشه‌ها. ```console $ pip install --index-url https://api.zaryn.xyz/v1/packages/pypi/all/simple/ tinyhash $ tinyhash --tree src/ uwulb2m4sffp tinyhash/__init__.py zmciwvuja5wy tinyhash/cli.py xubdz6t3q7rt src/ (4 files) $ tinyhash --check kxppivxcxam2 data/ ✓ data/ matches kxppivxcxam2 $ tinyhash --diff old/ new/ + extra.txt - notes.md ~ core.py 1 added, 1 removed, 1 changed ``` نمایهٔ بالا نمایهٔ یکتای زرین است: پروژه‌های زرین، و بقیه از pypi.org، پس وابستگی‌های دیگر هم مثل همیشه نصب می‌شوند. `uv tool install --index … tinyhash` هم کار می‌کند. چطور ساخته شد: فقط کتابخانهٔ استاندارد، پایتون ۳٫۹ به بعد، ۱۶ آزمون pytest، ساخته با `python -m build` و منتشر با `twine upload` و یک توکن فقط برای انتشار. همهٔ گام‌ها: [نخستین بستهٔ پایتون خود را در ۵ دقیقه منتشر کنید](/docs/fa/publish-python-package). ## بستهٔ @arvand/envguard (npm) ```bash npx --@arvand:registry=https://api.zaryn.xyz/v1/packages/npm/ @arvand/envguard ``` برای یک پروژه، یک بار در `.npmrc` به npm بگویید `@arvand` از کجا می‌آید: ```ini @arvand:registry=https://api.zaryn.xyz/v1/packages/npm/ ``` ```bash npm install --save-dev @arvand/envguard ``` | دستور | چه می‌کند | |---|---| | `envguard` | مقایسهٔ `.env` با `.env.example` | | `envguard init` | نوشتن `.env.example` از `.env` شما، فقط کلیدها، امن برای کامیت | | `envguard --ci` | بررسی محیط واقعی (رازهای CI) به جای یک فایل | | `envguard --strict` | شکست برای مقدارهای خالی و کلیدهایی که در نمونه نیستند هم | | `envguard --json` | نتیجه به شکل JSON | نام دامنه‌دار (`@arvand/…`) را فقط صاحبش می‌تواند منتشر کند، پس کسی نمی‌تواند بسته‌ای هم‌نام را جلویش بگذارد. چطور ساخته شد: بی وابستگی، ماژول‌های ES، Node 18 به بعد، ۱۷ آزمون `node:test`، `npm publish` به زرین. همهٔ گام‌ها: [npm روی زرین](/docs/fa/packages-npm). ## بستهٔ portcheck (Rust) ```bash cargo install --index sparse+https://api.zaryn.xyz/v1/packages/cargo/index/ portcheck ``` | دستور | چه می‌کند | |---|---| | `portcheck 8080` | پورت 8080 روی این رایانه آزاد است؟ | | `portcheck host:port` | این رایانه به آن می‌رسد، و با چه سرعتی؟ | | `portcheck https://example.com` | نشانی‌ها هم کار می‌کنند: پورت از طرح نشانی می‌آید | | `portcheck --free 3000-3100` | نخستین پورت آزاد در یک بازه | | `portcheck --wait db:5432` | صبر تا جواب دهد (`--timeout 2m`) | ```bash PORT=$(portcheck --free 3000-3100) npm run dev portcheck --wait --timeout 2m postgres://db:5432 && ./migrate ``` چطور ساخته شد: فقط کتابخانهٔ استاندارد، ۹ آزمون، بی هشدار در `cargo clippy`، `cargo publish --registry zaryn`. برای یک پروژه، یک بار زرین را به `~/.cargo/config.toml` بیفزایید و `--registry zaryn` را به کار ببرید: [crateهای Rust روی زرین](/docs/fa/packages-rust). ## بستهٔ humanize (Zig) ```bash zig fetch --save https://api.zaryn.xyz/v1/packages/zig/humanize/humanize-0.1.0.tar.gz ``` ```zig // build.zig const humanize = b.dependency("humanize", .{}); exe.root_module.addImport("humanize", humanize.module("humanize")); ``` ```zig var buf: [32]u8 = undefined; const size = try humanize.bytes(&buf, 1_572_864, .{}); // "1.5 MiB" const took = try humanize.duration(&buf, 9045, .{}); // "2h 30m" ``` | تابع | چه می‌دهد | |---|---| | `bytes`، `parseBytes` | `1.5 MiB`، و برگرداندن `"10MB"` به بایت | | `duration`، `elapsed`، `parseDuration` | `2h 30m`، `1.3 µs`، و برگرداندن `"1h30m"` به نانوثانیه | | `count`، `compact` | `1,234,567`، `3.4M` | | `ago`، `ordinal`، `plural` | `3 minutes ago`، `21st`، `file`/`files` | چطور ساخته شد: بی allocator (در بافر شما می‌نویسد)، آزموده روی Zig 0.15 و 0.17، منتشر به شکل بایگانی‌ای که `zig fetch` هشش را می‌سنجد. همهٔ گام‌ها: [بسته‌های Zig روی زرین](/docs/fa/packages-zig). ## بستهٔ خودتان را بسازید ```diagram type: cards title: انتشار بستهٔ خودتان، برای هر اکوسیستم --- 🐍 | پایتون | دستورهای python -m build و twine upload به زرین: نخستین بستهٔ پایتون خود را منتشر کنید 📦 | بستهٔ npm | دستور npm publish با نامی دامنه‌دار که مال شماست: npm روی زرین 🦀 | زبان Rust | دستور cargo publish --registry zaryn: crateهای Rust روی زرین ⚡ | زبان Zig | یک tarball که zig fetch آن را می‌سنجد: بسته‌های Zig روی زرین ``` یک توکن انتشار در [صفحهٔ بسته‌ها](/packages) بسازید (فقط می‌تواند منتشر کند). نام‌ها مال کسی است که زودتر بیاید. بسته‌های عمومی در همهٔ طرح‌ها رایگان‌اند.