Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[0.1.0] - 2025-08-09
Changed
- Improved documentation for contributors, including a more open security policy, a new development guide, and clearer instructions in the Code of Conduct.
- Updated sensitivity analysis runners to pass parameters more explicitly.
Added
- Initial project setup.
- Python project structure with
src/directory. pyproject.tomlfor dependency management and project configuration.pytestfor unit testing.rufffor linting and formatting.pre-commithooks for automated code quality checks.LICENSEfile (Apache 2.0 License).CONTRIBUTING.mdwith contribution guidelines.CITATION.cfffor citation information.- Optional modules for Paid Parental Leave and child support modelling.
- All yearly parameter files now include
pplandchild_supportsections so these modules can be enabled for any simulation year. SECURITY.mdfor vulnerability reporting.sas_models/directory for original SAS model files.docs/directory for documentation files.docs/external/for external reference documents (PDFs)..gitignoreupdated to include new directories and IDE-specific files.- Added type hints to
src/microsim.py,src/wff_microsim.py, andsrc/wff_microsim_main.py. - Added docstrings to
test_microsim.pyandtest_wff_microsim.py. - Added
src/py.typedto indicate type information availability. - Added
payroll_deductions.pywith KiwiSaver and student loan helper functions. - Extended parameter files with KiwiSaver contribution and student loan repayment settings.
- Added
README.mdfiles tosrc/,sas_models/,docs/,examples/,tests/, anddocs/external/directories. - Moved test files to
tests/directory and updatedpyproject.tomlaccordingly. - Added
requirements-dev.txtfor development dependencies and updatedMakefileto use it. - Refined
CITATION.cffto use generic project information. - Moved
CITATION.cfftodocs/directory. - Moved
CONTRIBUTING.mdtodocs/directory. - Moved
SECURITY.mdtodocs/directory. - Added
installtarget toMakefileand updatedREADME.mdwith installation instructions. - Added
run-exampletarget toMakefileand updatedREADME.mdwith instructions on how to run the example. - Added
.github/CODEOWNERSfile and a correspondingREADME.mdto the.github/directory. - Moved
LICENSEfile todocs/directory. - Added
calculate_evpifunction for computing the Expected Value of Perfect Information from probabilistic sensitivity outputs and corresponding unit tests. - Added budget impact analysis utilities for comparing baseline and reform scenarios.
- Added wrapper
calculate_budget_impactinsrc.reporting. - Added
src/acc_levy.pywith ACC levy and payroll deduction functions. - New unit tests for ACC levy calculations.
- Added inequality metrics helpers (
lorenz_curve,atkinson_index,theil_index). - Added simple dynamic simulation utilities for iterating policies across years.