From 6c5cccc87e1cea9174474d04eb2185e1b0c8a98b Mon Sep 17 00:00:00 2001 From: Joris Van den Bossche Date: Wed, 25 Jun 2025 18:21:06 +0200 Subject: [PATCH 1/4] WEB: add note to PDEP-10 about delayed timeline for requiring pyarrow --- web/pandas/pdeps/0010-required-pyarrow-dependency.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/web/pandas/pdeps/0010-required-pyarrow-dependency.md b/web/pandas/pdeps/0010-required-pyarrow-dependency.md index 60ed8c4b910eb..daa7090a51ab6 100644 --- a/web/pandas/pdeps/0010-required-pyarrow-dependency.md +++ b/web/pandas/pdeps/0010-required-pyarrow-dependency.md @@ -30,6 +30,11 @@ This PDEP proposes that: This will bring **immediate benefits to users**, as well as opening up the door for significant further benefits in the future. +**NOTE**: while this PDEP mentions adding pyarrow as a required dependency in +pyarrow 3.0, this aspect has been delayed until after pandas 3.0. Therefore, +pandas 3.0 will not have a hard requirement on pyarrow and only use it by +default (for strings) when installed. + ## Background PyArrow is an optional dependency of pandas that provides a wide range of supplemental features to pandas: From 6cd97703989a980f231d43d40009c61af525c1e9 Mon Sep 17 00:00:00 2001 From: Joris Van den Bossche Date: Wed, 25 Jun 2025 22:01:38 +0200 Subject: [PATCH 2/4] add link --- web/pandas/pdeps/0010-required-pyarrow-dependency.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/web/pandas/pdeps/0010-required-pyarrow-dependency.md b/web/pandas/pdeps/0010-required-pyarrow-dependency.md index daa7090a51ab6..a7eb27b531474 100644 --- a/web/pandas/pdeps/0010-required-pyarrow-dependency.md +++ b/web/pandas/pdeps/0010-required-pyarrow-dependency.md @@ -10,6 +10,12 @@ [TOC] +**NOTE**: while this PDEP mentions adding pyarrow as a required dependency in +pandas 3.0, this aspect has been delayed until after pandas 3.0 (see the +abstract of [PDEP-14](https://pandas.pydata.org/pdeps/0014-string-dtype.html)). +Therefore, pandas 3.0 will not have a hard requirement on pyarrow but still use +pyarrow by default (for the new string dtype) when installed. + ## Abstract This PDEP proposes that: @@ -30,11 +36,6 @@ This PDEP proposes that: This will bring **immediate benefits to users**, as well as opening up the door for significant further benefits in the future. -**NOTE**: while this PDEP mentions adding pyarrow as a required dependency in -pyarrow 3.0, this aspect has been delayed until after pandas 3.0. Therefore, -pandas 3.0 will not have a hard requirement on pyarrow and only use it by -default (for strings) when installed. - ## Background PyArrow is an optional dependency of pandas that provides a wide range of supplemental features to pandas: From 81bf84160e06004d0e8da02ee8f650d5033ccb58 Mon Sep 17 00:00:00 2001 From: Joris Van den Bossche Date: Sun, 19 Oct 2025 23:14:58 +0200 Subject: [PATCH 3/4] turn into admonition mode --- web/pandas/config.yml | 1 + .../pdeps/0010-required-pyarrow-dependency.md | 11 ++-- web/pandas/static/css/pandas.css | 62 +++++++++++++++++++ 3 files changed, 69 insertions(+), 5 deletions(-) diff --git a/web/pandas/config.yml b/web/pandas/config.yml index 4cb4ad0f48c5b..76e4494850182 100644 --- a/web/pandas/config.yml +++ b/web/pandas/config.yml @@ -19,6 +19,7 @@ main: - meta - footnotes - codehilite + - admonition static: logo: static/img/pandas_white.svg css: diff --git a/web/pandas/pdeps/0010-required-pyarrow-dependency.md b/web/pandas/pdeps/0010-required-pyarrow-dependency.md index a7eb27b531474..5c77b8c479638 100644 --- a/web/pandas/pdeps/0010-required-pyarrow-dependency.md +++ b/web/pandas/pdeps/0010-required-pyarrow-dependency.md @@ -10,11 +10,12 @@ [TOC] -**NOTE**: while this PDEP mentions adding pyarrow as a required dependency in -pandas 3.0, this aspect has been delayed until after pandas 3.0 (see the -abstract of [PDEP-14](https://pandas.pydata.org/pdeps/0014-string-dtype.html)). -Therefore, pandas 3.0 will not have a hard requirement on pyarrow but still use -pyarrow by default (for the new string dtype) when installed. +!!! note + While this PDEP mentions adding pyarrow as a required dependency in + pandas 3.0, this aspect has been delayed until after pandas 3.0 (see the + abstract of [PDEP-14](https://pandas.pydata.org/pdeps/0014-string-dtype.html)). + Therefore, pandas 3.0 will not have a hard requirement on pyarrow but still use + pyarrow by default (for the new string dtype) when installed. ## Abstract diff --git a/web/pandas/static/css/pandas.css b/web/pandas/static/css/pandas.css index 59904606040be..1313edacde726 100644 --- a/web/pandas/static/css/pandas.css +++ b/web/pandas/static/css/pandas.css @@ -135,3 +135,65 @@ h2:hover a.headerlink, h3:hover a.headerlink { opacity: 1; transition: opacity 0.5s; } + + +/** Copied from the pydata-sphinx-theme **/ + div.admonition, .admonition { + margin: 1.5625em auto; + padding: 0 0.6rem 0.8rem; + overflow: hidden; + /* break-inside has replaced page-break-inside and is widely usable since 2019 */ + page-break-inside: avoid; + break-inside: avoid; + border-left: 0.2rem solid; + border-color: #276be9; + border-radius: 0.25rem; + background-color: #fff; + /** * Special-case for a `sidebar` class that makes the admonition float to * the right like the { + sidebar + } + directive. */ +} + div.admonition *:last-child, .admonition *:last-child { + margin-bottom: 0; +} + div.admonition p.admonition-title ~ *, .admonition p.admonition-title ~ * { + margin-left: 1.4rem; + margin-right: 1.4rem; +} + div.admonition > ol, .admonition > ol, div.admonition > ul, .admonition > ul { + margin-left: 1em; +} + div.admonition > .admonition-title, .admonition > .admonition-title { + margin: 0 -0.6rem; + padding: 0.4rem 0.6rem 0.4rem 2rem; + /* font-weight: var(--pst-admonition-font-weight-heading); */ + position: relative; + background-color: #dce7fc; + z-index: 1; +} + div.admonition > .admonition-title::after, .admonition > .admonition-title::after { + position: absolute; + left: 0.5rem; + width: 1rem; + height: 1rem; + /* color: var(--pst-color-info); */ + /* font: var(--fa-font-solid); */ + line-height: inherit; + /* content: "\f05a"; */ + opacity: 1; +} + div.admonition > .admonition-title + *, .admonition > .admonition-title + * { + margin-top: 0.4em; +} + + div.admonition.note, .admonition.note { + border-color: #276be9; +} + div.admonition.note > .admonition-title, .admonition.note > .admonition-title { + background-color: #dce7fc; +} + div.admonition.note > .admonition-title::after, .admonition.note > .admonition-title::after { + color: #276be9; + /* content: "\f05a"; */ +} From 577206e04019e0ea8965a84cd07153563bfe3783 Mon Sep 17 00:00:00 2001 From: Joris Van den Bossche Date: Sun, 19 Oct 2025 23:29:02 +0200 Subject: [PATCH 4/4] fix shadow --- web/pandas/pdeps/0010-required-pyarrow-dependency.md | 2 +- web/pandas/static/css/pandas.css | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/web/pandas/pdeps/0010-required-pyarrow-dependency.md b/web/pandas/pdeps/0010-required-pyarrow-dependency.md index 5c77b8c479638..29e6f7f0e98f3 100644 --- a/web/pandas/pdeps/0010-required-pyarrow-dependency.md +++ b/web/pandas/pdeps/0010-required-pyarrow-dependency.md @@ -14,7 +14,7 @@ While this PDEP mentions adding pyarrow as a required dependency in pandas 3.0, this aspect has been delayed until after pandas 3.0 (see the abstract of [PDEP-14](https://pandas.pydata.org/pdeps/0014-string-dtype.html)). - Therefore, pandas 3.0 will not have a hard requirement on pyarrow but still use + Therefore, pandas 3.0 will *not* have a hard requirement on pyarrow but still use pyarrow by default (for the new string dtype) when installed. ## Abstract diff --git a/web/pandas/static/css/pandas.css b/web/pandas/static/css/pandas.css index 1313edacde726..ef354d8264da4 100644 --- a/web/pandas/static/css/pandas.css +++ b/web/pandas/static/css/pandas.css @@ -142,6 +142,7 @@ h2:hover a.headerlink, h3:hover a.headerlink { margin: 1.5625em auto; padding: 0 0.6rem 0.8rem; overflow: hidden; + box-shadow: 0 .2rem .5rem rgba(0,0,0,0.1),0 0 .0625rem rgba(0,0,0,0.1) !important; /* break-inside has replaced page-break-inside and is widely usable since 2019 */ page-break-inside: avoid; break-inside: avoid;