codedna 0.3.1__tar.gz → 0.3.3__tar.gz

{codedna-0.3.1 → codedna-0.3.3}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.3.3] - 2026-06-24 — "One-Command Update"
+
+### ✨ Added
+- **`codedna update` command** — self-upgrade from PyPI in a single command
+  - `codedna update` — upgrade to latest version
+  - `codedna update --check` — only check, do not install
+  - `codedna update --target 0.3.2` — install a specific version
+  - Auto-detects installer (`uv` first, falls back to `pip`)
+  - Verifies new version after install
+  - User no longer needs to remember `pip install --upgrade` or PATH dance
+- **`codedna update --check` exit code** — 0 if up-to-date, 1 if update available (CI-friendly)
+
+## [0.3.2] - 2026-06-24 — "Windows PATH Fix"
+
+### 📚 Documentation
+- **Windows PATH setup section** added to README
+  - Explains pip's "not on PATH" warning
+  - One-time PowerShell fix for current session
+  - Permanent fix via `[Environment]::SetEnvironmentVariable`
+  - Notes that macOS / Linux users are unaffected
+- **Verify Installation subsection** added (`codedna --version`, `codedna doctor`)
+
 ## [0.3.1] - 2026-06-24 — "Doctor Added"
 
 ### ✨ Added

{codedna-0.3.1 → codedna-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codedna
-Version: 0.3.1
+Version: 0.3.3
 Summary: AI Code Transparency Tool - detect AI-written code and measure developer understanding
 Project-URL: Homepage, https://codedna.dev
 Project-URL: Repository, https://github.com/natureco-official/codedna
@@ -167,6 +167,22 @@ cd codedna
 pip install -e .
 ```
 
+> ⚠️ **Windows users:** pip may warn *"The script codedna.exe is installed in '...' which is not on PATH"*. To fix:
+> ```powershell
+> # One-time setup (PowerShell, current user only)
+> $env:Path += ";$env:LocalAppData\Python\pythoncore-3.14-64\Scripts"
+> # Make it permanent:
+> [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:LocalAppData\Python\pythoncore-3.14-64\Scripts", "User")
+> ```
+> Then open a new PowerShell window and run `codedna --version`. **macOS / Linux** users don't need this — pip installs to `/usr/local/bin` or `~/.local/bin`, which is already on PATH.
+
+### Verify Installation
+
+```bash
+codedna --version   # should show "codedna 0.3.x"
+codedna doctor      # full system health check
+```
+
 ### First Use (60 seconds)
 
 ```bash

{codedna-0.3.1 → codedna-0.3.3}/README.md

@@ -115,6 +115,22 @@ cd codedna
 pip install -e .
 ```
 
+> ⚠️ **Windows users:** pip may warn *"The script codedna.exe is installed in '...' which is not on PATH"*. To fix:
+> ```powershell
+> # One-time setup (PowerShell, current user only)
+> $env:Path += ";$env:LocalAppData\Python\pythoncore-3.14-64\Scripts"
+> # Make it permanent:
+> [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:LocalAppData\Python\pythoncore-3.14-64\Scripts", "User")
+> ```
+> Then open a new PowerShell window and run `codedna --version`. **macOS / Linux** users don't need this — pip installs to `/usr/local/bin` or `~/.local/bin`, which is already on PATH.
+
+### Verify Installation
+
+```bash
+codedna --version   # should show "codedna 0.3.x"
+codedna doctor      # full system health check
+```
+
 ### First Use (60 seconds)
 
 ```bash

{codedna-0.3.1 → codedna-0.3.3}/codedna/__init__.py

@@ -1,4 +1,4 @@
 """CodeDNA — AI Code Transparency Tool."""
 
-__version__ = "0.3.1"
+__version__ = "0.3.3"
 __app_name__ = "codedna"

{codedna-0.3.1 → codedna-0.3.3}/codedna/cli.py

@@ -1885,6 +1885,108 @@ def doctor(
         raise typer.Exit(1)
 
 
+# ---------------------------------------------------------------------------
+# codedna update (self-upgrade from PyPI)
+# ---------------------------------------------------------------------------
+@app.command()
+def update(
+    check_only: bool = typer.Option(False, "--check", "-c", help="Only check for updates, do not install"),
+    target: Optional[str] = typer.Option(None, "--target", "-t", help="Install a specific version (e.g. 0.3.2)"),
+) -> None:
+    """Check for updates and upgrade CodeDNA to the latest PyPI release."""
+    import json
+    import urllib.request
+    import urllib.error
+
+    console.print(Panel.fit("🧬 CodeDNA — Update Check", style="bold cyan"))
+    console.print()
+
+    # 1. Get current version
+    import codedna
+    current = codedna.__version__
+    console.print(f"  Current version: [bold]{current}[/bold]")
+
+    # 2. Fetch latest version from PyPI
+    try:
+        req = urllib.request.Request(
+            "https://pypi.org/pypi/codedna/json",
+            headers={"Accept": "application/json", "User-Agent": "codedna-updater"},
+        )
+        with urllib.request.urlopen(req, timeout=10) as r:
+            data = json.loads(r.read())
+    except Exception as e:
+        console.print(f"  [red]✗[/red] Could not reach PyPI: {e}")
+        raise typer.Exit(1)
+
+    latest = data["info"]["version"]
+    desired = target or latest
+    console.print(f"  Latest version : [bold]{latest}[/bold]")
+
+    if target:
+        console.print(f"  Target version : [bold]{target}[/bold]")
+
+    # 3. Compare
+    def _parse(v: str) -> tuple[int, ...]:
+        return tuple(int(x) for x in v.split(".") if x.isdigit())
+
+    if _parse(current) >= _parse(desired) and not target:
+        console.print()
+        console.print(f"  [bold green]✓ Already on the latest version.[/bold green]")
+        return
+
+    console.print()
+    if check_only:
+        console.print(f"  [yellow]![/yellow] Update available: {current} → {desired}")
+        console.print(f"  [dim]Run [bold]codedna update[/bold] to install.[/dim]")
+        return
+
+    # 4. Detect installer (uv > pip)
+    import shutil
+    import subprocess
+
+    use_uv = shutil.which("uv") is not None
+    if use_uv:
+        cmd = ["uv", "tool", "install", "--force", f"codedna=={desired}"]
+        label = "uv tool install --force"
+    else:
+        cmd = [sys.executable, "-m", "pip", "install", "--upgrade", f"codedna=={desired}"]
+        label = "pip install --upgrade"
+
+    console.print(f"  [cyan]→[/cyan] Running: {label} codedna=={desired}")
+    try:
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=120)
+    except subprocess.TimeoutExpired:
+        console.print("  [red]✗[/red] Install timed out after 120s")
+        raise typer.Exit(1)
+    except Exception as e:
+        console.print(f"  [red]✗[/red] Install failed: {e}")
+        raise typer.Exit(1)
+
+    if result.returncode != 0:
+        console.print(f"  [red]✗[/red] Install returned exit code {result.returncode}")
+        if result.stderr:
+            # Show last 10 lines of stderr
+            for line in result.stderr.strip().split("\n")[-10:]:
+                console.print(f"    [dim]{line}[/dim]")
+        raise typer.Exit(1)
+
+    # 5. Verify new version
+    try:
+        # Re-import to get fresh metadata
+        import importlib
+        importlib.reload(codedna)
+        new_ver = codedna.__version__
+    except Exception:
+        new_ver = "?"
+
+    console.print()
+    if new_ver == desired:
+        console.print(f"  [bold green]✓ Updated {current} → {new_ver}[/bold green]")
+    else:
+        console.print(f"  [bold green]✓ Update complete.[/bold green] Installed {desired}; current process shows {new_ver}.")
+        console.print(f"  [dim]Restart your shell to pick up the new binary.[/dim]")
+
+
 # ---------------------------------------------------------------------------
 # Helper functions
 # ---------------------------------------------------------------------------

{codedna-0.3.1 → codedna-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codedna"
-version = "0.3.1"
+version = "0.3.3"
 description = "AI Code Transparency Tool - detect AI-written code and measure developer understanding"
 readme = "README.md"
 requires-python = ">=3.10"