rlsbl 0.5.1 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rlsbl",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Release orchestration and project scaffolding for npm and PyPI",
   "license": "MIT",
   "bin": {

package/rlsbl/__init__.py

@@ -3,11 +3,40 @@
 import os
 import sys
 
-try:
-    from importlib.metadata import version as _get_version
-    __version__ = _get_version("rlsbl")
-except Exception:
-    __version__ = "unknown"
+
+def _detect_version():
+    """Detect package version, preferring pyproject.toml over installed metadata.
+
+    Order: pyproject.toml in the source tree (accurate during editable installs)
+    -> importlib.metadata (works for regular installs) -> "unknown".
+    """
+    # Try reading version from pyproject.toml next to the package source
+    try:
+        pyproject_path = os.path.realpath(
+            os.path.join(os.path.dirname(__file__), "..", "pyproject.toml")
+        )
+        if os.path.isfile(pyproject_path):
+            try:
+                import tomllib
+            except ModuleNotFoundError:
+                import tomli as tomllib  # type: ignore[no-redef]
+            with open(pyproject_path, "rb") as f:
+                data = tomllib.load(f)
+            return data["project"]["version"]
+    except Exception:
+        pass
+
+    # Fall back to installed dist-info metadata
+    try:
+        from importlib.metadata import version as _get_version
+        return _get_version("rlsbl")
+    except Exception:
+        pass
+
+    return "unknown"
+
+
+__version__ = _detect_version()
 
 REGISTRIES = ("npm", "pypi", "go")
 COMMANDS = ("release", "status", "scaffold", "check", "config", "undo", "discover")
@@ -145,14 +174,17 @@ def main():
             sys.exit(1)
 
         if command == "check":
-            # check: if registry given, check that one; otherwise check all
+            # check: if registry given, check that one; otherwise check npm and pypi.
+            # Go is excluded from the default set because Go modules use repository
+            # paths (e.g. github.com/user/repo), not a flat claimable namespace, so
+            # "available" would be misleading.  Pass --registry go explicitly to check.
             if registry:
                 handler.run_cmd(registry, args, flags)
             else:
-                all_registries = ["npm", "pypi", "go"]
-                for i, r in enumerate(all_registries):
+                default_registries = ["npm", "pypi"]
+                for i, r in enumerate(default_registries):
                     handler.run_cmd(r, args, flags)
-                    if i < len(all_registries) - 1:
+                    if i < len(default_registries) - 1:
                         print("")
         elif command == "scaffold":
             if registry:

package/rlsbl/commands/check.py

@@ -168,35 +168,44 @@ def _check_name_pypi(name):
 def check_go_availability(name):
     """Check if a Go module path exists on pkg.go.dev.
 
-    Returns {"status": "available"|"taken"|"error", "message"?: str}.
+    Returns {"status": "not_found"|"exists"|"error", "message"?: str, "note"?: str}.
+
+    Go modules use repository paths (e.g. github.com/user/repo), not a flat
+    claimable namespace, so we report "not found" / "exists" rather than the
+    "available" / "taken" language used for npm and PyPI.
     """
     url = f"https://pkg.go.dev/{name}"
     try:
         req = urllib.request.Request(url, method="GET")
         with urllib.request.urlopen(req, timeout=5) as resp:
             if resp.status == 200:
-                return {"status": "taken"}
+                return {"status": "exists"}
             return {"status": "error", "message": f"Unexpected status {resp.status}"}
     except urllib.error.HTTPError as e:
         if e.code == 404:
-            return {"status": "available"}
+            return {
+                "status": "not_found",
+                "note": "Go modules use repository paths, not a central registry.",
+            }
         return {"status": "error", "message": f"Unexpected status {e.code}"}
     except Exception as e:
         return {"status": "error", "message": str(e) or "Network error"}
 
 
 def _check_name_go(name):
-    """Check Go module path availability on pkg.go.dev."""
+    """Check Go module path on pkg.go.dev."""
     print(f'Checking pkg.go.dev for "{name}"...')
 
     result = check_go_availability(name)
     if result["status"] == "error":
         print(f"Error checking pkg.go.dev: {result['message']}", file=sys.stderr)
         sys.exit(1)
-    if result["status"] == "available":
-        print(f'"{name}" is available on pkg.go.dev.')
+    if result["status"] == "not_found":
+        print(f'"{name}" not found on pkg.go.dev.')
     else:
-        print(f'"{name}" already exists on pkg.go.dev.')
+        print(f'"{name}" exists on pkg.go.dev.')
+    if result.get("note"):
+        print(f"  Note: {result['note']}")
 
 
 def run_cmd(registry, args, flags):

package/rlsbl/commands/discover.py

@@ -133,6 +133,8 @@ def run_cmd(registry, args, flags):
         repos = _fetch_all_repos(token)
     except urllib.error.HTTPError as e:
         print(f"Error: GitHub API returned {e.code}: {e.reason}", file=sys.stderr)
+        if e.code == 403:
+            print("Hint: run 'gh auth login' to increase API rate limits (60/hr unauthenticated → 5000/hr).", file=sys.stderr)
         sys.exit(1)
     except urllib.error.URLError as e:
         print(f"Error: could not reach GitHub API: {e.reason}", file=sys.stderr)

package/rlsbl/commands/init_cmd.py

@@ -177,13 +177,19 @@ def process_mappings(template_dir, mappings, vars_dict, force, update=False,
                 existing_lines = {
                     line.strip() for line in existing.split("\n") if line.strip()
                 }
+                # Normalize by stripping trailing slashes so e.g.
+                # "*.egg-info/" matches "*.egg-info" and vice versa.
+                existing_normalized = {
+                    line.rstrip("/") for line in existing_lines
+                }
                 new_lines = [
                     line.strip() for line in content.split("\n") if line.strip()
                 ]
                 # Only merge non-comment entries that are missing from the existing file
                 missing = [
                     line for line in new_lines
-                    if line not in existing_lines and not line.startswith("#")
+                    if line.rstrip("/") not in existing_normalized
+                    and not line.startswith("#")
                 ]
                 if missing:
                     with open(target, "a", encoding="utf-8") as f:

package/rlsbl/registries/go.py

@@ -86,6 +86,7 @@ def get_template_vars(dir_path):
         "author": author,
         "repoName": repo_name,
         "binCommand": short_name,
+        "publishSetup": "GoReleaser handles binary publishing via GitHub Actions (no secrets needed)",
     }
 
 

package/rlsbl/registries/npm.py

@@ -84,6 +84,7 @@ def get_template_vars(dir_path):
         "binCommand": bin_command,
         "author": pkg.get("author", ""),
         "repoName": repo_name,
+        "publishSetup": "Requires NPM_TOKEN secret on GitHub (Settings > Secrets > Actions)",
     }
 
 

package/rlsbl/registries/pypi.py

@@ -136,6 +136,7 @@ def get_template_vars(dir_path):
         "author": author,
         "repoName": repo_name,
         "importName": import_name,
+        "publishSetup": "Configure Trusted Publishing on pypi.org for automated PyPI releases",
     }
 
 

package/templates/go/ci.yml.tpl

@@ -13,8 +13,8 @@ jobs:
       matrix:
         go-version: ["1.22", "1.23", "1.24"]
     steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-go@v5
+      - uses: actions/checkout@v6
+      - uses: actions/setup-go@v6
         with:
           go-version: ${{ matrix.go-version }}
       - run: go test ./...

package/templates/go/publish.yml.tpl

@@ -11,15 +11,15 @@ jobs:
   goreleaser:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
-      - uses: actions/setup-go@v5
+      - uses: actions/setup-go@v6
         with:
           go-version-file: go.mod
-      - uses: goreleaser/goreleaser-action@v6
+      - uses: goreleaser/goreleaser-action@v7
         with:
-          version: latest
+          version: "~> v2"
           args: release --clean
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/templates/merged/publish.yml.tpl

@@ -12,8 +12,8 @@ jobs:
   npm:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v5
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version: 22
           registry-url: https://registry.npmjs.org
@@ -24,7 +24,7 @@ jobs:
   pypi:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - uses: astral-sh/setup-uv@v7
       - run: uv build
       - uses: pypa/gh-action-pypi-publish@release/v1

package/templates/npm/ci.yml.tpl

@@ -13,8 +13,8 @@ jobs:
       matrix:
         node-version: [18, 20, 22]
     steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v5
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
       - run: node -e "require('./package.json')"

package/templates/npm/publish.yml.tpl

@@ -12,8 +12,8 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v5
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version: 22
           registry-url: https://registry.npmjs.org

package/templates/pypi/ci.yml.tpl

@@ -13,7 +13,7 @@ jobs:
       matrix:
         python-version: ["3.12", "3.13", "3.14"]
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - uses: astral-sh/setup-uv@v7
       - run: uv python install ${{ matrix.python-version }}
       - run: uv sync

package/templates/pypi/publish.yml.tpl

@@ -12,7 +12,7 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - uses: astral-sh/setup-uv@v7
       - run: uv build
       - uses: pypa/gh-action-pypi-publish@release/v1

package/templates/shared/CLAUDE.md.tpl

@@ -8,7 +8,7 @@ This project uses [rlsbl](https://github.com/smm-h/rlsbl) for release orchestrat
 - Run `rlsbl release [patch|minor|major]` to bump version and create a GitHub Release
 - CI handles publishing automatically via the publish workflow
 - Never publish manually — always use `rlsbl release`
-- Requires `NPM_TOKEN` secret on GitHub (for npm projects)
+- {{publishSetup}}
 - Use `rlsbl release --dry-run` to preview a release without making changes
 
 ## Conventions

package/templates/shared/record-gif.sh.tpl

@@ -14,7 +14,7 @@ if ! command -v vhs &>/dev/null; then
   exit 1
 fi
 
-TAPE=$(mktemp /tmp/record-XXXX.tape)
+TAPE=$(mktemp)
 cat > "$TAPE" <<EOF
 Set FontFamily "monospace"
 Set FontSize 24