sphinx-contrib / redoc

ReDoc powered OpenAPI (fka Swagger) spec renderer for Sphinx.
https://sphinxcontrib-redoc.readthedocs.io/
BSD 2-Clause "Simplified" License
34 stars 20 forks source link

Aborted attempted copy warning about `redoc.js` #48

Open rra opened 2 months ago

rra commented 2 months ago

Starting with Sphinx 8, use of sphinxcontrib-redoc produces the following warning for any build after the first:

WARNING: Aborted attempted copy from /home/eagle/lsst/gafaelfawr/.tox/docs/lib/python3.12/site-packages/sphinxcontrib/redoc.js to /home/eagle/lsst/gafaelfawr/docs/_build/html/_static/redoc.js (the destination path has existing data). [misc.copy_overwrite]

If the text of the warning is correct, I suspect this means that the already-present copy in the build tree is not updated. I believe there's a new force=True option to the relevant Sphinx utility function that forces the overwrite. Perhaps that should be used here.

prjemian commented 6 days ago

This is not limited to redoc. Same problem without it:

WARNING: Aborted attempted copy from /home/prjemian/Documents/projects/BCDA-APS/bluesky_training/docs/build/doctrees/nbsphinx/howto/_time_scan.ipynb to /home/prjemian/Documents/projects/BCDA-APS/bluesky_training/docs/build/html/howto/_time_scan.ipynb (the destination path has existing data). [misc.copy_overwrite]
(bluesky_2024_3) prjemian@arf:~/.../BCDA-APS/bluesky_training$ conda list sphinx
# packages in environment at /home/prjemian/.conda/envs/bluesky_2024_3:
#
# Name                    Version                   Build  Channel
nbsphinx                  0.9.5              pyhd8ed1ab_0    conda-forge
pydata-sphinx-theme       0.15.4             pyhd8ed1ab_0    conda-forge
sphinx                    8.0.2              pyhd8ed1ab_0    conda-forge
sphinx-autodoc-typehints  2.5.0                    pypi_0    pypi
sphinx-basic-ng           1.0.0b2                  pypi_0    pypi
sphinx-design             0.6.1              pyhd8ed1ab_1    conda-forge
sphinx-jinja2-compat      0.3.0                    pypi_0    pypi
sphinx-prompt             1.9.0                    pypi_0    pypi
sphinx-tabs               3.4.5                    pypi_0    pypi
sphinx-toolbox            3.8.1                    pypi_0    pypi
sphinxcontrib-applehelp   2.0.0              pyhd8ed1ab_0    conda-forge
sphinxcontrib-devhelp     2.0.0              pyhd8ed1ab_0    conda-forge
sphinxcontrib-htmlhelp    2.1.0              pyhd8ed1ab_0    conda-forge
sphinxcontrib-jsmath      1.0.1              pyhd8ed1ab_0    conda-forge
sphinxcontrib-napoleon    0.7                        py_0    conda-forge
sphinxcontrib-qthelp      2.0.0              pyhd8ed1ab_0    conda-forge
sphinxcontrib-serializinghtml 1.1.10             pyhd8ed1ab_0    conda-forge