@@ -190,6 +190,24 @@ Hourly cronjob:
1901900 * * * * /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
195213poetry added the
@@ -797,6 +815,11 @@ location depends on the tool:
797815Tools that use profile scripts write to `/etc/profile.d/cooldowns.sh` if the directory exists and is writable,
798816otherwise 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