vra-anac 0.1.0__tar.gz

vra_anac-0.1.0/LICENSE

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

vra_anac-0.1.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: vra-anac
+Version: 0.1.0
+Summary: Pontualidade dos voos domésticos do Brasil pelo VRA da ANAC: lê o CSV do mês e calcula o indicador
+Author: Peter
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/peterwkdev-creator/vra-anac
+Project-URL: Source, https://github.com/peterwkdev-creator/vra-anac
+Project-URL: Issues, https://github.com/peterwkdev-creator/vra-anac/issues
+Project-URL: Changelog, https://github.com/peterwkdev-creator/vra-anac/blob/main/CHANGELOG.md
+Keywords: anac,vra,aviacao,voos,pontualidade,atrasos,dados-abertos,brasil
+Classifier: Programming Language :: Python :: 3
+Classifier: Natural Language :: Portuguese (Brazilian)
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# vra-anac
+
+[![testes](https://github.com/peterwkdev-creator/vra-anac/actions/workflows/testes.yml/badge.svg)](https://github.com/peterwkdev-creator/vra-anac/actions/workflows/testes.yml)
+[![PyPI](https://img.shields.io/pypi/v/vra-anac?label=PyPI)](https://pypi.org/project/vra-anac/)
+[![Python](https://img.shields.io/pypi/pyversions/vra-anac?label=Python)](https://pypi.org/project/vra-anac/)
+[![licença: MIT](https://img.shields.io/badge/licen%C3%A7a-MIT-blue)](https://github.com/peterwkdev-creator/vra-anac/blob/main/LICENSE)
+
+Quantos voos domésticos chegaram no horário, por voo, rota, companhia ou
+aeroporto, a partir do arquivo mensal do **VRA (Voo Regular Ativo) da
+ANAC**. Lê o CSV como a ANAC publica e aplica a mesma régua do
+[chegounahora.com.br](https://chegounahora.com.br/): **no horário = chegada
+até 15 min depois da prevista**.
+
+Só a biblioteca padrão do Python, sem rede: você baixa o CSV, ela faz a conta.
+
+![O comando vra-anac lê o CSV de agosto/2026 da ANAC e mostra a pontualidade por companhia e por rota](https://raw.githubusercontent.com/peterwkdev-creator/vra-anac/main/docs/vitrine.gif)
+
+## Instalar
+
+```bash
+pip install vra-anac
+```
+
+Ou uma versão exata, pela tag do GitHub:
+
+```bash
+pip install "git+https://github.com/peterwkdev-creator/vra-anac@v0.1.0"
+```
+
+Python 3.11 ou mais novo.
+
+## Usar
+
+```python
+import vra_anac
+
+# o CSV do mês que você baixou da ANAC (aqui, a amostra dos testes)
+atualizado, voos = vra_anac.ler_arquivo("tests/fixtures/vra-amostra.csv")
+t = vra_anac.tabelas()
+
+for chave, c in vra_anac.agrupar(voos, por="voo").items():
+    print(f"{t.rotulo(chave)}: {c.pct('chegada')}% no horário (n = {c.n})")
+# G3 1015 SDU→CGH: 100% no horário (n = 1)
+# G3 1016 CGH→SDU: 0% no horário (n = 2)
+# ...
+```
+
+Pela linha de comando, a tabela do mês (ou `--json`):
+
+```bash
+vra-anac VRA_20268.csv --por companhia
+```
+
+```
+VRA da ANAC, 08/2026 (arquivo atualizado em 2026-10-07): 68.355 voos domésticos regulares, 1 fora do mês.
+No horário = chegada até 15 min depois da prevista. Só os grupos com 20 voos ou mais.
+
+no horário  cancelado    voos  companhia
+       87%         1%  23.080  Azul (AZU)
+       84%         2%  20.295  GOL (GLO)
+       78%         1%  23.850  LATAM (TAM)
+       76%        16%   1.098  Azul Conecta (ACN)
+        0%       100%      24  Apuí Táxi Aéreo (CQB)
+
+Dados: ANAC, Voo Regular Ativo (VRA), licença CC-BY. https://www.gov.br/anac/...
+```
+
+`--por` aceita `voo` (padrão), `rota`, `companhia`, `origem` e `destino`;
+`--minimo` (padrão 20) deixa de fora o grupo com poucos voos, que oscila por
+acaso de um mês para o outro.
+
+## Onde baixar o CSV
+
+Na página do [Voo Regular Ativo (VRA)](https://www.gov.br/anac/pt-br/acesso-a-informacao/dados-abertos/areas-de-atuacao/voos-e-operacoes-aereas/voo-regular-ativo-vra)
+da ANAC, um arquivo por mês (`VRA_AAAAM.csv`, o mês sem zero). A ANAC
+publica com cerca de 4 semanas de atraso.
+
+## O que a conta faz
+
+- **Voo doméstico regular**: tipo de linha `N` e código de autorização `0`.
+  Extras, fretamentos e voos internacionais ficam de fora.
+- **No horário**: chegada real até 15 min depois da prevista; adiantado
+  conta como no horário. A partida tem o mesmo critério, ao lado
+  (`c.pct("partida")`).
+- **Faixas**: até 30 min, até 60 min, mais de 60 min e cancelado
+  (`c.distribuicao("chegada")`). O atraso é contado em segundos inteiros:
+  30 min exatos ficam na faixa de até 30.
+- **Cancelado** conta no total e nunca como no horário.
+- **Porcentagem** arredondada com o meio para cima (12,5 → 13).
+- **O voo** é empresa + número + origem + destino. O número sai sem o `Z`
+  que o VRA às vezes põe na frente (`Z1001` e `1001` são o mesmo voo
+  vendido). Isso é inferência, conferida em alguns voos contra o horário
+  publicado pela companhia, não regra escrita da ANAC.
+- **O mês** sai das datas das linhas, não do nome do arquivo; o que cai em
+  outro mês aparece contado à parte (`vra_anac.periodo`).
+- Os horários são os do arquivo, em Brasília.
+
+## O que vem junto
+
+As tabelas que levam o código ICAO do VRA ao que aparece no bilhete
+(`GLO` → `G3`, `SBSP` → `CGH Congonhas`): companhias do cadastro da ANAC e
+do diretório da IATA, e aeroportos da lista de aeródromos públicos da ANAC
+e do OurAirports (domínio público). Cada linha cita a fonte e a data da
+consulta (`t.companhias`, `t.aeroportos`). Código fora da tabela aparece
+como veio no arquivo.
+
+## Como é testado
+
+`python -m unittest`, do checkout, sem instalar nada. A amostra dos testes
+tem linhas reais do VRA de julho/2026, com os bytes do arquivo da ANAC (BOM
+e CRLF), e cada número esperado foi contado à mão. O CI roda do Python 3.11
+ao 3.14 e no Windows, e instala o pacote num ambiente limpo antes de cada
+versão.
+
+## Fontes e limites
+
+- **Dados: ANAC, Voo Regular Ativo (VRA), licença
+  [CC-BY](https://opendefinition.org/licenses/cc-by/).** Quem publicar
+  resultado feito com esta biblioteca precisa dar o crédito à ANAC; a linha
+  de comando já escreve a atribuição na saída.
+- Esta biblioteca **não é da ANAC** nem de companhia aérea. O resultado
+  mostra o que aconteceu no mês, não prevê o próximo voo.
+- O VRA não traz o motivo do atraso (o campo de justificativa vem vazio).
+
+## Contribuir
+
+Ver o [CONTRIBUTING.md](https://github.com/peterwkdev-creator/vra-anac/blob/main/CONTRIBUTING.md).
+Resultado diferente da sua conta: abra uma issue pelo modelo "Resultado
+diferente do esperado".
+
+## Licença
+
+Código sob a [licença MIT](https://github.com/peterwkdev-creator/vra-anac/blob/main/LICENSE).
+Os dados do VRA são da ANAC, sob CC-BY.

vra_anac-0.1.0/README.md

@@ -0,0 +1,134 @@
+# vra-anac
+
+[![testes](https://github.com/peterwkdev-creator/vra-anac/actions/workflows/testes.yml/badge.svg)](https://github.com/peterwkdev-creator/vra-anac/actions/workflows/testes.yml)
+[![PyPI](https://img.shields.io/pypi/v/vra-anac?label=PyPI)](https://pypi.org/project/vra-anac/)
+[![Python](https://img.shields.io/pypi/pyversions/vra-anac?label=Python)](https://pypi.org/project/vra-anac/)
+[![licença: MIT](https://img.shields.io/badge/licen%C3%A7a-MIT-blue)](https://github.com/peterwkdev-creator/vra-anac/blob/main/LICENSE)
+
+Quantos voos domésticos chegaram no horário, por voo, rota, companhia ou
+aeroporto, a partir do arquivo mensal do **VRA (Voo Regular Ativo) da
+ANAC**. Lê o CSV como a ANAC publica e aplica a mesma régua do
+[chegounahora.com.br](https://chegounahora.com.br/): **no horário = chegada
+até 15 min depois da prevista**.
+
+Só a biblioteca padrão do Python, sem rede: você baixa o CSV, ela faz a conta.
+
+![O comando vra-anac lê o CSV de agosto/2026 da ANAC e mostra a pontualidade por companhia e por rota](https://raw.githubusercontent.com/peterwkdev-creator/vra-anac/main/docs/vitrine.gif)
+
+## Instalar
+
+```bash
+pip install vra-anac
+```
+
+Ou uma versão exata, pela tag do GitHub:
+
+```bash
+pip install "git+https://github.com/peterwkdev-creator/vra-anac@v0.1.0"
+```
+
+Python 3.11 ou mais novo.
+
+## Usar
+
+```python
+import vra_anac
+
+# o CSV do mês que você baixou da ANAC (aqui, a amostra dos testes)
+atualizado, voos = vra_anac.ler_arquivo("tests/fixtures/vra-amostra.csv")
+t = vra_anac.tabelas()
+
+for chave, c in vra_anac.agrupar(voos, por="voo").items():
+    print(f"{t.rotulo(chave)}: {c.pct('chegada')}% no horário (n = {c.n})")
+# G3 1015 SDU→CGH: 100% no horário (n = 1)
+# G3 1016 CGH→SDU: 0% no horário (n = 2)
+# ...
+```
+
+Pela linha de comando, a tabela do mês (ou `--json`):
+
+```bash
+vra-anac VRA_20268.csv --por companhia
+```
+
+```
+VRA da ANAC, 08/2026 (arquivo atualizado em 2026-10-07): 68.355 voos domésticos regulares, 1 fora do mês.
+No horário = chegada até 15 min depois da prevista. Só os grupos com 20 voos ou mais.
+
+no horário  cancelado    voos  companhia
+       87%         1%  23.080  Azul (AZU)
+       84%         2%  20.295  GOL (GLO)
+       78%         1%  23.850  LATAM (TAM)
+       76%        16%   1.098  Azul Conecta (ACN)
+        0%       100%      24  Apuí Táxi Aéreo (CQB)
+
+Dados: ANAC, Voo Regular Ativo (VRA), licença CC-BY. https://www.gov.br/anac/...
+```
+
+`--por` aceita `voo` (padrão), `rota`, `companhia`, `origem` e `destino`;
+`--minimo` (padrão 20) deixa de fora o grupo com poucos voos, que oscila por
+acaso de um mês para o outro.
+
+## Onde baixar o CSV
+
+Na página do [Voo Regular Ativo (VRA)](https://www.gov.br/anac/pt-br/acesso-a-informacao/dados-abertos/areas-de-atuacao/voos-e-operacoes-aereas/voo-regular-ativo-vra)
+da ANAC, um arquivo por mês (`VRA_AAAAM.csv`, o mês sem zero). A ANAC
+publica com cerca de 4 semanas de atraso.
+
+## O que a conta faz
+
+- **Voo doméstico regular**: tipo de linha `N` e código de autorização `0`.
+  Extras, fretamentos e voos internacionais ficam de fora.
+- **No horário**: chegada real até 15 min depois da prevista; adiantado
+  conta como no horário. A partida tem o mesmo critério, ao lado
+  (`c.pct("partida")`).
+- **Faixas**: até 30 min, até 60 min, mais de 60 min e cancelado
+  (`c.distribuicao("chegada")`). O atraso é contado em segundos inteiros:
+  30 min exatos ficam na faixa de até 30.
+- **Cancelado** conta no total e nunca como no horário.
+- **Porcentagem** arredondada com o meio para cima (12,5 → 13).
+- **O voo** é empresa + número + origem + destino. O número sai sem o `Z`
+  que o VRA às vezes põe na frente (`Z1001` e `1001` são o mesmo voo
+  vendido). Isso é inferência, conferida em alguns voos contra o horário
+  publicado pela companhia, não regra escrita da ANAC.
+- **O mês** sai das datas das linhas, não do nome do arquivo; o que cai em
+  outro mês aparece contado à parte (`vra_anac.periodo`).
+- Os horários são os do arquivo, em Brasília.
+
+## O que vem junto
+
+As tabelas que levam o código ICAO do VRA ao que aparece no bilhete
+(`GLO` → `G3`, `SBSP` → `CGH Congonhas`): companhias do cadastro da ANAC e
+do diretório da IATA, e aeroportos da lista de aeródromos públicos da ANAC
+e do OurAirports (domínio público). Cada linha cita a fonte e a data da
+consulta (`t.companhias`, `t.aeroportos`). Código fora da tabela aparece
+como veio no arquivo.
+
+## Como é testado
+
+`python -m unittest`, do checkout, sem instalar nada. A amostra dos testes
+tem linhas reais do VRA de julho/2026, com os bytes do arquivo da ANAC (BOM
+e CRLF), e cada número esperado foi contado à mão. O CI roda do Python 3.11
+ao 3.14 e no Windows, e instala o pacote num ambiente limpo antes de cada
+versão.
+
+## Fontes e limites
+
+- **Dados: ANAC, Voo Regular Ativo (VRA), licença
+  [CC-BY](https://opendefinition.org/licenses/cc-by/).** Quem publicar
+  resultado feito com esta biblioteca precisa dar o crédito à ANAC; a linha
+  de comando já escreve a atribuição na saída.
+- Esta biblioteca **não é da ANAC** nem de companhia aérea. O resultado
+  mostra o que aconteceu no mês, não prevê o próximo voo.
+- O VRA não traz o motivo do atraso (o campo de justificativa vem vazio).
+
+## Contribuir
+
+Ver o [CONTRIBUTING.md](https://github.com/peterwkdev-creator/vra-anac/blob/main/CONTRIBUTING.md).
+Resultado diferente da sua conta: abra uma issue pelo modelo "Resultado
+diferente do esperado".
+
+## Licença
+
+Código sob a [licença MIT](https://github.com/peterwkdev-creator/vra-anac/blob/main/LICENSE).
+Os dados do VRA são da ANAC, sob CC-BY.

vra_anac-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vra-anac"
+# A versão tem uma fonte só: o __version__ do pacote (lido sem importar).
+dynamic = ["version"]
+# Uma frase só, até 100 caracteres (teto do catálogo MCP): a mesma no About
+# do GitHub (gh repo edit --description) e no server.json, se houver.
+description = "Pontualidade dos voos domésticos do Brasil pelo VRA da ANAC: lê o CSV do mês e calcula o indicador"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Peter" }]
+requires-python = ">=3.11"
+dependencies = []
+keywords = ["anac", "vra", "aviacao", "voos", "pontualidade", "atrasos", "dados-abertos", "brasil"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Natural Language :: Portuguese (Brazilian)",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+]
+
+# sem vitrine (Pages) na 0.1: a página inicial é o próprio repositório
+# (nomes que o PyPI reconhece)
+[project.urls]
+Homepage = "https://github.com/peterwkdev-creator/vra-anac"
+Source = "https://github.com/peterwkdev-creator/vra-anac"
+Issues = "https://github.com/peterwkdev-creator/vra-anac/issues"
+Changelog = "https://github.com/peterwkdev-creator/vra-anac/blob/main/CHANGELOG.md"
+
+# o comando que o pip instala no PATH, além do `python -m vra_anac`
+[project.scripts]
+vra-anac = "vra_anac.__main__:main"
+
+[tool.setuptools]
+# a pasta das tabelas entra aqui também: sem isto, o setuptools avisa que a
+# vê como pacote e não sabe se é para levar
+packages = ["vra_anac", "vra_anac.dados"]
+
+# as tabelas de companhias e aeroportos só vão na instalação se estiverem
+# aqui; sem isto, FileNotFoundError fora do checkout.
+[tool.setuptools.package-data]
+vra_anac = ["dados/*.csv"]
+
+[tool.setuptools.dynamic]
+version = { attr = "vra_anac.__version__" }

vra_anac-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vra_anac-0.1.0/tests/test_cli.py

@@ -0,0 +1,109 @@
+"""A linha de comando: saída em texto e JSON, erros e ajuda em português."""
+from __future__ import annotations
+
+import contextlib
+import io
+import json
+import re
+import sys
+import unittest
+from pathlib import Path
+from unittest import mock
+
+from vra_anac.__main__ import ATRIBUICAO, _milhar, main
+
+FIXTURE = str(Path(__file__).parent / "fixtures" / "vra-amostra.csv")
+INGLES = re.compile(r"\b(usage|options|positional|arguments?|required|invalid|"
+                    r"error|show this help|expected)\b", re.I)
+
+
+def _rodar(*args):
+    saida, erro = io.StringIO(), io.StringIO()
+    with contextlib.redirect_stdout(saida), contextlib.redirect_stderr(erro):
+        try:
+            codigo = main(list(args))
+        except SystemExit as e:
+            codigo = e.code
+    return codigo, saida.getvalue(), erro.getvalue()
+
+
+class Saida(unittest.TestCase):
+    def test_texto_por_voo(self):
+        codigo, saida, _ = _rodar(FIXTURE, "--minimo", "1")
+        self.assertEqual(codigo, 0)
+        self.assertIn("07/2026 (arquivo atualizado em 2026-08-28): 5 voos domésticos "
+                      "regulares, 1 fora do mês.", saida)
+        self.assertIn("Só os grupos com 1 voo ou mais.", saida)
+        linhas = [l.split() for l in saida.splitlines() if "%" in l]
+        # o de 100% primeiro; depois, no empate em 0%, o de mais voos
+        self.assertEqual(linhas[0], ["100%", "0%", "1", "G3", "1015", "SDU→CGH"])
+        self.assertEqual(linhas[1], ["0%", "50%", "2", "G3", "1016", "CGH→SDU"])
+        self.assertTrue(saida.rstrip().endswith(ATRIBUICAO))
+
+    def test_milhar_com_ponto(self):
+        self.assertEqual([_milhar(n) for n in (5, 999, 1098, 68355, 1234567)],
+                         ["5", "999", "1.098", "68.355", "1.234.567"])
+
+    def test_minimo_padrao_20_deixa_a_fixture_vazia(self):
+        codigo, saida, _ = _rodar(FIXTURE)
+        self.assertEqual(codigo, 0)
+        self.assertIn("Nenhum grupo com 20 voos ou mais.", saida)
+
+    def test_json(self):
+        codigo, saida, _ = _rodar(FIXTURE, "--por", "companhia", "--minimo", "1", "--json")
+        self.assertEqual(codigo, 0)
+        d = json.loads(saida)
+        self.assertEqual((d["mes"], d["voos"], d["fora_do_mes"]), ("2026-07", 5, 1))
+        self.assertIn("ANAC", d["atribuicao"])
+        glo = d["grupos"][0]
+        self.assertEqual((glo["rotulo"], glo["voos"], glo["chegada_no_horario_pct"],
+                          glo["cancelado_pct"]), ("GOL (GLO)", 4, 25, 25))
+        self.assertEqual(glo["chegada"], {"no_horario": 25, "ate30": 0, "ate60": 50,
+                                          "acima60": 0, "cancelado": 25})
+
+
+class Erros(unittest.TestCase):
+    def test_arquivo_ausente(self):
+        codigo, _, erro = _rodar("nao-existe.csv")
+        self.assertEqual(codigo, 1)
+        self.assertIn("erro: arquivo não encontrado: nao-existe.csv", erro)
+
+    def test_pasta(self):
+        codigo, _, erro = _rodar(str(Path(__file__).parent))
+        self.assertEqual(codigo, 1)
+        self.assertIn("é uma pasta", erro)
+
+    def test_arquivo_que_nao_e_o_vra(self):
+        codigo, _, erro = _rodar(__file__)
+        self.assertEqual(codigo, 1)
+        self.assertIn("1ª linha não é o metadado esperado", erro)
+
+    def test_erros_do_argparse_em_portugues(self):
+        for args in ([], [FIXTURE, "--minimo", "0"], [FIXTURE, "--por", "estado"],
+                     [FIXTURE, "--xyz"]):
+            with self.subTest(args=args):
+                codigo, _, erro = _rodar(*args)
+                self.assertEqual(codigo, 2)
+                self.assertIn("uso:", erro)
+                self.assertIsNone(INGLES.search(erro), erro)
+
+
+class Ajuda(unittest.TestCase):
+    def test_ajuda_em_portugues_com_atribuicao(self):
+        codigo, saida, _ = _rodar("--help")
+        self.assertEqual(codigo, 0)
+        self.assertTrue(saida.startswith("uso: "))
+        self.assertIsNone(INGLES.search(saida), saida)
+        self.assertIn("ANAC", saida)
+
+    def test_nome_do_comando_instalado(self):
+        with mock.patch.object(sys, "argv", ["/venv/bin/vra-anac"]):
+            _, saida, _ = _rodar("--help")
+        self.assertTrue(saida.startswith("uso: vra-anac "))
+        with mock.patch.object(sys, "argv", ["/x/vra_anac/__main__.py"]):
+            _, saida, _ = _rodar("--help")
+        self.assertTrue(saida.startswith("uso: python -m vra_anac "))
+
+
+if __name__ == "__main__":
+    unittest.main()

vra_anac-0.1.0/tests/test_indicador.py

@@ -0,0 +1,127 @@
+"""O indicador: no horário até 15 min pela chegada, faixas 30 e 60,
+cancelado sobre o total. Cada número esperado foi contado à mão."""
+from __future__ import annotations
+
+import unittest
+from datetime import datetime, timedelta
+from pathlib import Path
+
+import vra_anac
+from vra_anac import indicador
+from vra_anac.leitura import Operacao
+
+FIXTURE = Path(__file__).parent / "fixtures" / "vra-amostra.csv"
+
+
+def _op(chegada_min=0, partida_min=0, cancelado=False, numero="1000",
+        empresa="GLO", origem="SBSP", destino="SBRJ"):
+    """Voo inventado: atrasos em minutos sobre o previsto."""
+    pp = datetime(2026, 7, 1, 10, 0)
+    cp = pp + timedelta(hours=1)
+    pr = None if cancelado else pp + timedelta(minutes=partida_min)
+    cr = None if cancelado else cp + timedelta(minutes=chegada_min)
+    return Operacao(empresa, numero, origem, destino, pp, pr, cp, cr, cancelado)
+
+
+class Porcento(unittest.TestCase):
+    def test_meio_para_cima(self):
+        self.assertEqual(indicador.porcento(1, 8), 13)   # 12,5
+        self.assertEqual(indicador.porcento(1, 200), 1)  # 0,5; round() daria 0
+        self.assertEqual(indicador.porcento(0, 3), 0)
+
+    def test_sobre_zero(self):
+        with self.assertRaises(ValueError):
+            indicador.porcento(0, 0)
+
+
+class Limites(unittest.TestCase):
+    def test_15_min_exatos_e_no_horario_15_e_1_s_nao(self):
+        c = vra_anac.Contagem()
+        c.somar(_op(chegada_min=15))
+        op = _op()
+        c.somar(Operacao(op.empresa, op.numero, op.origem, op.destino, op.partida_prevista,
+                         op.partida_real, op.chegada_prevista,
+                         op.chegada_prevista + timedelta(minutes=15, seconds=1), False))
+        self.assertEqual(c.chegada_no_horario, 1)
+
+    def test_30_e_60_exatos_nao_passam_da_faixa(self):
+        c = vra_anac.Contagem()
+        for m in (30, 31, 60, 61):
+            c.somar(_op(chegada_min=m))
+        self.assertEqual(c.chegada_acima, {30: 3, 60: 1})
+
+    def test_adiantado_conta_no_horario(self):
+        c = vra_anac.Contagem()
+        c.somar(_op(chegada_min=-20, partida_min=-5))
+        self.assertEqual((c.chegada_no_horario, c.partida_no_horario), (1, 1))
+
+    def test_realizado_sem_horario_real_para(self):
+        op = _op()
+        sem = Operacao(op.empresa, op.numero, op.origem, op.destino, op.partida_prevista,
+                       op.partida_real, op.chegada_prevista, None, False)
+        with self.assertRaisesRegex(ValueError, "sem horário real"):
+            vra_anac.Contagem().somar(sem)
+
+
+class Contagem(unittest.TestCase):
+    def setUp(self):
+        self.c = vra_anac.Contagem()
+        # 8 voos: 4 no horário, 1 com 20 min, 1 com 45, 1 com 90, 1 cancelado
+        for m in (0, 5, -3, 15, 20, 45, 90):
+            self.c.somar(_op(chegada_min=m, partida_min=m + 10))
+        self.c.somar(_op(cancelado=True))
+
+    def test_percentuais(self):
+        self.assertEqual(self.c.n, 8)
+        self.assertEqual(self.c.pct("chegada"), 50)
+        self.assertEqual(self.c.pct("cancelado"), 13)   # 12,5
+        self.assertEqual(self.c.pct("chegada>30"), 25)  # 45 e 90
+        self.assertEqual(self.c.pct("chegada>60"), 13)  # 90
+        # partida = chegada + 10: no horário 0, 5 e -3 (o 15 vira 25)
+        self.assertEqual(self.c.pct("partida"), 38)    # 3/8 = 37,5
+
+    def test_distribuicao_soma_o_n(self):
+        fatias = self.c.distribuicao("chegada")
+        self.assertEqual([(f.chave, f.voos) for f in fatias],
+                         [("no_horario", 4), ("ate30", 1), ("ate60", 1),
+                          ("acima60", 1), ("cancelado", 1)])
+        self.assertEqual(sum(f.voos for f in fatias), self.c.n)
+        self.assertEqual(fatias[1].largura, "12.500")
+
+
+class Agrupar(unittest.TestCase):
+    def setUp(self):
+        _, self.ops = vra_anac.ler_arquivo(FIXTURE)
+
+    def test_por_voo_na_fixture(self):
+        g = vra_anac.agrupar(self.ops, "voo")
+        self.assertEqual(len(g), 4)
+        c = g[("GLO", "1016", "SBSP", "SBRJ")]
+        # 23/07 chegou 56 min depois; 15/07 cancelado
+        self.assertEqual((c.n, c.pct("chegada"), c.pct("cancelado"), c.pct("chegada>30")),
+                         (2, 0, 50, 50))
+        self.assertEqual(g[("GLO", "1015", "SBRJ", "SBSP")].pct("chegada"), 100)
+
+    def test_por_companhia_rota_origem_destino(self):
+        self.assertEqual({k: c.n for k, c in vra_anac.agrupar(self.ops, "companhia").items()},
+                         {("GLO",): 4, ("AZU",): 1})
+        self.assertEqual(vra_anac.agrupar(self.ops, "companhia")[("GLO",)].pct("chegada"), 25)
+        self.assertEqual(vra_anac.agrupar(self.ops, "rota")[("SBSP", "SBRJ")].n, 2)
+        self.assertEqual(vra_anac.agrupar(self.ops, "origem")[("SBSP",)].n, 2)
+        self.assertEqual(vra_anac.agrupar(self.ops, "destino")[("SBRJ",)].n, 2)
+
+    def test_minimo(self):
+        self.assertEqual(list(vra_anac.agrupar(self.ops, "voo", minimo=2)),
+                         [("GLO", "1016", "SBSP", "SBRJ")])
+
+    def test_numero_com_z_soma_no_mesmo_voo(self):
+        g = vra_anac.agrupar([_op(numero="1000"), _op(numero="Z1000")], "voo")
+        self.assertEqual({k: c.n for k, c in g.items()}, {("GLO", "1000", "SBSP", "SBRJ"): 2})
+
+    def test_agrupamento_desconhecido(self):
+        with self.assertRaisesRegex(ValueError, "agrupamento desconhecido"):
+            vra_anac.agrupar(self.ops, "estado")
+
+
+if __name__ == "__main__":
+    unittest.main()