shrinkwraptool 2026.9.0__tar.gz

shrinkwraptool-2026.9.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: shrinkwraptool
+Version: 2026.9.0
+Summary: Shrinkwrap is a tool to simplify the process of building and running firmware on Arm Fixed Virtual Platforms (FVP).
+Author-email: Ryan Roberts <ryan.roberts@arm.com>, Saul Romero D <saul.romerodominguez@arm.com>
+License-Expression: MIT
+Project-URL: Homepage, https://gitlab.arm.com/tooling/shrinkwrap
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9.0
+Description-Content-Type: text/markdown
+License-File: license.rst
+Requires-Dist: PyYAML>=6.0.3
+Requires-Dist: tuxmake>=1.34.0
+Requires-Dist: termcolor<3.0,>=2.4.0; python_version < "3.10"
+Requires-Dist: termcolor>=3.2.0; python_version >= "3.10"
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff==0.15.21; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: Sphinx<10,>=8.2; extra == "docs"
+Requires-Dist: sphinx-rtd-theme<4,>=3.1.0; extra == "docs"
+Requires-Dist: sphinx-copybutton>=0.5.2; extra == "docs"
+Dynamic: license-file
+
+# Shrinkwrap
+
+Shrinkwrap is a tool to simplify the process of building and running firmware on
+Arm Fixed Virtual Platforms (FVP). Users simply invoke the tool to build the
+required config, then pass their own kernel and rootfs to the tool to boot the
+full system on FVP.
+
+- Documentation is available at: [ReadTheDocs](https://shrinkwrap.docs.arm.com)
+- Source Code is available at: [GitLab](https://gitlab.arm.com/tooling/shrinkwrap)
+- Shrinkwrap Container Images are available at: [DockerHub](https://hub.docker.com/u/shrinkwraptool)
+
+The documentation (linked above) contains a
+[QuickStart](https://shrinkwrap.docs.arm.com/en/latest/userguide/quickstart.html)
+section, which details how to install and use the tool. However, if you are in a
+hurry, here are the minimal steps:
+
+> **NOTE:** This assumes you have Python >=3.9.0 and docker installed. If this
+> is not the case, please refer to the documentation.
+
+```
+  sudo apt-get install git netcat-openbsd python3 python3-pip telnet
+  python3 -m venv .venv
+  source .venv/bin/activate
+  pip install --upgrade pip
+  pip install shrinkwraptool
+```
+
+```
+  shrinkwrap --help
+```

shrinkwraptool-2026.9.0/README.md

@@ -0,0 +1,30 @@
+# Shrinkwrap
+
+Shrinkwrap is a tool to simplify the process of building and running firmware on
+Arm Fixed Virtual Platforms (FVP). Users simply invoke the tool to build the
+required config, then pass their own kernel and rootfs to the tool to boot the
+full system on FVP.
+
+- Documentation is available at: [ReadTheDocs](https://shrinkwrap.docs.arm.com)
+- Source Code is available at: [GitLab](https://gitlab.arm.com/tooling/shrinkwrap)
+- Shrinkwrap Container Images are available at: [DockerHub](https://hub.docker.com/u/shrinkwraptool)
+
+The documentation (linked above) contains a
+[QuickStart](https://shrinkwrap.docs.arm.com/en/latest/userguide/quickstart.html)
+section, which details how to install and use the tool. However, if you are in a
+hurry, here are the minimal steps:
+
+> **NOTE:** This assumes you have Python >=3.9.0 and docker installed. If this
+> is not the case, please refer to the documentation.
+
+```
+  sudo apt-get install git netcat-openbsd python3 python3-pip telnet
+  python3 -m venv .venv
+  source .venv/bin/activate
+  pip install --upgrade pip
+  pip install shrinkwraptool
+```
+
+```
+  shrinkwrap --help
+```

shrinkwraptool-2026.9.0/license.rst

@@ -0,0 +1,41 @@
+#######
+License
+#######
+
+The software is provided under the MIT license (below).
+
+.. code-block:: none
+
+    Copyright (c) 2022 Arm Limited
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to
+    deal in the Software without restriction, including without limitation the
+    rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+    sell copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice (including the next
+    paragraph) shall be included in all copies or substantial portions of the
+    Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+    IN THE SOFTWARE.
+
+****************
+SPDX Identifiers
+****************
+
+Individual files contain the following tag instead of the full license text.
+
+.. code-block:: none
+
+    SPDX-License-Identifier: MIT
+
+This enables machine processing of license information based on the SPDX
+License Identifiers that are here available: http://spdx.org/licenses/

shrinkwraptool-2026.9.0/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["setuptools >= 77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "shrinkwraptool"
+dynamic = ["version"]
+authors = [
+  { name="Ryan Roberts", email="ryan.roberts@arm.com" },
+  { name="Saul Romero D", email="saul.romerodominguez@arm.com" }
+]
+
+description = "Shrinkwrap is a tool to simplify the process of building and running firmware on Arm Fixed Virtual Platforms (FVP)."
+readme = "README.md"
+requires-python = ">=3.9.0"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "MIT"
+license-files = ["license*"]
+
+dependencies = [
+  "PyYAML>=6.0.3",
+  "tuxmake>=1.34.0",
+  # termcolor 3.x requires Python >= 3.10
+  "termcolor>=2.4.0,<3.0; python_version < '3.10'",
+  "termcolor>=3.2.0; python_version >= '3.10'",
+]
+
+[project.optional-dependencies]
+dev = [
+  "build",
+  "twine",
+  "pytest",
+  "ruff==0.15.21",
+]
+
+docs = [
+  "Sphinx>=8.2,<10",
+  "sphinx-rtd-theme>=3.1.0,<4",
+  "sphinx-copybutton>=0.5.2",
+]
+
+[project.urls]
+Homepage = "https://gitlab.arm.com/tooling/shrinkwrap"
+
+[project.scripts]
+shrinkwrap = "shrinkwrap.shrinkwrap_main:cli"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.package-data]
+shrinkwrap = [
+  "config/**/*.yaml",
+  "config/**/*.config",
+]
+
+[tool.setuptools.dynamic]
+version = { attr = "shrinkwrap.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["src"]

shrinkwraptool-2026.9.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

shrinkwraptool-2026.9.0/src/shrinkwrap/__init__.py

@@ -0,0 +1 @@
+__version__ = "2026.9.0"

shrinkwraptool-2026.9.0/src/shrinkwrap/__main__.py

@@ -0,0 +1,4 @@
+from .shrinkwrap_main import main
+
+if __name__ == "__main__":
+    main()

shrinkwraptool-2026.9.0/src/shrinkwrap/commands/build.py

@@ -0,0 +1,118 @@
+# Copyright (c) 2022, Arm Limited.
+# SPDX-License-Identifier: MIT
+
+import os
+import shrinkwrap.commands.buildall as buildall
+import shrinkwrap.utils.vars as vars
+
+
+cmd_name = os.path.splitext(os.path.basename(__file__))[0]
+
+
+def add_parser(parser, formatter):
+    """
+    Part of the command interface expected by shrinkwrap.py. Adds the
+    subcommand to the parser, along with all options and documentation.
+    Returns the subcommand name.
+    """
+    cmdp = parser.add_parser(
+        cmd_name,
+        formatter_class=formatter,
+        help="""Builds a specified config and packages it ready
+		     to run.""",
+        epilog="""Custom config store(s) can be defined at at
+		     <SHRINKWRAP_CONFIG> as a colon-separated list of
+		     directories. Building is done at <SHRINKWRAP_BUILD> and
+		     output is saved to <SHRINKWRAP_PACKAGE>. The package
+		     includes all FW binaries, a manifest and a build.sh script
+		     containing all the commands that were executed per config.
+		     Any pre-existing config package directory is first deleted.
+		     Shrinkwrap will always search its default config store even
+		     if <SHRINKWRAP_CONFIG> is not defined. <SHRINKWRAP_BUILD>
+		     and <SHRINKWRAP_PACKAGE> default to '~/.shrinkwrap/build'
+		     and '~/.shrinkwrap/package'. The user can override them by
+		     setting the environment variables.""",
+    )
+
+    cmdp.add_argument(
+        "config",
+        metavar="config",
+        help="""Config to build. If the config exists relative to the
+		     current directory that config is used. Else if the config
+		     exists relative to the config store then it is used.""",
+    )
+
+    cmdp.add_argument(
+        "-b",
+        "--btvar",
+        metavar="key=value",
+        required=False,
+        default=[],
+        action="append",
+        help="""Override value for a single build-time variable defined
+		     by the config. Specify option multiple times for multiple
+		     variables. Overrides for variables that have a default
+		     specified by the config are optional.""",
+    )
+
+    cmdp.add_argument(
+        "-s",
+        "--no-sync",
+        metavar="component",
+        required=False,
+        default=[],
+        action="append",
+        help="""Optionally specify any components whose git repos should
+		     not be synced. For all other components, Shrinkwrap ensures
+		     that all repos are clean and checked out at the correct
+		     revision. Option can be specified multiple times.""",
+    )
+
+    cmdp.add_argument(
+        "--no-sync-all",
+        required=False,
+        default=False,
+        action="store_true",
+        help="""Do not sync repos for any component, as if --no-sync was
+		     specified for every component in the config.""",
+    )
+
+    cmdp.add_argument(
+        "--force-sync",
+        metavar="component",
+        required=False,
+        default=[],
+        action="append",
+        help="""Synchronize the repo of the given component even if the local
+		     source directory contains unsaved changes. YOUR CHANGES WILL BE
+		     LOST! In addition, download updates from remote branches.""",
+    )
+
+    cmdp.add_argument(
+        "--force-sync-all",
+        required=False,
+        default=False,
+        action="store_true",
+        help="""Synchronize all components even if the local source directories
+		     contain unsaved changes. YOUR CHANGES WILL BE LOST! In addition,
+		     download all remote branch updates. Note that this will override
+		     any 'sync: false' config option.""",
+    )
+
+    buildall.add_common_args(cmdp)
+
+    return cmd_name
+
+
+def dispatch(args):
+    """
+    Part of the command interface expected by shrinkwrap.py. Called to
+    execute the subcommand, with the arguments the user passed on the
+    command line. The arguments comply with those requested in add_parser().
+    """
+    btvars = vars.parse(args.btvar, type="bt")
+    if args.no_sync_all:
+        args.no_sync = True
+    if args.force_sync_all:
+        args.force_sync = True
+    buildall.build([args.config], [btvars], args.no_sync, args.force_sync, args)

shrinkwraptool-2026.9.0/src/shrinkwrap/commands/buildall.py

@@ -0,0 +1,214 @@
+# Copyright (c) 2022, Arm Limited.
+# SPDX-License-Identifier: MIT
+
+import os
+import yaml
+import shrinkwrap.utils.config as config
+import shrinkwrap.utils.graph as ugraph
+import shrinkwrap.utils.runtime as runtime
+import shrinkwrap.utils.workspace as workspace
+
+
+cmd_name = os.path.splitext(os.path.basename(__file__))[0]
+
+
+def dflt_jobs():
+    return min(os.cpu_count() // 2, 32)
+
+
+def add_parser(parser, formatter):
+    """
+    Part of the command interface expected by shrinkwrap.py. Adds the
+    subcommand to the parser, along with all options and documentation.
+    Returns the subcommand name.
+    """
+    cmdp = parser.add_parser(
+        cmd_name,
+        formatter_class=formatter,
+        help="""Builds either all concrete standard configs or an
+		     explicitly specified set of configs and packages them ready
+		     to run.""",
+        epilog="""Custom config store(s) can be defined at at
+		     <SHRINKWRAP_CONFIG> as a colon-separated list of
+		     directories. Building is done at <SHRINKWRAP_BUILD> and
+		     output is saved to <SHRINKWRAP_PACKAGE>. The package
+		     includes all FW binaries, a manifest and a build.sh script
+		     containing all the commands that were executed per config.
+		     Any pre-existing config package directory is first deleted.
+		     Shrinkwrap will always search its default config store even
+		     if <SHRINKWRAP_CONFIG> is not defined. <SHRINKWRAP_BUILD>
+		     and <SHRINKWRAP_PACKAGE> default to '~/.shrinkwrap/build'
+		     and '~/.shrinkwrap/package'. The user can override them by
+		     setting the environment variables.""",
+    )
+
+    cmdp.add_argument(
+        "configs",
+        metavar="yamlfile",
+        help="""A yaml file containing all the configs to be built. The
+		     top level dictionary contains a 'configs' key, whose value
+		     is a list of dictionaries, each with a 'config' key, whose
+		     value is a config filename.""",
+    )
+
+    add_common_args(cmdp)
+
+    return cmd_name
+
+
+def add_common_args(cmdp):
+    """
+    Common args shared between build and buildmulti.
+    """
+    cmdp.add_argument(
+        "-o",
+        "--overlay",
+        metavar="cfgfile",
+        required=False,
+        default=[],
+        action="append",
+        help="""Optional config file overlay to override run-time and
+		     build-time settings. Only entries within the "build",
+		     "buildex" and "run" sections are used. Applied to all
+		     configs being built. Can be specified multiple times;
+		     left-most overlay is the first overlay applied.""",
+    )
+
+    cmdp.add_argument(
+        "-t",
+        "--tasks",
+        required=False,
+        default=dflt_jobs(),
+        metavar="count",
+        type=int,
+        help="""Maximum number of "high-level" tasks that will be
+		     performed in parallel by Shrinkwrap. Tasks include syncing
+		     git repositories, building components and copying
+		     artifacts. Default={}""".format(dflt_jobs()),
+    )
+
+    cmdp.add_argument(
+        "-j",
+        "--jobs",
+        required=False,
+        default=dflt_jobs(),
+        metavar="count",
+        type=int,
+        help="""Maximum number of low-level jobs that will be
+		     performed in parallel by each component build task.
+		     Default={}""".format(dflt_jobs()),
+    )
+
+    cmdp.add_argument(
+        "-v",
+        "--verbose",
+        required=False,
+        default=False,
+        action="store_true",
+        help="""If specified, the output from all executed commands will
+		     be displayed. It is advisable to set tasks to 1 when
+		     this option is selected.""",
+    )
+
+    cmdp.add_argument(
+        "-n",
+        "--dry-run",
+        required=False,
+        default=False,
+        action="store_true",
+        help="""If specified, <SHRINKWRAP_BUILD> and
+		     <SHRINKWRAP_PACKAGE> will not be touched and none of the
+		     build commands will be executed. Instead the set of
+		     commands that would have been executed are output to stdout
+		     as a bash script.""",
+    )
+
+    cmdp.add_argument(
+        "-c",
+        "--no-color",
+        required=False,
+        default=False,
+        action="store_true",
+        help="""If specified, logs will not be colorized.""",
+    )
+
+
+def dispatch(args):
+    """
+    Part of the command interface expected by shrinkwrap.py. Called to
+    execute the subcommand, with the arguments the user passed on the
+    command line. The arguments comply with those requested in add_parser().
+    """
+    with open(args.configs) as file:
+        cfgs = yaml.safe_load(file)
+
+    configs = [c["config"] for c in cfgs["configs"]]
+    btvarss = [c["btvars"] for c in cfgs["configs"]]
+    build(configs, btvarss, [], [], args)
+
+
+def build(configs, btvarss, nosync, force_sync, args):
+    """
+    Concurrently builds a list of configs. Intended to be called as a common
+    handler for the build and buildmulti commands.
+    """
+    clivars = {"jobs": args.jobs}
+    configs = config.load_resolveb_all(configs, args.overlay, clivars, btvarss)
+    graph = config.build_graph(configs, args.verbose, nosync, force_sync)
+
+    if args.dry_run:
+        script = ugraph.make_script(graph)
+        print(script)
+    else:
+        if args.verbose:
+            workspace.dump()
+
+        # Run under a runtime environment, which may just run commands
+        # natively on the host or may execute commands in a container,
+        # depending on what the user specified.
+        with runtime.Runtime(
+            name=args.runtime,
+            image=config.get_image(configs, args),
+            ssh_agent_keys=args.ssh_agent_keys,
+        ) as rt:
+
+            def add_volume(path, levels_up=0):
+                while levels_up:
+                    path = os.path.dirname(path)
+                    levels_up -= 1
+                os.makedirs(path, exist_ok=True)
+                rt.add_volume(path)
+
+            add_volume(workspace.build)
+            add_volume(workspace.package)
+            for c in workspace.configs():
+                add_volume(c)
+
+            for conf in configs:
+                for comp in conf["build"].values():
+                    add_volume(comp["sourcedir"], 1)
+                    add_volume(comp["builddir"])
+
+                for btvar in conf["buildex"]["btvars"].values():
+                    if btvar["type"] == "path":
+                        rt.add_volume(btvar["value"])
+
+            if workspace.project_cache:
+                add_volume(workspace.project_cache)
+
+            rt.start()
+
+            ugraph.execute(graph, args.tasks, args.verbose, not args.no_color)
+
+        for c in configs:
+            # Dump the config.
+            cfg_name = os.path.join(workspace.package, f"{c['name']}.yaml")
+            with open(cfg_name, "w") as cfg:
+                config.dump(c, cfg)
+
+            # Dump the script to build the config.
+            graph = config.build_graph([c], args.verbose, nosync, force_sync)
+            script = ugraph.make_script(graph)
+            build_name = os.path.join(workspace.package, c["name"], "build.sh")
+            with open(build_name, "w") as build:
+                build.write(script)