dashgusbr 0.1.0__tar.gz

dashgusbr-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest -q

dashgusbr-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # necessário para Trusted Publishing (OIDC)
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

dashgusbr-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.eggs/
+
+# Ambientes
+.venv/
+venv/
+env/
+
+# Testes / cobertura
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDEs
+.vscode/
+.idea/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# Saídas de exemplo
+demo_brasileirao.html
+
+# SO
+Thumbs.db
+.DS_Store

dashgusbr-0.1.0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+Todas as mudanças relevantes deste projeto são documentadas neste arquivo.
+
+O formato segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/)
+e o projeto adota [Versionamento Semântico](https://semver.org/lang/pt-BR/).
+
+## [Não lançado]
+
+## [0.1.0] - 2026-07-22
+
+### Adicionado
+- Cliente `Brasileirao` para consumo da OBT do projeto Infra-Brasileirao.
+- Camadas puras `data`, `analytics` e `viz` (gráficos Plotly).
+- Módulos de apoio `config`, `schema` e tema visual.
+- Suíte de testes (`pytest`) e exemplo de uso em `examples/demo.py`.
+
+[Não lançado]: https://github.com/gustavogasperetti/DashGusBr-lib/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/gustavogasperetti/DashGusBr-lib/releases/tag/v0.1.0

dashgusbr-0.1.0/LICENSE

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

dashgusbr-0.1.0/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: dashgusbr
+Version: 0.1.0
+Summary: Camada de consumo e visualização (Plotly) do histórico de partidas do Campeonato Brasileiro, sobre a OBT do projeto Infra-Brasileirao.
+Project-URL: Homepage, https://github.com/gustavogasperetti/DashGusBr-lib
+Project-URL: Repository, https://github.com/gustavogasperetti/DashGusBr-lib
+Project-URL: Issues, https://github.com/gustavogasperetti/DashGusBr-lib/issues
+Project-URL: Fonte de dados (ETL), https://github.com/gustavogasperetti/Infra-Brasileirao
+Author-email: Gustavo Gasperetti <gustavolgasperetti@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Gustavo Gasperetti
+        
+        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.
+License-File: LICENSE
+Keywords: brasileirao,dados,dataviz,futebol,pandas,plotly
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Portuguese (Brazilian)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.9
+Requires-Dist: pandas>=2.0
+Requires-Dist: plotly>=5.19
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# dashgusbr
+
+**Análise e visualização do histórico completo do Campeonato Brasileiro (1971–hoje), em uma linha de Python.**
+
+`dashgusbr` é a camada de consumo e visualização de uma arquitetura serverless desacoplada em dois
+repositórios: o [Infra-Brasileirao](https://github.com/gustavogasperetti/Infra-Brasileirao) roda o
+pipeline ETL agendado (cron) que limpa e consolida todas as partidas do Brasileirão em uma
+**OBT (One Big Table)** publicada na camada gold; este repositório contém apenas a biblioteca, que
+lê essa tabela (CSV no GitHub, com fallback para Google Sheets) e oferece análises prontas em
+**Pandas** e gráficos interativos em **Plotly**. O único acoplamento entre os dois é o contrato de
+dados: a URL da OBT e o schema documentado abaixo.
+
+```
+┌─────────────┐      ┌──────────────┐      ┌──────────────────┐      ┌────────────┐
+│ Fontes brutas │ ──▶ │ Pipeline ETL │ ──▶ │ OBT (camada gold) │ ──▶ │ dashgusbr  │
+└─────────────┘      └──────────────┘      │ GitHub / Sheets   │      │ análise+viz│
+                                           └──────────────────┘      └────────────┘
+```
+
+## Instalação
+
+```bash
+pip install dashgusbr
+```
+
+Requer Python ≥ 3.9. Dependências: `pandas` e `plotly`.
+
+## Uso rápido
+
+```python
+from dashgusbr import Brasileirao
+
+br = Brasileirao()                     # baixa a OBT na primeira consulta e cacheia
+
+br.tabela(2023)                        # DataFrame: classificação de 2023
+br.plot_tabela(2023).show()            # gráfico de barras da classificação
+
+br.plot_evolucao(["Palmeiras", "Botafogo"], 2023).show()   # corrida do título
+br.plot_confronto("Flamengo", "Palmeiras").show()          # histórico do confronto
+br.plot_historico("Santos").show()     # aproveitamento temporada a temporada
+br.plot_gols_por_temporada().show()    # média de gols/jogo desde 1971
+br.plot_mandante_visitante().show()    # o fator casa ao longo da história
+br.plot_placares().show()              # heatmap: frequência de cada placar
+br.goleadas(10)                        # DataFrame: as 10 maiores goleadas
+```
+
+Métodos utilitários: `br.anos()`, `br.times(ano=2023)`, `br.partidas(ano=2023, time="Grêmio")`,
+`br.recarregar()` (força novo download).
+
+## Uso avançado — camadas puras
+
+A classe `Brasileirao` é uma fachada. Por baixo, a biblioteca é organizada em três camadas de
+funções puras que você pode importar diretamente (por exemplo, para montar seu próprio dashboard
+em Streamlit):
+
+```python
+from dashgusbr import data, analytics, viz
+
+df  = data.carregar_dados()                       # OBT completa, schema canônico
+tab = analytics.classificacao(df, ano=2023)       # DataFrame → DataFrame
+fig = viz.classificacao(tab)                      # DataFrame → plotly Figure
+```
+
+| Camada | Responsabilidade | Principais funções |
+|---|---|---|
+| `dashgusbr.data` | carga, fallback e cache | `carregar_dados`, `limpar_cache` |
+| `dashgusbr.analytics` | agregações Pandas | `classificacao`, `evolucao_pontos`, `historico_time`, `confronto`, `estatisticas_temporada`, `distribuicao_placares`, `maiores_goleadas` |
+| `dashgusbr.viz` | figuras Plotly | `classificacao`, `evolucao`, `historico`, `confronto`, `gols_por_temporada`, `mandante_visitante`, `distribuicao_placares` |
+
+## Fontes de dados
+
+Por padrão, `dashgusbr` tenta o CSV publicado no GitHub e, se indisponível, cai para o Google
+Sheets. Também é possível apontar para um arquivo local ou URL própria:
+
+```python
+br = Brasileirao()                       # auto: GitHub → Sheets
+br = Brasileirao(fonte="sheets")         # força o Google Sheets
+br = Brasileirao(fonte="dados/obt.csv")  # arquivo local no mesmo schema
+br = Brasileirao(github_url="https://raw.githubusercontent.com/.../obt.csv")
+```
+
+## Schema da OBT
+
+A biblioteca normaliza os nomes na carga (`Data` → `data`, `Mandante` → `mandante`, ...) e valida
+as colunas obrigatórias. Schema canônico:
+
+| Coluna | Tipo | Descrição |
+|---|---|---|
+| `id_partida` | int | identificador da partida |
+| `ano_campeonato` | int | temporada |
+| `data` | date | data da partida |
+| `mandante` / `visitante` | str | times |
+| `estado_mandante` / `estado_visitante` | str | UF de cada time |
+| `gols_mandante` / `gols_visitante` | int | placar |
+| `resultado_mandante` / `resultado_visitante` | str | `V`/`E`/`D` |
+| `placar_status` | str | status do placar |
+| `fase` / `tipo_fase` | str | fase do campeonato (`Pontos Corridos`, mata-mata...) |
+| `is_mata_mata` / `is_classico_estadual` | bool | flags |
+| `total_gols`, `saldo_gols_*` | int | derivadas do placar |
+| `pontos_mandante` / `pontos_visitante` | int | pontos da partida, **já na regra da época** |
+
+> **Nota histórica:** a vitória valia **2 pontos até 1994** e **3 pontos a partir de 1995**. As
+> colunas de pontos já vêm calculadas pelo ETL com a regra correta de cada era; por isso as tabelas
+> de classificação somam esses pontos (em vez de recalcular 3-1-0) e o **aproveitamento** é
+> normalizado pelo valor da vitória da temporada — a única métrica comparável entre eras.
+
+Apenas jogos com `tipo_fase == "Pontos Corridos"` entram na classificação e nas estatísticas de
+temporada; o confronto direto considera todas as fases.
+
+## Desenvolvimento
+
+```bash
+git clone https://github.com/gustavogasperetti/DashGusBr-lib.git
+cd DashGusBr-lib
+pip install -e ".[dev]"
+pytest                          # suíte offline (fixture com mini-OBT)
+pytest -m rede -o addopts=""    # smoke tests que baixam a OBT real (requer internet)
+```
+
+Antes da publicação no PyPI, é possível instalar direto do GitHub:
+
+```bash
+pip install git+https://github.com/gustavogasperetti/DashGusBr-lib.git
+```
+
+## Licença
+
+[MIT](LICENSE)

dashgusbr-0.1.0/README.md

@@ -0,0 +1,128 @@
+# dashgusbr
+
+**Análise e visualização do histórico completo do Campeonato Brasileiro (1971–hoje), em uma linha de Python.**
+
+`dashgusbr` é a camada de consumo e visualização de uma arquitetura serverless desacoplada em dois
+repositórios: o [Infra-Brasileirao](https://github.com/gustavogasperetti/Infra-Brasileirao) roda o
+pipeline ETL agendado (cron) que limpa e consolida todas as partidas do Brasileirão em uma
+**OBT (One Big Table)** publicada na camada gold; este repositório contém apenas a biblioteca, que
+lê essa tabela (CSV no GitHub, com fallback para Google Sheets) e oferece análises prontas em
+**Pandas** e gráficos interativos em **Plotly**. O único acoplamento entre os dois é o contrato de
+dados: a URL da OBT e o schema documentado abaixo.
+
+```
+┌─────────────┐      ┌──────────────┐      ┌──────────────────┐      ┌────────────┐
+│ Fontes brutas │ ──▶ │ Pipeline ETL │ ──▶ │ OBT (camada gold) │ ──▶ │ dashgusbr  │
+└─────────────┘      └──────────────┘      │ GitHub / Sheets   │      │ análise+viz│
+                                           └──────────────────┘      └────────────┘
+```
+
+## Instalação
+
+```bash
+pip install dashgusbr
+```
+
+Requer Python ≥ 3.9. Dependências: `pandas` e `plotly`.
+
+## Uso rápido
+
+```python
+from dashgusbr import Brasileirao
+
+br = Brasileirao()                     # baixa a OBT na primeira consulta e cacheia
+
+br.tabela(2023)                        # DataFrame: classificação de 2023
+br.plot_tabela(2023).show()            # gráfico de barras da classificação
+
+br.plot_evolucao(["Palmeiras", "Botafogo"], 2023).show()   # corrida do título
+br.plot_confronto("Flamengo", "Palmeiras").show()          # histórico do confronto
+br.plot_historico("Santos").show()     # aproveitamento temporada a temporada
+br.plot_gols_por_temporada().show()    # média de gols/jogo desde 1971
+br.plot_mandante_visitante().show()    # o fator casa ao longo da história
+br.plot_placares().show()              # heatmap: frequência de cada placar
+br.goleadas(10)                        # DataFrame: as 10 maiores goleadas
+```
+
+Métodos utilitários: `br.anos()`, `br.times(ano=2023)`, `br.partidas(ano=2023, time="Grêmio")`,
+`br.recarregar()` (força novo download).
+
+## Uso avançado — camadas puras
+
+A classe `Brasileirao` é uma fachada. Por baixo, a biblioteca é organizada em três camadas de
+funções puras que você pode importar diretamente (por exemplo, para montar seu próprio dashboard
+em Streamlit):
+
+```python
+from dashgusbr import data, analytics, viz
+
+df  = data.carregar_dados()                       # OBT completa, schema canônico
+tab = analytics.classificacao(df, ano=2023)       # DataFrame → DataFrame
+fig = viz.classificacao(tab)                      # DataFrame → plotly Figure
+```
+
+| Camada | Responsabilidade | Principais funções |
+|---|---|---|
+| `dashgusbr.data` | carga, fallback e cache | `carregar_dados`, `limpar_cache` |
+| `dashgusbr.analytics` | agregações Pandas | `classificacao`, `evolucao_pontos`, `historico_time`, `confronto`, `estatisticas_temporada`, `distribuicao_placares`, `maiores_goleadas` |
+| `dashgusbr.viz` | figuras Plotly | `classificacao`, `evolucao`, `historico`, `confronto`, `gols_por_temporada`, `mandante_visitante`, `distribuicao_placares` |
+
+## Fontes de dados
+
+Por padrão, `dashgusbr` tenta o CSV publicado no GitHub e, se indisponível, cai para o Google
+Sheets. Também é possível apontar para um arquivo local ou URL própria:
+
+```python
+br = Brasileirao()                       # auto: GitHub → Sheets
+br = Brasileirao(fonte="sheets")         # força o Google Sheets
+br = Brasileirao(fonte="dados/obt.csv")  # arquivo local no mesmo schema
+br = Brasileirao(github_url="https://raw.githubusercontent.com/.../obt.csv")
+```
+
+## Schema da OBT
+
+A biblioteca normaliza os nomes na carga (`Data` → `data`, `Mandante` → `mandante`, ...) e valida
+as colunas obrigatórias. Schema canônico:
+
+| Coluna | Tipo | Descrição |
+|---|---|---|
+| `id_partida` | int | identificador da partida |
+| `ano_campeonato` | int | temporada |
+| `data` | date | data da partida |
+| `mandante` / `visitante` | str | times |
+| `estado_mandante` / `estado_visitante` | str | UF de cada time |
+| `gols_mandante` / `gols_visitante` | int | placar |
+| `resultado_mandante` / `resultado_visitante` | str | `V`/`E`/`D` |
+| `placar_status` | str | status do placar |
+| `fase` / `tipo_fase` | str | fase do campeonato (`Pontos Corridos`, mata-mata...) |
+| `is_mata_mata` / `is_classico_estadual` | bool | flags |
+| `total_gols`, `saldo_gols_*` | int | derivadas do placar |
+| `pontos_mandante` / `pontos_visitante` | int | pontos da partida, **já na regra da época** |
+
+> **Nota histórica:** a vitória valia **2 pontos até 1994** e **3 pontos a partir de 1995**. As
+> colunas de pontos já vêm calculadas pelo ETL com a regra correta de cada era; por isso as tabelas
+> de classificação somam esses pontos (em vez de recalcular 3-1-0) e o **aproveitamento** é
+> normalizado pelo valor da vitória da temporada — a única métrica comparável entre eras.
+
+Apenas jogos com `tipo_fase == "Pontos Corridos"` entram na classificação e nas estatísticas de
+temporada; o confronto direto considera todas as fases.
+
+## Desenvolvimento
+
+```bash
+git clone https://github.com/gustavogasperetti/DashGusBr-lib.git
+cd DashGusBr-lib
+pip install -e ".[dev]"
+pytest                          # suíte offline (fixture com mini-OBT)
+pytest -m rede -o addopts=""    # smoke tests que baixam a OBT real (requer internet)
+```
+
+Antes da publicação no PyPI, é possível instalar direto do GitHub:
+
+```bash
+pip install git+https://github.com/gustavogasperetti/DashGusBr-lib.git
+```
+
+## Licença
+
+[MIT](LICENSE)

dashgusbr-0.1.0/examples/demo.py

@@ -0,0 +1,45 @@
+"""Demonstração da dashgusbr: gera um relatório HTML com os gráficos do MVP.
+
+Uso:
+    python examples/demo.py [ano]
+
+Baixa a OBT real (GitHub, com fallback para Sheets) e grava
+``demo_brasileirao.html`` no diretório atual.
+"""
+
+import sys
+
+from dashgusbr import Brasileirao
+
+
+def main() -> None:
+    ano = int(sys.argv[1]) if len(sys.argv) > 1 else 2023
+
+    br = Brasileirao()
+    print(f"Base carregada: {len(br.partidas())} partidas, {br.anos()[0]}–{br.anos()[-1]}")
+
+    tabela = br.tabela(ano)
+    lideres = list(tabela.head(4)["time"])
+    print(f"G4 de {ano}: {', '.join(lideres)}")
+
+    figuras = [
+        br.plot_tabela(ano),
+        br.plot_evolucao(lideres, ano),
+        br.plot_confronto(lideres[0], lideres[1]),
+        br.plot_historico(lideres[0]),
+        br.plot_gols_por_temporada(),
+        br.plot_mandante_visitante(),
+        br.plot_placares(),
+    ]
+
+    destino = "demo_brasileirao.html"
+    with open(destino, "w", encoding="utf-8") as saida:
+        saida.write(f"<html><head><meta charset='utf-8'><title>dashgusbr — {ano}</title></head><body>")
+        for i, fig in enumerate(figuras):
+            saida.write(fig.to_html(full_html=False, include_plotlyjs=(i == 0)))
+        saida.write("</body></html>")
+    print(f"Relatório gravado em {destino}")
+
+
+if __name__ == "__main__":
+    main()

dashgusbr-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dashgusbr"
+dynamic = ["version"]
+description = "Camada de consumo e visualização (Plotly) do histórico de partidas do Campeonato Brasileiro, sobre a OBT do projeto Infra-Brasileirao."
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.9"
+authors = [
+    { name = "Gustavo Gasperetti", email = "gustavolgasperetti@gmail.com" },
+]
+keywords = ["brasileirao", "futebol", "dados", "plotly", "pandas", "dataviz"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: Portuguese (Brazilian)",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+dependencies = [
+    "pandas>=2.0",
+    "plotly>=5.19",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/gustavogasperetti/DashGusBr-lib"
+Repository = "https://github.com/gustavogasperetti/DashGusBr-lib"
+Issues = "https://github.com/gustavogasperetti/DashGusBr-lib/issues"
+"Fonte de dados (ETL)" = "https://github.com/gustavogasperetti/Infra-Brasileirao"
+
+[tool.hatch.version]
+path = "src/dashgusbr/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dashgusbr"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "rede: testes que acessam a internet (desmarcados por padrão: -m 'not rede')",
+]
+addopts = "-m 'not rede'"

dashgusbr-0.1.0/src/dashgusbr/__init__.py

@@ -0,0 +1,39 @@
+"""dashgusbr — consumo e visualização do histórico do Campeonato Brasileiro.
+
+Camada de consumo da arquitetura serverless do projeto Infra-Brasileirao:
+lê a OBT (One Big Table) publicada pelo pipeline ETL (CSV no GitHub, com
+fallback para Google Sheets) e oferece análises em Pandas e gráficos Plotly.
+
+Uso rápido::
+
+    from dashgusbr import Brasileirao
+
+    br = Brasileirao()
+    br.tabela(2023)                      # DataFrame da classificação
+    br.plot_confronto("Flamengo", "Palmeiras").show()
+
+Uso avançado (camadas puras)::
+
+    from dashgusbr import analytics, data, viz
+
+    df = data.carregar_dados()
+    tab = analytics.classificacao(df, ano=2023)
+    fig = viz.classificacao(tab)
+"""
+
+from . import analytics, config, data, schema, viz
+from .client import Brasileirao
+from .data import carregar_dados
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "Brasileirao",
+    "carregar_dados",
+    "analytics",
+    "config",
+    "data",
+    "schema",
+    "viz",
+    "__version__",
+]