devctl 1.0.0__tar.gz

devctl-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Youssef Fellah
+
+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.

devctl-1.0.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: devctl
+Version: 1.0.0
+Summary: Local development orchestrator for Spring Boot, Angular, and Vue.js
+Author: Youssef Fellah
+License: MIT License
+        
+        Copyright (c) 2026 Youssef Fellah
+        
+        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.
+        
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12.3
+Requires-Dist: requests>=2.31.0
+Requires-Dist: jinja2>=3.1.3
+Requires-Dist: rich>=13.7.0
+Requires-Dist: pyyaml>=6.0.1
+Dynamic: license-file
+
+# devctl
+
+`devctl` is a professional command-line interface (CLI) designed to automate and
+orchestrate the development lifecycle for modern full-stack architectures. It
+provides a unified workflow for managing backends (Spring Boot, NestJS, Go,
+FastAPI), frontends (Angular, Vue, React, NextJS, Svelte), and their
+containerization.
+
+## Core Features
+
+-   **Multi-Stack Orchestration**: Launch databases, multiple microservices, and
+    frontend dev servers with a single command. Includes real-time, prefixed log
+    streaming.
+-   **Full-Stack Scaffolding**: Generate consistent business resources
+    (Entities, DTOs, Controllers, Services) across both backend and frontend
+    layers simultaneously.
+-   **Instant Infrastructure**: Automatically generate optimized, multi-stage
+    `Dockerfiles` and global `docker-compose-prod.yml` configurations by scanning
+    your project tree.
+-   **Security by Default**: Inject standardized JWT authentication and security
+    configurations into new projects.
+
+## Installation
+
+You can install `devctl` locally for development:
+
+```bash
+git clone https://github.com/yss-ef/devctl.git
+cd devctl
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Initialize a Full-Stack Project
+
+Create a new backend and frontend in seconds:
+
+```bash
+mkdir my-app && cd my-app
+devctl init spring api --db postgres
+devctl init angular front
+```
+
+### 2. Add a Business Resource
+
+Generate a complete vertical slice of your application:
+
+```bash
+devctl add resource Product -f "name:string,price:double,quantity:int"
+```
+
+### 3. Run the Environment
+
+Launch everything in parallel with automatic database startup:
+
+```bash
+devctl run
+```
+
+## Supported Stacks
+
+| Type | Frameworks / Technologies |
+| :--- | :--- |
+| **Backends** | Spring Boot, NestJS, Express (NodeJS), FastAPI, Django, Go (Fiber) |
+| **Frontends** | Angular, Vue.js, ReactJS, NextJS, Svelte |
+| **Databases** | PostgreSQL, MySQL, MongoDB |
+
+## Documentation
+
+For a detailed reference of all available commands and their options, see the
+[Commands Reference](COMMANDS.md).
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for
+development setup and code quality guidelines.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
+for details.
+
+---
+Authored by Youssef Fellah.
+Professional Development Orchestrator.

devctl-1.0.0/README.md

@@ -0,0 +1,86 @@
+# devctl
+
+`devctl` is a professional command-line interface (CLI) designed to automate and
+orchestrate the development lifecycle for modern full-stack architectures. It
+provides a unified workflow for managing backends (Spring Boot, NestJS, Go,
+FastAPI), frontends (Angular, Vue, React, NextJS, Svelte), and their
+containerization.
+
+## Core Features
+
+-   **Multi-Stack Orchestration**: Launch databases, multiple microservices, and
+    frontend dev servers with a single command. Includes real-time, prefixed log
+    streaming.
+-   **Full-Stack Scaffolding**: Generate consistent business resources
+    (Entities, DTOs, Controllers, Services) across both backend and frontend
+    layers simultaneously.
+-   **Instant Infrastructure**: Automatically generate optimized, multi-stage
+    `Dockerfiles` and global `docker-compose-prod.yml` configurations by scanning
+    your project tree.
+-   **Security by Default**: Inject standardized JWT authentication and security
+    configurations into new projects.
+
+## Installation
+
+You can install `devctl` locally for development:
+
+```bash
+git clone https://github.com/yss-ef/devctl.git
+cd devctl
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Initialize a Full-Stack Project
+
+Create a new backend and frontend in seconds:
+
+```bash
+mkdir my-app && cd my-app
+devctl init spring api --db postgres
+devctl init angular front
+```
+
+### 2. Add a Business Resource
+
+Generate a complete vertical slice of your application:
+
+```bash
+devctl add resource Product -f "name:string,price:double,quantity:int"
+```
+
+### 3. Run the Environment
+
+Launch everything in parallel with automatic database startup:
+
+```bash
+devctl run
+```
+
+## Supported Stacks
+
+| Type | Frameworks / Technologies |
+| :--- | :--- |
+| **Backends** | Spring Boot, NestJS, Express (NodeJS), FastAPI, Django, Go (Fiber) |
+| **Frontends** | Angular, Vue.js, ReactJS, NextJS, Svelte |
+| **Databases** | PostgreSQL, MySQL, MongoDB |
+
+## Documentation
+
+For a detailed reference of all available commands and their options, see the
+[Commands Reference](COMMANDS.md).
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for
+development setup and code quality guidelines.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
+for details.
+
+---
+Authored by Youssef Fellah.
+Professional Development Orchestrator.

devctl-1.0.0/devctl/__init__.py

@@ -0,0 +1,3 @@
+"""
+devctl: CLI tool to orchestrate Spring Boot and Frontend projects.
+"""

devctl-1.0.0/devctl/commands/__init__.py

@@ -0,0 +1,3 @@
+"""
+CLI command modules for devctl.
+"""

devctl-1.0.0/devctl/commands/add.py

@@ -0,0 +1,166 @@
+"""
+CLI command group for adding new resources to existing projects.
+Supports Spring Boot, Angular, Vue.js, NestJS, NodeJS, React, NextJS, FastAPI,
+Django, Svelte, and Go scaffolding.
+"""
+
+import os
+
+import typer
+
+from devctl.generators.scaffold_angular import generate_angular_resource
+from devctl.generators.scaffold_django import generate_django_resource
+from devctl.generators.scaffold_fastapi import generate_fastapi_resource
+from devctl.generators.scaffold_go import generate_go_resource
+from devctl.generators.scaffold_nestjs import generate_nest_resource
+from devctl.generators.scaffold_nextjs import generate_nextjs_resource
+from devctl.generators.scaffold_nodejs import generate_nodejs_resource
+from devctl.generators.scaffold_react import generate_react_resource
+from devctl.generators.scaffold_spring import generate_spring_resource
+from devctl.generators.scaffold_svelte import generate_svelte_resource
+from devctl.generators.scaffold_vue import generate_vue_resource
+from devctl.orchestrator.scanner import detect_environment
+from devctl.utils.dependencies import check_tool
+
+app = typer.Typer(help="Adds resources to the current project (Scaffolding).")
+
+
+@app.command()
+def resource(
+    name: str = typer.Argument(..., help="The name of the resource (e.g., Client, Product)"),
+    fields: str = typer.Option(
+        "", "--fields", "-f", help="Fields in the format 'name:type, age:int'"
+    ),
+):
+    """
+    Scans the current folder and generates a suitable business architecture.
+    """
+    typer.secho("Analyzing current context...", fg=typer.colors.CYAN)
+    env_state = detect_environment(".")
+
+    original_dir = os.getcwd()
+    project_detected = False
+
+    # Check for Spring Boot project
+    if env_state["has_spring"]:
+        check_tool("java", "generating Spring Boot resources")
+        project_detected = True
+        typer.secho(
+            "Spring Boot project detected. Launching Java generator...", fg=typer.colors.GREEN
+        )
+        os.chdir(env_state["spring_path"])
+        try:
+            generate_spring_resource(name, fields)
+        except Exception as e:
+            typer.secho(f"Error: Spring generation failed: {e}", fg=typer.colors.RED)
+        finally:
+            os.chdir(original_dir)
+
+    # Check for Angular project
+    if env_state["has_angular"]:
+        check_tool("npm", "generating Angular resources")
+        project_detected = True
+        typer.secho(
+            "Angular project detected. Launching TypeScript generator...", fg=typer.colors.CYAN
+        )
+        try:
+            generate_angular_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: Angular generation failed: {e}", fg=typer.colors.RED)
+
+    # Check for Vue.js project
+    if env_state.get("has_vue"):
+        check_tool("npm", "generating Vue.js resources")
+        project_detected = True
+        typer.secho("Vue.js project detected. Launching Vue generator...", fg=typer.colors.GREEN)
+        try:
+            generate_vue_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: Vue generation failed: {e}", fg=typer.colors.RED)
+
+    # Check for NestJS project
+    if env_state.get("has_nest"):
+        project_detected = True
+        typer.secho("NestJS project detected. Launching Nest generator...", fg=typer.colors.CYAN)
+        try:
+            generate_nest_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: Nest generation failed: {e}", fg=typer.colors.RED)
+
+    # Check for React project
+    if env_state.get("has_react"):
+        project_detected = True
+        typer.secho("React project detected. Launching React generator...", fg=typer.colors.BLUE)
+        try:
+            generate_react_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: React generation failed: {e}", fg=typer.colors.RED)
+
+    # Check for NextJS project
+    if env_state.get("has_nextjs"):
+        project_detected = True
+        typer.secho(
+            "NextJS project detected. Launching NextJS generator...", fg=typer.colors.YELLOW
+        )
+        try:
+            generate_nextjs_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: NextJS generation failed: {e}", fg=typer.colors.RED)
+
+    # Check for FastAPI project
+    if env_state.get("has_fastapi"):
+        project_detected = True
+        typer.secho(
+            "FastAPI project detected. Launching FastAPI generator...", fg=typer.colors.CYAN
+        )
+        try:
+            generate_fastapi_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: FastAPI generation failed: {e}", fg=typer.colors.RED)
+
+    # Check for Django project
+    if env_state.get("has_django"):
+        project_detected = True
+        typer.secho("Django project detected. Launching Django generator...", fg=typer.colors.GREEN)
+        try:
+            generate_django_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: Django generation failed: {e}", fg=typer.colors.RED)
+
+    # Check for Svelte project
+    if env_state.get("has_svelte"):
+        project_detected = True
+        typer.secho("Svelte project detected. Launching Svelte generator...", fg=typer.colors.RED)
+        try:
+            generate_svelte_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: Svelte generation failed: {e}", fg=typer.colors.RED)
+
+    # Check for Go project
+    if env_state.get("has_go"):
+        project_detected = True
+        typer.secho("Go project detected. Launching Go generator...", fg=typer.colors.CYAN)
+        try:
+            generate_go_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: Go generation failed: {e}", fg=typer.colors.RED)
+
+    # Check for NodeJS project
+    if os.path.exists("package.json") and not project_detected:
+        # Heuristic for generic nodejs project if not already caught by others
+        project_detected = True
+        typer.secho("NodeJS project detected. Launching NodeJS generator...", fg=typer.colors.GREEN)
+        try:
+            generate_nodejs_resource(name, fields, root_path=".")
+        except Exception as e:
+            typer.secho(f"Error: NodeJS generation failed: {e}", fg=typer.colors.RED)
+
+    # Error message only if NO project detected
+    if not project_detected:
+        typer.secho(
+            "Error: Unable to determine project type. "
+            "Please run from within a supported project directory "
+            "(Spring, Angular, React, NextJS, FastAPI, Django, Svelte, Go, or Vue.js).",
+            fg=typer.colors.RED,
+        )
+        raise typer.Exit(code=1)

devctl-1.0.0/devctl/commands/deploy.py

@@ -0,0 +1,61 @@
+from pathlib import Path
+
+import typer
+
+from devctl.generators.docker_scaffold import (
+    DockerScaffoldError,
+    scaffold_docker_assets,
+)
+
+app = typer.Typer(help="Deployment and orchestration commands.")
+
+PATH_ARGUMENT = typer.Argument(
+    Path("."),
+    help="Repository or project directory to scan for services.",
+)
+
+FORCE_OPTION = typer.Option(
+    False,
+    "--force",
+    help="Overwrite generated Docker files that already exist.",
+)
+
+@app.command()
+def deploy(
+    path: Path = PATH_ARGUMENT,
+    force: bool = FORCE_OPTION,
+):
+    """
+    Generate a global docker-compose-prod.yml by scanning subdirectories.
+    """
+    typer.secho(f"Preparing deployment for {path.resolve()}...", fg=typer.colors.CYAN, bold=True)
+
+    try:
+        result = scaffold_docker_assets(
+            path,
+            force=force,
+        )
+    except DockerScaffoldError as exc:
+        typer.secho(f"Error: {exc}", fg=typer.colors.RED)
+        raise typer.Exit(code=1) from exc
+
+    typer.secho(
+        f"Deployment scaffolding complete for {result.root_path}",
+        fg=typer.colors.CYAN,
+        bold=True,
+    )
+
+    typer.echo("\nDetected services:")
+    for service in result.services:
+        typer.echo(f"  - {service.kind}: {service.service_name} ({service.relative_context})")
+
+    typer.echo("\nFiles:")
+    for operation in result.operations:
+        if "docker-compose-prod.yml" in str(operation.path):
+            relative_path = operation.path.relative_to(result.root_path)
+            typer.echo(f"  - {operation.action}: {relative_path}")
+
+    typer.secho(
+        f"\nSummary: {result.created_count} created, {result.skipped_count} skipped.",
+        fg=typer.colors.GREEN,
+    )

devctl-1.0.0/devctl/commands/docker.py

@@ -0,0 +1,65 @@
+"""
+CLI command group for Docker-related operations.
+Includes scaffolding Dockerfiles for detected services.
+"""
+
+from pathlib import Path
+
+import typer
+
+from devctl.generators.docker_scaffold import (
+    DockerScaffoldError,
+    scaffold_docker_assets,
+)
+
+PATH_ARGUMENT = typer.Argument(
+    Path("."),
+    help="Repository or project directory to scan for Dockerizable services.",
+)
+FORCE_OPTION = typer.Option(
+    False,
+    "--force",
+    help="Overwrite generated Docker files that already exist.",
+)
+DRY_RUN_OPTION = typer.Option(
+    False,
+    "--dry-run",
+    help="Show what would be generated without writing files.",
+)
+
+
+def dockerize(
+    path: Path = PATH_ARGUMENT,
+    force: bool = FORCE_OPTION,
+    dry_run: bool = DRY_RUN_OPTION,
+):
+    """
+    Scaffold Dockerfiles for Spring Boot, Angular, and Vue/Vite projects.
+    """
+    try:
+        result = scaffold_docker_assets(
+            path,
+            force=force,
+            dry_run=dry_run,
+        )
+    except DockerScaffoldError as exc:
+        typer.secho(f"Error: {exc}", fg=typer.colors.RED)
+        raise typer.Exit(code=1) from exc
+
+    mode = "Dry run" if dry_run else "Docker scaffolding"
+    typer.secho(f"{mode} complete for {result.root_path}", fg=typer.colors.CYAN, bold=True)
+
+    typer.echo("\nDetected services:")
+    for service in result.services:
+        typer.echo(f"  - {service.kind}: {service.service_name} ({service.relative_context})")
+
+    typer.echo("\nFiles:")
+    for operation in result.operations:
+        relative_path = operation.path.relative_to(result.root_path)
+        typer.echo(f"  - {operation.action}: {relative_path}")
+
+    typer.secho(
+        f"\nSummary: {result.created_count} created, "
+        f"{result.skipped_count} skipped, {result.planned_count} planned.",
+        fg=typer.colors.GREEN,
+    )