new build-order-prepare subcommand

conan/cli/commands/graph.py

@@ -4,13 +4,15 @@
 from conan.api.output import ConanOutput, cli_out_write, Color
 from conan.cli import make_abs_path
 from conan.cli.args import common_graph_args, validate_common_graph_args
-from conan.cli.command import conan_command, conan_subcommand
+from conan.cli.command import conan_command, conan_subcommand, OnceArgument
 from conan.cli.formatters.graph import format_graph_html, format_graph_json, format_graph_dot
 from conan.cli.formatters.graph.graph_info_text import format_graph_info
 from conan.cli.printers.graph import print_graph_packages, print_graph_basic
 from conan.internal.deploy import do_deploys
 from conans.client.graph.install_graph import InstallGraph
 from conan.errors import ConanException
+from conans.model.graph_lock import Lockfile
+from conans.model.recipe_ref import RecipeReference
 
 
 @conan_command(group="Consumer")
@@ -83,6 +85,37 @@ def graph_build_order(conan_api, parser, subparser, *args):
     return install_order_serialized
 
 
+@conan_subcommand(formatters={"text": cli_out_write})
+def graph_build_order_prepare(conan_api, parser, subparser, *args):
+    """
+    Compute the build order of a dependency graph.
+    """
+    subparser.add_argument("build_order_file", help="build-order json file")
+    subparser.add_argument("ref", help="recipe to build")
+    subparser.add_argument("package_id", help="package to build")
+    subparser.add_argument("-l", "--lockfile", action=OnceArgument,
+                           help="Path to a lockfile")
+    args = parser.parse_args(*args)
+
+    f = make_abs_path(args.build_order_file)
+    install_graph = InstallGraph.load(f)
+    ref = RecipeReference.loads(args.ref)
+    pkg = install_graph.find_build(ref, args.package_id)
+    context = pkg["context"]
+    cmd = f"--require={ref}" if context == "host" else f"--tool-require={ref}"
+    cmd += f" --build={ref}"
+    options = pkg["options"]
+    if options:
+        cmd += " " + " ".join(f"-o {o}" for o in options)
+
+    if args.lockfile:
+        lockfile_path = make_abs_path(args.lockfile)
+        graph_lock = Lockfile.load(lockfile_path)
+        # TODO: Replace here the overrides and save a new lockfile
+        cmd += f" --lockfile={args.lockfile}"
+    return cmd
+
+
 @conan_subcommand(formatters={"text": cli_build_order, "json": json_build_order})
 def graph_build_order_merge(conan_api, parser, subparser, *args):
     """

conans/client/graph/install_graph.py

@@ -169,6 +169,15 @@ def __init__(self, deps_graph=None):
         if deps_graph is not None:
             self._initialize_deps_graph(deps_graph)
 
+    def find_build(self, ref, package_id):
+        install_node = self._nodes.get(ref)
+        if install_node is None:
+            raise ConanException(f"Cannot find {ref} in build-order file")
+        packages = install_node.packages.get(package_id)
+        if packages is None:
+            raise ConanException(f"Cannot find {ref} - {package_id} in build-order file")
+        return packages.serialize()
+
     @staticmethod
     def load(filename):
         data = json.loads(load(filename))

conans/test/integration/lockfile/test_ci.py

@@ -346,9 +346,10 @@ def test_single_config_decentralized(client_setup):
                 package_id = package["package_id"]
                 if binary != "Build":
                     continue
-                # TODO: The options are completely missing
-                c.run("install --requires=%s@ --build=%s@ --lockfile=app1_b_changed.lock  -s os=Windows"
-                      % (ref, ref))
+                c.run(f"graph build-order-prepare build_order.json {repr(ref)} {package_id} "
+                      "--lockfile=app1_b_changed.lock")
+                cmd = c.stdout
+                c.run(f"install {cmd} -s os=Windows")
                 c.assert_listed_binary(
                     {str(ref): (package_id, "Build"),
                      "pkgawin/0.1": (pkgawin_01_id, "Cache"),