Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docstring improvement and check API links #142

Merged
merged 16 commits into from Jul 13, 2023

Conversation

ericpre
Copy link
Member

@ericpre ericpre commented Jul 6, 2023

Progress of the PR

  • Use sphinx-favicon since favicons option of pydata-sphinx-theme is deprecated
  • Enable sphinx nitpicky option to check link to API,
  • Use numpydoc to check docstring,
  • fix docstring according to numpydoc validation,
  • Set CI docs build to fail on warnings,
  • ignore API intersphinx know to fail - needs to be fixed in hyperspy
  • [n/a] update user guide (if appropriate),
  • update contributing guide,
  • add an changelog entry in the upcoming_changes folder (see upcoming_changes/README.rst),
  • Check formatting changelog entry in the readthedocs doc build of this PR (link in github checks)
  • add tests,
  • ready for review.

@codecov
Copy link

codecov bot commented Jul 6, 2023

Codecov Report

Patch coverage: 90.90% and project coverage change: -0.07 ⚠️

Comparison is base (c749d8e) 85.65% compared to head (8f193f0) 85.59%.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #142      +/-   ##
==========================================
- Coverage   85.65%   85.59%   -0.07%     
==========================================
  Files          74       74              
  Lines        9795     9800       +5     
  Branches     2085     2163      +78     
==========================================
- Hits         8390     8388       -2     
- Misses        907      913       +6     
- Partials      498      499       +1     
Impacted Files Coverage Δ
rsciio/utils/tools.py 79.29% <ø> (ø)
rsciio/netcdf/_api.py 20.22% <57.14%> (-3.69%) ⬇️
rsciio/ripple/_api.py 69.93% <66.66%> (ø)
rsciio/image/_api.py 68.53% <75.00%> (+1.87%) ⬆️
rsciio/tiff/_api.py 89.49% <75.00%> (-0.06%) ⬇️
rsciio/nexus/_api.py 91.61% <80.00%> (-0.02%) ⬇️
rsciio/tia/_api.py 77.71% <90.90%> (+0.27%) ⬆️
rsciio/_docstrings.py 100.00% <100.00%> (ø)
rsciio/blockfile/_api.py 95.33% <100.00%> (ø)
rsciio/bruker/_api.py 88.32% <100.00%> (+0.20%) ⬆️
... and 23 more

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

rsciio/tia/_api.py Fixed Show fixed Hide fixed
rsciio/bruker/_api.py Fixed Show fixed Hide fixed
docs/conf.py Fixed Show fixed Hide fixed
@ericpre ericpre force-pushed the check_API_links branch 4 times, most recently from 9037513 to f5c43d8 Compare July 8, 2023 10:38
docs/conf.py Dismissed Show dismissed Hide dismissed
@ericpre ericpre force-pushed the check_API_links branch 3 times, most recently from 3037a6d to 74156d5 Compare July 8, 2023 11:04
@ericpre ericpre added this to the v0.2 milestone Jul 8, 2023
@ericpre ericpre requested a review from jlaehne July 8, 2023 11:20
Copy link
Contributor

@jlaehne jlaehne left a comment

Choose a reason for hiding this comment

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

Thanks for all the cleanup!

CONTRIBUTING.rst Outdated
@@ -148,6 +148,11 @@ be used (see existing plugins).

The *docstrings* are automatically added in the *user guide* using the following lines
Copy link
Contributor

Choose a reason for hiding this comment

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

The code block should remain after this paragraph (this paragraph can also come after the new one).

Copy link
Member Author

Choose a reason for hiding this comment

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

Opss! This is now fixed - along with some typo and formatting issues.

rsciio/hspy/_api.py Outdated Show resolved Hide resolved
@ericpre ericpre force-pushed the check_API_links branch 2 times, most recently from 2218f11 to fcef136 Compare July 11, 2023 18:46
CONTRIBUTING.rst Outdated Show resolved Hide resolved
CONTRIBUTING.rst Outdated Show resolved Hide resolved
CONTRIBUTING.rst Outdated Show resolved Hide resolved
@jlaehne jlaehne merged commit 20907ac into hyperspy:main Jul 13, 2023
31 of 32 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation type: bug-fix type: enhancement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants