dx-cli 0.1.0__tar.gz

dx_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lepton Software
+
+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.

dx_cli-0.1.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: dx-cli
+Version: 0.1.0
+Summary: Developer experience CLI for Docker Compose monorepos — service scaffolding, port management, and project health checks
+Author-email: Lepton Software <dev@lepton.software>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/LeptonSoftware/smart-market-platform
+Project-URL: Repository, https://github.com/LeptonSoftware/smart-market-platform
+Keywords: docker,compose,devtools,cli,monorepo,microservices
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Systems Administration
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# dx — Developer Experience CLI
+
+A zero-dependency CLI for managing Docker Compose monorepos. Handles service lifecycle, port management, code generation, and project health checks.
+
+## Install
+
+```sh
+pip install dx-cli
+```
+
+Or install from source:
+
+```sh
+pip install -e dev-cli/
+```
+
+## Quick Start
+
+```sh
+dx up                     # Start all services
+dx dev                    # Start with hot-reload
+dx down                   # Stop everything
+dx ps                     # Show running containers
+dx logs service-data      # Stream logs
+```
+
+## Commands
+
+### Docker Lifecycle
+
+| Command | Description |
+|---------|-------------|
+| `dx up [targets...]` | Start services (prod mode) |
+| `dx dev [targets...]` | Start services (dev mode + hot-reload) |
+| `dx down [targets...]` | Stop and remove containers |
+| `dx restart [targets...]` | Restart containers |
+| `dx reset [targets...]` | Stop + wipe volumes |
+| `dx ps` | Show running containers |
+| `dx logs [targets...]` | Stream container logs |
+| `dx pull [targets...]` | Pull images |
+| `dx reload <service>` | Recompile Java service for DevTools restart |
+
+### Build / Test / Lint
+
+| Command | Description |
+|---------|-------------|
+| `dx build [targets...]` | Build services (`all`, `common`, or names) |
+| `dx test [targets...]` | Run tests (`all` or service names) |
+| `dx lint [targets...]` | Run linters (`all`, `frontend`, `python`) |
+
+### Service Scaffolding
+
+| Command | Description |
+|---------|-------------|
+| `dx generate python <name>` | Scaffold a new Python/FastAPI service |
+| `dx generate java <name>` | Scaffold a new Java/Spring Boot service |
+
+Generated services include Dockerfiles, compose entries, health checks, config, and agent guides.
+
+### Port Management
+
+| Command | Description |
+|---------|-------------|
+| `dx ports` | Show port assignments |
+| `dx ports pin <svc> <port>` | Pin a service to a specific port |
+| `dx ports reset [service]` | Clear port reservations |
+
+Ports are auto-allocated for all services (infra, services, apps) and persisted in `.dx/ports.json`.
+
+### Project Health
+
+| Command | Description |
+|---------|-------------|
+| `dx doctor` | Check project structure, Dockerfiles, and conventions |
+| `dx doctor --fix` | Auto-fix issues in compose files and Dockerfiles |
+
+Checks include:
+- Compose service naming conventions
+- Required files per service type (Dockerfile, pom.xml, pyproject.toml)
+- Java Dockerfile module sync with pom.xml
+- Hardcoded ports (auto-fixable)
+- Missing Dockerfile references
+
+### Proxy & DNS
+
+| Command | Description |
+|---------|-------------|
+| `dx proxy start` | Start reverse proxy on `:7355` |
+| `dx proxy stop` | Stop reverse proxy |
+| `dx hosts setup` | Add `*.dx.localhost` DNS entries |
+
+Access services at `http://<service>.dx.localhost:7355`.
+
+## Target Resolution
+
+Targets can be:
+- **Group names**: `infra`, `services`, `apps`
+- **Service names**: `service-data`, `infra-postgres`
+- **Shorthand**: `data`, `ai`, `frontend`
+- **Glob patterns**: `service-d*`, `app-*-ui`
+
+## Compose File Convention
+
+```
+docker-compose.infra.yml          # Infrastructure (prefix: infra-*)
+docker-compose.services.yml       # Backend services (prefix: service-*)
+docker-compose.apps.yml           # Frontend apps (prefix: app-*)
+docker-compose.dev.services.yml   # Dev overlay for services
+docker-compose.dev.apps.yml       # Dev overlay for apps
+```
+
+## Requirements
+
+- Python 3.11+
+- Docker with Compose v2
+- No Python dependencies (zero-dependency CLI)
+
+## License
+
+MIT

dx_cli-0.1.0/README.md

@@ -0,0 +1,120 @@
+# dx — Developer Experience CLI
+
+A zero-dependency CLI for managing Docker Compose monorepos. Handles service lifecycle, port management, code generation, and project health checks.
+
+## Install
+
+```sh
+pip install dx-cli
+```
+
+Or install from source:
+
+```sh
+pip install -e dev-cli/
+```
+
+## Quick Start
+
+```sh
+dx up                     # Start all services
+dx dev                    # Start with hot-reload
+dx down                   # Stop everything
+dx ps                     # Show running containers
+dx logs service-data      # Stream logs
+```
+
+## Commands
+
+### Docker Lifecycle
+
+| Command | Description |
+|---------|-------------|
+| `dx up [targets...]` | Start services (prod mode) |
+| `dx dev [targets...]` | Start services (dev mode + hot-reload) |
+| `dx down [targets...]` | Stop and remove containers |
+| `dx restart [targets...]` | Restart containers |
+| `dx reset [targets...]` | Stop + wipe volumes |
+| `dx ps` | Show running containers |
+| `dx logs [targets...]` | Stream container logs |
+| `dx pull [targets...]` | Pull images |
+| `dx reload <service>` | Recompile Java service for DevTools restart |
+
+### Build / Test / Lint
+
+| Command | Description |
+|---------|-------------|
+| `dx build [targets...]` | Build services (`all`, `common`, or names) |
+| `dx test [targets...]` | Run tests (`all` or service names) |
+| `dx lint [targets...]` | Run linters (`all`, `frontend`, `python`) |
+
+### Service Scaffolding
+
+| Command | Description |
+|---------|-------------|
+| `dx generate python <name>` | Scaffold a new Python/FastAPI service |
+| `dx generate java <name>` | Scaffold a new Java/Spring Boot service |
+
+Generated services include Dockerfiles, compose entries, health checks, config, and agent guides.
+
+### Port Management
+
+| Command | Description |
+|---------|-------------|
+| `dx ports` | Show port assignments |
+| `dx ports pin <svc> <port>` | Pin a service to a specific port |
+| `dx ports reset [service]` | Clear port reservations |
+
+Ports are auto-allocated for all services (infra, services, apps) and persisted in `.dx/ports.json`.
+
+### Project Health
+
+| Command | Description |
+|---------|-------------|
+| `dx doctor` | Check project structure, Dockerfiles, and conventions |
+| `dx doctor --fix` | Auto-fix issues in compose files and Dockerfiles |
+
+Checks include:
+- Compose service naming conventions
+- Required files per service type (Dockerfile, pom.xml, pyproject.toml)
+- Java Dockerfile module sync with pom.xml
+- Hardcoded ports (auto-fixable)
+- Missing Dockerfile references
+
+### Proxy & DNS
+
+| Command | Description |
+|---------|-------------|
+| `dx proxy start` | Start reverse proxy on `:7355` |
+| `dx proxy stop` | Stop reverse proxy |
+| `dx hosts setup` | Add `*.dx.localhost` DNS entries |
+
+Access services at `http://<service>.dx.localhost:7355`.
+
+## Target Resolution
+
+Targets can be:
+- **Group names**: `infra`, `services`, `apps`
+- **Service names**: `service-data`, `infra-postgres`
+- **Shorthand**: `data`, `ai`, `frontend`
+- **Glob patterns**: `service-d*`, `app-*-ui`
+
+## Compose File Convention
+
+```
+docker-compose.infra.yml          # Infrastructure (prefix: infra-*)
+docker-compose.services.yml       # Backend services (prefix: service-*)
+docker-compose.apps.yml           # Frontend apps (prefix: app-*)
+docker-compose.dev.services.yml   # Dev overlay for services
+docker-compose.dev.apps.yml       # Dev overlay for apps
+```
+
+## Requirements
+
+- Python 3.11+
+- Docker with Compose v2
+- No Python dependencies (zero-dependency CLI)
+
+## License
+
+MIT

dx_cli-0.1.0/dx/__init__.py

@@ -0,0 +1,3 @@
+"""dx — developer experience CLI for Docker Compose projects."""
+
+__version__ = "0.1.0"

dx_cli-0.1.0/dx/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as `python -m dx`."""
+
+from dx.cli import main
+
+main()

dx_cli-0.1.0/dx/cli.py

@@ -0,0 +1,141 @@
+"""CLI entry point — argument parsing and command dispatch."""
+
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+from pathlib import Path
+
+from dx import __version__
+from dx.compose import ComposeCatalog
+from dx.output import error
+
+
+def _find_repo_root() -> Path:
+    """Walk up from CWD to find the repo root (contains docker-compose.infra.yml)."""
+    # Check env var first (set by wrapper or user)
+    env_root = os.environ.get("DX_REPO_ROOT")
+    if env_root:
+        return Path(env_root)
+
+    path = Path.cwd()
+    while path != path.parent:
+        if (path / "docker-compose.infra.yml").exists():
+            return path
+        path = path.parent
+
+    # Fallback: assume CWD is repo root
+    return Path.cwd()
+
+
+USAGE = """\
+dx — developer experience CLI for Docker Compose projects
+
+Usage: dx <command> [targets...]
+
+Docker lifecycle:
+  up [targets...]          Start services (prod mode)
+  dev [targets...]         Start services (dev mode + hot-reload)
+  down [targets...]        Stop and remove containers
+  restart [targets...]     Restart containers
+  reset [targets...]       Stop + wipe volumes
+  ps                       Show running containers
+  logs [targets...]        Stream container logs
+  pull [targets...]        Pull images
+  reload <service>         Recompile Java service for DevTools restart
+
+Build / Test / Lint:
+  build [targets...]       Build services ("all", "common", or names)
+  test [targets...]        Run tests ("all" or service names)
+  lint [targets...]        Run linters ("all", "frontend", "python")
+
+Port management:
+  ports                    Show port assignments
+  ports pin <svc> <port>   Pin a service to a specific port
+  ports reset [service]    Clear port reservations
+
+Proxy:
+  proxy start              Start reverse proxy daemon on :7355
+  proxy stop               Stop reverse proxy
+  hosts                    Show DNS resolution status
+  hosts setup              Add *.dx.localhost entries (/etc/hosts)
+  hosts remove             Remove all dx DNS entries
+
+Dev utilities:
+  vite start|stop|logs     Manage vite dev server as a daemon
+
+Scaffolding:
+  generate python <name>   Scaffold a new Python/FastAPI service
+  generate java <name>     Scaffold a new Java/Spring Boot service
+
+Project health:
+  doctor                   Check project structure, Dockerfiles, and conventions
+  doctor --fix             Auto-fix issues in compose files and Dockerfiles
+
+Setup:
+  init                     Initialize ClickStack/HyperDX
+  validate                 Run harness validation
+  list [group]             List services by group
+
+Targets can be group names (infra, services, apps), service names,
+glob patterns (service-d*), or shorthand (data, frontend, ai).
+"""
+
+
+def main(argv: list[str] | None = None) -> None:
+    args = argv if argv is not None else sys.argv[1:]
+
+    if not args or args[0] in ("-h", "--help", "help"):
+        print(USAGE.strip())
+        sys.exit(0)
+
+    if args[0] in ("-V", "--version"):
+        print(f"dx {__version__}")
+        sys.exit(0)
+
+    command = args[0]
+    rest = args[1:]
+
+    root = _find_repo_root()
+    catalog = ComposeCatalog(root)
+
+    from dx import commands as cmd
+
+    from dx.doctor import cmd_doctor
+    from dx.generate import cmd_generate
+
+    dispatch = {
+        "up":       lambda: cmd.cmd_up(catalog, rest),
+        "dev":      lambda: cmd.cmd_dev(catalog, rest),
+        "down":     lambda: cmd.cmd_down(catalog, rest),
+        "restart":  lambda: cmd.cmd_restart(catalog, rest),
+        "reset":    lambda: cmd.cmd_reset(catalog, rest),
+        "ps":       lambda: cmd.cmd_ps(catalog),
+        "logs":     lambda: cmd.cmd_logs(catalog, rest),
+        "pull":     lambda: cmd.cmd_pull(catalog, rest),
+        "reload":   lambda: cmd.cmd_reload(catalog, rest),
+        "build":    lambda: cmd.cmd_build(catalog, rest),
+        "test":     lambda: cmd.cmd_test(catalog, rest),
+        "lint":     lambda: cmd.cmd_lint(catalog, rest),
+        "init":     lambda: cmd.cmd_init(catalog),
+        "validate": lambda: cmd.cmd_validate(catalog),
+        "list":     lambda: cmd.cmd_list(catalog, rest),
+        "ports":    lambda: cmd.cmd_ports(catalog, rest),
+        "proxy":    lambda: cmd.cmd_proxy(catalog, rest),
+        "hosts":    lambda: cmd.cmd_hosts(catalog, rest),
+        "vite":     lambda: cmd.cmd_vite(catalog, rest[0] if rest else ""),
+        "doctor":   lambda: cmd_doctor(catalog, fix="--fix" in rest),
+        "generate": lambda: cmd_generate(catalog, rest),
+    }
+
+    handler = dispatch.get(command)
+    if not handler:
+        error(f"Unknown command: {command}")
+        print(f"\nRun 'dx help' for usage.", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        handler()
+    except KeyboardInterrupt:
+        sys.exit(130)