devit-cli 0.1.0__py3-none-any.whl

_devkit_entry.py

@@ -0,0 +1,59 @@
+"""
+Thin bootstrap entry point for devit-cli.
+
+Lives at the top level of site-packages so it is importable even when
+devkit_cli itself is not installed in the active environment.  Defers the
+import of devkit_cli into a function body so an ImportError can be caught
+and turned into a human-readable message before Python prints a traceback.
+"""
+
+import sys
+
+# Enable ANSI colour codes on Windows.
+# colorama is a transitive dependency of click on Windows, so it is
+# almost always present whenever devkit.exe itself exists.
+if sys.platform == "win32":
+    try:
+        import colorama
+        colorama.init()
+    except ImportError:
+        pass  # Win10+ Terminal supports ANSI natively; older CMD will show plain text
+
+
+def main() -> None:
+    try:
+        from devkit_cli.main import cli  # deferred — lets us catch install issues
+    except ModuleNotFoundError as exc:
+        _friendly_not_installed(exc)
+        return  # unreachable — _friendly_not_installed calls sys.exit
+
+    cli()  # outside the try so Click's own SystemExit propagates normally
+
+
+def _friendly_not_installed(exc: ModuleNotFoundError) -> None:  # noqa: ANN001
+    R   = "\033[91m"   # red
+    B   = "\033[1m"    # bold
+    Y   = "\033[93m"   # yellow
+    RST = "\033[0m"    # reset
+
+    print(
+        f"\n{R}Error:{RST} devit-cli is not installed in the active Python environment.\n"
+        f"\n{B}Fix:{RST}   pip install devit-cli\n"
+        f"\n{Y}Active Python:{RST} {sys.executable}\n"
+        f"{Y}Active env:{RST}    "
+        + _env_name()
+        + f"\n\n{B}Details:{RST} {exc}",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
+
+def _env_name() -> str:
+    """Return a short human-readable name for the active environment."""
+    import os
+    from pathlib import Path
+
+    prefix = os.environ.get("CONDA_DEFAULT_ENV") or os.environ.get("VIRTUAL_ENV")
+    if prefix:
+        return Path(prefix).name
+    return Path(sys.executable).parent.parent.name

devit_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,273 @@
+Metadata-Version: 2.4
+Name: devit-cli
+Version: 0.1.0
+Summary: A full-featured CLI framework for professional Python developers
+License: MIT
+Project-URL: Homepage, https://github.com/dipenpadhiyar/devit-cli
+Project-URL: Issues, https://github.com/dipenpadhiyar/devit-cli/issues
+Keywords: cli,developer-tools,scaffold,devkit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: psutil>=5.9
+Requires-Dist: questionary>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-click>=1.1; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/dipenpadhiyar/devit-cli/main/assets/devkit.png" alt="devit-cli" width="300"/>
+</p>
+
+<p align="center">
+  <b>A full-featured CLI toolkit for professional Python developers.</b><br/>
+  Scaffold projects &nbsp;·&nbsp; Clean builds &nbsp;·&nbsp; Inspect system &nbsp;·&nbsp; Search files &nbsp;·&nbsp; Manage archives &amp; env vars
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/devit-cli/"><img src="https://img.shields.io/pypi/v/devit-cli.svg" alt="PyPI version"/></a>
+  <a href="https://pypistats.org/packages/devit-cli"><img src="https://img.shields.io/pypi/dm/devit-cli.svg?label=PyPI%20downloads" alt="Monthly downloads"/></a>
+  <a href="https://pypi.org/project/devit-cli/"><img src="https://img.shields.io/pypi/pyversions/devit-cli.svg" alt="Python versions"/></a>
+  <a href="https://pypi.org/project/devit-cli/"><img src="https://img.shields.io/pypi/l/devit-cli.svg" alt="License"/></a>
+</p>
+
+<p align="center">
+  <a href="https://pepy.tech/project/devit-cli"><img src="https://static.pepy.tech/badge/devit-cli" alt="Total downloads"/></a>
+  <a href="https://pepy.tech/project/devit-cli"><img src="https://static.pepy.tech/badge/devit-cli/month" alt="Monthly"/></a>
+  <a href="https://pepy.tech/project/devit-cli"><img src="https://static.pepy.tech/badge/devit-cli/week" alt="Weekly"/></a>
+</p>
+
+---
+
+## Installation
+
+```bash
+pip install devit-cli
+```
+
+Requires **Python 3.10+**. Works on **Windows · Linux · macOS**.
+
+---
+
+## Quick Start
+
+```bash
+devkit           # show help + logo
+devkit init      # interactive project wizard
+devkit info      # system snapshot
+devkit clean     # remove caches & build artifacts
+devkit dev       # start dev server / install in dev mode
+devkit test      # run tests (auto-detects pytest / django)
+```
+
+---
+
+## Commands
+
+### `devkit init` — Project wizard
+
+Interactively scaffold a new project. Asks for:
+
+| Question | Options |
+|---|---|
+| Project type | Python Package · FastAPI · Django · AWS Scripts |
+| Environment  | New venv · Existing Python interpreter · New conda · Existing conda env · Skip |
+| Python version | e.g. `3.11` |
+
+```bash
+devkit init                          # fully interactive
+devkit init my-api --type fastapi --env venv
+devkit init my-lib --type package --env conda --python 3.12
+devkit init my-app -y                # skip confirmation prompt
+```
+
+#### Generated structures
+
+**Python Package**
+```
+my-lib/
+├── my_lib/
+│   ├── __init__.py
+│   └── core.py
+├── tests/
+│   └── test_core.py
+├── docs/
+├── pyproject.toml
+├── README.md
+└── .gitignore
+```
+
+**FastAPI**
+```
+my-api/
+├── main.py
+├── app/
+│   └── routers/
+│       └── health.py
+├── tests/
+│   └── test_api.py
+├── requirements.txt
+├── README.md
+└── .gitignore
+```
+
+**Django**
+```
+my-site/
+├── manage.py
+├── my_site/
+│   ├── settings.py
+│   ├── urls.py
+│   └── wsgi.py
+├── apps/
+│   └── core/
+│       ├── views.py
+│       └── urls.py
+├── requirements.txt
+└── .gitignore
+```
+
+**AWS Scripts**
+```
+my-aws/
+├── scripts/
+│   ├── main.py
+│   ├── s3.py
+│   └── ec2.py
+├── tests/
+├── requirements.txt
+└── .gitignore
+```
+
+---
+
+### `devkit dev / run / build / test` — Unified task runner
+
+Auto-detects project type and runs the right command:
+
+| Command | Package | FastAPI | Django | AWS |
+|---|---|---|---|---|
+| `devkit dev` | `pip install -e .[dev]` | `uvicorn main:app --reload` | `manage.py runserver` | `sam local start-api` |
+| `devkit run` | `python -m <module>` | `uvicorn main:app` | `manage.py runserver 0.0.0.0` | `python -m scripts.main` |
+| `devkit build` | `python -m build` | `pip install -r requirements.txt` | `pip install -r requirements.txt` | `sam build` |
+| `devkit test` | `pytest -v` | `pytest -v` | `manage.py test` | `pytest -v` |
+
+```bash
+devkit dev
+devkit test
+devkit build
+devkit run -- --port 9000    # extra args forwarded
+```
+
+---
+
+### `devkit clean` — Remove artifacts
+
+```bash
+devkit clean                  # clean cwd
+devkit clean ./my-project     # clean specific dir
+devkit clean --dry-run        # preview only
+devkit clean --include-venv   # also remove .venv
+devkit clean -y               # skip confirmation
+```
+
+Removes: `__pycache__`, `*.pyc`, `.pytest_cache`, `build/`, `dist/`, `*.egg-info`, `.DS_Store`, `*.log`, `node_modules`, `.coverage`, and more.
+
+---
+
+### `devkit info` — System snapshot
+
+```bash
+devkit info
+devkit info --json
+```
+
+Shows: OS, hostname, Python version + executable, active venv/conda env, CPU count + frequency, RAM usage, disk usage.
+
+---
+
+### `devkit find` — Fast file search
+
+```bash
+devkit find "*.py"
+devkit find "config" -e toml -e ini
+devkit find "*" --min-size 1mb --newer-than 7    # >1 MB, modified in last 7 days
+devkit find --dirs-only "src"
+devkit find "*" -l 500                           # show up to 500 results
+```
+
+---
+
+### `devkit zip` / `devkit unzip` — Archive utilities
+
+```bash
+devkit zip dist.zip src/ README.md
+devkit zip dist.zip . -x __pycache__ -x "*.pyc" -l 9
+devkit unzip dist.zip ./output
+devkit unzip dist.zip --list     # show contents without extracting
+```
+
+---
+
+### `devkit env` — Environment variable management
+
+```bash
+devkit env list                        # list all env vars
+devkit env list --filter AWS           # filter by keyword
+devkit env list --json                 # JSON output
+
+devkit env export                      # save to .env  (dotenv format)
+devkit env export vars.json --format json
+devkit env export activate.sh  --format shell       # bash / zsh
+devkit env export activate.ps1 --format powershell  # Windows PowerShell
+devkit env export activate.bat --format cmd         # Windows CMD
+
+devkit env diff .env .env.production   # show what changed
+```
+
+---
+
+## Tech Stack
+
+| Library | Purpose |
+|---|---|
+| [click](https://click.palletsprojects.com) | CLI framework |
+| [rich](https://rich.readthedocs.io) | Beautiful terminal output, progress bars, tables |
+| [questionary](https://questionary.readthedocs.io) | Interactive prompts |
+| [psutil](https://github.com/giampaolo/psutil) | System metrics (CPU, RAM, disk) |
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/dipenpadhiyar/devit-cli
+cd devit-cli
+pip install -e ".[dev]"
+pytest
+```
+
+Pull requests are welcome!
+
+---
+
+## License
+
+MIT — see [LICENSE](https://github.com/dipenpadhiyar/devit-cli/blob/main/LICENSE) for details.
+
+

devit_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,52 @@
+_devkit_entry.py,sha256=gI7_Rw8p5BaT46PULrd5rpGCjBItyQ5LlwffVXUCtpE,2001
+devit_cli-0.1.0.dist-info/licenses/LICENSE,sha256=Utkevq-mBXnLgQwI9kxl8b1jKr-Z-mRDqQ01uJDejN4,1091
+devkit_cli/__init__.py,sha256=PjudVK6xjNIkF6iRD__uGdqXYDubIeN55aHk9Asgmes,138
+devkit_cli/main.py,sha256=1DJ8eQrwnmAkMTtjyiN9qQZuXrO18foRTh1wjyzRYHA,3418
+devkit_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devkit_cli/commands/archive.py,sha256=KLjmoo67u4JC43tFDt7-w5EX8-4-PFxnQFf0TeGOjMY,5969
+devkit_cli/commands/clean.py,sha256=3M4E_X_dvMB-gaiu8lFahulcUIY25iWWTPeifXsZGjA,3620
+devkit_cli/commands/env.py,sha256=T-pKgDd6LoevTGV9P3VS6loITbm9kJps8MjdadLidGg,5347
+devkit_cli/commands/find.py,sha256=4JSNyoZDASEwbwpLXmthyUxZDH3lRBKrkIHYMzloGXI,4377
+devkit_cli/commands/info.py,sha256=1W-av4SfWRUreW5L-nAdQNZaM3uVT7KYXMzn0mWx4H8,3737
+devkit_cli/commands/init.py,sha256=nJO_K1nG_mXqg8uiDVDgq8PKNBOinUlCPIK4Eertp20,18418
+devkit_cli/commands/run.py,sha256=HZ8zrzbfeltlf4bg7R0vSOZMmNhUM16GQdY3gzFT_RQ,8996
+devkit_cli/templates/aws/.gitignore,sha256=V9yZwen3aT5HHWcMxX5SUhFu4ITLOBmbun4rJjPJ_Ak,367
+devkit_cli/templates/aws/README.md,sha256=ttr7pSh4wKQ6QwyfcZvQCDn8TsdqwtRPN_hOtWm5dDg,324
+devkit_cli/templates/aws/requirements.txt,sha256=uyeWECNCrWBrNn6dgO3RI4yD2KRDyLNg_9_TCidg3Iw,29
+devkit_cli/templates/aws/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devkit_cli/templates/aws/scripts/ec2.py,sha256=sSW6wBbwr26SRoqL69aQEQXR6FvTT7Co_PjqAe_RwHA,230
+devkit_cli/templates/aws/scripts/main.py,sha256=x7JoPfusAXqnpNPbOyPwhiPrMHvPMZlN2a-9niP9dso,648
+devkit_cli/templates/aws/scripts/s3.py,sha256=keDReh8hUqGSuzT_m_WbWzpWI3q9A5snFfHW4-KU9iU,209
+devkit_cli/templates/aws/tests/test_scripts.py,sha256=SpryxcA9IUpRO3qxi-nK9Vjia1ZDAUHnW6dXZj0PntA,151
+devkit_cli/templates/django/.gitignore,sha256=V9yZwen3aT5HHWcMxX5SUhFu4ITLOBmbun4rJjPJ_Ak,367
+devkit_cli/templates/django/README.md,sha256=iec-vUguqqCrxW1PzMuWS1fSgRzi5S0tw_zRSFyo29Y,195
+devkit_cli/templates/django/manage.py,sha256=sIw_oyt1arveVPLwJkNkhGgrB_wpjejz6oC3fkwqS7M,569
+devkit_cli/templates/django/requirements.txt,sha256=vQUx6anPK0Sv2AQpekhtFMpkEf5Ra5KM57ZPC_ADQuY,13
+devkit_cli/templates/django/apps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devkit_cli/templates/django/apps/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devkit_cli/templates/django/apps/core/apps.py,sha256=kbGjkM2ifkNolj3XhS4i3LHTW-0tsRcrsYyxMvkOZ0w,151
+devkit_cli/templates/django/apps/core/urls.py,sha256=uew5_i7pyR19Qw7XO14shhtSPdUnYe_NB9kNS9DaBTA,115
+devkit_cli/templates/django/apps/core/views.py,sha256=wnBQTdoQ-HMOKEjUe5ABp9ps0WdYOlkqnr5MSOWNWBU,168
+devkit_cli/templates/django/{{module_name}}/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devkit_cli/templates/django/{{module_name}}/settings.py,sha256=pYhhM1f34dpNrni3MiSk0_gx_bQrP_Qb_Zn2iksF-js,1721
+devkit_cli/templates/django/{{module_name}}/urls.py,sha256=ZwwkCDNIduQJldIjJ6UKR8zEffWR20LAAzHySDh-MP0,217
+devkit_cli/templates/django/{{module_name}}/wsgi.py,sha256=XHF05_bx3pnlreeS4e_6AZU42mIlN7Wf6aPpGcxl1Hg,222
+devkit_cli/templates/fastapi/.gitignore,sha256=V9yZwen3aT5HHWcMxX5SUhFu4ITLOBmbun4rJjPJ_Ak,367
+devkit_cli/templates/fastapi/README.md,sha256=yoU2oTPgRA34OaipV_Ag0fj2KYho_dF9HWVoiWyRATw,209
+devkit_cli/templates/fastapi/main.py,sha256=F3zI1xmg6MyfzLvQEOgdckv19IM1oRJgc7lgLsfNQbQ,314
+devkit_cli/templates/fastapi/requirements.txt,sha256=ObwNW61KP5zyoZ7NLJaSe30Ocn0zmAHzr9ospe7zAPs,103
+devkit_cli/templates/fastapi/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devkit_cli/templates/fastapi/app/routers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devkit_cli/templates/fastapi/app/routers/health.py,sha256=OxHjmi_bB7haaEPpR4FK8Hcz-tUnzcWenJspN0Nh4w8,189
+devkit_cli/templates/fastapi/tests/test_api.py,sha256=XB--vVuR6NVNw-Hs3qgpjbloeSFIKCyNr8QxVkpaqEk,341
+devkit_cli/templates/package/.gitignore,sha256=V9yZwen3aT5HHWcMxX5SUhFu4ITLOBmbun4rJjPJ_Ak,367
+devkit_cli/templates/package/README.md,sha256=2UC-GSTm481oHBIIS5Kkv5HEtNmod4qBAeh1R2wM5zg,148
+devkit_cli/templates/package/pyproject.toml,sha256=b9s4EUyeJLJj18uaiCyFHHnFTrg5sr4W9G4bifB5FWE,581
+devkit_cli/templates/package/tests/test_core.py,sha256=Ws03fjSAGUpb-AwzceDJa8_jj2FyD0qx96lcUL-8S2U,187
+devkit_cli/templates/package/{{module_name}}/__init__.py,sha256=mP_XOicx6Xi0Ca2EXkrTBqCoT5UGppCL62n96PtrCh4,69
+devkit_cli/templates/package/{{module_name}}/core.py,sha256=l624VhIIxYJGP8re4FVBmiEDjNuRBZe7tcj9RfJzLh8,114
+devit_cli-0.1.0.dist-info/METADATA,sha256=sRn4dWGa659piBlT_aMdOA7wNq8cVzsVaxP_bcjvIGU,8093
+devit_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+devit_cli-0.1.0.dist-info/entry_points.txt,sha256=aaew_Nvzhy3BNEXKqQv--JWa8JNihftFNXXwkwX5cUc,46
+devit_cli-0.1.0.dist-info/top_level.txt,sha256=UmOPWna164DvKb2Pt3g5mhd3b1Xlz4OllFZKSPbulmU,25
+devit_cli-0.1.0.dist-info/RECORD,,

devit_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

devit_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+devkit = _devkit_entry:main

devit_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dipenpadhiyar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

devit_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+_devkit_entry
+devkit_cli

devkit_cli/__init__.py

@@ -0,0 +1,4 @@
+"""devkit-cli — A professional developer toolkit for the terminal."""
+
+__version__ = "0.1.0"
+__author__ = "devkit-cli contributors"

devkit_cli/commands/archive.py

@@ -0,0 +1,166 @@
+"""devkit zip / devkit unzip — Archive utilities with progress bars."""
+
+import zipfile
+from pathlib import Path
+
+import click
+from rich.console import Console
+from rich.progress import (
+    BarColumn,
+    FileSizeColumn,
+    Progress,
+    TaskProgressColumn,
+    TextColumn,
+    TimeRemainingColumn,
+    TransferSpeedColumn,
+)
+
+console = Console()
+
+
+def _bytes_to_human(n: int) -> str:
+    for unit in ("B", "KB", "MB", "GB"):
+        if n < 1024:
+            return f"{n:.1f} {unit}"
+        n /= 1024
+    return f"{n:.1f} TB"
+
+
+# ---------------------------------------------------------------------------
+# ZIP
+# ---------------------------------------------------------------------------
+
+@click.command("zip")
+@click.argument("output", metavar="OUTPUT.zip")
+@click.argument("sources", nargs=-1, required=True, metavar="FILE_OR_DIR...")
+@click.option("-l", "--level", default=6, show_default=True,
+              type=click.IntRange(0, 9), help="Compression level (0=none, 9=max).")
+@click.option("-x", "--exclude", multiple=True,
+              help="Glob pattern(s) to exclude, e.g. -x '*.pyc' -x '__pycache__'")
+def zip_cmd(output, sources, level, exclude):
+    """
+    Create a ZIP archive from files/directories.
+
+    \b
+    Examples:
+      devkit zip archive.zip src/ README.md
+      devkit zip dist.zip . -x __pycache__ -x '*.pyc' -l 9
+    """
+    out_path = Path(output)
+    if not out_path.suffix:
+        out_path = out_path.with_suffix(".zip")
+
+    # Collect all files
+    all_files: list[tuple[Path, str]] = []
+    for src_str in sources:
+        src = Path(src_str)
+        if not src.exists():
+            console.print(f"[red]Source not found: {src}[/red]")
+            raise click.Abort()
+        if src.is_dir():
+            for f in src.rglob("*"):
+                if f.is_file():
+                    arc_name = str(f.relative_to(src.parent))
+                    skip = any(f.match(pat) for pat in exclude)
+                    if not skip:
+                        all_files.append((f, arc_name))
+        else:
+            skip = any(src.match(pat) for pat in exclude)
+            if not skip:
+                all_files.append((src, src.name))
+
+    if not all_files:
+        console.print("[yellow]No files to archive.[/yellow]")
+        return
+
+    total_size = sum(f.stat().st_size for f, _ in all_files)
+    console.print(f"Archiving [bold]{len(all_files)}[/bold] files "
+                  f"([cyan]{_bytes_to_human(total_size)}[/cyan]) → [green]{out_path}[/green]")
+
+    compress = zipfile.ZIP_DEFLATED if level > 0 else zipfile.ZIP_STORED
+
+    with Progress(
+        TextColumn("[bold blue]{task.description}"),
+        BarColumn(),
+        TaskProgressColumn(),
+        FileSizeColumn(),
+        TransferSpeedColumn(),
+        TimeRemainingColumn(),
+        console=console,
+    ) as progress:
+        task = progress.add_task("Compressing", total=total_size)
+        with zipfile.ZipFile(out_path, "w", compression=compress, compresslevel=level) as zf:
+            for fpath, arc_name in all_files:
+                zf.write(fpath, arc_name)
+                progress.advance(task, fpath.stat().st_size)
+
+    final_size = out_path.stat().st_size
+    ratio = (1 - final_size / total_size) * 100 if total_size else 0
+    console.print(f"[green]✔[/green] Created [bold]{out_path}[/bold] "
+                  f"([cyan]{_bytes_to_human(final_size)}[/cyan], "
+                  f"[dim]{ratio:.1f}% compression[/dim])")
+
+
+# ---------------------------------------------------------------------------
+# UNZIP
+# ---------------------------------------------------------------------------
+
+@click.command("unzip")
+@click.argument("archive", type=click.Path(exists=True, dir_okay=False))
+@click.argument("destination", default=".", metavar="DEST_DIR")
+@click.option("-l", "--list", "list_only", is_flag=True, default=False,
+              help="List contents without extracting.")
+def unzip_cmd(archive, destination, list_only):
+    """
+    Extract a ZIP archive with a progress bar.
+
+    \b
+    Examples:
+      devkit unzip archive.zip
+      devkit unzip archive.zip ./output
+      devkit unzip archive.zip --list
+    """
+    arc_path = Path(archive)
+
+    if not zipfile.is_zipfile(arc_path):
+        console.print(f"[red]{archive} is not a valid ZIP file.[/red]")
+        raise click.Abort()
+
+    with zipfile.ZipFile(arc_path, "r") as zf:
+        members = zf.infolist()
+
+        if list_only:
+            from rich.table import Table
+            table = Table(title=f"Contents of {arc_path.name}")
+            table.add_column("File", style="cyan")
+            table.add_column("Size", justify="right", style="green")
+            table.add_column("Compressed", justify="right", style="dim")
+            for m in members:
+                if not m.is_dir():
+                    table.add_row(
+                        m.filename,
+                        _bytes_to_human(m.file_size),
+                        _bytes_to_human(m.compress_size),
+                    )
+            console.print(table)
+            return
+
+        dest = Path(destination)
+        dest.mkdir(parents=True, exist_ok=True)
+        total_size = sum(m.file_size for m in members if not m.is_dir())
+
+        with Progress(
+            TextColumn("[bold blue]{task.description}"),
+            BarColumn(),
+            TaskProgressColumn(),
+            FileSizeColumn(),
+            TimeRemainingColumn(),
+            console=console,
+        ) as progress:
+            task = progress.add_task("Extracting", total=total_size)
+            for member in members:
+                zf.extract(member, dest)
+                if not member.is_dir():
+                    progress.advance(task, member.file_size)
+
+    console.print(f"[green]✔[/green] Extracted [bold]{len(members)}[/bold] items to [cyan]{dest}[/cyan]")