search

pandas-dev / pandas

Flexible and powerful data analysis / manipulation library for Python, providing labeled data structures similar to R data.frame objects, statistical functions, and much more
https://pandas.pydata.org
BSD 3-Clause "New" or "Revised" License
43.91k stars 18.03k forks source link

BUG: "python make.py html" for documentation is giving error #60039

Open Swati-Sneha opened 1 month ago

Swati-Sneha commented 1 month ago

Pandas version checks

Reproducible Example

python make.py html

Issue Description

While trying to build documentation for pandas-dev, the build fails with Sphinx parallel build error

Screenshot 2024-10-14 at 19 06 45

Stackoverflow Issue Reference

Expected Behavior

The build should be successful and the docs should be built in local

Installed Versions

INSTALLED VERSIONS ------------------ commit : 2a10e04a099d5f1633abcdfbb2dd9fdf09142f8d python : 3.10.15 python-bits : 64 OS : Darwin OS-release : 23.6.0 Version : Darwin Kernel Version 23.6.0: Fri Jul 5 17:56:39 PDT 2024; root:xnu-10063.141.1~2/RELEASE_ARM64_T8122 machine : arm64 processor : arm byteorder : little LC_ALL : None LANG : en_US.UTF-8 LOCALE : en_US.UTF-8 pandas : 0+untagged.35606.g2a10e04 numpy : 1.26.4 dateutil : 2.9.0 pip : 24.2 Cython : 3.0.11 sphinx : 8.1.1 IPython : 8.28.0 adbc-driver-postgresql: None adbc-driver-sqlite : None bs4 : 4.12.3 blosc : None bottleneck : 1.4.0 fastparquet : 2024.5.0 fsspec : 2024.9.0 html5lib : 1.1 hypothesis : 6.114.1 gcsfs : 2024.9.0post1 jinja2 : 3.1.4 lxml.etree : 5.3.0 matplotlib : 3.9.2 numba : 0.60.0 numexpr : 2.10.1 odfpy : None openpyxl : 3.1.5 psycopg2 : 2.9.9 pymysql : 1.4.6 pyarrow : 17.0.0 pyreadstat : 1.2.7 pytest : 8.3.3 python-calamine : None pytz : 2024.2 pyxlsb : 1.0.10 s3fs : 2024.9.0 scipy : 1.14.1 sqlalchemy : 2.0.35 tables : 3.10.1 tabulate : 0.9.0 xarray : 2024.9.0 xlrd : 2.0.1 xlsxwriter : 3.2.0 zstandard : 0.23.0 tzdata : 2024.2 qtpy : None pyqt5 : None
vamsi-verma-s commented 1 month ago

@Swati-Sneha - Pls try deleting build directory and build again.

Swati-Sneha commented 1 month ago

@vamsi-verma-s I have done that already.

I also asked this in the slack channel, seems I am not the only one facing it.

rhshadrach commented 1 month ago

I can build the docs locally and the CI has been successful. But neither of these are on arm64.

The line count is off because there are some lines injected into the rst files in order to do e.g. import pandas as pd. My guess is the issue is from this code block:

https://github.com/pandas-dev/pandas/blob/68d9dcab5b543adb3bfe5b83563c61a9b8afae77/doc/source/whatsnew/v1.5.0.rst?plain=1#L39-L52

What happens when you run that?

Swati-Sneha commented 3 weeks ago

What do you mean @rhshadrach ? When I run what? The command: python make.py html or are you refering to something else?

rhshadrach commented 3 weeks ago

The code in the code-block in my comment.

Swati-Sneha commented 3 weeks ago

This is what I get when I run it from my terminal, seems okay to me.

Screenshot 2024-11-04 at 23 33 37
rhshadrach commented 3 weeks ago

Can you try python make.py html --num-jobs=1. Hopefully that should give you a stack trace.