forge-cicd 0.1.0__tar.gz

forge_cicd-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: forge-cicd
+Version: 0.1.0
+Summary: Forge — spec-driven CI/CD for full-stack projects.
+Author-email: Tahir Siddique <tahir@example.com>
+Project-URL: Homepage, https://github.com/TahirSiddique092/forge
+Project-URL: Repository, https://github.com/TahirSiddique092/forge
+Project-URL: Issues, https://github.com/TahirSiddique092/forge/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Environment :: Console
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer[all]
+Requires-Dist: requests
+Requires-Dist: rich>=13.0.0
+
+# Forge CI/CD CLI
+
+Forge is a spec-driven CI/CD platform designed for modern, full-stack applications. It bridges the gap between your local terminal and production deployments by orchestrating builds, running CI steps in local/remote workers, and managing deployments to platforms like Railway and Vercel.
+
+## Features
+
+- **Spec-driven**: Define your build and deploy pipeline in a simple YAML or JSON spec.
+- **Local Workers**: Run your CI jobs locally using Docker while still reporting status to the cloud.
+- **Integrated Deployments**: Native support for Railway (backend) and Vercel (frontend).
+- **GitHub Integration**: Securely authenticate with GitHub and link your repositories effortlessly.
+- **Real-time Logs**: Stream build and deployment logs directly to your terminal.
+
+## Installation
+
+Forge requires Python 3.9 or higher.
+
+```bash
+pip install forge-cicd
+```
+
+## Quick Start
+
+1. **Initialize your project**:
+   ```bash
+   forge init
+   ```
+
+2. **Login with GitHub**:
+   ```bash
+   forge login
+   ```
+
+3. **Link your repository**:
+   ```bash
+   forge link <your-project-id>
+   ```
+
+4. **Set your cloud credentials**:
+   ```bash
+   forge set-cred railway
+   forge set-cred vercel
+   ```
+
+5. **Start a local worker** (optional, for CI execution):
+   ```bash
+   forge worker start
+   ```
+
+6. **Deploy**:
+   ```bash
+   forge deploy
+   ```
+
+## Documentation
+
+For full documentation and advanced usage, visit [github.com/TahirSiddique092/forge](https://github.com/TahirSiddique092/forge).
+
+## License
+
+Forge is released under the MIT License.

forge_cicd-0.1.0/README.md

@@ -0,0 +1,60 @@
+# Forge CI/CD CLI
+
+Forge is a spec-driven CI/CD platform designed for modern, full-stack applications. It bridges the gap between your local terminal and production deployments by orchestrating builds, running CI steps in local/remote workers, and managing deployments to platforms like Railway and Vercel.
+
+## Features
+
+- **Spec-driven**: Define your build and deploy pipeline in a simple YAML or JSON spec.
+- **Local Workers**: Run your CI jobs locally using Docker while still reporting status to the cloud.
+- **Integrated Deployments**: Native support for Railway (backend) and Vercel (frontend).
+- **GitHub Integration**: Securely authenticate with GitHub and link your repositories effortlessly.
+- **Real-time Logs**: Stream build and deployment logs directly to your terminal.
+
+## Installation
+
+Forge requires Python 3.9 or higher.
+
+```bash
+pip install forge-cicd
+```
+
+## Quick Start
+
+1. **Initialize your project**:
+   ```bash
+   forge init
+   ```
+
+2. **Login with GitHub**:
+   ```bash
+   forge login
+   ```
+
+3. **Link your repository**:
+   ```bash
+   forge link <your-project-id>
+   ```
+
+4. **Set your cloud credentials**:
+   ```bash
+   forge set-cred railway
+   forge set-cred vercel
+   ```
+
+5. **Start a local worker** (optional, for CI execution):
+   ```bash
+   forge worker start
+   ```
+
+6. **Deploy**:
+   ```bash
+   forge deploy
+   ```
+
+## Documentation
+
+For full documentation and advanced usage, visit [github.com/TahirSiddique092/forge](https://github.com/TahirSiddique092/forge).
+
+## License
+
+Forge is released under the MIT License.

forge_cicd-0.1.0/forge/commands/_render_logs.py

@@ -0,0 +1,46 @@
+def print_run_logs(run: dict):
+    commit = run.get("commit", "")[:7]
+    message = run.get("message") or "(no commit message)"
+    status = run.get("status", "unknown")
+    created = run.get("created_at", "")
+    logs = run.get("logs") or {}
+
+    print("")
+    print(f"Run {run['id']}")
+    print("-" * 72)
+    print(f"Commit     {commit}  {message}")
+    print(f"Status     {status}")
+    print(f"Created    {created}")
+    print("")
+
+    steps = logs.get("steps", [])
+
+    if not steps:
+        print("No logs available for this run.")
+        return
+
+    print("Steps")
+    print("-" * 72)
+
+    for idx, step in enumerate(steps, start=1):
+        print(f"[{idx}] {step['name']}")
+        print(f"Command:")
+        print(f"  {step.get('command', '(unknown)')}")
+        print("")
+
+        if step.get("stdout"):
+            print("Output:")
+            for line in step["stdout"].splitlines():
+                print(f"  {line}")
+
+        if step.get("stderr"):
+            print("Error:")
+            for line in step["stderr"].splitlines():
+                print(f"  {line}")
+
+        print("")
+        print(
+            f"Result     {step['status']} "
+            f"({step.get('duration_ms', 0)} ms)"
+        )
+        print("")

forge_cicd-0.1.0/forge/commands/create.py

@@ -0,0 +1,137 @@
+import typer
+import requests
+import os
+from rich.prompt import Prompt
+from forge.config import load_config, save_config
+from forge import ui
+
+BACKEND_URL = os.getenv("FORGE_BACKEND_URL", "https://forge-backend-wwp9.onrender.com")
+
+
+def create(name: str = typer.Argument(..., help="Project name")):
+    """
+    Create a new Forge project and link this directory to it.
+
+    Creates a project with a standard backend (Railway) and frontend (Vercel)
+    component spec. To use a custom spec, create the project via the dashboard.
+    """
+
+    try:
+        cfg = load_config()
+    except Exception:
+        cfg = {}
+
+    session_token = cfg.get("session_token")
+    if not session_token:
+        ui.error("Not authenticated. Run [bold]forge login[/bold] first.")
+        raise typer.Exit(1)
+
+    ui.blank()
+    ui.header("Backend Configuration (Railway)")
+    backend_choice = Prompt.ask(
+        "Framework",
+        choices=["fastapi", "flask", "express", "custom"],
+        default="fastapi",
+        console=ui.console
+    )
+
+    if backend_choice == "fastapi":
+        b_runtime = "python"
+        b_install = "pip install -r requirements.txt"
+        b_build   = "uvicorn app.main:app --host 0.0.0.0 --port $PORT" 
+        
+    elif backend_choice == "flask":
+        b_runtime = "python"
+        b_install = "pip install -r requirements.txt"
+        b_build   = "gunicorn app:app -b 0.0.0.0:$PORT" 
+        
+    elif backend_choice == "express":
+        b_runtime = "node"
+        b_install = "npm install"
+        b_build   = "npm start" 
+    else:
+        b_runtime = Prompt.ask("  Runtime", choices=["python", "node"], default="python", console=ui.console)
+        b_install = Prompt.ask("  Install Command", default="pip install -r requirements.txt", console=ui.console)
+        b_build   = Prompt.ask("  Build/Start Command", default="uvicorn app.main:app --host 0.0.0.0 --port $PORT", console=ui.console)
+
+
+    b_root = Prompt.ask("Root directory", default="backend", console=ui.console)
+
+    ui.blank()
+    ui.header("Frontend Configuration (Vercel)")
+    frontend_choice = Prompt.ask(
+        "Framework",
+        choices=["nextjs", "vite", "custom"],
+        default="nextjs",
+        console=ui.console
+    )
+
+    if frontend_choice == "nextjs" or frontend_choice == "vite":
+        f_runtime = "node"
+        f_install = "npm install"
+        f_build   = "npm run build"
+    else:
+        f_runtime = Prompt.ask("  Runtime", choices=["node", "python"], default="node", console=ui.console)
+        f_install = Prompt.ask("  Install Command", default="npm install", console=ui.console)
+        f_build   = Prompt.ask("  Build Command", default="npm run build", console=ui.console)
+
+    f_root = Prompt.ask("Root directory", default="frontend", console=ui.console)
+    ui.blank()
+
+    payload = {
+        "name": name,
+        "spec": {
+            "components": [
+                {
+                    "name": "backend",
+                    "platform": "railway",
+                    "root_dir": b_root,
+                    "runtime": b_runtime,
+                    "install_command": b_install,
+                    "build_command": b_build,
+                    "test_command": None,
+                    "env_vars": {},
+                },
+                {
+                    "name": "frontend",
+                    "platform": "vercel",
+                    "root_dir": f_root,
+                    "runtime": f_runtime,
+                    "install_command": f_install,
+                    "build_command": f_build,
+                    "test_command": None,
+                    "env_vars": {},
+                },
+            ]
+        },
+    }
+
+    with ui.console.status("[dim]Creating project...[/dim]", spinner="dots"):
+        r = requests.post(
+            f"{BACKEND_URL}/projects",
+            json=payload,
+            headers={"Authorization": f"Bearer {session_token}"},
+            timeout=15,
+        )
+
+    if r.status_code != 200:
+        ui.error(f"Failed to create project: {r.text}")
+        raise typer.Exit(1)
+
+    data       = r.json()
+    proj_id    = data["project_details"]["project_id"]
+    worker_tok = data["worker_details"]["worker_token"]
+
+    cfg["project_id"]   = proj_id
+    cfg["worker_token"] = worker_tok
+    save_config(cfg)
+
+    ui.success(f"Project [bold]{name}[/bold] created.")
+    ui.blank()
+    ui.label("Project ID",    proj_id)
+    ui.label("Worker token",  worker_tok)
+    ui.blank()
+    ui.info("Next steps:")
+    ui.console.print("    1. [bold]forge set-cred railway[/bold]   — add your Railway API key")
+    ui.console.print("    2. [bold]forge set-cred vercel[/bold]   — add your Vercel token")
+    ui.console.print("    3. [bold]forge link[/bold]              — link this repo to the project")

forge_cicd-0.1.0/forge/commands/credentials.py

@@ -0,0 +1,66 @@
+import typer
+import requests
+import os
+from forge.config import load_config
+from forge import ui
+
+BACKEND_URL = os.getenv("FORGE_BACKEND_URL", "https://forge-backend-wwp9.onrender.com")
+
+_VALID_PROVIDERS = ["railway", "vercel"]
+
+
+def set_credential(
+    provider: str = typer.Argument(
+        ...,
+        help="Hosting provider: railway or vercel",
+    ),
+    token: str = typer.Option(
+        ...,
+        prompt="API token",
+        hide_input=True,
+        help="API key / token for the provider (input is hidden)",
+    ),
+):
+    """
+    Save a hosting provider API token.
+
+    The token is encrypted at rest and never stored locally.
+    Run this once per provider before your first deployment.
+
+    \b
+    Valid options:
+      railway  — Railway API token
+      vercel   — Vercel personal access token
+    """
+
+    if provider not in _VALID_PROVIDERS:
+        ui.error(
+            f"Unknown provider '{provider}'. "
+            f"Valid options: {', '.join(_VALID_PROVIDERS)}"
+        )
+        raise typer.Exit(1)
+
+    try:
+        cfg = load_config()
+    except Exception:
+        ui.error("Not initialized. Run [bold]forge init[/bold] first.")
+        raise typer.Exit(1)
+
+    session_token = cfg.get("session_token")
+    if not session_token:
+        ui.error("Not authenticated. Run [bold]forge login[/bold] first.")
+        raise typer.Exit(1)
+
+    with ui.console.status(f"[dim]Saving {provider} credentials...[/dim]", spinner="dots"):
+        r = requests.post(
+            f"{BACKEND_URL}/credentials",
+            json={"provider": provider, "token": token},
+            headers={"Authorization": f"Bearer {session_token}"},
+            timeout=10,
+        )
+
+    if r.status_code == 200:
+        ui.success(f"{provider.capitalize()} credentials saved.")
+    else:
+        ui.error(f"Failed to save credentials: {r.text}")
+        raise typer.Exit(1)

forge_cicd-0.1.0/forge/commands/deploy.py

@@ -0,0 +1,99 @@
+import typer
+import requests
+import os
+import time
+import webbrowser
+from forge.config import load_config
+from forge import ui
+from rich.live import Live
+
+BACKEND_URL = os.getenv("FORGE_BACKEND_URL", "https://forge-backend-wwp9.onrender.com")
+
+def deploy():
+    """
+    Trigger a deployment and follow its progress in real-time.
+    """
+    try:
+        cfg = load_config()
+    except Exception:
+        ui.error("Not initialized. Run [bold]forge init[/bold] first.")
+        raise typer.Exit(1)
+
+    project_id = cfg.get("project_id")
+    token      = cfg.get("session_token")
+
+    if not project_id or not token:
+        ui.error("Not linked or authenticated. Run [bold]forge link[/bold] and [bold]forge login[/bold].")
+        raise typer.Exit(1)
+
+    # 1. Trigger Deployment
+    ui.info(f"Initiating deployment for project [cyan]{project_id}[/cyan]...")
+    try:
+        r = requests.post(
+            f"{BACKEND_URL}/projects/{project_id}/deploy",
+            headers={"Authorization": f"Bearer {token}"},
+            timeout=15,
+        )
+    except requests.RequestException as e:
+        ui.error(f"Failed to reach backend: {e}")
+        raise typer.Exit(1)
+
+    if r.status_code != 200:
+        ui.error(f"Deployment trigger failed ({r.status_code}): {r.text}")
+        raise typer.Exit(1)
+
+    ui.success("Deployment sequence started! Tracking progress...")
+    ui.blank()
+
+    # 2. Polling Loop with Live UI
+    last_status = None
+    with Live(ui.console.print("[dim]Waiting for status...[/dim]"), refresh_per_second=1) as live:
+        while True:
+            try:
+                status_res = requests.get(
+                    f"{BACKEND_URL}/projects/{project_id}/deploy/status",
+                    headers={"Authorization": f"Bearer {token}"},
+                    timeout=10,
+                )
+                if status_res.status_code != 200:
+                    continue
+
+                data = status_res.json()
+                raw_status = data.get("deploy_status") or "unknown"
+                components = data.get("components") or {}
+
+                # Update the Live display
+                # We reuse your component table logic for the UI
+                live.update(ui.render_deployment_progress(raw_status, components))
+
+                if "success" in raw_status.lower() or "failed" in raw_status.lower():
+                    last_status = data
+                    break
+
+            except Exception:
+                pass # Continue polling on transient network errors
+
+            time.sleep(3) # Poll every 3 seconds
+
+    # 3. Final Result Handling
+    raw_final_status = last_status.get("deploy_status", "unknown")
+    components = last_status.get("components", {})
+
+    if raw_final_status == "success":
+        ui.blank()
+        ui.success("Deployment complete.")
+        
+        # Automatically open the primary frontend URL
+        for name, info in components.items():
+            url = info.get("url")
+            if url and ("vercel.app" in url or "vercel.com" in url):
+                ui.info(f"Opening [cyan]{url}[/cyan] in browser...")
+                try:
+                    webbrowser.open(url)
+                except Exception:
+                    pass
+                break
+    else:
+        ui.blank()
+        ui.error(f"Deployment failed: {raw_final_status}")
+        ui.info("Check logs or dashboard for details.")

forge_cicd-0.1.0/forge/commands/deploy_status.py

@@ -0,0 +1,117 @@
+import typer
+import requests
+import os
+import webbrowser
+from forge.config import load_config
+from forge import ui
+
+BACKEND_URL = os.getenv("FORGE_BACKEND_URL", "https://forge-backend-wwp9.onrender.com")
+
+
+def deploy_status():
+    """
+    Show the current status of the most recent deployment.
+    A full deployment across multiple components can take
+    several minutes depending on your Railway and Vercel configurations.
+    """
+
+    try:
+        cfg = load_config()
+    except Exception:
+        ui.error("Not initialized. Run [bold]forge init[/bold] first.")
+        raise typer.Exit(1)
+
+    project_id = cfg.get("project_id")
+    if not project_id:
+        ui.error("Not linked to a project. Run [bold]forge link[/bold] first.")
+        raise typer.Exit(1)
+
+    token = cfg.get("session_token")
+    if not token:
+        ui.error("Not authenticated. Run [bold]forge login[/bold] first.")
+        raise typer.Exit(1)
+
+    try:
+        r = requests.get(
+            f"{BACKEND_URL}/projects/{project_id}/deploy/status",
+            headers={"Authorization": f"Bearer {token}"},
+            timeout=10,
+        )
+    except requests.RequestException as e:
+        ui.error(f"Request failed: {e}")
+        raise typer.Exit(1)
+
+    if r.status_code != 200:
+        ui.error(f"Could not fetch deployment status ({r.status_code}).")
+        raise typer.Exit(1)
+
+    data       = r.json()
+    raw_status = data.get("deploy_status") or "unknown"
+    components = data.get("components") or {}
+
+    # ── Header ────────────────────────────────────────────────────────────────
+    ui.blank()
+    ui.label("Project",    project_id)
+    ui.console.print(f"  [dim]{'Status':<14}[/dim]", end="")
+    ui.console.print(ui.status_badge(raw_status))
+    ui.blank()
+
+    if raw_status == "no_deployment_found":
+        ui.warn("No deployment has been triggered yet. Run [bold]forge deploy[/bold] first.")
+        return
+
+    # ── Component breakdown ───────────────────────────────────────────────────
+    if components:
+        ui.console.rule("[dim]Components[/dim]", style="dim")
+        ui.blank()
+        ui.deploy_components_table(components)
+
+    # ── Final outcome ─────────────────────────────────────────────────────────
+    if raw_status == "success":
+        ui.blank()
+        ui.success("Deployment complete.")
+
+        # Open the first Vercel URL in the browser
+        for name, info in components.items():
+            url = info.get("url") or ""
+            if "vercel.app" in url or "vercel.com" in url:
+                ui.info(f"Opening [cyan]{url}[/cyan] in your browser.")
+                try:
+                    webbrowser.open(url)
+                except Exception:
+                    pass
+                break
+
+    elif "failed" in raw_status.lower():
+        ui.blank()
+        reason = raw_status.replace("failed: ", "").strip()
+        
+        if "GITHUB_INTEGRATION_MISSING" in reason:
+            parts = reason.split("|")
+            provider_part = parts[0].split(":")[1].strip().lower()
+            repo = parts[1].strip() if len(parts) > 1 else "your repository"
+            
+            app_name = "Railway" if provider_part == "railway" else "Vercel"
+            provider_part = "railway-app" if provider_part == "railway" else "vercel"
+            app_url = f"https://github.com/apps/{provider_part}"
+
+            ui.error(f"Deployment failed: {app_name} cannot access your repository.")
+            ui.blank()
+            ui.rule("Action Required")
+            ui.blank()
+            ui.info(f"The {app_name} GitHub App is not installed or lacks permissions.")
+            ui.blank()
+            
+            ui.label("1. Install", app_url)
+            ui.label("2. Permission", f"Grant access to: {repo}")
+            ui.label("3. Retry", "Run [bold]forge deploy[/bold] again")
+            
+            ui.blank()
+            ui.rule()
+        else:
+            ui.error(f"Deployment failed: {reason}")
+            ui.info("Check your Railway / Vercel dashboard for detailed logs.")
+
+    else:
+        ui.blank()
+        ui.info("Deployment is in progress. Run this command again to check for updates.")

forge_cicd-0.1.0/forge/commands/init.py

@@ -0,0 +1,35 @@
+import typer
+import os
+import subprocess
+from forge.config import load_config, save_config
+from forge import ui
+
+
+def init():
+    """Initialize forge in the current git repository."""
+
+    if not os.path.exists(".git"):
+        ui.error("Not a git repository. Run this command from your project root.")
+        raise typer.Exit(1)
+
+    try:
+        repo = subprocess.check_output(
+            ["git", "remote", "get-url", "origin"],
+            stderr=subprocess.DEVNULL,
+        ).decode().strip()
+    except Exception:
+        repo = "unknown"
+
+    try:
+        config = load_config()
+    except Exception:
+        config = {}
+
+    config["repo"] = repo
+    save_config(config)
+
+    ui.success("forge initialized")
+    ui.blank()
+    ui.label("Repository", repo)
+    ui.blank()
+    ui.info("Next: run [bold]forge login[/bold] to authenticate with GitHub.")