Skip to content

Commit 8ac4215

Browse files
mprpicclaude
andcommitted
Add pipenv cooldown documentation
- Add pipenv section under Python Ecosystem documenting the cool-down-period Pipfile setting (pipenv 2026.6.2+) - Add pipenv to Quick reference and Bypassing cooldowns tables - Note in cooldowns.sh section that project-level-only tools (pipenv, pixi, Scala Steward) are not covered by the script Fixes #20 Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> Signed-off-by: Martin Prpič <martin.prpic@gmail.com>
1 parent 4b1ac7c commit 8ac4215

1 file changed

Lines changed: 26 additions & 0 deletions

File tree

README.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,24 @@ Hourly cronjob:
190190
0 * * * * /usr/local/bin/pip-dependency-cooldown ~/.config/pip/pip.conf 3 2>&1 | logger -t pip-dependency-cooldown
191191
```
192192

193+
### pipenv
194+
195+
[pipenv](https://pipenv.pypa.io/) added the `cool-down-period` setting in version 2026.6.2. It is configured in the
196+
`[pipenv]` section of the project's `Pipfile` and accepts a duration string in the form `<N>d` (days). For example, to
197+
apply a three-day cooldown:
198+
199+
```toml
200+
[pipenv]
201+
cool-down-period = "3d"
202+
```
203+
204+
Under the hood, pipenv passes this value to pip's `--uploaded-prior-to` flag during resolution. The filtering only works
205+
against indexes that expose upload-time metadata via the Simple Repository API; when the index does not provide it, the
206+
setting is accepted but has no filtering effect (see [Private PyPI registries](#private-pypi-registries)).
207+
208+
There is no environment variable equivalent and no per-package bypass. To install a specific package without the
209+
cooldown, temporarily remove the setting from the Pipfile or install the package directly with pip.
210+
193211
### poetry
194212

195213
poetry added the
@@ -797,6 +815,11 @@ location depends on the tool:
797815
Tools that use profile scripts write to `/etc/profile.d/cooldowns.sh` if the directory exists and is writable,
798816
otherwise they fall back to `~/.bashrc`.
799817

818+
Tools that only support project-level configuration are not covered by this script. This includes pipenv
819+
(`cool-down-period` in the Pipfile), pixi (`exclude-newer` in `pixi.toml`), and Scala Steward
820+
(`updates.cooldown.minimumAge` in `.scala-steward.conf`). For pipenv specifically, the `PIP_UPLOADED_PRIOR_TO`
821+
environment variable set by `cooldowns.sh set pip` is inherited by pipenv since it uses pip under the hood.
822+
800823
### Checking cooldowns
801824

802825
```bash
@@ -842,6 +865,7 @@ RUN cooldowns.sh check
842865
| --------------- | ------------------------------------------ | ----------------------------------------------------------------- |
843866
| pip | Relative durations (26.1+) | `PIP_UPLOADED_PRIOR_TO="P3D"` / `--uploaded-prior-to P3D` |
844867
| uv | Relative durations | `exclude-newer = "3 days"` in `uv.toml` / `pyproject.toml` |
868+
| pipenv | Relative durations (2026.6.2+) | `cool-down-period = "3d"` in `Pipfile` |
845869
| poetry | Relative durations | `solver.min-release-age=3` in `pyproject.toml` |
846870
| pixi | Relative durations (0.67.0+) | `exclude-newer = "3d"` in `pixi.toml` |
847871
| npm | Relative durations | `min-release-age=3` in `.npmrc` |
@@ -870,6 +894,7 @@ disable the cooldown for a single run. The table below summarizes the bypass mec
870894
| --------------- | ------------------ | ----------------------------------------------------------------------- |
871895
| pip | No | Unset env var or override on CLI; see [pip section](#pip) |
872896
| uv | Yes | `exclude-newer-package = { pkg = false }` in config file |
897+
| pipenv | No | Remove `cool-down-period` from `Pipfile` or install directly with pip |
873898
| poetry | Yes | `solver.min-release-age-exclude = "pkg"` or env var |
874899
| pixi | Yes | `[pypi-exclude-newer]` / `[exclude-newer]` table, set to `"0d"` |
875900
| npm | No | Pass `--min-release-age=0` on the command line |
@@ -935,6 +960,7 @@ with zero ongoing effort after initial setup. Pick a number, configure it, and s
935960

936961
## Changelog
937962

963+
- **2026-07-22**: Added pipenv cooldown documentation.
938964
- **2026-07-21**: Added GitHub Actions cooldown documentation (`actions-up`).
939965
- **2026-06-19**: Updated VS Code documentation for the `extensions.autoUpdateDelay` setting.
940966
- **2026-06-18**: Added per-package bypass documentation.

0 commit comments

Comments
 (0)