feat: add a solver.min-release-age-exclude config option

Author: radoering

docs/configuration.md

@@ -423,6 +423,25 @@ If a source does not provide upload times for a release,
 that release is not filtered out by this setting.
 {{% /note %}}
 
+### `solver.min-release-age-exclude`
+
+**Type**: `string`
+
+**Default**: *not set*
+
+**Environment Variable**: `POETRY_SOLVER_MIN_RELEASE_AGE_EXCLUDE`
+
+*Introduced in 2.4.0*
+
+A comma-separated list of package names that should be excluded from the
+[`solver.min-release-age`](#solvermin-release-age) filter.
+Versions of these packages will always be considered by the solver,
+regardless of their upload age.
+
+```bash
+poetry config solver.min-release-age-exclude "my-package,other-package"
+```
+
 ### `system-git-client`
 
 **Type**: `boolean`

src/poetry/config/config.py

@@ -175,6 +175,7 @@ class Config:
         "solver": {
             "lazy-wheel": True,
             "min-release-age": 0,
+            "min-release-age-exclude": None,
         },
         "system-git-client": False,
         "keyring": {
@@ -403,7 +404,11 @@ def _get_normalizer(name: str) -> Callable[[str], Any]:
         }:
             return int_normalizer
 
-        if name in ["installer.no-binary", "installer.only-binary"]:
+        if name in {
+            "installer.no-binary",
+            "installer.only-binary",
+            "solver.min-release-age-exclude",
+        }:
             return PackageFilterPolicy.normalize
 
         if name.startswith("installer.build-config-settings."):

src/poetry/console/commands/config.py

@@ -103,6 +103,10 @@ def unique_config_values(self) -> dict[str, tuple[Any, Any]]:
             ),
             "solver.lazy-wheel": (boolean_validator, boolean_normalizer),
             "solver.min-release-age": (lambda val: int(val) >= 0, int_normalizer),
+            "solver.min-release-age-exclude": (
+                PackageFilterPolicy.validator,
+                PackageFilterPolicy.normalize,
+            ),
             "keyring.enabled": (boolean_validator, boolean_normalizer),
             "python.installation-dir": (str, lambda val: str(Path(val))),
         }

src/poetry/repositories/http_repository.py

@@ -17,6 +17,7 @@
 import requests.adapters
 
 from packaging.metadata import parse_email
+from packaging.utils import canonicalize_name
 from poetry.core.constraints.version import Version
 from poetry.core.constraints.version import VersionConstraint
 from poetry.core.constraints.version import parse_constraint
@@ -81,10 +82,15 @@ def __init__(
 
         self._min_release_age = config.get("solver.min-release-age", 0)
         self._min_release_age_cutoff: datetime | None = None
+        self._min_release_age_exclude: set[NormalizedName] = set()
         if self._min_release_age:
             self._min_release_age_cutoff = datetime.now(tz=timezone.utc) - timedelta(
                 days=self._min_release_age
             )
+            self._min_release_age_exclude = {
+                canonicalize_name(n)
+                for n in (config.get("solver.min-release-age-exclude") or [])
+            }
         self._age_filtered_versions: dict[NormalizedName, set[Version]] = {}
         # We are tracking if a domain supports range requests or not to avoid
         # unnecessary requests.
@@ -173,7 +179,10 @@ def _find_packages(
             if constraint.allows(version)
         ]
 
-        if self._min_release_age_cutoff is not None:
+        if (
+            self._min_release_age_cutoff is not None
+            and name not in self._min_release_age_exclude
+        ):
             filtered_out: set[Version] = set()
             accepted: list[tuple[Version, str | bool]] = []
             for version, yanked in versions:

tests/console/commands/test_config.py

@@ -76,6 +76,7 @@ def test_list_displays_default_value_if_not_set(
 requests.max-retries = 0
 solver.lazy-wheel = true
 solver.min-release-age = 0
+solver.min-release-age-exclude = null
 system-git-client = false
 virtualenvs.create = true
 virtualenvs.in-project = null
@@ -112,6 +113,7 @@ def test_list_displays_set_get_setting(
 requests.max-retries = 0
 solver.lazy-wheel = true
 solver.min-release-age = 0
+solver.min-release-age-exclude = null
 system-git-client = false
 virtualenvs.create = false
 virtualenvs.in-project = null
@@ -169,6 +171,7 @@ def test_unset_setting(
 requests.max-retries = 0
 solver.lazy-wheel = true
 solver.min-release-age = 0
+solver.min-release-age-exclude = null
 system-git-client = false
 virtualenvs.create = true
 virtualenvs.in-project = null
@@ -204,6 +207,7 @@ def test_unset_repo_setting(
 requests.max-retries = 0
 solver.lazy-wheel = true
 solver.min-release-age = 0
+solver.min-release-age-exclude = null
 system-git-client = false
 virtualenvs.create = true
 virtualenvs.in-project = null
@@ -340,6 +344,7 @@ def test_list_displays_set_get_local_setting(
 requests.max-retries = 0
 solver.lazy-wheel = true
 solver.min-release-age = 0
+solver.min-release-age-exclude = null
 system-git-client = false
 virtualenvs.create = false
 virtualenvs.in-project = null
@@ -385,6 +390,7 @@ def test_list_must_not_display_sources_from_pyproject_toml(
 requests.max-retries = 0
 solver.lazy-wheel = true
 solver.min-release-age = 0
+solver.min-release-age-exclude = null
 system-git-client = false
 virtualenvs.create = true
 virtualenvs.in-project = null
@@ -624,6 +630,27 @@ def test_config_solver_min_release_age(
     assert repo._min_release_age == 3
 
 
+def test_config_solver_min_release_age_exclude(
+    tester: CommandTester, command_tester_factory: CommandTesterFactory
+) -> None:
+    tester.execute("--local solver.min-release-age-exclude")
+    assert tester.io.fetch_output().strip() == "null"
+
+    repo = LegacyRepository("foo", "https://foo.com")
+    assert repo._min_release_age_exclude == set()
+
+    tester.io.clear_output()
+    tester.execute("--local solver.min-release-age 3")
+    tester.execute("--local solver.min-release-age-exclude 'my-pkg,Other-Pkg'")
+    tester.execute("--local solver.min-release-age-exclude")
+    output = tester.io.fetch_output().strip()
+    assert "my-pkg" in output
+    assert "other-pkg" in output
+
+    repo = LegacyRepository("foo", "https://foo.com")
+    assert repo._min_release_age_exclude == {"my-pkg", "other-pkg"}
+
+
 current_config = """\
 [experimental]
 system-git-client = true

tests/repositories/test_http_repository.py

@@ -69,6 +69,33 @@ def test_min_release_age_and_cutoff_is_set(
         assert repo._min_release_age_cutoff is None
 
 
+def test_min_release_age_exclude_is_set(config: Config) -> None:
+    config.merge(
+        {
+            "solver": {
+                "min-release-age": 1,
+                "min-release-age-exclude": ["My-Package", "other-pkg"],
+            }
+        }
+    )
+    repo = MockRepository(config=config)
+    assert repo._min_release_age_exclude == {"my-package", "other-pkg"}
+
+
+def test_min_release_age_exclude_is_not_set_without_min_release_age(
+    config: Config,
+) -> None:
+    config.merge({"solver": {"min-release-age-exclude": ["My-Package", "other-pkg"]}})
+    repo = MockRepository(config=config)
+    assert repo._min_release_age_exclude == set()
+
+
+def test_min_release_age_exclude_default(config: Config) -> None:
+    config.merge({"solver": {"min-release-age": 1}})
+    repo = MockRepository(config=config)
+    assert repo._min_release_age_exclude == set()
+
+
 @pytest.mark.parametrize(
     ("links", "expected"),
     [

tests/repositories/test_legacy_repository.py

@@ -11,6 +11,7 @@
 import pytest
 import requests
 
+from packaging.utils import NormalizedName
 from packaging.utils import canonicalize_name
 from poetry.core.constraints.version import Version
 from poetry.core.packages.dependency import Dependency
@@ -286,16 +287,23 @@ def test_find_packages_yanked(
     assert [str(p.version) for p in packages] == expected
 
 
-def test_find_packages_min_release_age(legacy_repository: TestLegacyRepository) -> None:
+@pytest.mark.parametrize(
+    "min_release_age_exclude", [set(), {"a", "b"}, {"ipython", "other"}]
+)
+def test_find_packages_min_release_age(
+    legacy_repository: TestLegacyRepository,
+    min_release_age_exclude: set[NormalizedName],
+) -> None:
     """Versions with files uploaded within min-release-age days are filtered."""
     repo = legacy_repository
     # ipython fixture upload times:
     #   4.1.0rc1: 2016-01-26, 5.7.0: 2018-05-10, 7.5.0: 2019-04-25
     repo._min_release_age_cutoff = datetime(2018, 10, 6, tzinfo=timezone.utc)
+    repo._min_release_age_exclude = min_release_age_exclude
     packages = repo.find_packages(Factory.create_dependency("ipython", "*"))
 
     # HTML API does not provide upload time
-    if repo.json:
+    if repo.json and "ipython" not in min_release_age_exclude:
         expected_versions = ["5.7.0"]
         expected_filtered = {"ipython": {Version.parse("7.5.0")}}
     else:

tests/repositories/test_pypi_repository.py

@@ -8,6 +8,7 @@
 
 import pytest
 
+from packaging.utils import NormalizedName
 from packaging.utils import canonicalize_name
 from poetry.core.constraints.version import Version
 from poetry.core.packages.dependency import Dependency
@@ -86,7 +87,12 @@ def test_find_packages_yanked(
     assert [str(p.version) for p in packages] == expected
 
 
-def test_find_packages_min_release_age(pypi_repository: PyPiRepository) -> None:
+@pytest.mark.parametrize(
+    "min_release_age_exclude", [set(), {"a", "b"}, {"requests", "other"}]
+)
+def test_find_packages_min_release_age(
+    pypi_repository: PyPiRepository, min_release_age_exclude: set[NormalizedName]
+) -> None:
     """Versions with files uploaded within min-release-age days are filtered."""
     repo = pypi_repository
     # requests fixture upload times:
@@ -96,17 +102,22 @@ def test_find_packages_min_release_age(pypi_repository: PyPiRepository) -> None:
     # Cutoff = 2017-08-10. Versions with any file uploaded after that are filtered.
     # Note that 2.19.0 is uploaded in the future ;)
     repo._min_release_age_cutoff = datetime(2017, 8, 10, tzinfo=timezone.utc)
+    repo._min_release_age_exclude = min_release_age_exclude
     packages = repo.find_packages(Factory.create_dependency("requests", ">=2.18.0"))
 
-    assert [str(p.version) for p in packages] == [
+    expected_versions = [
         "2.18.0",
         "2.18.1",
         "2.18.2",
         "2.18.3",
     ]
-    assert repo._age_filtered_versions == {
-        "requests": {Version.parse("2.18.4"), Version.parse("2.19.0")}
-    }
+    expected_filtered = {"requests": {Version.parse("2.18.4"), Version.parse("2.19.0")}}
+    if "requests" in min_release_age_exclude:
+        expected_versions += ["2.18.4", "2.19.0"]
+        expected_filtered = {}
+
+    assert [str(p.version) for p in packages] == expected_versions
+    assert repo._age_filtered_versions == expected_filtered
 
 
 def test_package(