quantilica-cli 0.3.0__tar.gz

quantilica_cli-0.3.0/.githooks/pre-commit

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# Formata e verifica os arquivos Python staged com `ruff check --fix` e `ruff format` antes do commit.
+#
+# Instalação (uma vez por clone):
+#   git config core.hooksPath .githooks
+#
+set -euo pipefail
+
+cd "$(git rev-parse --show-toplevel)"
+
+mapfile -t files < <(git diff --cached --name-only --diff-filter=ACMR -- '*.py')
+
+if [ "${#files[@]}" -eq 0 ]; then
+    exit 0
+fi
+
+if ! uv run ruff check --fix "${files[@]}"; then
+    echo "pre-commit: ruff check falhou — commit abortado." >&2
+    exit 1
+fi
+
+if ! uv run ruff format "${files[@]}"; then
+    echo "pre-commit: ruff format falhou — commit abortado." >&2
+    exit 1
+fi
+
+git add -- "${files[@]}"

quantilica_cli-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,66 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/quantilica-cli
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: publish-testpypi
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/quantilica-cli
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

quantilica_cli-0.3.0/.github/workflows/test.yml

@@ -0,0 +1,38 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --group dev
+
+      - name: Lint with ruff
+        run: |
+          uv run ruff check src/ tests/
+          uv run ruff format --check src/ tests/
+
+      - name: Run tests
+        run: uv run pytest

quantilica_cli-0.3.0/.gitignore

@@ -0,0 +1,38 @@
+# Build / packaging
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+
+# Virtual envs e caches do uv
+.venv/
+.uv-cache/
+
+# Lockfile — libs não versionam uv.lock
+uv.lock
+
+# Caches de teste / lint / tipos
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# Cobertura
+.coverage
+.coverage.*
+htmlcov/
+
+# Editor / IDE / OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+*.swp
+
+# Logs e env locais
+*.log
+.env
+.env.local
+
+# Claude
+.claude/

quantilica_cli-0.3.0/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+Todas as mudanças notáveis deste projeto serão documentadas neste arquivo.
+
+O formato segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/),
+e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/).
+
+## [0.3.0] - 2026-08-10
+
+### Adicionado
+- Extensão da `FetcherApp` (`sdk.py`) com suporte opcional para `FtpClient`.
+- Exposição do método `download_datasets` na `FetcherApp` para uso por comandos Typer customizados nos plugins.
+- Aceitação e passagem do parâmetro `aliases_dict` para personalização total dos subcomandos por fetcher.
+
+### Alterado
+- Padrão de metadados do pacote portado integralmente para a PEP 639 (licença) e PEP 561 (tipagem estática).
+
+## [0.2.2] - 2026-07-28
+*(Release retroativo não documentado)*
+
+## [0.2.0] - 2026-07-15
+*(Release retroativo não documentado)*
+
+## [0.1.0] - 2026-06-04
+
+Primeira entrada em formato Keep a Changelog; documenta o estado do pacote nesta
+versão.
+
+### Adicionado
+
+- CLI unificada `quantilica` que descobre e monta os fetchers instalados via
+  entry points `quantilica.fetchers`, sem depender diretamente dos pacotes de
+  fetcher.
+- Comando `list-sources` e montagem automática dos sub-apps Typer de cada fetcher
+  instalado (`quantilica <fonte> ...`).

quantilica_cli-0.3.0/LICENSE

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

quantilica_cli-0.3.0/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: quantilica-cli
+Version: 0.3.0
+Summary: Unified CLI for Quantilica open data fetchers
+Author-email: "Komesu, D.K." <daniel@dkko.me>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: brazil,cli,open-data,quantilica
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: quantilica-core>=0.4.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.15.0
+Description-Content-Type: text/markdown
+
+# quantilica-cli
+
+CLI unificada para o ecossistema Quantilica de dados abertos brasileiros.
+
+## Instalação
+
+```bash
+pip install quantilica-cli
+```
+
+Instale os fetchers desejados separadamente:
+
+```bash
+pip install comex-fetcher inmet-fetcher rtn-fetcher
+```
+
+## Uso
+
+```bash
+quantilica --help
+quantilica list-sources
+quantilica comex sync 2024
+quantilica inmet sync 2020 2021
+quantilica td sync --dataset prices
+```

quantilica_cli-0.3.0/README.md

@@ -0,0 +1,25 @@
+# quantilica-cli
+
+CLI unificada para o ecossistema Quantilica de dados abertos brasileiros.
+
+## Instalação
+
+```bash
+pip install quantilica-cli
+```
+
+Instale os fetchers desejados separadamente:
+
+```bash
+pip install comex-fetcher inmet-fetcher rtn-fetcher
+```
+
+## Uso
+
+```bash
+quantilica --help
+quantilica list-sources
+quantilica comex sync 2024
+quantilica inmet sync 2020 2021
+quantilica td sync --dataset prices
+```

quantilica_cli-0.3.0/pyproject.toml

@@ -0,0 +1,70 @@
+[project]
+name = "quantilica-cli"
+version = "0.3.0"
+description = "Unified CLI for Quantilica open data fetchers"
+readme = "README.md"
+authors = [{ name = "Komesu, D.K.", email = "daniel@dkko.me" }]
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+keywords = ["quantilica", "cli", "open-data", "brazil"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
+    "Typing :: Typed",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "quantilica-core>=0.4.0",
+    "rich>=13.0.0",
+    "typer>=0.15.0",
+]
+
+[project.scripts]
+quantilica = "quantilica.cli.cli:main"
+
+[dependency-groups]
+dev = ["ruff>=0.9.0", "pytest>=8.0.0"]
+
+# Os fetchers são instalados independentemente pelo usuário — quantilica-cli
+# os descobre via entry points (grupo "quantilica.fetchers") sem dependência direta.
+# Exemplo de instalação local para desenvolvimento:
+#   uv pip install -e ../comex-fetcher ../rtn-fetcher ...
+
+# Para desenvolvimento local do quantilica-core em conjunto com o CLI:
+# cd quantilica-cli && uv pip install -e ../quantilica-core (sem [tool.uv.sources])
+# Em produção, quantilica-core é instalado via git+https (declarado em dependencies).
+
+# [tool.hatch.metadata]
+# allow-direct-references = true
+
+[tool.hatch.build]
+sources = ["src"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/quantilica/cli"]
+
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["-p", "no:cacheprovider"]
+
+[tool.ruff]
+line-length = 88
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/quantilica/cli/sources.py" = ["E501"]
+"src/quantilica/cli/cli.py" = ["E501"]
+"src/quantilica/cli/sdk.py" = ["E501"]
+"tests/*" = ["E501"]

quantilica_cli-0.3.0/quantilica/cli/__init__.py

@@ -0,0 +1,10 @@
+"""Unified CLI for Quantilica open data fetchers."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("quantilica-cli")
+except PackageNotFoundError:
+    __version__ = "0.0.0"
+
+__all__ = ["__version__"]

quantilica_cli-0.3.0/quantilica/cli/cli.py

@@ -0,0 +1,154 @@
+"""Unified CLI entry point for Quantilica fetchers."""
+
+from __future__ import annotations
+
+import logging
+import sys
+from importlib.metadata import entry_points
+from typing import Annotated
+
+import typer
+from rich.console import Console
+from rich.logging import RichHandler
+from rich.table import Table
+
+from quantilica.cli import __version__
+from quantilica.cli.manifests import app as manifests_app
+from quantilica.cli.sources import (
+    app as sources_app,
+)
+from quantilica.cli.sources import (
+    cmd_doctor,
+    cmd_install,
+    cmd_uninstall,
+    fetch_remote_sources,
+)
+
+FETCHER_GROUP = "quantilica.fetchers"
+COMMAND_GROUP = "quantilica.commands"
+
+app = typer.Typer(
+    name="quantilica",
+    help="Quantilica — ferramentas de dados abertos brasileiros.",
+    no_args_is_help=True,
+)
+app.add_typer(manifests_app, name="manifests")
+app.add_typer(sources_app, name="sources")
+
+# Adiciona comandos top-level install, uninstall e doctor
+app.command("install")(cmd_install)
+app.command("uninstall")(cmd_uninstall)
+app.command("doctor")(cmd_doctor)
+
+console = Console()
+
+
+def _load_plugins(group: str) -> dict[str, typer.Typer]:
+    plugins: dict[str, typer.Typer] = {}
+    for ep in entry_points(group=group):
+        try:
+            plugins[ep.name] = ep.load()
+        except Exception as exc:
+            console.print(
+                f"[yellow]Aviso:[/yellow] falha ao carregar plugin '{ep.name}': {exc}"
+            )
+    return plugins
+
+
+def _register_plugins() -> None:
+    # Fetchers e comandos ficam na raiz: `quantilica <nome>`.
+    for name, plugin_app in _load_plugins(FETCHER_GROUP).items():
+        app.add_typer(plugin_app, name=name)
+    for name, plugin_app in _load_plugins(COMMAND_GROUP).items():
+        app.add_typer(plugin_app, name=name)
+
+
+_register_plugins()
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        console.print(f"quantilica {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def root_callback(
+    version: bool | None = typer.Option(
+        None,
+        "--version",
+        "-V",
+        callback=_version_callback,
+        is_eager=True,
+        help="Exibe a versão e encerra.",
+    ),
+) -> None:
+    """Quantilica CLI."""
+
+
+@app.command("list-sources")
+def list_sources(
+    remote: Annotated[
+        bool,
+        typer.Option(
+            "--remote", help="Exibe todas as fontes conhecidas no registro remoto"
+        ),
+    ] = False,
+) -> None:
+    """Lista as fontes de dados instaladas ou disponíveis no repositório."""
+    plugins = _load_plugins(FETCHER_GROUP)
+
+    if remote:
+        remote_registry = fetch_remote_sources()
+        table = Table(title="Todas as fontes de dados conhecidas", show_header=True)
+        table.add_column("Fonte", style="cyan")
+        table.add_column("Pacote", style="magenta")
+        table.add_column("Status", style="green")
+
+        for name, dist in sorted(remote_registry.items()):
+            status = (
+                "[green]Instalado[/green]"
+                if name in plugins
+                else "[dim]Não instalado[/dim]"
+            )
+            table.add_row(name, dist, status)
+
+        console.print(table)
+        return
+
+    if not plugins:
+        console.print(
+            "[yellow]Nenhum fetcher instalado.[/yellow]\n"
+            "Use 'quantilica install <fonte>' para instalar um fetcher (ex: quantilica install comex)."
+        )
+        return
+
+    table = Table(title="Fontes instaladas", show_header=True)
+    table.add_column("Comando", style="cyan")
+    table.add_column("Descrição", style="green")
+
+    for name, plugin_app in sorted(plugins.items()):
+        info = getattr(plugin_app, "info", None)
+        description = ""
+        if info and hasattr(info, "help") and info.help:
+            description = info.help
+        table.add_row(f"quantilica {name}", description)
+
+    console.print(table)
+
+
+def main() -> None:
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # type: ignore
+    logging.basicConfig(
+        level=logging.INFO,
+        format="%(message)s",
+        datefmt="[%X]",
+        handlers=[RichHandler(rich_tracebacks=True, show_path=False)],
+        force=True,
+    )
+    app()
+
+
+if __name__ == "__main__":
+    main()