fabian-carini/uruguay-stats

This repository is a collection of Python data analysis and visualization projects focused on Uruguayan statistics. Each project covers a specific topic: presidential approval ratings from 1990 to 2026, national budget spending broken down by sector from 1973 to 2024, Montevideo bus line counts by company from 1920 to 2026, and radio audience ratings in Montevideo from recent years. The output of each project is a chart saved as a PNG or SVG file, with annotations in Spanish. The project is structured so that each topic lives in its own folder with a script called plot.py, data files, and pre-generated chart images. Running a script generates charts and optionally opens them for viewing. Each script can also be converted to a Jupyter notebook, so the same analysis can be browsed interactively via Google Colab or a local notebook server without any local install. The codebase stays close to standard Python tools. Charts are produced with matplotlib using a clean grid-based style. Statistics utilities are written from scratch in a shared library rather than relying on heavy data science packages. Dependency management uses a modern tool called uv, which installs everything from a lockfile. The project requires Python 3.14 or newer. There is a pre-commit hook that automatically regenerates notebooks, checks formatting, and runs a type checker every time code is committed, keeping the notebooks in sync with the scripts. The charts use Spanish-language labels and Uruguayan number formatting. Source data comes from Uruguayan government offices, the World Bank, polling firms, and transit authority records. The README includes Google Colab badges next to each project so anyone can run the notebooks in a browser instantly.