44
55``` bash
66# Setup (uses existing or downloads portable Python)
7- ./setup-portable .sh
7+ ./setup.sh
88
99# Clean rebuild (removes everything, starts fresh)
10- ./setup-portable.sh --force-clean
10+ ./setupsh --force-clean
1111
1212# Show help
13- ./setup-portable.sh --help
14-
15- # Create distributable package
16- ./package-portable.sh
13+ ./setup.sh --help
1714```
1815
1916## 📊 Quick Decision Guide
@@ -25,9 +22,6 @@ First time?
2522Something broken?
2623└─ ./setup-portable.sh --force-clean
2724
28- Ready to distribute?
29- └─ ./package-portable.sh
30-
3125Changed dependencies?
3226├─ Edit pyproject.toml
3327└─ uv lock && uv sync
@@ -41,7 +35,6 @@ Changed dependencies?
4135| ** Daily development** | ` source .venv/bin/activate ` → ` python src/main.py ` |
4236| ** Add dependency** | Edit ` pyproject.toml ` → ` uv lock ` → ` uv sync ` |
4337| ** Fix issues** | ` ./setup-portable.sh --force-clean ` |
44- | ** Create package** | ` ./package-portable.sh ` |
4538| ** Complete reset** | ` ./setup-portable.sh --force-clean ` |
4639
4740## 📁 What Gets Created
@@ -68,7 +61,6 @@ dist/ # Packages (~50MB compressed, gitignored)
6861| First setup (download) | 1-2 min | Required |
6962| Reuse existing Python | 10-30 sec | Optional |
7063| Clean rebuild | 1-2 min | Required |
71- | Package creation | 10-20 sec | No |
7264
7365## 💾 Disk Space
7466
@@ -105,21 +97,6 @@ source .venv/bin/activate && pip install --upgrade uv
10597uv lock && uv sync
10698```
10799
108- ## 📦 Package Distribution
109-
110- ``` bash
111- # 1. Create package
112- ./package-portable.sh
113-
114- # 2. Send to user
115- scp dist/my-app-1.0.0-portable.tar.gz user@server:
116-
117- # 3. User extracts and runs
118- tar -xzf my-app-1.0.0-portable.tar.gz
119- cd my-app-1.0.0-portable
120- ./run.sh
121- ```
122-
123100## 🎯 Key Principles
124101
1251021 . ** Always portable** - Never uses system Python
0 commit comments