countrycodes-cli 0.1.0rc2__tar.gz

countrycodes_cli-0.1.0rc2/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, CountryCodes developers.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

countrycodes_cli-0.1.0rc2/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: countrycodes-cli
+Version: 0.1.0rc2
+Summary: Command-line interface for the countrycodes library
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Requires-Dist: countrycodes==0.1.0rc2
+Requires-Dist: rich>=13.7.1
+Requires-Dist: typer>=0.24.1
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# countrycodes-cli
+
+[![GitHub](https://img.shields.io/badge/GitHub-code-blue)](https://github.com/oyghen/countrycodes/tree/main/packages/countrycodes-cli)
+[![PyPI](https://img.shields.io/pypi/v/countrycodes-cli?label=PyPI)](https://pypi.org/project/countrycodes-cli/)
+[![License](https://img.shields.io/badge/License-BSD--3--Clause-blue)](https://github.com/oyghen/countrycodes/blob/main/packages/countrycodes-cli/LICENSE)
+[![CI](https://github.com/oyghen/countrycodes/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/oyghen/countrycodes/actions/workflows/ci.yml)
+
+</div>
+
+Command-line interface for the [`countrycodes`](https://pypi.org/project/countrycodes/)
+ISO 3166-1 lookup library.
+
+## Installation
+
+Install as a command-line tool with [uv](https://docs.astral.sh/uv/):
+
+```console
+uv tool install countrycodes-cli
+```
+
+Or install into the active Python environment:
+
+```console
+python -m pip install countrycodes-cli
+```
+
+Requires Python 3.11 or newer. The library dependency is installed automatically.
+
+## Usage
+
+Look up a country by code or name:
+
+```console
+countrycodes lookup US
+countrycodes lookup "United Kingdom"
+```
+
+Lookups are displayed as a table by default. Choose JSON output or list all
+countries:
+
+```console
+countrycodes lookup GBR --format json
+countrycodes list
+countrycodes list --format json
+```
+
+The default list is rendered as a table sorted by alpha-2 code, with a row
+number. JSON output remains an unnumbered array of country records.
+
+See all options with:
+
+```console
+countrycodes --help
+```
+
+## License
+
+The CLI code is licensed under BSD 3-Clause. The separately distributed
+`countrycodes` library includes ISO registry data under LGPL-2.1-or-later and
+continent assignments from GeoNames under CC BY 4.0; installing the CLI
+installs that library as a dependency.

countrycodes_cli-0.1.0rc2/README.md

@@ -0,0 +1,63 @@
+<div align="center">
+
+# countrycodes-cli
+
+[![GitHub](https://img.shields.io/badge/GitHub-code-blue)](https://github.com/oyghen/countrycodes/tree/main/packages/countrycodes-cli)
+[![PyPI](https://img.shields.io/pypi/v/countrycodes-cli?label=PyPI)](https://pypi.org/project/countrycodes-cli/)
+[![License](https://img.shields.io/badge/License-BSD--3--Clause-blue)](https://github.com/oyghen/countrycodes/blob/main/packages/countrycodes-cli/LICENSE)
+[![CI](https://github.com/oyghen/countrycodes/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/oyghen/countrycodes/actions/workflows/ci.yml)
+
+</div>
+
+Command-line interface for the [`countrycodes`](https://pypi.org/project/countrycodes/)
+ISO 3166-1 lookup library.
+
+## Installation
+
+Install as a command-line tool with [uv](https://docs.astral.sh/uv/):
+
+```console
+uv tool install countrycodes-cli
+```
+
+Or install into the active Python environment:
+
+```console
+python -m pip install countrycodes-cli
+```
+
+Requires Python 3.11 or newer. The library dependency is installed automatically.
+
+## Usage
+
+Look up a country by code or name:
+
+```console
+countrycodes lookup US
+countrycodes lookup "United Kingdom"
+```
+
+Lookups are displayed as a table by default. Choose JSON output or list all
+countries:
+
+```console
+countrycodes lookup GBR --format json
+countrycodes list
+countrycodes list --format json
+```
+
+The default list is rendered as a table sorted by alpha-2 code, with a row
+number. JSON output remains an unnumbered array of country records.
+
+See all options with:
+
+```console
+countrycodes --help
+```
+
+## License
+
+The CLI code is licensed under BSD 3-Clause. The separately distributed
+`countrycodes` library includes ISO registry data under LGPL-2.1-or-later and
+continent assignments from GeoNames under CC BY 4.0; installing the CLI
+installs that library as a dependency.

countrycodes_cli-0.1.0rc2/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "countrycodes-cli"
+version = "0.1.0rc2"
+description = "Command-line interface for the countrycodes library"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+dependencies = [
+    "countrycodes==0.1.0rc2",
+    "rich>=13.7.1",
+    "typer>=0.24.1",
+]
+
+[project.scripts]
+countrycodes = "countrycodes_cli.cli:app"
+
+[tool.uv.sources.countrycodes]
+workspace = true
+
+[build-system]
+requires = ["uv_build>=0.11.7,<0.12.0"]
+build-backend = "uv_build"

countrycodes_cli-0.1.0rc2/pyproject.toml.orig

@@ -0,0 +1,19 @@
+[project]
+name = "countrycodes-cli"
+version = "0.1.0rc2"
+description = "Command-line interface for the countrycodes library"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+dependencies = ["countrycodes==0.1.0rc2", "rich>=13.7.1", "typer>=0.24.1"]
+
+[project.scripts]
+countrycodes = "countrycodes_cli.cli:app"
+
+[tool.uv.sources]
+countrycodes = { workspace = true }
+
+[build-system]
+requires = ["uv_build>=0.11.7,<0.12.0"]
+build-backend = "uv_build"

countrycodes_cli-0.1.0rc2/src/countrycodes_cli/__init__.py

@@ -0,0 +1,7 @@
+"""Command-line application for the countrycodes library."""
+
+__all__ = ["__version__"]
+
+from importlib import metadata
+
+__version__ = metadata.version(__name__)

countrycodes_cli-0.1.0rc2/src/countrycodes_cli/cli.py

@@ -0,0 +1,102 @@
+"""Command-line interface for country code lookups."""
+
+import json
+from dataclasses import asdict
+from typing import Annotated, Literal
+
+import countrycodes as cc
+import typer
+from rich.console import Console
+from rich.table import Table
+
+app = typer.Typer(add_completion=False)
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    version: bool = typer.Option(False, "--version", help="Show version and exit."),
+) -> None:
+    pkg_name = cc.__name__
+    pkg_version = typer.style(cc.__version__, fg=typer.colors.CYAN)
+
+    if version:
+        typer.echo(f"{pkg_name} {pkg_version}")
+        raise typer.Exit()
+    if ctx.invoked_subcommand is None:
+        typer.echo(f"{pkg_name} {pkg_version} ready. See --help for usage.")
+        raise typer.Exit()
+
+
+@app.command()
+def lookup(
+    query: Annotated[str, typer.Argument(help="Country name or ISO code.")],
+    output_format: Annotated[
+        Literal["text", "json"],
+        typer.Option("--format", help="Output format."),
+    ] = "text",
+) -> None:
+    """Look up a country by name or ISO code."""
+    try:
+        country = cc.get_country(query)
+    except cc.CountryNotFoundError as error:
+        typer.echo(str(error), err=True)
+        raise typer.Exit(1) from error
+
+    if output_format == "json":
+        typer.echo(json.dumps(asdict(country), ensure_ascii=False))
+    else:
+        table = Table(
+            "Alpha-2",
+            "Alpha-3",
+            "Numeric",
+            "Continent",
+            "Country",
+            show_lines=False,
+        )
+        table.add_row(
+            country.alpha2,
+            country.alpha3,
+            country.numeric,
+            country.continent,
+            country.name,
+        )
+        Console().print(table)
+
+
+@app.command(name="list")
+def list_countries(
+    output_format: Annotated[
+        Literal["text", "json"],
+        typer.Option("--format", help="Output format."),
+    ] = "text",
+) -> None:
+    """List all countries and territories."""
+    countries = sorted(cc.list_countries(), key=lambda country: country.alpha2)
+    if output_format == "json":
+        typer.echo(
+            json.dumps(
+                [asdict(country) for country in countries],
+                ensure_ascii=False,
+            )
+        )
+    else:
+        table = Table(
+            "#",
+            "Alpha-2",
+            "Alpha-3",
+            "Numeric",
+            "Continent",
+            "Country",
+            show_lines=False,
+        )
+        for index, country in enumerate(countries, start=1):
+            table.add_row(
+                str(index),
+                country.alpha2,
+                country.alpha3,
+                country.numeric,
+                country.continent,
+                country.name,
+            )
+        Console().print(table)