svc-infra 0.1.619__py3-none-any.whl → 0.1.620__py3-none-any.whl

svc_infra/cli/cmds/docs/docs_cmds.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import importlib.util
 import os
 from importlib.metadata import PackageNotFoundError, distribution
 from pathlib import Path
@@ -24,31 +25,50 @@ def _discover_fs_topics(docs_dir: Path) -> Dict[str, Path]:
 def _discover_pkg_topics() -> Dict[str, Path]:
     """Discover docs packaged under 'docs/' in the installed distribution.
 
-    This lets 'svc-infra docs' work from external projects that don't have a
-    local docs/ directory by falling back to files shipped in the wheel.
+    Works in external projects without a local docs/ by inspecting the wheel
+    metadata and, as a fallback, searching for a top-level docs/ next to the
+    installed package directory in site-packages.
     """
     topics: Dict[str, Path] = {}
-    try:
-        dist = distribution("svc-infra")
-    except PackageNotFoundError:
-        return topics
-
-    files = getattr(dist, "files", None) or []
-    for f in files:
-        # f is a PackagePath; string form like 'docs/topic.md'
-        s = str(f)
-        if not s.startswith("docs/") or not s.endswith(".md"):
-            continue
-        name = Path(s).stem.replace(" ", "-")
+
+    # 1) Prefer distribution metadata (RECORD) for both hyphen/underscore names
+    dist = None
+    for name in ("svc-infra", "svc_infra"):
         try:
-            abs_path = dist.locate_file(f)
-            # Ensure it's a file before adding
-            abs_p = Path(abs_path)
-            if abs_p.exists() and abs_p.is_file():
-                topics[name] = abs_p
-        except Exception:
-            # best-effort; skip unreadable entries
-            continue
+            dist = distribution(name)
+            break
+        except PackageNotFoundError:
+            dist = None
+
+    if dist is not None:
+        files = getattr(dist, "files", None) or []
+        for f in files:
+            s = str(f)
+            if not s.startswith("docs/") or not s.endswith(".md"):
+                continue
+            topic_name = Path(s).stem.replace(" ", "-")
+            try:
+                abs_path = Path(dist.locate_file(f))
+                if abs_path.exists() and abs_path.is_file():
+                    topics[topic_name] = abs_path
+            except Exception:
+                # Best effort; continue to next
+                continue
+
+    # 2) Fallback: site-packages sibling 'docs/' directory
+    try:
+        spec = importlib.util.find_spec("svc_infra")
+        if spec and spec.submodule_search_locations:
+            pkg_dir = Path(next(iter(spec.submodule_search_locations)))
+            candidate = pkg_dir.parent / "docs"
+            if candidate.exists() and candidate.is_dir():
+                for p in sorted(candidate.glob("*.md")):
+                    if p.is_file():
+                        topics.setdefault(p.stem.replace(" ", "-"), p)
+    except Exception:
+        # Optional fallback only
+        pass
+
     return topics
 
 
@@ -57,19 +77,21 @@ def _resolve_docs_dir(ctx: click.Context) -> Path | None:
     # executes subcommands in child contexts that do not inherit params.
     current: click.Context | None = ctx
     while current is not None:
-        docs_dir = (current.params or {}).get("docs_dir")
-        if docs_dir:
-            path = docs_dir if isinstance(docs_dir, Path) else Path(docs_dir)
+        docs_dir_opt = (current.params or {}).get("docs_dir")
+        if docs_dir_opt:
+            path = docs_dir_opt if isinstance(docs_dir_opt, Path) else Path(docs_dir_opt)
             path = path.expanduser()
             if path.exists():
                 return path
         current = current.parent
+
     # Env var next
     env_dir = os.getenv("SVC_INFRA_DOCS_DIR")
     if env_dir:
         p = Path(env_dir).expanduser()
         if p.exists():
             return p
+
     # Project docs
     root = resolve_project_root()
     proj_docs = root / "docs"
@@ -88,16 +110,15 @@ class DocsGroup(TyperGroup):
         names.extend([k for k in fs.keys()])
         names.extend([k for k in pkg.keys() if k not in fs])
         # Deduplicate and sort
-        uniq = sorted({*names})
-        return uniq
+        return sorted({*names})
 
     def get_command(self, ctx: click.Context, name: str) -> click.Command | None:
-        # Built-ins first (e.g., list)
+        # Built-ins first (e.g., list, show)
         cmd = super().get_command(ctx, name)
         if cmd is not None:
             return cmd
 
-        # Dynamic topic resolution
+        # Dynamic topic resolution from FS
         dir_to_use = _resolve_docs_dir(ctx)
         fs = _discover_fs_topics(dir_to_use) if dir_to_use else {}
         if name in fs:
@@ -145,6 +166,10 @@ def register(app: typer.Typer) -> None:
             if topic in fs:
                 typer.echo(fs[topic].read_text(encoding="utf-8", errors="replace"))
                 raise typer.Exit(code=0)
+            pkg = _discover_pkg_topics()
+            if topic in pkg:
+                typer.echo(pkg[topic].read_text(encoding="utf-8", errors="replace"))
+                raise typer.Exit(code=0)
             raise typer.BadParameter(f"Unknown topic: {topic}")
 
     @docs_app.command("list", help="List available documentation topics")

{svc_infra-0.1.619.dist-info → svc_infra-0.1.620.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: svc-infra
-Version: 0.1.619
+Version: 0.1.620
 Summary: Infrastructure for building and deploying prod-ready services
 License: MIT
 Keywords: fastapi,sqlalchemy,alembic,auth,infra,async,pydantic

{svc_infra-0.1.619.dist-info → svc_infra-0.1.620.dist-info}/RECORD

@@ -142,7 +142,7 @@ svc_infra/cli/cmds/db/sql/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 svc_infra/cli/cmds/db/sql/alembic_cmds.py,sha256=uCreHg69Zf6B5gbv9Dm39jCRk6q2KQy_05A-75IP0Fg,9650
 svc_infra/cli/cmds/db/sql/sql_export_cmds.py,sha256=YpkguUJFeFApMphVkhOJllTi25ejlsQaJarMe6vJD54,2685
 svc_infra/cli/cmds/db/sql/sql_scaffold_cmds.py,sha256=MKc_T_tY1Y_wQl7XTlq8GhYWMMI1q1_vcFZVPOEcNUg,4601
-svc_infra/cli/cmds/docs/docs_cmds.py,sha256=nvqxkqeYNSV79Eeq0Kv8PN1M8CbyS3lnrFNjHNlO53w,6661
+svc_infra/cli/cmds/docs/docs_cmds.py,sha256=vRDhddel_X9MCfCVRvV7_Ns7sB3awfwSVWV0HqKLRKg,7653
 svc_infra/cli/cmds/dx/__init__.py,sha256=wQtl3-kOgoESlpVkjl3YFtqkOnQSIvVsOdutiaZFejM,197
 svc_infra/cli/cmds/dx/dx_cmds.py,sha256=XTKUJzS3UIYn6h3CHzDEWKYJaWn0TzGiUCq3OeW27E0,3326
 svc_infra/cli/cmds/help.py,sha256=wGfZFMYaR2ZPwW2JwKDU7M3m4AtdCd8GRQ412AmEBUM,758
@@ -296,7 +296,7 @@ svc_infra/webhooks/fastapi.py,sha256=BCNvGNxukf6dC2a4i-6en-PrjBGV19YvCWOot5lXWsA
 svc_infra/webhooks/router.py,sha256=6JvAVPMEth_xxHX-IsIOcyMgHX7g1H0OVxVXKLuMp9w,1596
 svc_infra/webhooks/service.py,sha256=hWgiJRXKBwKunJOx91C7EcLUkotDtD3Xp0RT6vj2IC0,1797
 svc_infra/webhooks/signing.py,sha256=NCwdZzmravUe7HVIK_uXK0qqf12FG-_MVsgPvOw6lsM,784
-svc_infra-0.1.619.dist-info/METADATA,sha256=yoqsuCYdTjgJVgqMPZDDVIjbd5xDW7KQ7XbNRlbsPfA,8106
-svc_infra-0.1.619.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-svc_infra-0.1.619.dist-info/entry_points.txt,sha256=6x_nZOsjvn6hRZsMgZLgTasaCSKCgAjsGhACe_CiP0U,48
-svc_infra-0.1.619.dist-info/RECORD,,
+svc_infra-0.1.620.dist-info/METADATA,sha256=Ii8wzmysVqUARGfBUES-2TQIMzhyeAGvGimkSTMIpYg,8106
+svc_infra-0.1.620.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+svc_infra-0.1.620.dist-info/entry_points.txt,sha256=6x_nZOsjvn6hRZsMgZLgTasaCSKCgAjsGhACe_CiP0U,48
+svc_infra-0.1.620.dist-info/RECORD,,