repro-cli 0.1.0__tar.gz → 0.2.1__tar.gz

repro_cli-0.2.1/LICENSE

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

repro_cli-0.2.1/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: repro-cli
+Version: 0.2.1
+Summary: Disposable Docker environments for any GitHub issue
+Author: Sukhdev Thukral
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# REPRO
+<img width="1279" height="238" alt="Screenshot 2026-08-09 203800" src="https://github.com/user-attachments/assets/f6c12a93-be02-45f3-a237-d310c24ac395" />
+
+> Disposable Docker environments for any GitHub issue.
+One command. No setup.
+<br>
+<img width="800" height="456" alt="ezgif com-video-to-gif-converter" src="https://github.com/user-attachments/assets/635990fc-ae46-4995-aded-c74b965c0c1d" />
+<br>
+
+```bash
+pip install repro-cli
+repro https://github.com/org/repo/issues/42
+```
+
+That's it, your terminal boots an isolated sandbox - repo cloned, dependencies installed and IF you have VS Code, it opens automatically **attached directly to the container** so you get a real editor and a single unified terminal, not just a shell. Type `exit` and the container disappears. Your files stay on disk, exactly where they were.
+
+---
+
+## Install
+
+```bash
+pip install repro-cli
+```
+
+**Requirements:**
+- Python 3.9+
+- [Docker](https://docs.docker.com/get-docker/) (INSTALLED AND RUNNING)
+- VS Code (optional, but recommended - enables the unified editor/terminal experience below)
+ 
+---
+
+## Usage
+
+```bash
+# Open a sandbox for any publish GitHub issue
+repro https://github.com/org/repo/issues/123
+```
+
+```bash
+#Forward a port (e.g. to view a web app running inside the sandbox)
+repro https://github.com/org/repo/issues/123 -p 3000
+```
+
+```bash
+# Map a different host port to a container port
+repro https://github.com/org/repo/issues/123 -p 8080:3000
+```
+
+```bash
+# Private repos - pass a GitHub token
+repro https://github.com/org/private-repo/issues/7 --token ghp_xxx
+```
+
+```bash
+#Or set it once as an env var instead of typing it every single time!
+export DEVSANDBOX_GITHUB_TOKEN=ghp_xxx
+repro https://github.com/org/private-repo/issues/7
+```
+
+```bash
+# Skip auto-opening an editor
+repro https://github.com/org/repo/issues/123 --no-editor
+```
+
+```bash
+#Help
+repro --help
+```
+
+## What it does
+
+1. **Processes** the GitHub issue URL
+2. **Detects** the repo's runtime i.e Node, Python, Go, Rust, Ruby, PHP, Java, or a devcontainer based on whats actually in the repo.
+3. **Spins up** a disposable, isolated Docker container with the right base image.
+4. **Bind-mounts** a real folder on your machine into the container, so nothing is trapped and files persist after you exit
+5. **Clones** the repo directly into that shared folder and install dependencies
+6. **Attaches VS Code directly to the running container** (auto-installing the Dev Containers extension if needed) - one window, one terminal, running *inside* the sandbox.
+7. *Destroys* the container the moment you exit. Your edited files remain exactly where they were.
+
+---
+
+## The unified editor experience
+
+- **Real editor**: VS Code attaches directly into the container, so its built-in terminal *is* the sandbox shell
+- **Real persistence**: because the folder is bind-mounted, not just cloned inside the container, your work survives after `exit`.
+If VS Code isn't installed, `repro` falls back gracefully, you still get a real folder path printed at the end, ready to open in whatever editor you use.
+
+---
+
+## Supported runtimes
+| File detected | Runtime | Base image |
+|---|---|---|
+| `package.json` | Node.js | `node:20-alpine` |
+| `yarn.lock` | Node.js (yarn) | `node:20-alpine` |
+| `pnpm-lock.yaml` | Node.js (pnpm) | `node:20-alpine` |
+| `requirements.txt` | Python | `python:3.12-slim` |
+| `pyproject.toml` | Python | `python:3.12-slim` |
+| `Pipfile` | Python (pipenv) | `python:3.12-slim` |
+| `go.mod` | Go | `golang:1.21-alpine` |
+| `Cargo.toml` | Rust | `rust:1.75-slim` |
+| `Gemfile` | Ruby | `ruby:3.3-slim` |
+| `composer.json` | PHP | `php:8.3-cli` |
+| `pom.xml` | Java (Maven) | `maven:3.9-eclipse-temurin-21` |
+| `build.gradle` | Java (Gradle) | `gradle:8-jdk21` |
+| `.devcontainer` | devcontainer | MS universal image |
+| *(none matched)* | Universal fallback | `ubuntu:22.04` |
+
+---
+
+## The GitHub App
+
+Install [**repro-sandbox-bot**](https://github.com/apps/repro-sandbox-bot) on any repo and it automatically comments the exact `repro` command on every new issue, so that contributors never have to think about setup.
+
+```
+🏖 Open this issue in DevSandbox
+ 
+Spin up a disposable Docker environment with this repo already checked out:
+ 
+    repro https://github.com/org/repo/issues/42
+ 
+Don't have repro yet? Install it here.
+ 
+Comment /sandbox on any issue to get this again.
+```
+
+You can also trigger it on demand by commenting `/sandbox` on any issue. The bot runs 24/7, independent of your machine.
+
+---
+## Contributing 
+PRs welcome. Open an issue first for anything beyond small fixes - and yes, you can use `repro` itself to work on `repro`.
+
+## License
+
+MIT

repro_cli-0.2.1/README.md

@@ -0,0 +1,134 @@
+# REPRO
+<img width="1279" height="238" alt="Screenshot 2026-08-09 203800" src="https://github.com/user-attachments/assets/f6c12a93-be02-45f3-a237-d310c24ac395" />
+
+> Disposable Docker environments for any GitHub issue.
+One command. No setup.
+<br>
+<img width="800" height="456" alt="ezgif com-video-to-gif-converter" src="https://github.com/user-attachments/assets/635990fc-ae46-4995-aded-c74b965c0c1d" />
+<br>
+
+```bash
+pip install repro-cli
+repro https://github.com/org/repo/issues/42
+```
+
+That's it, your terminal boots an isolated sandbox - repo cloned, dependencies installed and IF you have VS Code, it opens automatically **attached directly to the container** so you get a real editor and a single unified terminal, not just a shell. Type `exit` and the container disappears. Your files stay on disk, exactly where they were.
+
+---
+
+## Install
+
+```bash
+pip install repro-cli
+```
+
+**Requirements:**
+- Python 3.9+
+- [Docker](https://docs.docker.com/get-docker/) (INSTALLED AND RUNNING)
+- VS Code (optional, but recommended - enables the unified editor/terminal experience below)
+ 
+---
+
+## Usage
+
+```bash
+# Open a sandbox for any publish GitHub issue
+repro https://github.com/org/repo/issues/123
+```
+
+```bash
+#Forward a port (e.g. to view a web app running inside the sandbox)
+repro https://github.com/org/repo/issues/123 -p 3000
+```
+
+```bash
+# Map a different host port to a container port
+repro https://github.com/org/repo/issues/123 -p 8080:3000
+```
+
+```bash
+# Private repos - pass a GitHub token
+repro https://github.com/org/private-repo/issues/7 --token ghp_xxx
+```
+
+```bash
+#Or set it once as an env var instead of typing it every single time!
+export DEVSANDBOX_GITHUB_TOKEN=ghp_xxx
+repro https://github.com/org/private-repo/issues/7
+```
+
+```bash
+# Skip auto-opening an editor
+repro https://github.com/org/repo/issues/123 --no-editor
+```
+
+```bash
+#Help
+repro --help
+```
+
+## What it does
+
+1. **Processes** the GitHub issue URL
+2. **Detects** the repo's runtime i.e Node, Python, Go, Rust, Ruby, PHP, Java, or a devcontainer based on whats actually in the repo.
+3. **Spins up** a disposable, isolated Docker container with the right base image.
+4. **Bind-mounts** a real folder on your machine into the container, so nothing is trapped and files persist after you exit
+5. **Clones** the repo directly into that shared folder and install dependencies
+6. **Attaches VS Code directly to the running container** (auto-installing the Dev Containers extension if needed) - one window, one terminal, running *inside* the sandbox.
+7. *Destroys* the container the moment you exit. Your edited files remain exactly where they were.
+
+---
+
+## The unified editor experience
+
+- **Real editor**: VS Code attaches directly into the container, so its built-in terminal *is* the sandbox shell
+- **Real persistence**: because the folder is bind-mounted, not just cloned inside the container, your work survives after `exit`.
+If VS Code isn't installed, `repro` falls back gracefully, you still get a real folder path printed at the end, ready to open in whatever editor you use.
+
+---
+
+## Supported runtimes
+| File detected | Runtime | Base image |
+|---|---|---|
+| `package.json` | Node.js | `node:20-alpine` |
+| `yarn.lock` | Node.js (yarn) | `node:20-alpine` |
+| `pnpm-lock.yaml` | Node.js (pnpm) | `node:20-alpine` |
+| `requirements.txt` | Python | `python:3.12-slim` |
+| `pyproject.toml` | Python | `python:3.12-slim` |
+| `Pipfile` | Python (pipenv) | `python:3.12-slim` |
+| `go.mod` | Go | `golang:1.21-alpine` |
+| `Cargo.toml` | Rust | `rust:1.75-slim` |
+| `Gemfile` | Ruby | `ruby:3.3-slim` |
+| `composer.json` | PHP | `php:8.3-cli` |
+| `pom.xml` | Java (Maven) | `maven:3.9-eclipse-temurin-21` |
+| `build.gradle` | Java (Gradle) | `gradle:8-jdk21` |
+| `.devcontainer` | devcontainer | MS universal image |
+| *(none matched)* | Universal fallback | `ubuntu:22.04` |
+
+---
+
+## The GitHub App
+
+Install [**repro-sandbox-bot**](https://github.com/apps/repro-sandbox-bot) on any repo and it automatically comments the exact `repro` command on every new issue, so that contributors never have to think about setup.
+
+```
+🏖 Open this issue in DevSandbox
+ 
+Spin up a disposable Docker environment with this repo already checked out:
+ 
+    repro https://github.com/org/repo/issues/42
+ 
+Don't have repro yet? Install it here.
+ 
+Comment /sandbox on any issue to get this again.
+```
+
+You can also trigger it on demand by commenting `/sandbox` on any issue. The bot runs 24/7, independent of your machine.
+
+---
+## Contributing 
+PRs welcome. Open an issue first for anything beyond small fixes - and yes, you can use `repro` itself to work on `repro`.
+
+## License
+
+MIT

{repro_cli-0.1.0 → repro_cli-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name="repro-cli"
-version="0.1.0"
+version="0.2.1"
 description = "Disposable Docker environments for any GitHub issue"
 readme="README.md"
 requires-python=">=3.9"

repro_cli-0.2.1/repro/docker/runner.py

@@ -0,0 +1,290 @@
+import os 
+import shutil
+import re
+import subprocess
+import tempfile
+import threading
+import time
+
+class DockerNotFoundError(Exception):
+    pass
+
+class DockerNotRunningError(Exception):
+    pass
+
+class InvalidPortError(Exception):
+    pass
+
+class InvalidRepoError(Exception):
+    pass
+
+SAFE_NAME = re.compile(r"^[A-Za-z0-9._-]+$")
+
+def check_docker_available():
+    """Verify Docker CLI exists and the daemon is reachable before trying anythg"""
+    if shutil.which("docker") is None:
+        raise DockerNotFoundError(
+            "Docker is not installed or not on your PATH.\n"
+            "   Install it from: https://docs.docker.com/get-docker/"
+        )
+
+    result = subprocess.run(["docker", "info"], capture_output=True, text=True)
+    if result.returncode != 0:
+        raise DockerNotRunningError(
+            "Docker is installed but the daemon isnt running.\n"
+            "   Start Docker Desktop and wait for the icon to go steady, then try again."
+        )
+
+
+def validate_repo_identifiers(owner: str, repo:str):
+    """ Guard against shell injection -> owner/repo gets interpolated into a shell command, so anything outside GitHub's allowed charst is rejected 
+    before it even reaches da subprocess"""
+    for label, value in (("owner", owner), ("repo", repo)):
+        if not SAFE_NAME.match(value):
+            raise InvalidRepoError(f'invalid {label} "{value}" - contains disallowed characters')
+        if value in (".", ".."):
+            raise InvalidRepoError(f'invalid {label} "{value}"')
+        if value.startswith("."):
+            raise InvalidRepoError(f'invalid {label} "{value}" - cannot start with a dot')
+
+
+def parse_port_spec(spec: str) -> tuple[int, int]:
+    """ Parse a --port value into (host_port, container_port).
+        Accepts "3000" (same both sides) or "8080:3000" (host:container).
+    """
+    parts = spec.split(":")
+
+    if len(parts) == 1:
+        host, container = parts[0], parts[0]
+    elif len(parts) == 2:
+        host, container = parts
+    else:
+        raise InvalidPortError(f'invalid port spec "{spec}" - use PORT or HOST:CONTAINER')
+
+    for label, value in (("host", host), ("container", container)):
+        if not value.isdigit():
+            raise InvalidPortError(f'invalid {label} port "{value}" in "{spec}" - must be a number')
+        port_num = int(value)
+        if not(1 <= port_num <= 65535):
+            raise InvalidPortError(f'{label} port {port_num} out of range (1-65535)')
+
+    return int(host), int(container)
+
+DEVCONTAINERS_EXT_ID = "ms-vscode-remote.remote-containers"
+
+def has_devcontainers_extension() -> bool:
+    """Check if VS Code's DEV containers extension is installed"""
+    try:
+        result = subprocess.run(
+            ["code", "--list-extensions"],
+            capture_output=True, text=True, timeout=5,
+            shell=(os.name == "nt"),
+        )
+        return DEVCONTAINERS_EXT_ID in result.stdout
+    except Exception:
+        return False
+
+def install_devcontainers_extension() -> bool:
+    print("📦 Installing VS Code's 'Dev Containers' extension (one-time setup)...")
+    try:
+        result = subprocess.run(
+            ["code", "--install-extension", DEVCONTAINERS_EXT_ID],
+            capture_output=True, text=True, timeout=60,
+            shell=(os.name=="nt")
+        )
+        if result.returncode == 0:
+            print("✅ Dev Containers extension installed.\n")
+            return True
+        print("⚠️  Couldn't auto-install the extension. Falling back to folder mode.\n")
+        return False
+    except Exception as e:
+        print(f"⚠️  Couldn't auto-install the extension ({e}). Falling back to folder mode.\n")
+        return False
+
+def attach_vscode_to_container(container_name: str, work_dir:str):
+    for _ in range(20):
+        result = subprocess.run(
+            ["docker", "inspect", "--format", "{{.State.Running}}", container_name],
+            capture_output=True, text=True,
+        )
+        if result.returncode == 0 and result.stdout.strip() == "true":
+            break
+        time.sleep(0.5)
+    else:
+        return
+
+    id_result = subprocess.run(
+        ["docker", "inspect", "--format", "{{.Id}}", container_name],
+        capture_output=True, text=True,
+    )
+    if id_result.returncode != 0:
+        return
+
+    container_id =  id_result.stdout.strip()
+    hex_id = container_id.encode().hex()
+    uri = f"vscode-remote://attached-container+{hex_id}{work_dir}"
+
+    try:
+        subprocess.Popen(["code", "--folder-uri", uri], shell=(os.name=="nt"))
+    except Exception:
+        pass
+
+def run_sandbox(issue: dict, runtime: dict, ports: list =None, token: str = None, no_editor: bool = False):
+    check_docker_available()
+    ports = ports or []
+
+    owner = issue["owner"]
+    repo = issue["repo"]
+    number = issue["number"]
+
+    validate_repo_identifiers(owner, repo)
+
+    if not isinstance(number, int):
+        raise InvalidRepoError("issue number must be an integer")
+
+    clone_url_public = f"https://github.com/{owner}/{repo}.git"
+    work_dir = f"/sandbox/{repo}"
+    container_name = f"repro-{owner}-{repo}-{number}"
+
+    subprocess.run(["docker", "rm", "-f", container_name], capture_output=True)
+
+    host_dir = tempfile.mkdtemp(prefix=f"repro-{owner}-{repo}-{number}-")
+
+    print(f"📁 Sandbox files will live at: {host_dir}")
+    print("     (this folder survives after you exit - edit here with your own editor)\n")
+
+    editor_mode = None
+    if not no_editor and shutil.which("code"):
+        if not has_devcontainers_extension():
+            install_devcontainers_extension()
+            
+        if has_devcontainers_extension():
+            editor_mode="attached"
+            print("🖊️  VS Code will attach directly to the container once it's up...")
+            print("   (its built-in terminal will run INSIDE the sandbox — one window, no split)\n")
+        else:
+            editor_mode= "folder"
+            print("🖊️  Opening the folder in VS Code (editing only)...")
+            print("   💡 Install the 'Dev Containers' extension for a fully unified terminal.\n")
+    elif not no_editor:
+        print("💡 No auto-attach editor detected (currently supports VS Code :( .\n")
+        print(" Open the folder above in whatever editor you use - its a real folder on your machine!! .\n")
+
+    startup_script = build_startup_script(clone_url_public, work_dir, runtime["install"], number, ports, has_token=bool(token))
+
+    args = [
+        "docker", "run",
+        "--rm",
+        "-i",
+        "-t",
+        "--name", container_name,
+        "--hostname", f"sandbox-issue-{number}",
+        "-v", f"{host_dir}:{work_dir}",
+        "-e", f"ISSUE_NUMBER={number}",
+        "-e", f"REPO={owner}/{repo}",
+        "-e", "TERM=xterm-256color",
+    ]
+
+    for host_port, container_port in ports:
+        args += ["-p", f"127.0.0.1:{host_port}:{container_port}"]
+
+    env_file_path = None
+    if token:
+        fd, env_file_path = tempfile.mkstemp(prefix="repro-", suffix=".env")
+        try:
+            os.chmod(env_file_path, 0o600)
+            with os.fdopen(fd, "w") as f:
+                f.write(f"GIT_TOKEN={token}\n")
+            args+=["--env-file", env_file_path]
+        except Exception:
+            if os.path.exists(env_file_path):
+                os.remove(env_file_path)
+            raise
+
+    args += [runtime["image"], "sh", "-c", startup_script]
+
+    print(f"🚀 Starting sandbox for {owner}/{repo} issue #{number}")
+    print("     (container will be deleted automatically when you exit)\n")
+
+    env = os.environ.copy()
+    env["DOCKER_CLI_HINTS"] = "false"
+
+    if editor_mode == "attached":
+        threading.Thread(
+            target=attach_vscode_to_container,
+            args=(container_name, work_dir),
+            daemon=True,
+        ).start()
+    elif editor_mode == "folder":
+        try:
+            subprocess.Popen(["code", host_dir], shell=(os.name=="nt"))
+        except Exception as e:
+            print(f"⚠️  Couldn't auto-open VS Code: {e}\n")
+
+    try:
+        try:
+            result = subprocess.run(args, env=env)
+        except KeyboardInterrupt:
+            print("Interrupted - cleaning up the sandbox...")
+            return
+        
+        if result.returncode not in (0,130):
+            if result.returncode == 125:
+                print(f"\n⚠️  Docker couldn't start the container (exit 125) — this often means"
+                      f"the image failed to pull. Check your internet connection and try again.")
+            else:
+                print(f"Sandbox exited with code {result.returncode} - check the output above.")
+            return
+
+        print("\n Sandbox destroyed. Back to reality.")
+
+    finally:
+        if env_file_path and os.path.exists(env_file_path):
+            os.remove(env_file_path)
+    print(f"📁 Your files are still here: {host_dir}")
+    print("   (delete manually whenever you're done)")
+
+def build_startup_script(clone_url_public, work_dir, install_cmd, issue_number, ports, has_token: bool = False) -> str:
+    install_step = (
+        f'echo "Installing dependencies....." && {install_cmd}'
+        if install_cmd
+        else 'echo "No install step, dropping into shell... "'
+    )
+
+    host_and_path = clone_url_public[len("https://"):]
+    clone_cmd = (
+        f'if [ -n "$GIT_TOKEN" ]; then '
+        f'CLONE_URL="https://${{GIT_TOKEN}}@{host_and_path}";'
+        f'else CLONE_URL="{clone_url_public}"; fi && '
+        f'git clone --depth=1 "$CLONE_URL" {work_dir}'
+        f'|| (echo "❌ Clone failed — check the repo exists, the URL is correct, and your token has access." && exit 1)'
+    )
+
+    lines = [
+        "set -e",
+        "which git > /dev/null 2>&1 || (apk add --no-cache git curl 2>/dev/null || (apt-get update -qq && apt-get install -y -qq git  curl))",
+        'echo ""',
+        'echo "=================================="',
+        f'echo "  Repro - Issue #{issue_number}"',
+        'echo "=================================="',
+        'echo ""',
+        f'echo "Cloning repo..."',
+        clone_cmd,
+        f"cd {work_dir} && git remote set-url origin {clone_url_public} && unset GIT_TOKEN",
+        install_step,
+        'echo ""',
+        f'echo "Ready! You are in: {work_dir}"',
+        f'echo "Working on issue #{issue_number}"',
+    ]
+
+    if ports:
+        lines.append('echo ""')
+        for host_port, container_port in ports:
+            lines.append(f'echo "Port {container_port} forwarded -> http://localhost:{host_port}"')
+        lines.append('echo "  Start your app inside this shell (e.g. npm start / node server.js) to use it."')
+
+    lines.append('echo ""')
+    lines.append(f"cd {work_dir} && exec sh")
+
+
+    return " && ".join(lines)

repro_cli-0.2.1/repro_cli.egg-info/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: repro-cli
+Version: 0.2.1
+Summary: Disposable Docker environments for any GitHub issue
+Author: Sukhdev Thukral
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# REPRO
+<img width="1279" height="238" alt="Screenshot 2026-08-09 203800" src="https://github.com/user-attachments/assets/f6c12a93-be02-45f3-a237-d310c24ac395" />
+
+> Disposable Docker environments for any GitHub issue.
+One command. No setup.
+<br>
+<img width="800" height="456" alt="ezgif com-video-to-gif-converter" src="https://github.com/user-attachments/assets/635990fc-ae46-4995-aded-c74b965c0c1d" />
+<br>
+
+```bash
+pip install repro-cli
+repro https://github.com/org/repo/issues/42
+```
+
+That's it, your terminal boots an isolated sandbox - repo cloned, dependencies installed and IF you have VS Code, it opens automatically **attached directly to the container** so you get a real editor and a single unified terminal, not just a shell. Type `exit` and the container disappears. Your files stay on disk, exactly where they were.
+
+---
+
+## Install
+
+```bash
+pip install repro-cli
+```
+
+**Requirements:**
+- Python 3.9+
+- [Docker](https://docs.docker.com/get-docker/) (INSTALLED AND RUNNING)
+- VS Code (optional, but recommended - enables the unified editor/terminal experience below)
+ 
+---
+
+## Usage
+
+```bash
+# Open a sandbox for any publish GitHub issue
+repro https://github.com/org/repo/issues/123
+```
+
+```bash
+#Forward a port (e.g. to view a web app running inside the sandbox)
+repro https://github.com/org/repo/issues/123 -p 3000
+```
+
+```bash
+# Map a different host port to a container port
+repro https://github.com/org/repo/issues/123 -p 8080:3000
+```
+
+```bash
+# Private repos - pass a GitHub token
+repro https://github.com/org/private-repo/issues/7 --token ghp_xxx
+```
+
+```bash
+#Or set it once as an env var instead of typing it every single time!
+export DEVSANDBOX_GITHUB_TOKEN=ghp_xxx
+repro https://github.com/org/private-repo/issues/7
+```
+
+```bash
+# Skip auto-opening an editor
+repro https://github.com/org/repo/issues/123 --no-editor
+```
+
+```bash
+#Help
+repro --help
+```
+
+## What it does
+
+1. **Processes** the GitHub issue URL
+2. **Detects** the repo's runtime i.e Node, Python, Go, Rust, Ruby, PHP, Java, or a devcontainer based on whats actually in the repo.
+3. **Spins up** a disposable, isolated Docker container with the right base image.
+4. **Bind-mounts** a real folder on your machine into the container, so nothing is trapped and files persist after you exit
+5. **Clones** the repo directly into that shared folder and install dependencies
+6. **Attaches VS Code directly to the running container** (auto-installing the Dev Containers extension if needed) - one window, one terminal, running *inside* the sandbox.
+7. *Destroys* the container the moment you exit. Your edited files remain exactly where they were.
+
+---
+
+## The unified editor experience
+
+- **Real editor**: VS Code attaches directly into the container, so its built-in terminal *is* the sandbox shell
+- **Real persistence**: because the folder is bind-mounted, not just cloned inside the container, your work survives after `exit`.
+If VS Code isn't installed, `repro` falls back gracefully, you still get a real folder path printed at the end, ready to open in whatever editor you use.
+
+---
+
+## Supported runtimes
+| File detected | Runtime | Base image |
+|---|---|---|
+| `package.json` | Node.js | `node:20-alpine` |
+| `yarn.lock` | Node.js (yarn) | `node:20-alpine` |
+| `pnpm-lock.yaml` | Node.js (pnpm) | `node:20-alpine` |
+| `requirements.txt` | Python | `python:3.12-slim` |
+| `pyproject.toml` | Python | `python:3.12-slim` |
+| `Pipfile` | Python (pipenv) | `python:3.12-slim` |
+| `go.mod` | Go | `golang:1.21-alpine` |
+| `Cargo.toml` | Rust | `rust:1.75-slim` |
+| `Gemfile` | Ruby | `ruby:3.3-slim` |
+| `composer.json` | PHP | `php:8.3-cli` |
+| `pom.xml` | Java (Maven) | `maven:3.9-eclipse-temurin-21` |
+| `build.gradle` | Java (Gradle) | `gradle:8-jdk21` |
+| `.devcontainer` | devcontainer | MS universal image |
+| *(none matched)* | Universal fallback | `ubuntu:22.04` |
+
+---
+
+## The GitHub App
+
+Install [**repro-sandbox-bot**](https://github.com/apps/repro-sandbox-bot) on any repo and it automatically comments the exact `repro` command on every new issue, so that contributors never have to think about setup.
+
+```
+🏖 Open this issue in DevSandbox
+ 
+Spin up a disposable Docker environment with this repo already checked out:
+ 
+    repro https://github.com/org/repo/issues/42
+ 
+Don't have repro yet? Install it here.
+ 
+Comment /sandbox on any issue to get this again.
+```
+
+You can also trigger it on demand by commenting `/sandbox` on any issue. The bot runs 24/7, independent of your machine.
+
+---
+## Contributing 
+PRs welcome. Open an issue first for anything beyond small fixes - and yes, you can use `repro` itself to work on `repro`.
+
+## License
+
+MIT

{repro_cli-0.1.0 → repro_cli-0.2.1}/repro_cli.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 repro/__init__.py

repro_cli-0.1.0/PKG-INFO

@@ -1,8 +0,0 @@
-Metadata-Version: 2.4
-Name: repro-cli
-Version: 0.1.0
-Summary: Disposable Docker environments for any GitHub issue
-Author: Sukhdev Thukral
-License-Expression: MIT
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown

repro_cli-0.1.0/repro/docker/runner.py

@@ -1,182 +0,0 @@
-import os 
-import shutil
-import re
-import subprocess
-import tempfile
-
-class DockerNotFoundError(Exception):
-    pass
-
-class DockerNotRunningError(Exception):
-    pass
-
-class InvalidPortError(Exception):
-    pass
-
-class InvalidRepoError(Exception):
-    pass
-
-SAFE_NAME = re.compile(r"^[A-Za-z0-9._-]+$")
-
-def check_docker_available():
-    """Verify Docker CLI exists and the daemon is reachable before trying anythg"""
-    if shutil.which("docker") is None:
-        raise DockerNotFoundError(
-            "Docker is not installed or not on your PATH.\n"
-            "   Install it from: https://docs.docker.com/get-docker/"
-        )
-
-    result = subprocess.run(["docker", "info"], capture_output=True, text=True)
-    if result.returncode != 0:
-        raise DockerNotRunningError(
-            "Docker is installed but the daemon isnt running.\n"
-            "   Start Docker Desktop and wait for the icon to go steady, then try again."
-        )
-
-def validate_repo_identifiers(owner: str, repo:str):
-    """ Guard against shell injection -> owner/repo gets interpolated into a shell command, so anything outside GitHub's allowed charst is rejected 
-    before it even reaches da subprocess"""
-    for label, value in (("owner", owner), ("repo", repo)):
-        if not SAFE_NAME.match(value):
-            raise InvalidRepoError(f'invalid {label} "{value}" - contains disallowed characters')
-        if value in (".", ".."):
-            raise InvalidRepoError(f'invalid {label} "{value}"')
-        if value.startswith("."):
-            raise InvalidRepoError(f'invalid {label} "{value}" - cannot start with a dot')
-
-
-def parse_port_spec(spec: str) -> tuple[int, int]:
-    """ Parse a --port value into (host_port, container_port).
-        Accepts "3000" (same both sides) or "8080:3000" (host:container).
-    """
-    parts = spec.split(":")
-
-    if len(parts) == 1:
-        host, container = parts[0], parts[0]
-    elif len(parts) == 2:
-        host, container = parts
-    else:
-        raise InvalidPortError(f'invalid port spec "{spec}" - use PORT or HOST:CONTAINER')
-
-    for label, value in (("host", host), ("container", container)):
-        if not value.isdigit():
-            raise InvalidPortError(f'invalid {label} port "{value}" in "{spec}" - must be a number')
-        port_num = int(value)
-        if not(1 <= port_num <= 65535):
-            raise InvalidPortError(f'{label} port {port_num} out of range (1-65535)')
-
-    return int(host), int(container)
-
-def run_sandbox(issue: dict, runtime: dict, ports: list =None, token: str = None):
-    check_docker_available()
-    ports = ports or []
-
-    owner = issue["owner"]
-    repo = issue["repo"]
-    number = issue["number"]
-
-    validate_repo_identifiers(owner, repo)
-
-    if not isinstance(number, int):
-        raise InvalidRepoError("issue number must be an integer")
-
-    clone_url_public = f"https://github.com/{owner}/{repo}.git"
-    clone_url_auth = f"https://{token}@github.com/{owner}/{repo}.git" if token else clone_url_public
-
-    work_dir = f"/sandbox/{repo}"
-    container_name = f"repro-{owner}-{repo}-{number}"
-
-    startup_script = build_startup_script(clone_url_auth, clone_url_public, work_dir, runtime["install"], number, ports, has_token=bool(token))
-
-    args = [
-        "docker", "run",
-        "--rm",
-        "-i",
-        "-t",
-        "--name", container_name,
-        "--hostname", f"sandbox-issue-{number}",
-        "-e", f"ISSUE_NUMBER={number}",
-        "-e", f"REPO={owner}/{repo}",
-        "-e", "TERM=xterm-256color",
-    ]
-
-    for host_port, container_port in ports:
-        args += ["-p", f"127.0.0.1:{host_port}:{container_port}"]
-
-    env_file_path = None
-    if token:
-        #writing the toekn to a temp file passed via --env-fle instead of -e/embedded-in-command
-        fd, env_file_path = tempfile.mkstemp(prefix="repro-", suffix=".env")
-        try:
-            os.chmod(env_file_path, 0o600)
-            with os.fdopen(fd, "w") as f:
-                f.write(f"GIT_TOKEN={token}\n")
-        except Exception:
-            if os.path.exists(env_file_path):
-                os.remove(env_file_path)
-            raise
-
-    args += [runtime["image"], "sh", "-c", startup_script]
-
-    print(f"Starting sandbox for {owner}/{repo} issue #{number}")
-    print("     (container will be deleted automatically when you exit)\n")
-
-    env = os.environ.copy()
-    env["DOCKER_CLI_HINTS"] = "false"
-
-    try:
-        result = subprocess.run(args, env=env)
-    except KeyboardInterrupt:
-        print("Interrupted - cleaning up the sandbox...")
-        return
-    
-    if result.returncode not in (0,130):
-        print(f"Sandbox exited with code {result.returncode} - check the output above.")
-        return
-
-    print("\n Sandbox destroyed. Back to reality.")
-
-def build_startup_script(clone_url_auth, clone_url_public, work_dir, install_cmd, issue_number, ports) -> str:
-    install_step = (
-        f'echo "Installing dependencies....." && {install_cmd}'
-        if install_cmd
-        else 'echo "No install step, dropping into shell... "'
-    )
-
-    host_and_path = clone_url_public[len("https://"):]
-    clone_cmd = (
-        f'if [ -n "$GIT_TOEKN" ]; then '
-        f'CLONE_URL="https://${{GIT_TOKEN}}@{host_and_path}";'
-        f'else CLONE_URL="{clone_url_public}"; fi && '
-        f'git clone --depth=1 "$CLONE_URL" {work_dir} 2>&1 | tail -5'
-    )
-
-    lines = [
-        "set -e",
-        "which git > /dev/null 2>&1 || (apk add --no-cache git curl)",
-        'echo ""',
-        'echo "=================================="',
-        f'echo "  DevSandbox - Issue #{issue_number}"',
-        'echo "=================================="',
-        'echo ""',
-        f'echo "Cloning repo..."',
-        clone_cmd,
-        f"git clone --depth=1 {clone_url_auth} {work_dir} 2>&1 | tail -5",
-        f"cd {work_dir} && git remote set-url origin {clone_url_public} && unset GIT_TOKEN",
-        install_step,
-        'echo ""',
-        f'echo "Ready! You are in: {work_dir}"',
-        f'echo "Working on issue #{issue_number}"',
-    ]
-
-    if ports:
-        lines.append('echo ""')
-        for host_port, container_port in ports:
-            lines.append(f'echo "Port {container_port} forwarded -> http://localhost:{host_port}"')
-        lines.append('echo "  Start your app inside this shell (e.g. npm start / node server.js) to use it."')
-
-    lines.append('echo ""')
-    lines.append(f"cd {work_dir} && exec sh")
-
-
-    return " && ".join(lines)

repro_cli-0.1.0/repro_cli.egg-info/PKG-INFO

@@ -1,8 +0,0 @@
-Metadata-Version: 2.4
-Name: repro-cli
-Version: 0.1.0
-Summary: Disposable Docker environments for any GitHub issue
-Author: Sukhdev Thukral
-License-Expression: MIT
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown