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

Fix doc builds for main branch #3792

Merged
merged 5 commits into from
Jan 9, 2023
Merged

Conversation

beroda
Copy link
Contributor

@beroda beroda commented Jan 7, 2023

This is an attempt to resolve #3782

…ameters in DataObject copy_meta_from docstring
@github-actions github-actions bot added documentation Anything related to the documentation/website maintenance Low-impact maintenance activity labels Jan 7, 2023
@beroda beroda changed the title Fix docs for main Fix doc builds for main branch Jan 7, 2023
@codecov
Copy link

codecov bot commented Jan 7, 2023

Codecov Report

Merging #3792 (f37caeb) into main (4b3a856) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main    #3792   +/-   ##
=======================================
  Coverage   94.15%   94.15%           
=======================================
  Files          86       86           
  Lines       18891    18891           
=======================================
  Hits        17787    17787           
  Misses       1104     1104           

banesullivan
banesullivan previously approved these changes Jan 7, 2023
 Renderers (and hence wraps in Plotter) class was missing  a docstring (copy/paste from Renderer class)
@beroda
Copy link
Contributor Author

beroda commented Jan 7, 2023

From what I can see in doc build logs, 4 warnings seemed to be causing the failure (since we build doc with the -W option).
https://github.com/pyvista/pyvista/actions/runs/3858649131/jobs/6577403817#step:11:4302

I think I was able to remove these warnings by implementing docstrings for aforementioned methods, but I am afraid that we cannot tell the fix is working from this PR's CI, since it appears to behave differently to main, (might deserve and investigation/issue ?)

doc/conf.py Outdated Show resolved Hide resolved
@beroda
Copy link
Contributor Author

beroda commented Jan 7, 2023

Since we try to remove all warnings in doc builds, I am afraid that this warning would need to wait for #3783 to be handled.

@beroda beroda marked this pull request as ready for review January 7, 2023 21:38
@@ -139,6 +139,7 @@ filterwarnings = [
'ignore:.*numpy.ufunc size changed.*:RuntimeWarning',
'ignore:.*Given trait value dtype "float64":UserWarning',
'ignore:.*The NumPy module was reloaded*:UserWarning',
'error::pyvista.PyVistaDeprecationWarning'
Copy link
Contributor Author

@beroda beroda Jan 7, 2023

Choose a reason for hiding this comment

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

I added this warning conversion to an error in oder to detect which docstrings use deprecated methods (when using pytest --doctest-module).
It also serves to asses that warnings are indeed captured in tests.

Let me know if it is fine for you.

Copy link
Member

Choose a reason for hiding this comment

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

Ahh this is great, thanks!

@banesullivan banesullivan merged commit 188fab8 into pyvista:main Jan 9, 2023
@banesullivan banesullivan mentioned this pull request Feb 1, 2023
5 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Anything related to the documentation/website maintenance Low-impact maintenance activity
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Documentation build is failing on main
3 participants