devlaunch 0.0.5__tar.gz → 0.0.7__tar.gz

{devlaunch-0.0.5 → devlaunch-0.0.7}/.gitignore

@@ -50,6 +50,7 @@ coverage.xml
 .hypothesis/
 .pytest_cache/
 cover/
+test/docker/results/
 
 # Translations
 *.mo
@@ -191,3 +192,7 @@ test_suite_analysis/metadata.json
 progress.json
 status.json
 logs/
+.ralph/
+
+# uv is not this project's package manager (pixi.lock is authoritative)
+uv.lock

devlaunch-0.0.5/README.md → devlaunch-0.0.7/PKG-INFO

@@ -1,3 +1,26 @@
+Metadata-Version: 2.4
+Name: devlaunch
+Version: 0.0.7
+Summary: DevLaunch - A streamlined CLI for devpod workspaces
+Project-URL: Source, https://github.com/blooop/devlaunch
+Project-URL: Home, https://github.com/blooop/devlaunch
+Author-email: Austin Gregg-Smith <blooop@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: iterfzf>=1.0.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: tomli>=2.0.0
+Provides-Extra: test
+Requires-Dist: coverage<=7.14.1,>=7.5.4; extra == 'test'
+Requires-Dist: hypothesis<=6.155.1,>=6.104.2; extra == 'test'
+Requires-Dist: prek<0.5.0,>=0.2.28; extra == 'test'
+Requires-Dist: pylint<=4.0.5,>=3.2.5; extra == 'test'
+Requires-Dist: pytest-cov<=7.1.0,>=4.1; extra == 'test'
+Requires-Dist: pytest<=9.0.3,>=7.4; extra == 'test'
+Requires-Dist: ruff<=0.15.15,>=0.5.0; extra == 'test'
+Requires-Dist: ty<=0.0.19,>=0.0.12; extra == 'test'
+Description-Content-Type: text/markdown
+
 # devlaunch
 
 A streamlined CLI for [devpod](https://devpod.sh) with intuitive autocomplete and fzf fuzzy selection.
@@ -10,7 +33,7 @@ A streamlined CLI for [devpod](https://devpod.sh) with intuitive autocomplete an
 [![GitHub pull-requests merged](https://badgen.net/github/merged-prs/blooop/devlaunch)](https://github.com/blooop/devlaunch/pulls?q=is%3Amerged)
 [![GitHub release](https://img.shields.io/github/release/blooop/devlaunch.svg)](https://GitHub.com/blooop/devlaunch/releases/)
 [![PyPI](https://img.shields.io/pypi/v/devlaunch)](https://pypi.org/project/devlaunch/)
-[![Conda](https://img.shields.io/badge/conda-blooop-green?logo=conda-forge)](https://prefix.dev/channels/blooop/packages/devlaunch)
+[![Conda](https://img.shields.io/badge/conda-v0.0.7-brightgreen?logo=anaconda)](https://prefix.dev/channels/blooop/packages/devlaunch)
 [![License](https://img.shields.io/github/license/blooop/devlaunch)](https://opensource.org/license/mit/)
 [![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org/downloads/)
 [![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh)
@@ -72,12 +95,25 @@ dl ./path                        # Create from local path
 | `dl <user/repo> reset` | Clean slate (remove all, recreate) |
 | `dl <user/repo> -- <command>` | Run shell command in workspace |
 
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--devcontainer <variant\|path>` | Use a non-default `devcontainer.json`. A bare name means `.devcontainer/<name>/devcontainer.json`. Stored with the workspace, so pass it once. |
+
+Projects with demanding devcontainers — several variants, compose sidecars, or a
+host-side `initializeCommand` that has to tell branch workspaces apart — are
+covered in [docs/devcontainer-projects.md](docs/devcontainer-projects.md).
+
 ## Global Commands
 
 | Command | Description |
 |---------|-------------|
 | `dl --ls` | List all workspaces |
 | `dl --install` | Install shell completions |
+| `dl --purge [-y]` | Remove all devlaunch data |
+| `dl --prune-worktrees [days]` | Remove unused worktrees (default: 30 days) |
+| `dl --refresh` | Refresh completion cache |
 | `dl --help, -h` | Show this help |
 | `dl --version` | Show version |
 
@@ -102,6 +138,38 @@ dl blooop/devlaunch stop         # Stop workspace
 - **Branch Support**: Specify branches with `owner/repo@branch` syntax
 - **Fast Autocomplete**: Completion cache for ~3ms response time (vs ~700ms without cache)
 
+## Worktree Backend
+
+For git repositories, devlaunch uses an efficient worktree backend by default:
+
+- **Efficient Storage**: Repos are cloned once to `~/.cache/devlaunch/repos/owner/repo/`, then git worktrees are created for each branch
+- **Shared Git Objects**: All branches share git objects, saving disk space
+- **Lazy Fetch**: Remote updates are only fetched if the configured interval has elapsed (default: 1 hour)
+
+### Container Sharing Mode
+
+Use `--shared` to share a single container across multiple branches of the same repo:
+
+```bash
+dl --shared owner/repo@branch1  # Creates container "owner-repo"
+dl --shared owner/repo@branch2  # Reuses "owner-repo" container
+```
+
+### Pre-warming
+
+Use `--warm` to prepare a workspace without attaching a shell:
+
+```bash
+dl --warm owner/repo@branch  # Creates container in background
+```
+
+### Backend Selection
+
+```bash
+dl --backend devpod owner/repo  # Force legacy DevPod backend
+DEVLAUNCH_BACKEND=devpod dl owner/repo  # Use environment variable
+```
+
 ## Shell Completion
 
 After running `dl --install`, you get intelligent tab completion:

devlaunch-0.0.5/PKG-INFO → devlaunch-0.0.7/README.md

@@ -1,24 +1,3 @@
-Metadata-Version: 2.4
-Name: devlaunch
-Version: 0.0.5
-Summary: DevLaunch - A streamlined CLI for devpod workspaces
-Project-URL: Source, https://github.com/blooop/devlaunch
-Project-URL: Home, https://github.com/blooop/devlaunch
-Author-email: Austin Gregg-Smith <blooop@gmail.com>
-License-Expression: MIT
-License-File: LICENSE
-Requires-Dist: iterfzf>=1.0.0
-Provides-Extra: test
-Requires-Dist: coverage<=7.13.1,>=7.5.4; extra == 'test'
-Requires-Dist: hypothesis<=6.150.2,>=6.104.2; extra == 'test'
-Requires-Dist: prek<0.3.0,>=0.2.28; extra == 'test'
-Requires-Dist: pylint<=4.0.4,>=3.2.5; extra == 'test'
-Requires-Dist: pytest-cov<=7.0.0,>=4.1; extra == 'test'
-Requires-Dist: pytest<=9.0.2,>=7.4; extra == 'test'
-Requires-Dist: ruff<=0.14.13,>=0.5.0; extra == 'test'
-Requires-Dist: ty<=0.0.12,>=0.0.12; extra == 'test'
-Description-Content-Type: text/markdown
-
 # devlaunch
 
 A streamlined CLI for [devpod](https://devpod.sh) with intuitive autocomplete and fzf fuzzy selection.
@@ -31,7 +10,7 @@ A streamlined CLI for [devpod](https://devpod.sh) with intuitive autocomplete an
 [![GitHub pull-requests merged](https://badgen.net/github/merged-prs/blooop/devlaunch)](https://github.com/blooop/devlaunch/pulls?q=is%3Amerged)
 [![GitHub release](https://img.shields.io/github/release/blooop/devlaunch.svg)](https://GitHub.com/blooop/devlaunch/releases/)
 [![PyPI](https://img.shields.io/pypi/v/devlaunch)](https://pypi.org/project/devlaunch/)
-[![Conda](https://img.shields.io/badge/conda-blooop-green?logo=conda-forge)](https://prefix.dev/channels/blooop/packages/devlaunch)
+[![Conda](https://img.shields.io/badge/conda-v0.0.7-brightgreen?logo=anaconda)](https://prefix.dev/channels/blooop/packages/devlaunch)
 [![License](https://img.shields.io/github/license/blooop/devlaunch)](https://opensource.org/license/mit/)
 [![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org/downloads/)
 [![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh)
@@ -93,12 +72,25 @@ dl ./path                        # Create from local path
 | `dl <user/repo> reset` | Clean slate (remove all, recreate) |
 | `dl <user/repo> -- <command>` | Run shell command in workspace |
 
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--devcontainer <variant\|path>` | Use a non-default `devcontainer.json`. A bare name means `.devcontainer/<name>/devcontainer.json`. Stored with the workspace, so pass it once. |
+
+Projects with demanding devcontainers — several variants, compose sidecars, or a
+host-side `initializeCommand` that has to tell branch workspaces apart — are
+covered in [docs/devcontainer-projects.md](docs/devcontainer-projects.md).
+
 ## Global Commands
 
 | Command | Description |
 |---------|-------------|
 | `dl --ls` | List all workspaces |
 | `dl --install` | Install shell completions |
+| `dl --purge [-y]` | Remove all devlaunch data |
+| `dl --prune-worktrees [days]` | Remove unused worktrees (default: 30 days) |
+| `dl --refresh` | Refresh completion cache |
 | `dl --help, -h` | Show this help |
 | `dl --version` | Show version |
 
@@ -123,6 +115,38 @@ dl blooop/devlaunch stop         # Stop workspace
 - **Branch Support**: Specify branches with `owner/repo@branch` syntax
 - **Fast Autocomplete**: Completion cache for ~3ms response time (vs ~700ms without cache)
 
+## Worktree Backend
+
+For git repositories, devlaunch uses an efficient worktree backend by default:
+
+- **Efficient Storage**: Repos are cloned once to `~/.cache/devlaunch/repos/owner/repo/`, then git worktrees are created for each branch
+- **Shared Git Objects**: All branches share git objects, saving disk space
+- **Lazy Fetch**: Remote updates are only fetched if the configured interval has elapsed (default: 1 hour)
+
+### Container Sharing Mode
+
+Use `--shared` to share a single container across multiple branches of the same repo:
+
+```bash
+dl --shared owner/repo@branch1  # Creates container "owner-repo"
+dl --shared owner/repo@branch2  # Reuses "owner-repo" container
+```
+
+### Pre-warming
+
+Use `--warm` to prepare a workspace without attaching a shell:
+
+```bash
+dl --warm owner/repo@branch  # Creates container in background
+```
+
+### Backend Selection
+
+```bash
+dl --backend devpod owner/repo  # Force legacy DevPod backend
+DEVLAUNCH_BACKEND=devpod dl owner/repo  # Use environment variable
+```
+
 ## Shell Completion
 
 After running `dl --install`, you get intelligent tab completion:

devlaunch-0.0.7/devlaunch/completions/dl.bash

@@ -0,0 +1,158 @@
+# dl completion
+# Note: This completion function does not support quoted arguments or escaped spaces.
+# All arguments are treated as literal strings separated by whitespace.
+# This is acceptable because GitHub usernames, repo names, and workspace names
+# do not contain spaces or special characters that would require quoting.
+#
+# Implementation note: We parse COMP_LINE directly instead of adjusting COMP_WORDBREAKS
+# because temporary COMP_WORDBREAKS modification can have side effects with bash's
+# internal completion state and doesn't reliably prevent word splitting in all
+# bash versions. Direct parsing gives us full control over word boundaries.
+_dl_completion() {
+    local cur prev opts
+    COMPREPLY=()
+
+    # Extract current line from COMP_LINE instead of COMP_WORDS
+    # This avoids issues with COMP_WORDBREAKS treating dashes as word boundaries
+    local line="${COMP_LINE:0:COMP_POINT}"
+
+    # Parse the line into an array of words (pure bash, no external processes)
+    local words
+    read -r -a words <<< "$line"
+    local word_count=${#words[@]}
+
+    # Extract current and previous words from the parsed array
+    if (( word_count > 0 )); then
+        cur="${words[word_count-1]}"
+    else
+        cur=""
+    fi
+
+    if (( word_count > 1 )); then
+        prev="${words[word_count-2]}"
+    else
+        prev=""
+    fi
+
+    # If line ends with whitespace, we're starting a new word
+    if [[ "$line" =~ [[:space:]]$ ]]; then
+        ((word_count++))
+        cur=""
+        # Update prev when starting a new word
+        if (( ${#words[@]} > 0 )); then
+            prev="${words[-1]}"
+        fi
+    fi
+
+    # Global command options (only valid as first arg)
+    local global_opts="--ls --install --help -h --version --devcontainer"
+
+    # Workspace subcommands
+    local ws_cmds="stop rm code restart recreate reset --"
+
+    # Options that take a value; a variant name or a path follows them.
+    local value_opts="--devcontainer"
+
+    # After --devcontainer, offer the repo's variant directories (and paths).
+    if [[ " ${value_opts} " == *" ${prev} "* ]]; then
+        local variants=""
+        if [[ -d .devcontainer ]]; then
+            local d
+            for d in .devcontainer/*/devcontainer.json; do
+                [[ -f "$d" ]] || continue
+                d="${d#.devcontainer/}"
+                variants+=" ${d%/devcontainer.json}"
+            done
+        fi
+        COMPREPLY=( $(compgen -W "${variants}" -- ${cur}) )
+        compopt -o default 2>/dev/null
+        return 0
+    fi
+
+    # Cache file location (honors XDG_CACHE_HOME)
+    local cache_dir="${XDG_CACHE_HOME:-$HOME/.cache}/devlaunch"
+    local cache_file="$cache_dir/completions.bash"
+
+    # Initialize completion variables
+    local DL_WORKSPACES=""
+    local DL_REPOS=""
+    local DL_OWNERS=""
+    local DL_BRANCHES=""
+
+    # Source the bash cache file (fast, no jq needed)
+    if [[ -f "$cache_file" ]]; then
+        source "$cache_file"
+    fi
+
+    # First argument: global flags, workspaces, repos, owners, or paths
+    if [[ ${word_count} -eq 2 ]]; then
+        # Global flags
+        if [[ ${cur} == -* ]]; then
+            COMPREPLY=( $(compgen -W "${global_opts}" -- ${cur}) )
+            return 0
+        fi
+
+        # If typing a path, complete files/directories
+        if [[ "$cur" == ./* || "$cur" == /* || "$cur" == ~/* ]]; then
+            COMPREPLY=( $(compgen -d -- ${cur}) )
+            return 0
+        fi
+
+        # Check if completing branch (contains @)
+        if [[ "$cur" == *@* ]]; then
+            # Use cached branches (format: owner/repo@branch)
+            if [[ -n "$DL_BRANCHES" ]]; then
+                COMPREPLY=( $(compgen -W "${DL_BRANCHES}" -- ${cur}) )
+            fi
+            return 0
+        fi
+
+        # Check if completing owner/repo format (contains /)
+        if [[ "$cur" == */* ]]; then
+            # Don't add space - allow @branch suffix
+            compopt -o nospace
+            # Complete from known repos
+            if [[ -n "$DL_REPOS" ]]; then
+                COMPREPLY=( $(compgen -W "${DL_REPOS}" -- ${cur}) )
+            fi
+            return 0
+        fi
+
+        # Default: complete workspace names and offer owner/ completion
+        compopt -o nospace  # For owner/ completions
+        local completions="$DL_WORKSPACES"
+
+        # Add owners with trailing slash
+        for owner in $DL_OWNERS; do
+            completions="$completions ${owner}/"
+        done
+
+        if [[ -n "$completions" ]]; then
+            COMPREPLY=( $(compgen -W "${completions}" -- ${cur}) )
+        fi
+        return 0
+    fi
+
+    # Second argument (after workspace): subcommands
+    if [[ ${word_count} -eq 3 ]]; then
+        # Don't complete after global flags
+        # Extract the first argument (word after "dl") from the words array
+        local first=""
+        if (( ${#words[@]} > 1 )); then
+            first="${words[1]}"
+        fi
+        if [[ "$first" == --* ]]; then
+            return 0
+        fi
+
+        COMPREPLY=( $(compgen -W "${ws_cmds}" -- ${cur}) )
+        return 0
+    fi
+
+    # After "--": no completion (user types shell command)
+    return 0
+}
+
+# Use -o default for better completion behavior
+complete -o default -F _dl_completion dl
+# end dl completion