dev-setup 1.0.0__tar.gz → 1.1.0__tar.gz

{dev_setup-1.0.0 → dev_setup-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dev-setup
-Version: 1.0.0
+Version: 1.1.0
 Summary: Development environment setup CLI for Linux
 Project-URL: Repository, https://github.com/thesawdawg/dev-setup-py
 Author-email: Sawyer <sawyerksu@gmail.com>
@@ -30,29 +30,52 @@ A Python-based CLI for managing your Linux development environment. Install, rem
 
 ---
 
-## How it works
+## Installation
 
-The entry point is a thin bash wrapper (`./dev-setup`) that bootstraps Python automatically:
+### From PyPI (recommended)
 
-1. Checks for `uv` on `PATH`; installs it via the official installer if missing
-2. Runs `uv run --project <dir> python -m dev_setup` — uv provisions Python 3.11+ if needed
-3. All further logic (commands, UI, installs) is pure Python
+The simplest install — no git clone required, Python 3.11+ is the only prerequisite:
 
-You never need to manually install Python or manage a virtualenv. The first invocation after a fresh clone may take a few seconds to resolve dependencies; every run after that is instant.
+```bash
+# pipx gives the tool its own isolated environment (preferred)
+pipx install dev-setup
 
----
+# or plain pip
+pip install dev-setup
+```
 
-## Installation
+After install, `dev-setup` is available as a command. Run `dev-setup --help` to verify.
+
+### From source (development)
 
 ```bash
 git clone <repo-url> ~/dev-setup-py
 cd ~/dev-setup-py
-bash install.sh
+bash install.sh   # installs from PyPI via pipx or pip
+```
+
+Or to run directly from the cloned repo without installing:
+
+```bash
+./dev-setup list   # creates a .venv on first run, then stays fast
+```
+
+The `./dev-setup` bash script requires Python 3.11+ and creates a local `.venv` automatically. On Debian/Ubuntu, if `python3-venv` is not installed, it falls back to `uv venv` if uv is available.
+
+For editable development installs:
+
+```bash
+pip install -e .
+dev-setup list
 ```
 
-`install.sh` creates a symlink at `~/.local/bin/dev-setup` and ensures `~/.local/bin` is on `PATH` in `~/.bashrc`. Open a new terminal (or run `source ~/.bashrc`) and you're done.
+---
+
+## How it works
+
+When installed from PyPI (via `pip` or `pipx`), the `dev-setup` command is a standard Python entry point — Python is the only runtime dependency. The `[project.scripts]` entry in `pyproject.toml` maps `dev-setup` directly to `dev_setup.__main__:main`.
 
-> **Note:** Installing this tool symlinks `~/.local/bin/dev-setup`, which will replace an existing bash `dev-setup` at that path if you have one.
+The bash `./dev-setup` script in the repo is a convenience runner for the git-clone workflow. It creates a `.venv` using `python3 -m venv` (falling back to `uv venv` on systems where `python3-venv` is a separate package) and installs the project in editable mode on first run.
 
 ---
 

{dev_setup-1.0.0 → dev_setup-1.1.0}/README.md

@@ -4,29 +4,52 @@ A Python-based CLI for managing your Linux development environment. Install, rem
 
 ---
 
-## How it works
+## Installation
 
-The entry point is a thin bash wrapper (`./dev-setup`) that bootstraps Python automatically:
+### From PyPI (recommended)
 
-1. Checks for `uv` on `PATH`; installs it via the official installer if missing
-2. Runs `uv run --project <dir> python -m dev_setup` — uv provisions Python 3.11+ if needed
-3. All further logic (commands, UI, installs) is pure Python
+The simplest install — no git clone required, Python 3.11+ is the only prerequisite:
 
-You never need to manually install Python or manage a virtualenv. The first invocation after a fresh clone may take a few seconds to resolve dependencies; every run after that is instant.
+```bash
+# pipx gives the tool its own isolated environment (preferred)
+pipx install dev-setup
 
----
+# or plain pip
+pip install dev-setup
+```
 
-## Installation
+After install, `dev-setup` is available as a command. Run `dev-setup --help` to verify.
+
+### From source (development)
 
 ```bash
 git clone <repo-url> ~/dev-setup-py
 cd ~/dev-setup-py
-bash install.sh
+bash install.sh   # installs from PyPI via pipx or pip
+```
+
+Or to run directly from the cloned repo without installing:
+
+```bash
+./dev-setup list   # creates a .venv on first run, then stays fast
+```
+
+The `./dev-setup` bash script requires Python 3.11+ and creates a local `.venv` automatically. On Debian/Ubuntu, if `python3-venv` is not installed, it falls back to `uv venv` if uv is available.
+
+For editable development installs:
+
+```bash
+pip install -e .
+dev-setup list
 ```
 
-`install.sh` creates a symlink at `~/.local/bin/dev-setup` and ensures `~/.local/bin` is on `PATH` in `~/.bashrc`. Open a new terminal (or run `source ~/.bashrc`) and you're done.
+---
+
+## How it works
+
+When installed from PyPI (via `pip` or `pipx`), the `dev-setup` command is a standard Python entry point — Python is the only runtime dependency. The `[project.scripts]` entry in `pyproject.toml` maps `dev-setup` directly to `dev_setup.__main__:main`.
 
-> **Note:** Installing this tool symlinks `~/.local/bin/dev-setup`, which will replace an existing bash `dev-setup` at that path if you have one.
+The bash `./dev-setup` script in the repo is a convenience runner for the git-clone workflow. It creates a `.venv` using `python3 -m venv` (falling back to `uv venv` on systems where `python3-venv` is a separate package) and installs the project in editable mode on first run.
 
 ---
 

dev_setup-1.1.0/dev-setup

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# Local runner for development / git-clone installs.
+# For production: pip install dev-setup  or  pipx install dev-setup
+set -euo pipefail
+
+DEVSETUP_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+VENV="$DEVSETUP_DIR/.venv"
+
+# Common locations where pip/pipx/uv install binaries
+export PATH="$HOME/.local/bin:$HOME/.cargo/bin:$PATH"
+
+_find_python() {
+    local py
+    for py in python3.13 python3.12 python3.11 python3; do
+        if command -v "$py" &>/dev/null; then
+            if "$py" -c "import sys; exit(0 if sys.version_info >= (3,11) else 1)" 2>/dev/null; then
+                echo "$py"
+                return 0
+            fi
+        fi
+    done
+    echo "  ✖ Python 3.11+ is required." >&2
+    echo "    Install from https://www.python.org/downloads/ or via your package manager." >&2
+    exit 1
+}
+
+_setup_venv() {
+    local python="$1"
+    echo "  ❯ Creating virtual environment..."
+
+    if "$python" -m venv "$VENV" &>/dev/null; then
+        "$VENV/bin/pip" install --quiet -e "$DEVSETUP_DIR"
+        echo "  ✔ Ready"
+        return 0
+    fi
+
+    # python3 -m venv may leave a partial directory behind on failure — clean it up
+    rm -rf "$VENV"
+
+    # Debian/Ubuntu ships python3 without python3-venv by default.
+    # uv can create venvs with a bundled pip, bypassing ensurepip entirely.
+    if command -v uv &>/dev/null; then
+        echo "  ❯ python3-venv unavailable — falling back to uv venv..."
+        uv venv "$VENV" --quiet
+        VIRTUAL_ENV="$VENV" uv pip install -e "$DEVSETUP_DIR" --quiet
+        echo "  ✔ Ready"
+        return 0
+    fi
+
+    echo "  ✖ Could not create virtual environment." >&2
+    echo "" >&2
+    echo "  On Debian/Ubuntu, install the missing package:" >&2
+    echo "    sudo apt install python3-venv" >&2
+    echo "" >&2
+    echo "  Or install the tool directly (no venv needed):" >&2
+    echo "    pip install dev-setup   or   pipx install dev-setup" >&2
+    exit 1
+}
+
+PYTHON=$(_find_python)
+
+if [ ! -f "$VENV/bin/python" ] || ! "$VENV/bin/python" -c "import dev_setup" 2>/dev/null; then
+    _setup_venv "$PYTHON"
+fi
+
+exec "$VENV/bin/python" -m dev_setup "$@"

dev_setup-1.1.0/install.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# Installs dev-setup from PyPI using pipx (preferred) or pip.
+set -euo pipefail
+
+PACKAGE="dev-setup"
+
+_find_python() {
+    local py
+    for py in python3.13 python3.12 python3.11 python3; do
+        if command -v "$py" &>/dev/null; then
+            if "$py" -c "import sys; exit(0 if sys.version_info >= (3,11) else 1)" 2>/dev/null; then
+                echo "$py"
+                return 0
+            fi
+        fi
+    done
+    echo "  ✖ Python 3.11+ is required." >&2
+    echo "    Install from https://www.python.org/downloads/ or via your package manager." >&2
+    exit 1
+}
+
+_ensure_local_bin_on_path() {
+    local dir="$HOME/.local/bin"
+    local bashrc="$HOME/.bashrc"
+    if ! grep -qF '.local/bin' "$bashrc" 2>/dev/null; then
+        printf '\n# dev-setup\nexport PATH="%s:$PATH"\n' "$dir" >> "$bashrc"
+        echo "  ✔ Added $dir to PATH in $bashrc"
+        NEED_RELOAD=1
+    fi
+}
+
+PYTHON=$(_find_python)
+NEED_RELOAD=0
+echo "  ✔ Python: $($PYTHON --version)"
+
+# --- pipx path (preferred: isolated env, clean uninstall) ---
+if command -v pipx &>/dev/null || "$PYTHON" -m pipx --version &>/dev/null 2>&1; then
+    PIPX=$(command -v pipx 2>/dev/null || echo "$PYTHON -m pipx")
+    echo "  ❯ Installing $PACKAGE via pipx..."
+    $PIPX install "$PACKAGE"
+    echo ""
+    echo "  ✔ Done. Run: dev-setup --help"
+    exit 0
+fi
+
+# --- bootstrap pipx then use it ---
+if "$PYTHON" -m pip --version &>/dev/null 2>&1; then
+    echo "  ❯ pipx not found — installing pipx first..."
+    "$PYTHON" -m pip install --user pipx --quiet
+    "$PYTHON" -m pipx ensurepath --quiet 2>/dev/null || true
+    _ensure_local_bin_on_path
+
+    echo "  ❯ Installing $PACKAGE via pipx..."
+    "$PYTHON" -m pipx install "$PACKAGE"
+    echo ""
+    echo "  ✔ Done. Run: dev-setup --help"
+    [ "$NEED_RELOAD" -eq 1 ] && echo "    (run 'source ~/.bashrc' first if the command isn't found)"
+    exit 0
+fi
+
+# --- last resort: pip --user ---
+echo "  ❯ Installing $PACKAGE via pip..."
+"$PYTHON" -m pip install --user "$PACKAGE" --quiet
+_ensure_local_bin_on_path
+echo ""
+echo "  ✔ Done. Run: dev-setup --help"
+[ "$NEED_RELOAD" -eq 1 ] && echo "    (run 'source ~/.bashrc' first if the command isn't found)"

{dev_setup-1.0.0 → dev_setup-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dev-setup"
-version = "1.0.0"
+version = "1.1.0"
 description = "Development environment setup CLI for Linux"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -41,6 +41,3 @@ build-backend = "hatchling.build"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/dev_setup"]
-
-[tool.uv]
-package = true

{dev_setup-1.0.0 → dev_setup-1.1.0}/uv.lock

@@ -25,7 +25,7 @@ wheels = [
 
 [[package]]
 name = "dev-setup"
-version = "1.0.0"
+version = "1.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

dev_setup-1.0.0/dev-setup

@@ -1,26 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-export PATH="$HOME/.local/bin:$HOME/.cargo/bin:$PATH"
-
-_ensure_uv() {
-    command -v uv &>/dev/null && return 0
-
-    echo "  ❯ uv not found — installing..."
-    if ! curl -LsSf https://astral.sh/uv/install.sh | sh; then
-        echo "  ✖ uv installation failed." >&2
-        echo "    Install manually: https://docs.astral.sh/uv/getting-started/installation/" >&2
-        exit 1
-    fi
-
-    if ! command -v uv &>/dev/null; then
-        echo "  ✖ uv not found after installation. Add ~/.local/bin to PATH and retry." >&2
-        exit 1
-    fi
-    echo "  ✔ uv installed"
-}
-
-_ensure_uv
-
-DEVSETUP_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-exec uv run --project "$DEVSETUP_DIR" python -m dev_setup "$@"

dev_setup-1.0.0/install.sh

@@ -1,25 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-DEVSETUP_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-BIN_DIR="${HOME}/.local/bin"
-LINK="$BIN_DIR/dev-setup"
-
-mkdir -p "$BIN_DIR"
-chmod +x "$DEVSETUP_DIR/dev-setup"
-ln -sf "$DEVSETUP_DIR/dev-setup" "$LINK"
-
-echo "  ✔ Installed: $LINK → $DEVSETUP_DIR/dev-setup"
-
-BASHRC="$HOME/.bashrc"
-PATH_LINE='export PATH="$HOME/.local/bin:$PATH"'
-if ! grep -qF '.local/bin' "$BASHRC" 2>/dev/null; then
-    printf '\n# dev-setup\n%s\n' "$PATH_LINE" >> "$BASHRC"
-    echo "  ✔ Added ~/.local/bin to PATH in $BASHRC"
-    echo "    Run: source ~/.bashrc  (or open a new terminal)"
-else
-    echo "  ✔ ~/.local/bin already on PATH in $BASHRC"
-fi
-
-echo ""
-echo "  Run 'dev-setup --help' to get started."