From 90856e9a8d1bf13e483e7a00aa022b2edc10260e Mon Sep 17 00:00:00 2001 From: Mohamed Ajab Date: Tue, 22 Sep 2026 12:02:53 +0100 Subject: [PATCH 1/3] docs: clarify source exclusion configuration --- docs/configuration.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/docs/configuration.md b/docs/configuration.md index f1fac414dbe..2fbae535c47 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -473,7 +473,7 @@ poetry config solver.min-release-age-exclude "my-package,other-package" ### `solver.min-release-age-exclude-source` -**Type**: `string` +**Type**: `array` **Default**: *not set* @@ -481,8 +481,11 @@ poetry config solver.min-release-age-exclude "my-package,other-package" *Introduced in 2.4.0* -A comma-separated list of source names or URLs that should be excluded from the -[`solver.min-release-age`](#solvermin-release-age) filter. +A list of source names or URLs that should be excluded from the +[`solver.min-release-age`](#solvermin-release-age) filter. When setting the +value with `poetry config` or the environment variable, provide a +comma-separated list. When setting it directly in `poetry.toml`, use a TOML +array. All packages from these sources will always be considered by the solver, regardless of their upload age. Sources can be referenced by the name defined in `pyproject.toml` or by URL. @@ -491,6 +494,11 @@ Sources can be referenced by the name defined in `pyproject.toml` or by URL. poetry config solver.min-release-age-exclude-source "private-repo,https://example.com/simple/" ``` +```toml title="poetry.toml" +[solver] +min-release-age-exclude-source = ["private-repo", "https://example.com/simple/"] +``` + ### `system-git-client` **Type**: `boolean` From 14f7173cf8dc0bd353940fc1fee11429c3130490 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Randy=20D=C3=B6ring?= <30527984+radoering@users.noreply.github.com> Date: Sun, 27 Sep 2026 07:43:12 +0200 Subject: [PATCH 2/3] also clarify min-release-age-exclude --- docs/configuration.md | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/docs/configuration.md b/docs/configuration.md index 2fbae535c47..b04362923d7 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -454,7 +454,7 @@ that release is not filtered out by this setting. ### `solver.min-release-age-exclude` -**Type**: `string` +**Type**: `array` **Default**: *not set* @@ -462,8 +462,12 @@ that release is not filtered out by this setting. *Introduced in 2.4.0* -A comma-separated list of package names that should be excluded from the +A list of package names that should be excluded from the [`solver.min-release-age`](#solvermin-release-age) filter. +When setting the value with `poetry config` or the environment variable, +provide a comma-separated list. When setting it directly in `poetry.toml`, +use a TOML array. + Versions of these packages will always be considered by the solver, regardless of their upload age. @@ -482,10 +486,11 @@ poetry config solver.min-release-age-exclude "my-package,other-package" *Introduced in 2.4.0* A list of source names or URLs that should be excluded from the -[`solver.min-release-age`](#solvermin-release-age) filter. When setting the -value with `poetry config` or the environment variable, provide a -comma-separated list. When setting it directly in `poetry.toml`, use a TOML -array. +[`solver.min-release-age`](#solvermin-release-age) filter. +When setting the value with `poetry config` or the environment variable, +provide a comma-separated list. When setting it directly in `poetry.toml`, +use a TOML array. + All packages from these sources will always be considered by the solver, regardless of their upload age. Sources can be referenced by the name defined in `pyproject.toml` or by URL. From d0ad6f5c6bcc6164527590c60be565f890ad0f62 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Randy=20D=C3=B6ring?= <30527984+radoering@users.noreply.github.com> Date: Sun, 27 Sep 2026 07:45:43 +0200 Subject: [PATCH 3/3] add example --- docs/configuration.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/configuration.md b/docs/configuration.md index b04362923d7..3d1a31bc576 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -475,6 +475,11 @@ regardless of their upload age. poetry config solver.min-release-age-exclude "my-package,other-package" ``` +```toml title="poetry.toml" +[solver] +min-release-age-exclude = ["my-package", "other-package"] +``` + ### `solver.min-release-age-exclude-source` **Type**: `array`