bashers 0.1.0__tar.gz

bashers-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.venv/
+venv/
+ENV/
+env/
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.hypothesis/
+.mypy_cache/
+.dmypy.json
+dmypy.json

bashers-0.1.0/LICENSE

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

bashers-0.1.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: bashers
+Version: 0.1.0
+Summary: Installable bash command helpers
+Author: Sung Kim
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Bashers
+Installable bash command helpers
+
+## Installation
+
+Install the package:
+
+```bash
+pip install .
+```
+
+Or with uv:
+
+```bash
+uv pip install .
+```
+
+Or install from a built wheel:
+
+```bash
+pip install dist/bashers-*.whl
+```
+
+## Usage
+
+After installation, use the `bashers` dispatcher:
+
+```bash
+bashers update
+bashers update requests
+bashers show
+bashers show requests
+bashers setup
+bashers setup --frozen
+```
+
+Verify the command is on PATH:
+
+```bash
+which bashers
+```
+
+If you are using a virtualenv or `uv`, make sure its `bin/` directory is active in your shell.
+
+## Development
+
+To install in development mode:
+
+```bash
+uv sync
+```
+
+Or with pip:
+
+```bash
+pip install -e .
+```
+
+## Adding New Commands
+
+1. Add your bash script under the `bashers/` directory (subfolders are OK)
+2. If you want a bash function, define a function with the same name as the file
+3. Reinstall: `uv sync` or `pip install -e .`

bashers-0.1.0/README.md

@@ -0,0 +1,63 @@
+# Bashers
+Installable bash command helpers
+
+## Installation
+
+Install the package:
+
+```bash
+pip install .
+```
+
+Or with uv:
+
+```bash
+uv pip install .
+```
+
+Or install from a built wheel:
+
+```bash
+pip install dist/bashers-*.whl
+```
+
+## Usage
+
+After installation, use the `bashers` dispatcher:
+
+```bash
+bashers update
+bashers update requests
+bashers show
+bashers show requests
+bashers setup
+bashers setup --frozen
+```
+
+Verify the command is on PATH:
+
+```bash
+which bashers
+```
+
+If you are using a virtualenv or `uv`, make sure its `bin/` directory is active in your shell.
+
+## Development
+
+To install in development mode:
+
+```bash
+uv sync
+```
+
+Or with pip:
+
+```bash
+pip install -e .
+```
+
+## Adding New Commands
+
+1. Add your bash script under the `bashers/` directory (subfolders are OK)
+2. If you want a bash function, define a function with the same name as the file
+3. Reinstall: `uv sync` or `pip install -e .`

bashers-0.1.0/bashers/__init__.py

@@ -0,0 +1,65 @@
+import importlib.resources
+import subprocess
+import sys
+from pathlib import Path
+
+
+def _create_script_runner(script_name: str):
+    def runner() -> int:
+        try:
+            with importlib.resources.path("bashers", script_name) as script_path:
+                if script_path.read_text().strip().startswith("#!"):
+                    content = script_path.read_text()
+                    if f"{script_name}()" in content:
+                        result = subprocess.run(
+                            [
+                                "bash",
+                                "-c",
+                                f'source {script_path} && {script_name} "$@"',
+                                "--",
+                            ]
+                            + sys.argv[1:],
+                        )
+                    else:
+                        result = subprocess.run([str(script_path)] + sys.argv[1:])
+                    return result.returncode
+        except Exception:
+            script_path = Path(__file__).parent / script_name
+            if script_path.exists():
+                content = script_path.read_text()
+                if f"{script_name}()" in content:
+                    result = subprocess.run(
+                        [
+                            "bash",
+                            "-c",
+                            f'source {script_path} && {script_name} "$@"',
+                            "--",
+                        ]
+                        + sys.argv[1:],
+                    )
+                else:
+                    result = subprocess.run([str(script_path)] + sys.argv[1:])
+                return result.returncode
+        return 1
+
+    return runner
+
+
+def _discover_scripts():
+    scripts_dir = Path(__file__).parent
+    scripts = {}
+    for script_file in scripts_dir.glob("*"):
+        if (
+            script_file.is_file()
+            and not script_file.name.endswith((".py", ".pyc"))
+            and not script_file.name.startswith("__")
+        ):
+            script_name = script_file.name
+            if script_file.read_text().strip().startswith("#!"):
+                scripts[script_name] = _create_script_runner(script_name)
+    return scripts
+
+
+_scripts = _discover_scripts()
+for name, runner in _scripts.items():
+    globals()[name] = runner

bashers-0.1.0/bashers/bashers

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+
+print_help() {
+  local pkg_dir="$1"
+  echo "Bashers - Bash command helpers"
+  echo "Usage: bashers <command> [args...]"
+  echo ""
+  echo "Available commands:"
+  if [[ -d "$pkg_dir" ]]; then
+    find "$pkg_dir" -type f \
+      | sed "s|^$pkg_dir/||" \
+      | grep -vE '(^__|/__)' \
+      | grep -vE '(^\.|/\.)' \
+      | grep -vE '\.(py|pyc)$' \
+      | sort \
+      | sed 's/^/  /'
+  fi
+}
+
+if [[ $# -eq 0 ]]; then
+  pkg_dir="$(
+    python - <<'PY'
+import importlib.resources as resources
+print(resources.files("bashers"))
+PY
+  )"
+  print_help "$pkg_dir"
+  exit 0
+fi
+
+command="$1"
+shift
+
+case "$command" in
+  help|-h|--help)
+    pkg_dir="$(
+      python - <<'PY'
+import importlib.resources as resources
+print(resources.files("bashers"))
+PY
+    )"
+    print_help "$pkg_dir"
+    exit 0
+    ;;
+esac
+
+pkg_dir="$(
+  python - <<'PY'
+import importlib.resources as resources
+print(resources.files("bashers"))
+PY
+)"
+
+script_path=""
+if [[ "$command" == */* ]]; then
+  candidate="$pkg_dir/$command"
+  [[ -f "$candidate" ]] && script_path="$candidate"
+else
+  mapfile -t matches < <(find "$pkg_dir" -type f -name "$command" \
+    | grep -vE '(^__|/__)' \
+    | grep -vE '(^\.|/\.)' \
+    | grep -vE '\.(py|pyc)$')
+  if [[ ${#matches[@]} -gt 1 ]]; then
+    echo "Command '$command' is ambiguous. Use a path:" >&2
+    for match in "${matches[@]}"; do
+      echo "  ${match#"$pkg_dir"/}" >&2
+    done
+    exit 2
+  fi
+  [[ ${#matches[@]} -eq 1 ]] && script_path="${matches[0]}"
+fi
+
+if [[ -n "$script_path" && -f "$script_path" ]]; then
+  script_name="$(basename "$script_path")"
+  if grep -qE "^[[:space:]]*${script_name}[[:space:]]*\\(\\)[[:space:]]*\\{" "$script_path"; then
+    exec bash -c "source \"$script_path\" && $script_name \"\$@\"" -- "$@"
+  fi
+  exec "$script_path" "$@"
+fi
+
+echo "Command '$command' not found. Use 'bashers help' for available commands."
+exit 1

bashers-0.1.0/bashers/project_utils/setup

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+
+setup() {
+  local arg="${1-}" want_frozen=0 want_no_cache=0
+  if [[ "$arg" == "-h" || "$arg" == "--help" ]]; then
+    cat <<'EOF'
+Usage: setup [--rm] [--frozen|--locked|--sync]
+
+Install project dependencies using uv or poetry.
+
+Options:
+  --rm       Remove .venv before install (implies --no-cache where supported)
+  --frozen   Use a locked/frozen install if supported
+  --locked   Same as --frozen
+  --sync     Same as --frozen
+EOF
+    return 0
+  fi
+  [[ "$arg" == "--rm" ]] && rm -rf .venv && want_no_cache=1 && shift && arg="${1-}"
+  [[ "$arg" == "--frozen" || "$arg" == "--locked" || "$arg" == "--sync" ]] && want_frozen=1
+
+  _need() { command -v "$1" >/dev/null 2>&1 || { echo "[setup]: $2" >&2; return 127; }; }
+  _has()  { [[ -f "$1" ]] || return 1; }
+  _tbl()  { [[ -f pyproject.toml ]] && grep -Eq "^\[$1\]" pyproject.toml; }
+
+  if _has uv.lock || _tbl project; then
+    _need uv "uv required but not on PATH" || return $?
+    local uv_opts="--all-extras"
+    (( want_frozen )) && uv_opts="$uv_opts --frozen"
+    (( want_no_cache )) && uv_opts="$uv_opts --no-cache"
+    uv sync $uv_opts
+    return $?
+  fi
+
+  if _has poetry.lock || _tbl tool.poetry; then
+    _need poetry "poetry required but not on PATH" || return $?
+    local poetry_opts="--all-extras"
+    [[ "$arg" == "--frozen" || "$arg" == "--locked" || "$arg" == "--sync" ]] && poetry_opts="$poetry_opts --sync"
+    (( want_no_cache )) && poetry_opts="$poetry_opts --no-cache"
+    poetry install $poetry_opts
+    return $?
+  fi
+
+  echo "[setup]: no uv/poetry lockfile and no pyproject.toml with [project]/[tool.poetry] in $(pwd)" >&2
+  return 2
+}

bashers-0.1.0/bashers/project_utils/show

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+
+show() {
+  if [[ "${1-}" == "-h" || "${1-}" == "--help" ]]; then
+    cat <<'EOF'
+Usage: show [pattern...]
+
+List installed Python packages for the current project.
+
+With patterns, filters results (case-insensitive).
+Works with uv or poetry projects.
+EOF
+    return 0
+  fi
+  _need() { command -v "$1" >/dev/null 2>&1 || { echo "[show]: $1 not on PATH" >&2; return 127; }; }
+  _has_project() { [[ -f pyproject.toml ]] && grep -qE '^\[project\]' pyproject.toml; }
+  _has_poetry() { [[ -f pyproject.toml ]] && grep -qE '^\[tool\.poetry\]' pyproject.toml; }
+
+  if [[ -f uv.lock ]] || _has_project; then
+    _need uv || return $?
+    if [[ $# -eq 0 ]]; then
+      uv pip list
+    else
+      uv pip list | grep -iE "$(IFS='|'; echo "$*")"
+    fi
+    return $?
+  fi
+
+  if [[ -f poetry.lock ]] || _has_poetry; then
+    _need poetry || return $?
+    if [[ $# -eq 0 ]]; then
+      poetry show
+    else
+      poetry show | grep -iE "$(IFS='|'; echo "$*")"
+    fi
+    return $?
+  fi
+
+  echo "[show]: no uv/poetry project found in $(pwd)" >&2
+  return 2
+}

bashers-0.1.0/bashers/project_utils/update

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+
+update() {
+  local pkg="${1-}"
+
+  if [[ "$pkg" == "-h" || "$pkg" == "--help" ]]; then
+    cat <<'EOF'
+Usage: update [package]
+
+Update Python dependencies in the current project.
+
+If [package] is provided, updates just that package (with fuzzy matching).
+Works with uv or poetry projects.
+EOF
+    return 0
+  fi
+
+  [[ -n "$pkg" && "$pkg" == -* ]] && { echo "[update]: usage: update [package]" >&2; return 2; }
+  _need() { command -v "$1" >/dev/null 2>&1 || { echo "[update]: $1 not on PATH" >&2; return 127; }; }
+  _has_project() { [[ -f pyproject.toml ]] && grep -qE '^\[project\]' pyproject.toml; }
+  _has_poetry() { [[ -f pyproject.toml ]] && grep -qE '^\[tool\.poetry\]' pyproject.toml; }
+  _has_prerelease() {
+    [[ -f pyproject.toml ]] && grep -qE '[0-9]+\.[0-9]+(\.[0-9]+)?[a-zA-Z]|\.(a|b|rc|dev|pre|alpha|beta)[0-9]' pyproject.toml
+  }
+
+  local packages_cmd=""
+  if [[ -f uv.lock ]] || _has_project; then
+    _need uv || return $?
+    packages_cmd="uv pip list 2>/dev/null | tail -n +3 | awk '{print \$1}'"
+  elif [[ -f poetry.lock ]] || _has_poetry; then
+    _need poetry || return $?
+    packages_cmd="poetry show 2>/dev/null | grep -E '^name\s+:' | sed 's/^name\s*:\s*//'"
+  else
+    echo "[update]: no uv/poetry project found in $(pwd)" >&2
+    return 2
+  fi
+
+  if [[ -n "$pkg" ]]; then
+    local matches=$(eval "$packages_cmd" | grep -iE "$pkg")
+    local count=$(echo "$matches" | grep -c . || echo "0")
+    [[ "$count" -eq 0 ]] && { echo "[update]: no packages found matching '$pkg'" >&2; return 1; }
+    [[ "$count" -gt 1 ]] && { _need fzf || return 127; pkg=$(echo "$matches" | fzf --prompt="Package> "); }
+    [[ -z "$pkg" ]] && return 1
+  fi
+
+  if [[ -f uv.lock ]] || _has_project; then
+    local prerelease_flag=""
+    _has_prerelease && prerelease_flag="--prerelease allow"
+    [[ -z "$pkg" ]] && uv lock --upgrade $prerelease_flag || uv lock --upgrade-package "$pkg" $prerelease_flag
+    uv sync --all-extras
+  else
+    local prerelease_flag=""
+    _has_prerelease && prerelease_flag="--allow-prereleases"
+    [[ -z "$pkg" ]] && poetry update $prerelease_flag || poetry update "$pkg" $prerelease_flag
+  fi
+  return $?
+}

bashers-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling>=1.24.1"]
+build-backend = "hatchling.build"
+
+[project]
+name = "bashers"
+version = "0.1.0"
+description = "Installable bash command helpers"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Sung Kim" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+]
+
+
+[tool.hatch.build.targets.wheel]
+packages = ["bashers"]
+include = ["bashers/*"]
+shared-scripts = { "bashers/bashers" = "bashers" }
+exclude = ["bashers/__pycache__/*"]
+
+[tool.hatch.build.targets.sdist]
+include = ["bashers/*", "README.md", "pyproject.toml"]
+exclude = ["bashers/__pycache__/*"]
+
+[tool.semantic_release]
+branch = "main"
+version_toml = ["pyproject.toml:project.version"]