Skip to content

brasil-cli 0.4.0

Latest

Choose a tag to compare

@github-actions github-actions released this 19 Apr 18:29
· 3422 commits to main since this release

[0.4.0] — 2026-04-19

Added

  • Bilingual interactive data essay (docs/index.html) — 15 Plotly sections
    (Brazil choropleth, Lorenz curve, UF ranking with CI, UF×faixa heatmap,
    macro-regions, age pyramid, cross-tabulations, income-source composition,
    state dependency ranking, socioeconomic gauges) rendered from the brasil dashboard --format json payload via docs/build_index.py. PT/EN toggle,
    Newsreader + IBM Plex typography, Brazilian flag palette, roman-numeral
    chapter rail, auditable footer seal with vintage + hash.
  • Long-form essay in PT (docs/artigo_pt.md, 10.052 words) and EN
    (docs/artigo_en.md, 10.480 words), both in 15 H1 chapters with inline
    markdown citations to 2024–2026 journalism and canonical sources (IBGE,
    IPEA, FGV-IBRE, INEP, INAF, Banco Mundial, OECD).
  • Static hero PNG (docs/assets/hero.png) generated by
    docs/build_hero.py from the br-uf GeoJSON — embedded at the top of the
    README.
  • GitHub Pages-ready docs/ folder with .nojekyll, publishable via
    main:/docs.
  • Statistical audit seal in terminal dashboard — checklist of weight
    column, replicate count, deflator target, SM reference, rows, households,
    and a short reproducibility hash on every render.
  • Annual PNADC replicate weights (V1032001..V1032200) now included in
    DEFAULT_KEEP_ANUAL; bootstrap CI works in --mode anual.
  • Auto-detection of replicate-weight base — V1028xxx (trimestral) vs
    V1032xxx (anual) — chosen from the selected primary weight column.
  • Editorial CLI dashboard v3 — ornamental section dividers, narrative
    italic blocks, Lorenz curve with shaded Gini area, Cleveland dot-plot with
    whiskers, Brazil ASCII choropleth, analog-style gauges, executive briefing
    "O Brasil em 5 verdades", country-equivalent read-out, official seal.
  • CITATION.cff for academic citation.
  • CI workflow expanded with ruff check, black --check, and a template
    placeholder validation step. Python 3.13 added to the matrix.
  • --mode anual --composition-by-band --dependency-ranking flags surfaced in
    the quick-start commands.

Changed

  • License changed from Apache-2.0 to MIT for maximum downstream reuse.
  • pyproject.toml updated with full authorship, maintainer, keyword, and
    URL metadata; version bumped to 0.4.0.
  • README rewritten with a short editorial opening ("Why this exists"),
    embedded hero image, and banner linking to the interactive essay plus both
    long-form articles. Technical body preserved.
  • Dashboard terminal output expanded from ~220 to ~390 lines of richer
    typography with narrative explainers per section.

Fixed

  • Validation checklist in the dashboard now accepts either V1028/V1027 or
    V1032/V1031 as primary weight, labeled correctly per mode.
  • Audit seal shows the actual weight base (V1028 or V1032) instead of a
    hard-coded trimestral label.
  • Pre-existing pyright type-narrowing warnings on int() casts against
    Dict[str, object] values reduced by explicit str() coercion.
  • Multiple ruff issues cleaned up (unused imports, ambiguous names, f-strings
    without placeholders). The whole scripts/ and docs/ trees now pass
    ruff check and black --check with zero warnings.