feat: add 'fromage package resolve' subcommand

The new `package resolve` subcommand is designed to debug Fromager
settings and resolver properties. It compares the results from
Fromager's internal resolver with a simple PyPI lookup. It prints
informations like resolver configuration, detected versions and versions
with sdists and wheels on PyPI.

```console
$ fromager --variant cpu package resolve 'fromager~=0.68.0'
resolving requirement for 'fromager~=0.68.0' (variant: cpu)

Package uses standard settings.
- sdist server url: https://pypi.org/simple
- resolver includes sdists: True
- resolver includes wheels: False
- wheel server url: None
- download url: None
- prebuilt wheel: False
- package is not constrained by '--constraints-file'
Using distribution type: default (sdists: True, wheels: False)

get_resolver_provider returns provider 'PyPIProvider'
found 2 Fromager candidates with 2 unique versions for req: 'fromager~=0.68.0', Fromager constraint: 'None'
- most recent release: 2025-10-21 14:37:12+02:00
- Fromager versions: 0.68.0, 0.68.1

found 2 versions on PyPI for req: 'fromager~=0.68.0', Fromager constraint: 'None'
- most recent PyPI release: 2025-10-21 14:37:12+02:00
- package has purelib wheels (pure Python code)
- PyPI versions: 0.68.0, 0.68.1
```

Signed-off-by: Christian Heimes <cheimes@redhat.com>

Author: tiran

pyproject.toml

@@ -118,6 +118,7 @@ list-overrides = "fromager.commands.list_overrides:list_overrides"
 list-versions = "fromager.commands.list_versions:list_versions"
 migrate-config = "fromager.commands.migrate_config:migrate_config"
 minimize = "fromager.commands.minimize:minimize"
+package = "fromager.commands.package:package"
 stats = "fromager.commands.stats:stats"
 step = "fromager.commands.step:step"
 canonicalize = "fromager.commands.canonicalize:canonicalize"

src/fromager/commands/find_updates.py

@@ -10,8 +10,8 @@
 from packaging.requirements import Requirement
 from packaging.version import Version
 
-from fromager import constraints, context, overrides, resolver
-from fromager.commands.list_versions import DistributionType
+from .. import constraints, context, overrides, resolver
+from . import package
 
 logger = logging.getLogger(__name__)
 
@@ -32,17 +32,8 @@ class OutputFormat(Enum):
     default=OutputFormat.REQUIREMENTS.value,
     help="Output format (requirements: name==version, json: JSON array, csv: CSV with name,version columns)",
 )
-@click.option(
-    "--distribution-type",
-    type=click.Choice(DistributionType, case_sensitive=False),
-    default=DistributionType.DEFAULT.value,
-    help="Distribution type to include in version lookup (default: use package settings, sdist: source only, wheel: wheels only, both: include both sdists and wheels)",
-)
-@click.option(
-    "--sdist-server-url",
-    default=resolver.PYPI_SERVER_URL,
-    help="URL to the Python package index to use for version lookup",
-)
+@package.distribution_type_option
+@package.sdist_server_url_option
 @click.option(
     "-o",
     "--output",
@@ -197,22 +188,9 @@ def _find_newer_versions(
     override_sdist_server_url = pbi.resolver_sdist_server_url(sdist_server_url)
 
     # Determine include flags based on distribution type
-    dist_type = DistributionType(distribution_type)
-    match dist_type:
-        case DistributionType.SDIST:
-            include_sdists = True
-            include_wheels = False
-        case DistributionType.WHEEL:
-            include_sdists = False
-            include_wheels = True
-        case DistributionType.BOTH:
-            include_sdists = True
-            include_wheels = True
-        case _:  # DEFAULT
-            # Use package settings defaults
-            package_settings = wkctx.settings.package_setting(constraint.name)
-            include_sdists = package_settings.resolver_dist.include_sdists
-            include_wheels = package_settings.resolver_dist.include_wheels
+    include_sdists, include_wheels = package.parse_distribution_option(
+        distribution_type, pbi
+    )
 
     # Get resolver provider
     provider = overrides.find_and_invoke(

src/fromager/commands/list_versions.py

@@ -1,29 +1,14 @@
-import logging
-from enum import Enum
-
 import click
-from packaging.requirements import Requirement
-from packaging.version import Version
-
-from fromager import context, overrides, resolver
-
-logger = logging.getLogger(__name__)
-
-
-class DistributionType(Enum):
-    """Distribution type for version lookup"""
 
-    DEFAULT = "default"
-    SDIST = "sdist"
-    WHEEL = "wheel"
-    BOTH = "both"
+from .. import resolver
+from . import package
 
 
-@click.command()
+@click.command(deprecated=True)
 @click.option(
     "--distribution-type",
-    type=click.Choice(DistributionType, case_sensitive=False),
-    default=DistributionType.DEFAULT.value,
+    type=click.Choice(package.DistributionType, case_sensitive=False),
+    default=package.DistributionType.DEFAULT.value,
     help="Distribution type to include in version lookup (default: use package settings, sdist: source only, wheel: wheels only, both: include both sdists and wheels)",
 )
 @click.option(
@@ -42,98 +27,22 @@ class DistributionType(Enum):
     help="Format output as requirement specifiers (name==version) instead of just version numbers",
 )
 @click.argument("requirement_spec", required=True)
-@click.pass_obj
+@click.pass_context
 def list_versions(
-    wkctx: context.WorkContext,
+    ctx: click.Context,
     requirement_spec: str,
     distribution_type: str,
     sdist_server_url: str,
     ignore_no_versions: bool,
     format_as_requirements: bool,
 ) -> None:
-    """List all available versions for a package requirement specifier.
-
-    The REQUIREMENT_SPEC should be a package requirement specification like:
-    - "package_name" (any version)
-    - "package_name>=1.0" (versions >= 1.0)
-    - "package_name==1.*" (versions matching 1.*)
-
-    This command uses the get_resolver_provider hook to retrieve a resolver
-    provider for the package in case there is a custom provider configured.
-
-    Distribution types:
-    - "default": Use package settings for include_sdists/include_wheels
-    - "sdist": Only include source distributions
-    - "wheel": Only include wheels
-    - "both": Include both source distributions and wheels
-    """
-    try:
-        req = Requirement(requirement_spec)
-    except Exception as e:
-        raise click.ClickException(
-            f"Invalid requirement specification '{requirement_spec}': {e}"
-        ) from e
-
-    pbi = wkctx.package_build_info(req)
-    override_sdist_server_url = pbi.resolver_sdist_server_url(sdist_server_url)
-
-    # Determine include flags based on distribution type
-    dist_type = DistributionType(distribution_type)
-    match dist_type:
-        case DistributionType.SDIST:
-            include_sdists = True
-            include_wheels = False
-        case DistributionType.WHEEL:
-            include_sdists = False
-            include_wheels = True
-        case DistributionType.BOTH:
-            include_sdists = True
-            include_wheels = True
-        case _:  # DEFAULT
-            # Use package settings defaults
-            package_settings = wkctx.settings.package_setting(req.name)
-            include_sdists = package_settings.resolver_dist.include_sdists
-            include_wheels = package_settings.resolver_dist.include_wheels
-
-    logger.info(f"Looking up versions for {req.name}")
-    if req.specifier:
-        logger.info(f"Filtering versions with specifier: {req.specifier}")
-    logger.info(
-        f"Using distribution type: {dist_type.value} (sdists: {include_sdists}, wheels: {include_wheels})"
+    """List all available versions for a package requirement specifier."""
+    click.secho("use 'fromager package list-versions'", bold=True)
+    ctx.invoke(
+        package.list_versions,
+        requirement_spec=requirement_spec,
+        distribution_type=distribution_type,
+        sdist_server_url=sdist_server_url,
+        ignore_no_versions=ignore_no_versions,
+        format_as_requirements=format_as_requirements,
     )
-
-    provider = overrides.find_and_invoke(
-        req.name,
-        "get_resolver_provider",
-        resolver.default_resolver_provider,
-        ctx=wkctx,
-        req=req,
-        include_sdists=include_sdists,
-        include_wheels=include_wheels,
-        sdist_server_url=override_sdist_server_url,
-    )
-
-    # Get all available candidates from the provider
-    candidates = list(
-        provider.find_matches(
-            identifier=req.name,
-            requirements={req.name: [req]},
-            incompatibilities={req.name: []},
-        )
-    )
-
-    if not candidates:
-        if ignore_no_versions:
-            logger.warning(f"No versions found for {req.name}")
-            return
-        else:
-            raise click.ClickException(f"No versions found for {req.name}")
-
-    versions: list[Version] = sorted(set(candidate.version for candidate in candidates))
-    logger.info(f"Found {len(versions)} version(s)")
-
-    for version in versions:
-        if format_as_requirements:
-            print(f"{req.name}=={version}")
-        else:
-            print(version)