devit-cli 0.1.0__tar.gz

devit_cli-0.1.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,241 @@
+<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/_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