Skip to content

Document the flat-file dataset format - #536

Merged
anth-volk merged 1 commit into
masterfrom
document-flat-file-data-format
Sep 2, 2026
Merged

Document the flat-file dataset format#536
anth-volk merged 1 commit into
masterfrom
document-flat-file-data-format

Conversation

@anth-volk

Copy link
Copy Markdown
Collaborator

Fixes #263

Summary

  • List Dataset.FLAT_FILE alongside the other supported Dataset.data_format values.
  • Document that this format stores the dataset as a single CSV file represented by a pandas DataFrame.
  • Add the required towncrier fragment.

Validation

  • uv run --no-sync ruff format policyengine_core/data/dataset.py
  • uv run --no-sync ruff check policyengine_core/data/dataset.py
  • uv run --no-sync towncrier build --draft --version 3.32.1
  • uv run --no-sync make documentation — succeeded with 25 pre-existing warnings
  • git diff --check

The checks use the existing development environment without synchronizing because the automated 3.32.0 release commit updated the package version while the lockfile's root-package record remains at 3.31.1. This pull request does not alter dependency resolution.

Documentation review

The Dataset.data_format source documentation now describes all four accepted formats. No runtime behavior or separate usage-guide changes are required for this narrowly scoped correction. Impact is low and confidence is high. The generated API page displays the class attributes but, as before, does not render any of their adjacent attribute-description strings; this pull request preserves the documentation pattern requested by the issue rather than changing the documentation configuration.

@anth-volk
anth-volk marked this pull request as ready for review September 2, 2026 12:06
@anth-volk
anth-volk merged commit a99ff9a into master Sep 2, 2026
18 checks passed
@anth-volk
anth-volk deleted the document-flat-file-data-format branch September 2, 2026 12:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation for data_format in Dataset class doesn't contain info on FLAT_FILE-type

1 participant