Skip to content

Conversation

@Sara-Jade-O
Copy link

Proposed Changes

Related Issues

Pre-requisites

This section may not be fully required if the branch is not merging into main.
Please indicate items that aren't necessary and why, with comments around incomplete checks.

  • Version number has been incremented, according to SemVer
  • Changelog has been updated, listing changes to this version. Use the keep a changelog format
  • New features are tested
  • New features are documented using the numpydoc docstring format
  • Other relevant package documentation is updated
  • For new functionality, examples are included in the docs or a feature request has
    been made for it/them.

@Sara-Jade-O Sara-Jade-O changed the title add type hints to code and updated mkdocstrings config 96 add type hints to code and updated mkdocstrings config Oct 24, 2025
@Sara-Jade-O Sara-Jade-O self-assigned this Oct 27, 2025
@gisellerosetta gisellerosetta removed their request for review October 27, 2025 10:21
@ellie-o ellie-o requested a review from Jday7879 October 27, 2025 10:22
@ellie-o ellie-o linked an issue Oct 27, 2025 that may be closed by this pull request
Copy link

@Jday7879 Jday7879 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice work Sara-Jade, a couple of issues I've noticed with the unit tests failing. It looks like the default arguments have been changed and are not the correct type anymore. I've highlighted a couple but might be more.
Also you will need to run the pre-commit hooks by either doing pre-commit install which means they run when attempting to commit, or to check all files do pre-commit run --all-files and this should format everything for you :)

theme: Optional["Theme"] = None,
cover: Optional["Cover"] = None,
contentsheet_label: str = "Contents",
contentsheet_options: Optional[Dict[str, Any]] = None,

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

default argument has been changed from empty dict to None, this caused fails in unit tests

contentsheet_options: Optional[Dict[str, Any]] = None,
notes_table: Optional[pd.DataFrame] = None,
notesheet_label: str = "Notes",
notesheet_options: Optional[Dict[str, Any]] = None,

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as above

legend: Optional[List[Any]] = None,
index_columns: Optional[Dict[int, int]] = None,
additional_formatting: Optional[List[Dict[str, Any]]] = None,
) -> None:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Default args for subtitles, legend, index column and additional formatting have been updated which might be causing test failures

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.

Use type hinting

3 participants