feature: add a build-sequence command

.github/workflows/test.yaml

@@ -63,6 +63,7 @@ jobs:
         test-script:
           - bootstrap
           - build
+          - build_order
           - build_steps
           - override
           - report_missing_dependency

.mergify.yml

@@ -42,6 +42,10 @@ pull_request_rules:
           - check-success=e2e (3.11, 1.75, build)
           - check-success=e2e (3.12, 1.75, build)
 
+          - check-success=e2e (3.10, 1.75, build_order)
+          - check-success=e2e (3.11, 1.75, build_order)
+          - check-success=e2e (3.12, 1.75, build_order)
+
           - check-success=e2e (3.10, 1.75, build_steps)
           - check-success=e2e (3.11, 1.75, build_steps)
           - check-success=e2e (3.12, 1.75, build_steps)

e2e/test_build_order.sh

@@ -0,0 +1,92 @@
+#!/bin/bash
+# -*- indent-tabs-mode: nil; tab-width: 2; sh-indentation: 2; -*-
+
+# Test to show that we get a detailed error message if a dependency is
+# not available when setting up to build a package.
+
+SCRIPTDIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+set -x
+set -e
+set -o pipefail
+
+on_exit() {
+  [ "$HTTP_SERVER_PID" ] && kill "$HTTP_SERVER_PID"
+}
+trap on_exit EXIT SIGINT SIGTERM
+
+# Bootstrap to create the build order file.
+OUTDIR="$(dirname "$SCRIPTDIR")/e2e-output"
+
+# What are we building?
+DIST="stevedore"
+VERSION="5.2.0"
+
+# Recreate output directory
+rm -rf "$OUTDIR"
+mkdir -p "$OUTDIR/build-logs"
+
+# Set up virtualenv with the CLI and dependencies.
+tox -e e2e -n -r
+source ".tox/e2e/bin/activate"
+
+# Bootstrap the test project
+fromager \
+    --sdists-repo="$OUTDIR/sdists-repo" \
+    --wheels-repo="$OUTDIR/wheels-repo" \
+    --work-dir="$OUTDIR/work-dir" \
+    bootstrap "${DIST}==${VERSION}"
+
+# Save the build order file but remove everything else.
+cp "$OUTDIR/work-dir/build-order.json" "$OUTDIR/"
+rm -r "$OUTDIR/work-dir" "$OUTDIR/sdists-repo" "$OUTDIR/wheels-repo"
+
+# Rebuild the wheel mirror to be empty
+pypi-mirror create -d "$OUTDIR/wheels-repo/downloads/" -m "$OUTDIR/wheels-repo/simple/"
+
+# Start a web server for the wheels-repo. We remember the PID so we
+# can stop it later, and we determine the primary IP of the host
+# because podman won't see the server via localhost.
+python3 -m http.server --directory "$OUTDIR/wheels-repo/" 9999 &
+HTTP_SERVER_PID=$!
+IP=$(ip route get 1.1.1.1 | grep 1.1.1.1 | awk '{print $7}')
+export WHEEL_SERVER_URL="http://${IP}:9999/simple"
+
+# Rebuild everything
+fromager \
+    --log-file "$OUTDIR/build-logs/${dist}-build.log" \
+    --work-dir "$OUTDIR/work-dir" \
+    --sdists-repo "$OUTDIR/sdists-repo" \
+    --wheels-repo "$OUTDIR/wheels-repo" \
+    build-sequence "$OUTDIR/build-order.json" "https://pypi.org/simple"
+
+find "$OUTDIR/wheels-repo/"
+
+EXPECTED_FILES="
+wheels-repo/downloads/flit_core-3.9.0-py3-none-any.whl
+wheels-repo/downloads/wheel-0.43.0-py3-none-any.whl
+wheels-repo/downloads/setuptools-70.0.0-py3-none-any.whl
+wheels-repo/downloads/pbr-6.0.0-py2.py3-none-any.whl
+wheels-repo/downloads/stevedore-5.2.0-py3-none-any.whl
+
+sdists-repo/downloads/stevedore-5.2.0.tar.gz
+sdists-repo/downloads/setuptools-70.0.0.tar.gz
+sdists-repo/downloads/wheel-0.43.0.tar.gz
+sdists-repo/downloads/flit_core-3.9.0.tar.gz
+sdists-repo/downloads/pbr-6.0.0.tar.gz
+
+work-dir/flit_core-3.9.0/build.log
+work-dir/pbr-6.0.0/build.log
+work-dir/setuptools-70.0.0/build.log
+work-dir/stevedore-5.2.0/build.log
+work-dir/wheel-0.43.0/build.log
+"
+
+pass=true
+for f in $EXPECTED_FILES; do
+  if [ ! -f "$OUTDIR/$f" ]; then
+    echo "FAIL: Did not find $OUTDIR/$f" 1>&2
+    pass=false
+  fi
+done
+$pass

src/fromager/commands/__init__.py

@@ -3,6 +3,7 @@
 commands = [
     bootstrap.bootstrap,
     build.build,
+    build.build_sequence,
     build_order.build_order,
     step.step,
     canonicalize.canonicalize,

src/fromager/commands/build.py

@@ -1,3 +1,4 @@
+import json
 import logging
 
 import click
@@ -35,6 +36,36 @@ def build(wkctx, dist_name, dist_version, sdist_server_url):
     separately.
 
     """
+    wheel_filename = _build(wkctx, dist_name, dist_version, sdist_server_url)
+    print(wheel_filename)
+
+
+@click.command()
+@click.argument('build_order_file')
+@click.argument('sdist_server_url')
+@click.pass_obj
+def build_sequence(wkctx, build_order_file, sdist_server_url):
+    """Build a sequence of wheels in order
+
+    BUILD_ORDER_FILE is the build-order.json files to build
+
+    SDIST_SERVER_URL is the URL for a PyPI-compatible package index hosting sdists
+
+    Performs the equivalent of the 'build' command for each item in
+    the build order file.
+
+    """
+    with open(build_order_file, 'r') as f:
+        for entry in json.load(f):
+            wheel_filename = _build(wkctx, entry['dist'], entry['version'], sdist_server_url)
+            server.update_wheel_mirror(wkctx)
+            # After we update the wheel mirror, the built file has
+            # moved to a new directory.
+            wheel_filename = wkctx.wheels_downloads / wheel_filename.name
+            print(wheel_filename)
+
+
+def _build(wkctx, dist_name, dist_version, sdist_server_url):
     server.start_wheel_server(wkctx)
 
     req = Requirement(f'{dist_name}=={dist_version}')
@@ -58,5 +89,4 @@ def build(wkctx, dist_name, dist_version, sdist_server_url):
     logger.info('building for %s', req)
     build_env = wheels.BuildEnvironment(wkctx, source_root_dir.parent, None)
     wheel_filename = wheels.build_wheel(wkctx, req, source_root_dir, build_env)
-
-    print(wheel_filename)
+    return wheel_filename