kryptorious-devflow 1.0.0__tar.gz

kryptorious_devflow-1.0.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: kryptorious-devflow
+Version: 1.0.0
+Summary: Developer workflow automation CLI — scaffold, audit, fix, and ship projects with one tool.
+Author: Kryptorious Quantum Biosciences, Inc.
+License: Proprietary
+Project-URL: Homepage, https://devflow.sh
+Project-URL: Repository, https://github.com/kryptorious/devflow
+Keywords: cli,developer-tools,productivity,scaffold,code-quality,automation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Requires-Dist: gitpython>=3.1
+Requires-Dist: packaging>=23.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+
+# DevFlow — Developer Workflow Automation CLI
+
+**One tool to scaffold, audit, fix, and ship any project.**
+
+[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-Proprietary-red.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-1.0.0-green.svg)](https://devflow.sh)
+
+---
+
+## Stop Wasting Hours on Project Setup
+
+Every developer knows the pain:
+
+- Starting a new project means hours of boilerplate — config files, CI/CD, linting, testing, Docker
+- Code reviews catch formatting and lint issues that should have been fixed automatically
+- Shipping a release means bumping versions, updating changelogs, tagging, building — all manual and error-prone
+
+**DevFlow replaces 10+ separate tools with 4 commands.**
+
+---
+
+## What DevFlow Does
+
+### `devflow init` — Smart Project Scaffolding
+
+Creates production-ready projects with best practices baked in:
+
+- Python (CLI, API, library), Node.js, and full-stack templates
+- Pre-configured linting (ruff), formatting (black), type checking (mypy), and testing (pytest)
+- GitHub Actions CI/CD ready to go
+- Docker config included
+- Automatic git init and initial commit
+- Sensible defaults you can override
+
+```bash
+$ devflow init my-api --template api --description "REST API for widget tracking"
+$ devflow init my-cli --template cli
+$ devflow init my-saas --template fullstack --description "My SaaS app"
+```
+
+### `devflow audit` — Codebase Health Check
+
+Comprehensive project audit that checks:
+
+- Project structure and conventions
+- Linting violations (ruff)
+- Code formatting (black)
+- Import organization (isort/ruff)
+- Test coverage and passing status
+- Docstring coverage
+- Security vulnerabilities (bandit)
+- Hardcoded secrets
+- Dependency freshness and known vulnerabilities
+
+```bash
+$ devflow audit
+# 72/100 — 8 passed, 3 warnings, 1 error
+
+$ devflow audit --format markdown --severity error
+$ devflow audit --format json  # for CI integration
+```
+
+### `devflow fix` — Auto-Fix Everything
+
+One command to fix all the issues audit found:
+
+- Format code with black
+- Sort imports with ruff/isort
+- Fix lint violations
+- Preview with `--dry-run` before applying
+
+```bash
+$ devflow fix --dry-run      # See what would change
+$ devflow fix --apply        # Fix everything
+$ devflow fix --scope format # Just fix formatting
+```
+
+### `devflow ship` — Release Automation
+
+Ship a release in one command:
+
+- Runs audit first (quality gate — blocks release on errors)
+- Bumps version (patch/minor/major)
+- Updates CHANGELOG.md
+- Creates git tag
+- Builds distribution packages
+- Optionally pushes to remote
+
+```bash
+$ devflow ship --bump patch --message "Fix login bug"
+$ devflow ship --bump minor --message "Add user dashboard" --push
+$ devflow ship --bump major --dry-run  # Preview before shipping
+```
+
+---
+
+## Why Developers Buy DevFlow
+
+- **Save 2-4 hours per project setup.** Stop copy-pasting configs between projects.
+- **Catch issues before code review.** Audit and fix in your editor, not in PR comments.
+- **Ship with confidence.** Automated quality gates prevent broken releases.
+- **One tool, not ten.** Replace black, isort, ruff, flake8, bandit, pip-audit, bumpversion, and manual changelogs.
+- **CI-ready output.** JSON and markdown formats integrate with any pipeline.
+
+---
+
+## Installation
+
+```bash
+pip install devflow-cli
+```
+
+Requires Python 3.9+.
+
+---
+
+## Quick Start
+
+```bash
+# Create a new project
+devflow init my-project --template cli
+
+# Check its health
+cd my-project
+devflow audit
+
+# Fix any issues
+devflow fix --apply
+
+# Ship v0.1.0
+devflow ship --bump patch --message "Initial release"
+```
+
+---
+
+## What You Get
+
+- **Full source code** — MIT-licensed, modifiable, extensible
+- **6 project templates** — Python CLI, API, Library, Node.js, Full-stack, and Generic
+- **Pre-configured tooling** — ruff, black, mypy, pytest, GitHub Actions CI
+- **Docker support** — Dockerfile and docker-compose included for all templates
+- **Lifetime updates** — All 1.x updates included
+
+---
+
+## Requirements
+
+- Python 3.9 or later
+- Git (for init and ship commands)
+- Optional: black, ruff, bandit, pip-audit (devflow tells you what to install)
+
+---
+
+## License
+
+Proprietary — single-user license. See [LICENSE](LICENSE) for terms.
+
+---
+
+## Support
+
+Email: support@devflow.sh
+Docs: https://devflow.sh/docs
+
+---
+
+*Built with DevFlow itself. Ship everything.*

kryptorious_devflow-1.0.0/README.md

@@ -0,0 +1,168 @@
+# DevFlow — Developer Workflow Automation CLI
+
+**One tool to scaffold, audit, fix, and ship any project.**
+
+[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-Proprietary-red.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-1.0.0-green.svg)](https://devflow.sh)
+
+---
+
+## Stop Wasting Hours on Project Setup
+
+Every developer knows the pain:
+
+- Starting a new project means hours of boilerplate — config files, CI/CD, linting, testing, Docker
+- Code reviews catch formatting and lint issues that should have been fixed automatically
+- Shipping a release means bumping versions, updating changelogs, tagging, building — all manual and error-prone
+
+**DevFlow replaces 10+ separate tools with 4 commands.**
+
+---
+
+## What DevFlow Does
+
+### `devflow init` — Smart Project Scaffolding
+
+Creates production-ready projects with best practices baked in:
+
+- Python (CLI, API, library), Node.js, and full-stack templates
+- Pre-configured linting (ruff), formatting (black), type checking (mypy), and testing (pytest)
+- GitHub Actions CI/CD ready to go
+- Docker config included
+- Automatic git init and initial commit
+- Sensible defaults you can override
+
+```bash
+$ devflow init my-api --template api --description "REST API for widget tracking"
+$ devflow init my-cli --template cli
+$ devflow init my-saas --template fullstack --description "My SaaS app"
+```
+
+### `devflow audit` — Codebase Health Check
+
+Comprehensive project audit that checks:
+
+- Project structure and conventions
+- Linting violations (ruff)
+- Code formatting (black)
+- Import organization (isort/ruff)
+- Test coverage and passing status
+- Docstring coverage
+- Security vulnerabilities (bandit)
+- Hardcoded secrets
+- Dependency freshness and known vulnerabilities
+
+```bash
+$ devflow audit
+# 72/100 — 8 passed, 3 warnings, 1 error
+
+$ devflow audit --format markdown --severity error
+$ devflow audit --format json  # for CI integration
+```
+
+### `devflow fix` — Auto-Fix Everything
+
+One command to fix all the issues audit found:
+
+- Format code with black
+- Sort imports with ruff/isort
+- Fix lint violations
+- Preview with `--dry-run` before applying
+
+```bash
+$ devflow fix --dry-run      # See what would change
+$ devflow fix --apply        # Fix everything
+$ devflow fix --scope format # Just fix formatting
+```
+
+### `devflow ship` — Release Automation
+
+Ship a release in one command:
+
+- Runs audit first (quality gate — blocks release on errors)
+- Bumps version (patch/minor/major)
+- Updates CHANGELOG.md
+- Creates git tag
+- Builds distribution packages
+- Optionally pushes to remote
+
+```bash
+$ devflow ship --bump patch --message "Fix login bug"
+$ devflow ship --bump minor --message "Add user dashboard" --push
+$ devflow ship --bump major --dry-run  # Preview before shipping
+```
+
+---
+
+## Why Developers Buy DevFlow
+
+- **Save 2-4 hours per project setup.** Stop copy-pasting configs between projects.
+- **Catch issues before code review.** Audit and fix in your editor, not in PR comments.
+- **Ship with confidence.** Automated quality gates prevent broken releases.
+- **One tool, not ten.** Replace black, isort, ruff, flake8, bandit, pip-audit, bumpversion, and manual changelogs.
+- **CI-ready output.** JSON and markdown formats integrate with any pipeline.
+
+---
+
+## Installation
+
+```bash
+pip install devflow-cli
+```
+
+Requires Python 3.9+.
+
+---
+
+## Quick Start
+
+```bash
+# Create a new project
+devflow init my-project --template cli
+
+# Check its health
+cd my-project
+devflow audit
+
+# Fix any issues
+devflow fix --apply
+
+# Ship v0.1.0
+devflow ship --bump patch --message "Initial release"
+```
+
+---
+
+## What You Get
+
+- **Full source code** — MIT-licensed, modifiable, extensible
+- **6 project templates** — Python CLI, API, Library, Node.js, Full-stack, and Generic
+- **Pre-configured tooling** — ruff, black, mypy, pytest, GitHub Actions CI
+- **Docker support** — Dockerfile and docker-compose included for all templates
+- **Lifetime updates** — All 1.x updates included
+
+---
+
+## Requirements
+
+- Python 3.9 or later
+- Git (for init and ship commands)
+- Optional: black, ruff, bandit, pip-audit (devflow tells you what to install)
+
+---
+
+## License
+
+Proprietary — single-user license. See [LICENSE](LICENSE) for terms.
+
+---
+
+## Support
+
+Email: support@devflow.sh
+Docs: https://devflow.sh/docs
+
+---
+
+*Built with DevFlow itself. Ship everything.*

kryptorious_devflow-1.0.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kryptorious-devflow"
+version = "1.0.0"
+description = "Developer workflow automation CLI — scaffold, audit, fix, and ship projects with one tool."
+readme = "README.md"
+license = {text = "Proprietary"}
+requires-python = ">=3.9"
+authors = [{name = "Kryptorious Quantum Biosciences, Inc."}]
+keywords = ["cli", "developer-tools", "productivity", "scaffold", "code-quality", "automation"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Software Development :: Quality Assurance",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+dependencies = [
+    "click>=8.0",
+    "rich>=13.0",
+    "pyyaml>=6.0",
+    "tomli>=2.0; python_version < '3.11'",
+    "gitpython>=3.1",
+    "packaging>=23.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "pytest-cov>=4.0", "black>=23.0", "ruff>=0.1"]
+
+[project.scripts]
+devflow = "devflow.cli:main"
+
+[project.urls]
+Homepage = "https://devflow.sh"
+Repository = "https://github.com/kryptorious/devflow"
+
+[tool.setuptools.packages.find]
+where = ["src"]

kryptorious_devflow-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kryptorious_devflow-1.0.0/src/devflow/__init__.py

@@ -0,0 +1,6 @@
+"""DevFlow — Developer Workflow Automation CLI.
+
+Scaffold, audit, fix, and ship projects with a single tool.
+"""
+
+__version__ = "1.0.0"

kryptorious_devflow-1.0.0/src/devflow/cli.py

@@ -0,0 +1,140 @@
+"""DevFlow CLI — main entry point."""
+
+import click
+from rich.console import Console
+from rich import print as rprint
+
+console = Console()
+
+
+@click.group()
+@click.version_option(version="1.0.0", prog_name="devflow")
+def main():
+    """DevFlow — Developer Workflow Automation CLI.
+
+    The unified tool for project scaffolding, codebase auditing,
+    auto-fixing, and release shipping. One tool, four commands.
+    """
+    pass
+
+
+@main.command()
+@click.argument("name")
+@click.option(
+    "--template", "-t",
+    type=click.Choice(["python", "node", "fullstack", "cli", "api", "lib"]),
+    default="python",
+    help="Project template type"
+)
+@click.option(
+    "--path", "-p",
+    default=".",
+    help="Parent directory for the new project"
+)
+@click.option("--docker/--no-docker", default=True, help="Include Docker config")
+@click.option("--ci/--no-ci", default=True, help="Include CI/CD (GitHub Actions)")
+@click.option("--git/--no-git", default=True, help="Initialize git repository")
+@click.option("--license", "-l", default="MIT", help="License type")
+@click.option("--description", "-d", default="", help="Project description")
+def init(name, template, path, docker, ci, git, license, description):
+    """Scaffold a new project with best practices.
+
+    Creates a production-ready project structure with linting, formatting,
+    testing, CI/CD, Docker, and git — all configured out of the box.
+
+    \b
+    Examples:
+        devflow init my-api --template api
+        devflow init my-lib --template lib --no-docker
+        devflow init my-app --template fullstack --description "My SaaS app"
+    """
+    from .commands.init import run
+    run(name=name, template=template, path=path, docker=docker,
+        ci=ci, git_init=git, license_type=license, description=description)
+
+
+@main.command()
+@click.option(
+    "--path", "-p",
+    default=".",
+    help="Path to the project to audit"
+)
+@click.option(
+    "--format", "-f", "output_format",
+    type=click.Choice(["terminal", "markdown", "json"]),
+    default="terminal",
+    help="Output format"
+)
+@click.option(
+    "--severity", "-s",
+    type=click.Choice(["error", "warning", "info", "all"]),
+    default="all",
+    help="Minimum severity to show"
+)
+@click.option("--security/--no-security", default=True, help="Run security audit")
+@click.option("--deps/--no-deps", default=True, help="Check dependencies")
+def audit(path, output_format, severity, security, deps):
+    """Run a comprehensive codebase health check.
+
+    Checks linting, formatting, type checking, security vulnerabilities,
+    dependency freshness, documentation coverage, and test coverage.
+    Produces a detailed report with actionable recommendations.
+
+    \b
+    Examples:
+        devflow audit
+        devflow audit --format markdown --severity warning
+        devflow audit --no-security
+    """
+    from .commands.audit import run
+    run(path=path, output_format=output_format, severity=severity,
+        security=security, deps=deps)
+
+
+@main.command()
+@click.option("--path", "-p", default=".", help="Path to the project")
+@click.option("--dry-run/--apply", default=False, help="Preview fixes without applying")
+@click.option("--scope", "-s", type=click.Choice(["all", "format", "lint", "imports", "security"]), default="all", help="Fix scope")
+def fix(path, dry_run, scope):
+    """Automatically fix common code issues.
+
+    Applies formatting, sorts imports, fixes lint violations,
+    and addresses common security issues. Use --dry-run to preview.
+
+    \b
+    Examples:
+        devflow fix --dry-run
+        devflow fix --scope format
+        devflow fix --apply
+    """
+    from .commands.fix import run
+    run(path=path, dry_run=dry_run, scope=scope)
+
+
+@main.command()
+@click.option("--path", "-p", default=".", help="Path to the project")
+@click.option("--bump", "-b", type=click.Choice(["patch", "minor", "major"]), required=True, help="Version bump type")
+@click.option("--message", "-m", default="", help="Release message for changelog")
+@click.option("--dry-run/--execute", default=False, help="Preview release without executing")
+@click.option("--tag/--no-tag", default=True, help="Create git tag")
+@click.option("--push/--no-push", default=False, help="Push to remote")
+def ship(path, bump, message, dry_run, tag, push):
+    """Prepare and execute a release.
+
+    Bumps version, updates changelog, creates git tag,
+    builds distribution packages, and optionally pushes.
+    Runs audit first to ensure quality gates pass.
+
+    \b
+    Examples:
+        devflow ship --bump patch --message "Bug fixes"
+        devflow ship --bump minor --dry-run
+        devflow ship --bump major --push --message "Breaking changes v2.0"
+    """
+    from .commands.ship import run
+    run(path=path, bump=bump, message=message, dry_run=dry_run,
+        tag=tag, push=push)
+
+
+if __name__ == "__main__":
+    main()

kryptorious_devflow-1.0.0/src/devflow/commands/__init__.py

@@ -0,0 +1 @@
+"""DevFlow commands package."""