Skip to content

Conversation

@desilinguist
Copy link
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
Copy link

codecov bot commented Jun 12, 2023

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.

@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.

4 participants