pkgmap-py 0.1.1__tar.gz → 0.2.0__tar.gz

{pkgmap_py-0.1.1 → pkgmap_py-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pkgmap-py
-Version: 0.1.1
+Version: 0.2.0
 Summary: Cross-distribution Linux package name resolution
 Author: Levizor
 Author-email: Levizor <levizor@disroot.org>
@@ -19,9 +19,10 @@ Cross-distribution Linux package name resolution.
 
 Different distributions often package the exact same software under different names (for example, `ninja` on Arch is `ninja-build` on Debian and Alpine; `bat` on Arch is `rust-bat` on Debian and Fedora; `fd` on Arch is `rust-fd-find` on Debian; Nixpkgs uses specific attribute paths). `pkgmap` provides an offline SQLite database and a companion Python library/CLI to translate package names between any pair of Linux distributions, resolve packages across all repositories, or look up native packages by upstream project name.
 
-Data is updated daily from [Repology](https://repology.org) and indexed for instant local lookups. On first run, `pkgmap` automatically downloads and decompresses the latest daily database release (`~/.cache/pkgmap/pkgmap.db`).
+Data is updated daily from [Repology](https://repology.org) and indexed for instant local lookups. On first run, `pkgmap` automatically downloads and decompresses the latest daily database snapshot (`~/.cache/pkgmap/`).
 
-The package is available on PyPI as [`pkgmap-py`](https://pypi.org/project/pkgmap-py/).
+- **PyPI**: [`pkgmap-py`](https://pypi.org/project/pkgmap-py/)
+- **Web Interface**: [levizor.github.io/pkgmap](https://levizor.github.io/pkgmap/) (runs 100% client-side via SQLite WebAssembly + OPFS)
 
 ---
 
@@ -34,13 +35,28 @@ Use `--from` (`-f`) and `--to` (`-t`):
 ```bash
 # What is Arch's 'bat' called in Debian?
 pkgmap resolve bat --from arch --to debian
-# Output: rust-bat (0.22.1) [category: misc]
+# Output: rust-bat (0.24.0)
 
 # What is Arch's 'fd' in Nixpkgs?
 pkgmap resolve fd -f arch -t nixpkgs
 # Output: fd (10.5.0)
 ```
 
+### Batch resolution
+
+Pass multiple package names to resolve them in a single query:
+
+```bash
+pkgmap resolve git gcc bat --from nix --to gnuguix
+```
+
+Output:
+```text
+git -> git (2.54.0)
+gcc -> gcc (15.2.0)
+bat -> bat (0.26.1)
+```
+
 ### Resolve across all distributions
 
 Omit `--to` to see equivalents across every indexed distribution:
@@ -51,8 +67,8 @@ pkgmap resolve bat --from arch
 
 Output:
 ```text
-alpine_3_20: bat (0.24.0)
-debian_12: rust-bat (0.22.1) [category: misc]
+alpine_edge: bat (0.24.0)
+debian_unstable: rust-bat (0.24.0)
 fedora_rawhide: rust-bat (0.26.1)
 nix_unstable: bat (0.26.1)
 ubuntu_24_04: rust-bat (0.24.0)
@@ -65,7 +81,7 @@ Omit `--from` (or pass `--project` / `-p`) to resolve packages directly from an
 
 ```bash
 pkgmap resolve ripgrep --to debian
-# Output: rust-ripgrep (13.0.0) [category: misc]
+# Output: rust-ripgrep (14.1.0)
 ```
 
 ### JSON output
@@ -80,13 +96,15 @@ pkgmap resolve bat -f arch -t debian --json
 [
   {
     "name": "rust-bat",
-    "version": "0.22.1",
-    "repo": "debian_12",
+    "version": "0.24.0",
+    "repo": "debian_unstable",
     "repo_family": "debuntu"
   }
 ]
 ```
 
+When multiple packages are passed with `--json`, the output is a dictionary keyed by each input package name.
+
 ### Other commands
 
 ```bash
@@ -95,22 +113,42 @@ pkgmap repos
 
 # Manually refresh the local database snapshot
 pkgmap update
+
+# Download the full database (all 330+ Repology repositories)
+pkgmap update --full
 ```
 
 ---
 
+## Core vs. Full Database Variants
+
+`pkgmap` publishes two database snapshots with every daily release:
+
+| Variant | File | Compressed Size | Coverage | Default For |
+| :--- | :--- | :--- | :--- | :--- |
+| **Core** | `pkgmap-core.db` | ~7 MB | Top 10 repositories (Nixpkgs, Arch, AUR, Debian, Ubuntu, Fedora, Alpine, openSUSE, Gentoo, Void) | **CLI & Web UI** |
+| **Full** | `pkgmap.db` | ~37 MB | All 330+ Repology repositories | **Python Library** |
+
+- **CLI behavior**: Defaults to the **Core** database (`~/.cache/pkgmap/pkgmap-core.db`) unless the Full database is already downloaded locally or `--full` is passed. If you query a repository not present in Core, the CLI prompts you to run `pkgmap update --full`. You can also pass `--core` or `--full` to any CLI command (`resolve`, `update`, `repos`).
+- **Python library behavior**: Defaults to the **Full** database (`~/.cache/pkgmap/pkgmap.db`). Call `set_default_variant("core")` (or set `PKGMAP_DB_VARIANT=core`) to use the Core database instead.
+
+---
+
 ## Python API
 
-You can also use `pkgmap` as a Python library:
+You can use `pkgmap` as a Python library:
 
 ```python
-from pkgmap import resolve, resolve_all, resolve_batch
+from pkgmap import resolve, resolve_all, resolve_batch, set_default_variant
+
+# Optional: switch library default from 'full' to 'core'
+# set_default_variant("core")
 
 # 1. Single package resolution
 res = resolve("bat", from_repo="arch", to_repo="debian")
 if res:
     print(res.name, res.version)
-    # Output: rust-bat 0.22.1
+    # Output: rust-bat 0.24.0
 
 # 2. Query all repositories for equivalents
 matches = resolve_all("bat", from_repo="arch")
@@ -133,20 +171,24 @@ for pkg, match in results.items():
 - `resolve_batch(packages, from_repo=None, to_repo=None, db_path=None)`: Resolves a sequence of packages in a single batch query, returning `{package: PackageResolution | None}`.
 - `resolve_batch_all(packages, from_repo=None, to_repo=None, db_path=None)`: Batch resolution returning `{package: list[PackageResolution]}`.
 - `list_repositories(db_path=None)`: Returns all repositories with package counts and families.
+- `set_default_variant(variant)`: Sets the default database variant (`"full"` or `"core"`).
+- `get_default_variant()`: Returns the active default database variant.
 
 ---
 
 ## Configuration
 
-By default, the database is stored at:
-- `~/.cache/pkgmap/pkgmap.db`
+By default, databases are cached at:
+- Full database: `~/.cache/pkgmap/pkgmap.db`
+- Core database: `~/.cache/pkgmap/pkgmap-core.db`
 
-You can customize the location using:
-- The `PKGMAP_DB_PATH` environment variable:
+You can customize behavior using environment variables:
+- `PKGMAP_DB_VARIANT`: Set to `core` or `full` to override the default database variant.
+- `PKGMAP_DB_PATH`: Override the database file path directly:
   ```bash
   export PKGMAP_DB_PATH="/path/to/custom/pkgmap.db"
   ```
-- Or the `--db-path` argument on the CLI / `db_path` parameter in Python.
+- Or pass `--db-path` on the CLI / `db_path` in Python.
 
 ---
 

{pkgmap_py-0.1.1 → pkgmap_py-0.2.0}/README.md

@@ -4,9 +4,10 @@ Cross-distribution Linux package name resolution.
 
 Different distributions often package the exact same software under different names (for example, `ninja` on Arch is `ninja-build` on Debian and Alpine; `bat` on Arch is `rust-bat` on Debian and Fedora; `fd` on Arch is `rust-fd-find` on Debian; Nixpkgs uses specific attribute paths). `pkgmap` provides an offline SQLite database and a companion Python library/CLI to translate package names between any pair of Linux distributions, resolve packages across all repositories, or look up native packages by upstream project name.
 
-Data is updated daily from [Repology](https://repology.org) and indexed for instant local lookups. On first run, `pkgmap` automatically downloads and decompresses the latest daily database release (`~/.cache/pkgmap/pkgmap.db`).
+Data is updated daily from [Repology](https://repology.org) and indexed for instant local lookups. On first run, `pkgmap` automatically downloads and decompresses the latest daily database snapshot (`~/.cache/pkgmap/`).
 
-The package is available on PyPI as [`pkgmap-py`](https://pypi.org/project/pkgmap-py/).
+- **PyPI**: [`pkgmap-py`](https://pypi.org/project/pkgmap-py/)
+- **Web Interface**: [levizor.github.io/pkgmap](https://levizor.github.io/pkgmap/) (runs 100% client-side via SQLite WebAssembly + OPFS)
 
 ---
 
@@ -19,13 +20,28 @@ Use `--from` (`-f`) and `--to` (`-t`):
 ```bash
 # What is Arch's 'bat' called in Debian?
 pkgmap resolve bat --from arch --to debian
-# Output: rust-bat (0.22.1) [category: misc]
+# Output: rust-bat (0.24.0)
 
 # What is Arch's 'fd' in Nixpkgs?
 pkgmap resolve fd -f arch -t nixpkgs
 # Output: fd (10.5.0)
 ```
 
+### Batch resolution
+
+Pass multiple package names to resolve them in a single query:
+
+```bash
+pkgmap resolve git gcc bat --from nix --to gnuguix
+```
+
+Output:
+```text
+git -> git (2.54.0)
+gcc -> gcc (15.2.0)
+bat -> bat (0.26.1)
+```
+
 ### Resolve across all distributions
 
 Omit `--to` to see equivalents across every indexed distribution:
@@ -36,8 +52,8 @@ pkgmap resolve bat --from arch
 
 Output:
 ```text
-alpine_3_20: bat (0.24.0)
-debian_12: rust-bat (0.22.1) [category: misc]
+alpine_edge: bat (0.24.0)
+debian_unstable: rust-bat (0.24.0)
 fedora_rawhide: rust-bat (0.26.1)
 nix_unstable: bat (0.26.1)
 ubuntu_24_04: rust-bat (0.24.0)
@@ -50,7 +66,7 @@ Omit `--from` (or pass `--project` / `-p`) to resolve packages directly from an
 
 ```bash
 pkgmap resolve ripgrep --to debian
-# Output: rust-ripgrep (13.0.0) [category: misc]
+# Output: rust-ripgrep (14.1.0)
 ```
 
 ### JSON output
@@ -65,13 +81,15 @@ pkgmap resolve bat -f arch -t debian --json
 [
   {
     "name": "rust-bat",
-    "version": "0.22.1",
-    "repo": "debian_12",
+    "version": "0.24.0",
+    "repo": "debian_unstable",
     "repo_family": "debuntu"
   }
 ]
 ```
 
+When multiple packages are passed with `--json`, the output is a dictionary keyed by each input package name.
+
 ### Other commands
 
 ```bash
@@ -80,22 +98,42 @@ pkgmap repos
 
 # Manually refresh the local database snapshot
 pkgmap update
+
+# Download the full database (all 330+ Repology repositories)
+pkgmap update --full
 ```
 
 ---
 
+## Core vs. Full Database Variants
+
+`pkgmap` publishes two database snapshots with every daily release:
+
+| Variant | File | Compressed Size | Coverage | Default For |
+| :--- | :--- | :--- | :--- | :--- |
+| **Core** | `pkgmap-core.db` | ~7 MB | Top 10 repositories (Nixpkgs, Arch, AUR, Debian, Ubuntu, Fedora, Alpine, openSUSE, Gentoo, Void) | **CLI & Web UI** |
+| **Full** | `pkgmap.db` | ~37 MB | All 330+ Repology repositories | **Python Library** |
+
+- **CLI behavior**: Defaults to the **Core** database (`~/.cache/pkgmap/pkgmap-core.db`) unless the Full database is already downloaded locally or `--full` is passed. If you query a repository not present in Core, the CLI prompts you to run `pkgmap update --full`. You can also pass `--core` or `--full` to any CLI command (`resolve`, `update`, `repos`).
+- **Python library behavior**: Defaults to the **Full** database (`~/.cache/pkgmap/pkgmap.db`). Call `set_default_variant("core")` (or set `PKGMAP_DB_VARIANT=core`) to use the Core database instead.
+
+---
+
 ## Python API
 
-You can also use `pkgmap` as a Python library:
+You can use `pkgmap` as a Python library:
 
 ```python
-from pkgmap import resolve, resolve_all, resolve_batch
+from pkgmap import resolve, resolve_all, resolve_batch, set_default_variant
+
+# Optional: switch library default from 'full' to 'core'
+# set_default_variant("core")
 
 # 1. Single package resolution
 res = resolve("bat", from_repo="arch", to_repo="debian")
 if res:
     print(res.name, res.version)
-    # Output: rust-bat 0.22.1
+    # Output: rust-bat 0.24.0
 
 # 2. Query all repositories for equivalents
 matches = resolve_all("bat", from_repo="arch")
@@ -118,20 +156,24 @@ for pkg, match in results.items():
 - `resolve_batch(packages, from_repo=None, to_repo=None, db_path=None)`: Resolves a sequence of packages in a single batch query, returning `{package: PackageResolution | None}`.
 - `resolve_batch_all(packages, from_repo=None, to_repo=None, db_path=None)`: Batch resolution returning `{package: list[PackageResolution]}`.
 - `list_repositories(db_path=None)`: Returns all repositories with package counts and families.
+- `set_default_variant(variant)`: Sets the default database variant (`"full"` or `"core"`).
+- `get_default_variant()`: Returns the active default database variant.
 
 ---
 
 ## Configuration
 
-By default, the database is stored at:
-- `~/.cache/pkgmap/pkgmap.db`
+By default, databases are cached at:
+- Full database: `~/.cache/pkgmap/pkgmap.db`
+- Core database: `~/.cache/pkgmap/pkgmap-core.db`
 
-You can customize the location using:
-- The `PKGMAP_DB_PATH` environment variable:
+You can customize behavior using environment variables:
+- `PKGMAP_DB_VARIANT`: Set to `core` or `full` to override the default database variant.
+- `PKGMAP_DB_PATH`: Override the database file path directly:
   ```bash
   export PKGMAP_DB_PATH="/path/to/custom/pkgmap.db"
   ```
-- Or the `--db-path` argument on the CLI / `db_path` parameter in Python.
+- Or pass `--db-path` on the CLI / `db_path` in Python.
 
 ---
 

{pkgmap_py-0.1.1 → pkgmap_py-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pkgmap-py"
-version = "0.1.1"
+version = "0.2.0"
 description = "Cross-distribution Linux package name resolution"
 readme = "README.md"
 requires-python = ">=3.12"

{pkgmap_py-0.1.1 → pkgmap_py-0.2.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "pkgmap-py"
-version = "0.1.1"
+version = "0.2.0"
 description = "Cross-distribution Linux package name resolution"
 authors = [{ name = "Levizor", email = "levizor@disroot.org" }]
 license = { text = "MIT" }

{pkgmap_py-0.1.1 → pkgmap_py-0.2.0}/src/pkgmap/__init__.py

@@ -1,6 +1,13 @@
 """Cross-distribution Linux package name resolution library."""
 
-from pkgmap.db import ensure_database, get_database_path, update_database
+from pkgmap.db import (
+    DatabaseVariant,
+    ensure_database,
+    get_database_path,
+    get_default_variant,
+    set_default_variant,
+    update_database,
+)
 from pkgmap.resolver import (
     PackageResolution,
     list_repositories,
@@ -11,16 +18,19 @@ from pkgmap.resolver import (
     resolve_project,
 )
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __all__ = [
+    "DatabaseVariant",
     "PackageResolution",
     "ensure_database",
     "get_database_path",
+    "get_default_variant",
     "list_repositories",
     "resolve",
     "resolve_all",
     "resolve_batch",
     "resolve_batch_all",
     "resolve_project",
+    "set_default_variant",
     "update_database",
 ]

{pkgmap_py-0.1.1 → pkgmap_py-0.2.0}/src/pkgmap/apps.py

@@ -53,6 +53,21 @@ def pipeline_build(
             help="Path for the output SQLite database",
         ),
     ] = Path("pkgmap.db"),
+    core_output_file: Annotated[
+        Path | None,
+        typer.Option(
+            "-c",
+            "--core-output-path",
+            help="Optional path for the core subset SQLite database (e.g. pkgmap-core.db)",
+        ),
+    ] = None,
+    repos_config: Annotated[
+        Path | None,
+        typer.Option(
+            "--repos-config",
+            help="Optional path to repos.toml configuration file",
+        ),
+    ] = None,
     batch_size: Annotated[
         int,
         typer.Option(
@@ -73,6 +88,8 @@ def pipeline_build(
     pipeline.main(
         dump_file=input_dump,
         output_file=output_file,
+        core_output_file=core_output_file,
+        repos_config=repos_config,
         batch_size=batch_size,
         release_notes=release_notes,
         dump_date=dump_date,

pkgmap_py-0.2.0/src/pkgmap/cli.py

@@ -0,0 +1,267 @@
+import json
+from pathlib import Path
+from typing import Annotated
+
+import typer
+
+from pkgmap.db import (
+    DatabaseVariant,
+    get_database_path,
+    resolve_cli_variant,
+    set_default_variant,
+    update_database,
+)
+from pkgmap.resolver import (
+    get_missing_repositories,
+    list_repositories,
+    resolve_batch_all,
+)
+
+cli_app = typer.Typer(
+    name="pkgmap",
+    help="Cross-distribution Linux package name resolution CLI",
+    add_completion=False,
+)
+
+
+def _select_variant(core: bool, full: bool) -> DatabaseVariant:
+    if core and full:
+        typer.secho(
+            "Error: Cannot specify both --core and --full.",
+            fg=typer.colors.RED,
+        )
+        raise typer.Exit(code=2)
+    variant = resolve_cli_variant(full=full, core=core)
+    set_default_variant(variant)
+    return variant
+
+
+@cli_app.callback()
+def cli_callback(
+    verbose: Annotated[
+        bool,
+        typer.Option("--verbose", "-v", help="Enable verbose debug logging"),
+    ] = False,
+) -> None:
+    if verbose:
+        import logging
+
+        for name in ("pkgmap", "pkgmap-db", "pkgmap-downloader", "pkgmap-consumer"):
+            log = logging.getLogger(name)
+            log.setLevel(logging.DEBUG)
+            for handler in log.handlers:
+                handler.setLevel(logging.DEBUG)
+
+
+def _format_not_found_msg(
+    package: str,
+    from_repo: str | None,
+    to_repo: str | None,
+    project: bool,
+) -> str:
+    if from_repo and not project:
+        if to_repo:
+            return f"No equivalent package found for '{package}' from '{from_repo}' to '{to_repo}'."
+        return f"No equivalent package found for '{package}' from '{from_repo}'."
+    if to_repo:
+        return f"No equivalent package found for project '{package}' in '{to_repo}'."
+    return f"No equivalent package found for project '{package}'."
+
+
+@cli_app.command(name="resolve")
+def resolve_cmd(
+    packages: Annotated[
+        list[str],
+        typer.Argument(help="Package or upstream project name(s) to resolve"),
+    ],
+    to_repo: Annotated[
+        str | None,
+        typer.Option(
+            "--to",
+            "-t",
+            help="Target repository/distribution (e.g. nixpkgs, alpine). If omitted, matches across all repositories.",
+        ),
+    ] = None,
+    from_repo: Annotated[
+        str | None,
+        typer.Option(
+            "--from",
+            "-f",
+            help="Source repository/distribution (e.g. debian, arch). If omitted, package is resolved by upstream project name.",
+        ),
+    ] = None,
+    project: Annotated[
+        bool,
+        typer.Option(
+            "--project",
+            "-p",
+            help="Resolve package directly as an upstream project name",
+        ),
+    ] = False,
+    all_matches: Annotated[
+        bool,
+        typer.Option("--all", "-a", help="Show all matching target packages"),
+    ] = False,
+    json_output: Annotated[
+        bool,
+        typer.Option("--json", "-j", help="Output results in JSON format"),
+    ] = False,
+    core: Annotated[
+        bool,
+        typer.Option("--core", help="Use the core database (top 10 repositories)"),
+    ] = False,
+    full: Annotated[
+        bool,
+        typer.Option("--full", help="Use the full database (all repositories)"),
+    ] = False,
+    db_path: Annotated[
+        Path | None,
+        typer.Option("--db-path", help="Custom path to pkgmap.db database"),
+    ] = None,
+) -> None:
+    """Resolve one or more package names across Linux distributions."""
+    if project and from_repo:
+        typer.secho(
+            "Error: Cannot specify both --from and --project.",
+            fg=typer.colors.RED,
+        )
+        raise typer.Exit(code=2)
+
+    variant = _select_variant(core=core, full=full)
+    effective_from = from_repo if not project else None
+    batch_results = resolve_batch_all(
+        packages,
+        from_repo=effective_from,
+        to_repo=to_repo,
+        db_path=db_path,
+    )
+
+    is_batch = len(packages) > 1
+    any_found = any(batch_results.get(pkg) for pkg in packages)
+
+    if not any_found:
+        if json_output:
+            empty_payload: list[object] | dict[str, list[object]] = (
+                {pkg: [] for pkg in packages} if is_batch else []
+            )
+            typer.echo(json.dumps(empty_payload, indent=2 if is_batch else None))
+        else:
+            for pkg in packages:
+                msg = _format_not_found_msg(pkg, from_repo, to_repo, project)
+                typer.secho(msg, fg=typer.colors.YELLOW)
+
+            requested_repos = [r for r in (from_repo, to_repo) if r]
+            missing_repos = get_missing_repositories(requested_repos, db_path=db_path)
+            if missing_repos and variant == "core":
+                missing_str = ", ".join(f"'{r}'" for r in missing_repos)
+                typer.secho(
+                    f"Repository {missing_str} is not in the core database. "
+                    "Try the full database with: pkgmap update --full",
+                    fg=typer.colors.CYAN,
+                )
+        raise typer.Exit(code=1)
+
+    if json_output:
+        if not is_batch:
+            pkg = packages[0]
+            matches = batch_results.get(pkg, [])
+            items = matches if (all_matches or to_repo is None) else matches[:1]
+            data = [
+                {
+                    "name": r.name,
+                    "version": r.version,
+                    "repo": r.repo,
+                    "repo_family": r.repo_family,
+                }
+                for r in items
+            ]
+            typer.echo(json.dumps(data, indent=2))
+        else:
+            batch_data = {
+                pkg: [
+                    {
+                        "name": r.name,
+                        "version": r.version,
+                        "repo": r.repo,
+                        "repo_family": r.repo_family,
+                    }
+                    for r in (
+                        batch_results.get(pkg, [])
+                        if (all_matches or to_repo is None)
+                        else batch_results.get(pkg, [])[:1]
+                    )
+                ]
+                for pkg in packages
+            }
+            typer.echo(json.dumps(batch_data, indent=2))
+        return
+
+    for pkg in packages:
+        matches = batch_results.get(pkg, [])
+        items_to_show = matches if (all_matches or to_repo is None) else matches[:1]
+        if not items_to_show:
+            typer.secho(f"{pkg} -> not found", fg=typer.colors.YELLOW)
+            continue
+        for res in items_to_show:
+            version_str = f" ({res.version})" if res.version else ""
+            repo_prefix = f"{res.repo}: " if to_repo is None else ""
+            pkg_prefix = f"{pkg} -> " if is_batch else ""
+            typer.echo(f"{pkg_prefix}{repo_prefix}{res.name}{version_str}")
+
+
+@cli_app.command(name="update")
+def update_cmd(
+    core: Annotated[
+        bool,
+        typer.Option("--core", help="Download the core database (top 10 repositories)"),
+    ] = False,
+    full: Annotated[
+        bool,
+        typer.Option("--full", help="Download the full database (all repositories)"),
+    ] = False,
+    db_path: Annotated[
+        Path | None,
+        typer.Option("--db-path", help="Custom path to save pkgmap.db database"),
+    ] = None,
+) -> None:
+    """Explicitly download and update the local package map database."""
+    variant = _select_variant(core=core, full=full)
+    target_path = get_database_path(db_path, variant=variant)
+    typer.echo(f"Updating {variant} package database at {target_path}...")
+    update_database(db_path=target_path, show_progress=True, variant=variant)
+    typer.secho(
+        f"Successfully updated {variant} database at {target_path}",
+        fg=typer.colors.GREEN,
+    )
+
+
+@cli_app.command(name="repos")
+def repos_cmd(
+    core: Annotated[
+        bool,
+        typer.Option("--core", help="List repositories from the core database"),
+    ] = False,
+    full: Annotated[
+        bool,
+        typer.Option("--full", help="List repositories from the full database"),
+    ] = False,
+    db_path: Annotated[
+        Path | None,
+        typer.Option("--db-path", help="Custom path to pkgmap.db database"),
+    ] = None,
+) -> None:
+    """List all available distributions and repositories."""
+    _select_variant(core=core, full=full)
+    repos = list_repositories(db_path=db_path)
+    typer.echo(f"{'Repository':<25} {'Family':<15} {'Packages':>10}")
+    typer.echo("-" * 52)
+    for r in sorted(repos, key=lambda x: x.name):
+        typer.echo(f"{r.name:<25} {r.family:<15} {r.package_count:>10,}")
+
+
+def main() -> None:
+    cli_app()
+
+
+if __name__ == "__main__":
+    main()