-
-
Notifications
You must be signed in to change notification settings - Fork 19k
Open
@hwhsu1231
Description
Pandas version checks
-
I have checked that this issue has not already been reported.
-
I have confirmed this bug exists on the latest version of pandas.
-
I have confirmed this bug exists on the main branch of pandas.
Reproducible Example
# Prepare Environment PANDAS_VERSION=2.1.x git clone --branch=${PANDAS_VERSION} https://github.com/pandas-dev/pandas.git pandas-${PANDAS_VERSION} cd pandas-${PANDAS_VERSION} export LANG=en_US.UTF-8 LANGUAGE=en_US PYTHONNOUSERSITE=1 conda create --prefix ./.conda --yes conda env update --prefix ./.conda --file environment.yml conda activate ./.conda pip uninstall pandas --yes pip install --editable . --no-build-isolation --no-deps --progress-bar=off --verbose conda list --export > env-pandas-${PANDAS_VERSION}.txt cat env-pandas-${PANDAS_VERSION}.txt # Build the Docs python doc/make.py html python doc/make.py clean python doc/make.py html --num-jobs=1 --single user_guide/scale.rst
Issue Description
Hello, Pandas Community,
Recently, I tried to build the Pandas documentation on 2.1.x branch, but I encountered an error related to a missing directory when executing a code block in the user_guide/scale.rst file. The error message indicates that the directory data/timeseries does not exist, which causes a FileNotFoundError:
Click to expand the error message
(/media/hwhsu1231/KubuntuData/Repo/testing/pandas-2.1.x/.conda) hwhsu1231@vb-kubuntu:/media/hwhsu1231/KubuntuData/Repo/testing/pandas-2.1.x$ python doc/make.py html --num-jobs=1 --single user_guide/scale.rst Running Sphinx v8.1.3 loading translations [en]... done making output directory... done Converting `source_suffix = ['.rst']` to `source_suffix = {'.rst': 'restructuredtext'}`. [autosummary] generating autosummary for: index.rst Writing evaluated template result to /media/hwhsu1231/KubuntuData/Repo/testing/pandas-2.1.x/doc/build/html/_static/nbsphinx-code-cells.css building [mo]: targets for 0 po files that are out of date writing output... building [html]: targets for 2 source files that are out of date updating environment: [new config] 2 added, 0 changed, 0 removed WARNING: ources... [100%] user_guide/scale >>>------------------------------------------------------------------------- Exception in /media/hwhsu1231/KubuntuData/Repo/testing/pandas-2.1.x/doc/source/user_guide/scale.rst at block ending on line None Specify :okexcept: as an option in the ipython:: block to suppress this message --------------------------------------------------------------------------- FileNotFoundError Traceback (most recent call last) Cell In[30], line 1 ----> 1 pathlib.Path("data/timeseries").mkdir(exist_ok=True) File /media/hwhsu1231/KubuntuData/Repo/testing/pandas-2.1.x/.conda/lib/python3.10/pathlib.py:1175, in Path.mkdir(self, mode, parents, exist_ok) 1171 """ 1172 Create a new directory at this given path. 1173 """ 1174 try: -> 1175 self._accessor.mkdir(self, mode) 1176 except FileNotFoundError: 1177 if not parents or self.parent == self: FileNotFoundError: [Errno 2] No such file or directory: 'data/timeseries' <<<------------------------------------------------------------------------- Exception occurred: File "/media/hwhsu1231/KubuntuData/Repo/testing/pandas-2.1.x/.conda/lib/python3.10/site-packages/IPython/sphinxext/ipython_directive.py", line 585, in process_input raise RuntimeError( RuntimeError: Unexpected exception in `/media/hwhsu1231/KubuntuData/Repo/testing/pandas-2.1.x/doc/source/user_guide/scale.rst` line None The full traceback has been saved in /tmp/sphinx-err-alx186om.log, if you want to report the issue to the developers. Please also report this if it was a user error, so that a better error message can be provided next time. A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
The full log: log-build-pandas-2.1.x-docs.txt
But strangely, when I attempted to build the Pandas documentation on the 2.2.x, 2.3.x, and main branch, the build process completed successfully without any errors.
What happened between the 2.1.x and 2.2.x branches that resolved this issue? Is there a specific fix or change that was made to address this problem?
Expected Behavior
Build the documentation successfully without errors.
Installed Versions
INSTALLED VERSIONS
------------------
commit : a671b5a8bf5dd13fb19f0e88edc679bc9e15c673
python : 3.10.18.final.0
python-bits : 64
OS : Linux
OS-release : 6.8.0-79-generic
Version : #79-Ubuntu SMP PREEMPT_DYNAMIC Tue Aug 12 14:42:46 UTC 2025
machine : x86_64
processor : x86_64
byteorder : little
LC_ALL : None
LANG : en_US.UTF-8
LOCALE : en_US.UTF-8
pandas : 2.1.4
numpy : 1.26.4
pytz : 2025.2
dateutil : 2.9.0.post0
setuptools : 80.9.0
pip : 25.2
Cython : 0.29.33
pytest : 8.4.2
hypothesis : 6.138.15
sphinx : 8.1.3
blosc : None
feather : None
xlsxwriter : 3.2.5
lxml.etree : 6.0.1
html5lib : 1.1
pymysql : 1.4.6
psycopg2 : 2.9.10
jinja2 : 3.1.6
IPython : 8.37.0
pandas_datareader : None
bs4 : 4.13.5
bottleneck : 1.6.0
dataframe-api-compat: None
fastparquet : 2024110
fsspec : 202590
gcsfs : 202590
matplotlib : 3.7.3
numba : 0.61.2
numexpr : 2.10.2
odfpy : None
openpyxl : 3.1.5
pandas_gbq : None
pyarrow : 21.0.0
pyreadstat : 1.3.1
pyxlsb : 1.0.10
s3fs : 202590
scipy : 1.15.2
sqlalchemy : 2.0.43
tables : 3.10.1
tabulate : 0.9.0
xarray : 2024100
xlrd : 2.0.2
zstandard : 0.24.0
tzdata : 2025.2
qtpy : None
pyqt5 : None