دستاویزاتپہلے اقدامات
تنصیب
تقاضے
| ضرورت | کیوں |
|---|---|
| Python 3.12+ | requires-python میں pyproject.toml؛ سی کمپائلر کی ضرورت نہیں، ونڈوز بھی شامل ہے۔ |
| uv | پروجیکٹ بناتا ہے، اس کے پیکجز انسٹال کرتا ہے اور Nexy چلاتا ہے۔ |
| Node.js 18+ | صرف کلائنٹ فریم ورک کے لیے (React، Vue، Svelte، Solid، Preact) |
کلائنٹ فریم ورک کے بغیر کسی پروجیکٹ کو Node.js کی ضرورت ہی نہیں ہے۔
پہلے uv انسٹال کریں۔
uvx کوئی الگ ٹول نہیں ہے: یہ uv کے ساتھ آتا ہے، لہذا کسی بھی چیز سے پہلے uv کو انسٹال کریں۔
# macOS and Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh # Windows (PowerShell)powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"اسے uv --version اور uvx --version سے چیک کریں۔
ایک پروجیکٹ بنائیں
uvx nexy new my-appuvx Nexy کو عارضی ماحول میں چلاتا ہے اور پیچھے کچھ نہیں چھوڑتا ہے۔ اتنا ہی کافی ہے۔ بنائیں ایک پروجیکٹ (new، init) اور کچھ نہیں: عارضی ماحول Nexy رکھتا ہے اور کوئی دوسرا پیکج نہیں۔ nexy new پروجیکٹ کا اپنا ورچوئل ماحول بناتا ہے، .venv، اور وہاں اپنے پیکجز انسٹال کرتا ہے۔
nexy new my-app چار سوالات پوچھتا ہے: راؤٹر (فائل پر مبنی یا ماڈیولر)، پروجیکٹ کی قسم (ویب یا API)، کلائنٹ فریم ورک، ORM۔ Python اور نوڈ انحصار کی تنصیب پھر ایک لائن فی قدم اور اس کی مدت کے ساتھ چلتی ہے۔ دیکھیں CLI۔
رجسٹرڈ ٹیمپلیٹ کے ساتھ پرامپٹس کو چھوڑیں:
uvx nexy new my-app --template <name>پروجیکٹ کے ورچوئل ماحول کے اندر کام کریں۔
ہر دوسری کمانڈ (nexy dev، nexy build، nexy migrate...) کو پروجیکٹ کے ورچوئل ماحول کے اندر چلنا چاہیے۔ یہ وہ جگہ ہے جہاں آپ کے اپنے پیکیج رہتے ہیں: آپ کا ORM، آپ کی لائبریریاں، اور Nexy جس کے ساتھ پروجیکٹ بنایا گیا تھا۔ اس کے باہر، ایک پروجیکٹ جس کی ضرورت ہے sqlmodel ModuleNotFoundError: No module named 'sqlmodel' کے ساتھ ناکام ہوجاتی ہے۔
پروجیکٹ فولڈر سے فی ٹرمینل ایک بار اسے چالو کریں:
| شیل | حکم |
|---|---|
| پاور شیل، سی ایم ڈی (ونڈوز) | .venv\Scripts\activate |
| میکوس، لینکس | source .venv/bin/activate |
اس کے بعد پرامپٹ (.venv) سے شروع ہوتا ہے۔ وہاں سے:
cd my-app.venv\Scripts\activate # Windows; on macOS and Linux: source .venv/bin/activatenexy devکھولیں http://localhost:3000۔
ایکٹیویشن کو چھوڑنے کے لیے، اسے uv کو ایک کمانڈ کے لیے کرنے دیں: uv run nexy dev۔
Nexy کو موجودہ پروجیکٹ میں شامل کریں۔
اسے پروجیکٹ کے ورچوئل ماحول سے چلائیں، اس کے پیکجوں میں Nexy کے ساتھ (uv add nexy):
nexy init