Skip to content

Improve docstrings and type hints (Part 2). - #738

Merged
desilinguist merged 6 commits into
mainfrom
647-improve-docstrings-typehints-2
Jun 13, 2023
Merged

Improve docstrings and type hints (Part 2). #738
desilinguist merged 6 commits into
mainfrom
647-improve-docstrings-typehints-2

Conversation

@desilinguist

Copy link
Copy Markdown
Collaborator
  • chore(req): revert sphinx to <6.0. The sidebar does not work properly with sphinx>=6.0.
  • chore: ignore E501 errors in featureset.py.
  • chore: fix docstrings and types in skll.data. Also refactored the keyword arguments for many writers to be more explicit rather than using **kwargs everywhere.
  • docs: improve layout of api/data.rst. Use individual autoclass items instead of one automodule item to make sure that Reader and Writer base classes are shown before all the other classes.

To review this, please look at the built documentation and check that under the "API documentation" > "data Package`":

  • All parameters have a docstring.
  • All type hints have clickable types or type hints.
  • The default values are all specified as default = blah.
  • All other changes look okay.

This is part of #647.

- The sidebar does not work properly with sphinx>=6.0.
- Also refactored the keyword arguments for many writers to be
  more explicit rather than using `**kwargs` everywhere.
Use individual `autoclass` items instead of one `automodule` item to make sure
that `Reader` and `Writer` base classes are shown before all the other classes.
@codecov

codecov Bot commented Jun 12, 2023

Copy link
Copy Markdown

Codecov Report

Patch coverage: 93.10% and project coverage change: -0.03 ⚠️

Comparison is base (7709aa4) 95.21% compared to head (bc08d5d) 95.18%.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #738      +/-   ##
==========================================
- Coverage   95.21%   95.18%   -0.03%     
==========================================
  Files          29       29              
  Lines        3532     3533       +1     
==========================================
  Hits         3363     3363              
- Misses        169      170       +1     
Impacted Files Coverage Δ
skll/data/dict_vectorizer.py 100.00% <ø> (ø)
skll/data/featureset.py 91.57% <ø> (ø)
skll/data/readers.py 90.42% <ø> (ø)
skll/data/writers.py 93.20% <93.10%> (-0.46%) ⬇️

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

Comment thread CONTRIBUTING.md
Comment thread skll/data/writers.py Outdated
@desilinguist
desilinguist merged commit b8be359 into main Jun 13, 2023
@delete-merged-branch
delete-merged-branch Bot deleted the 647-improve-docstrings-typehints-2 branch June 13, 2023 15:27
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.

3 participants