shrinkwrap-tool 2026.2.1__tar.gz

shrinkwrap_tool-2026.2.1/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: shrinkwrap-tool
+Version: 2026.2.1
+Summary: Shrinkwrap tool for building and running Arm FVPs
+Author-email: Ryan Roberts <ryan.roberts@arm.com>, Saul Romero D <saul.romerodominguez@arm.com>
+License-Expression: MIT
+Project-URL: Homepage, https://git.gitlab.arm.com/tooling/shrinkwrap
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+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"
+Requires-Dist: graphlib-backport; python_version < "3.9"
+Provides-Extra: dev
+Requires-Dist: cffi>=2.0.0; extra == "dev"
+Requires-Dist: cryptography>=46.0.3; extra == "dev"
+Requires-Dist: cmake>=3.31.6; extra == "dev"
+Requires-Dist: pycparser>=2.23; extra == "dev"
+Requires-Dist: fdt>=0.3.3; extra == "dev"
+Requires-Dist: pyelftools>=0.32; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; 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
+  python -m pip install --upgrade pip
+  python -m pip install shrinkwrap
+```
+
+```
+  shrinkwrap --help
+```

shrinkwrap_tool-2026.2.1/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
+  python -m pip install --upgrade pip
+  python -m pip install shrinkwrap
+```
+
+```
+  shrinkwrap --help
+```

shrinkwrap_tool-2026.2.1/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/

shrinkwrap_tool-2026.2.1/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["setuptools >= 77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "shrinkwrap-tool"
+version = "2026.02.1"
+authors = [
+  { name="Ryan Roberts", email="ryan.roberts@arm.com" },
+  { name="Saul Romero D", email="saul.romerodominguez@arm.com" }
+]
+
+description = "Shrinkwrap tool for building and running Arm FVPs"
+readme = "README.md"
+requires-python = ">=3.8"
+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'",
+  "graphlib-backport; python_version < '3.9'",
+]
+
+[project.optional-dependencies]
+dev = [
+  "cffi>=2.0.0",
+  "cryptography>=46.0.3",
+  "cmake>=3.31.6",
+  "pycparser>=2.23",
+  "fdt>=0.3.3",
+  "pyelftools>=0.32",
+  "build",
+  "twine",
+  "pytest",
+]
+
+docs = [
+  "Sphinx>=8.2,<10",
+  "sphinx-rtd-theme>=3.1.0,<4",
+  "sphinx-copybutton>=0.5.2",
+]
+
+[project.urls]
+Homepage = "https://git.gitlab.arm.com/tooling/shrinkwrap"
+
+[project.scripts]
+shrinkwrap = "shrinkwrap.shrinkwrap_main:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.package-data]
+shrinkwrap = ["config/**/*.yaml"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

shrinkwrap_tool-2026.2.1/setup.cfg

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

shrinkwrap_tool-2026.2.1/src/shrinkwrap/__init__.py

@@ -0,0 +1 @@
+__version__ = "2026.3.0.dev0"

shrinkwrap_tool-2026.2.1/src/shrinkwrap/__main__.py

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

shrinkwrap_tool-2026.2.1/src/shrinkwrap/commands/build.py

@@ -0,0 +1,91 @@
+# 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)

shrinkwrap_tool-2026.2.1/src/shrinkwrap/commands/buildall.py

@@ -0,0 +1,180 @@
+# 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)

shrinkwrap_tool-2026.2.1/src/shrinkwrap/commands/clean.py

@@ -0,0 +1,161 @@
+# Copyright (c) 2022, Arm Limited.
+# SPDX-License-Identifier: MIT
+
+import os
+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="""Cleans either all concrete standard configs or an
+		     explicitly specified set of configs, ready to be rebuilt
+		     from scratch.""")
+
+	cmdp.add_argument('configs',
+		metavar='config', nargs='*',
+		help="""0 or more configs to clean. If a config exists relative
+		     to the current directory that config is used. Else if a
+		     config exists relative to the config store then it is used.
+		     If no configs are provided, all concrete configs in the
+		     config store are cleaned.""")
+
+	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 cleaning
+		     components. 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 clean 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, none of the clean 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.""")
+
+	cmdp.add_argument('-f', '--filter',
+		metavar='[config.]component', required=False, default=[],
+		action='append',
+		help="""Optionally specify the components to clean. Option can
+		     be specified multiple times to clean multiple components.
+		     If not specified, all components are cleaned. If 'config.'
+		     is omitted, component is cleaned for all configs being
+		     cleaned (component must exist in all configs being
+		     cleaned).""")
+
+	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().
+	"""
+	clivars = {'jobs': args.jobs}
+	configs = config.load_resolveb_all(args.configs, args.overlay, clivars)
+	if len(args.configs) == 0:
+		configs = [c for c in configs if c['concrete']]
+	for conf in configs:
+		conf['graph'] = _filter(conf['name'],
+					conf['graph'],
+					args.filter)
+
+	graph = config.clean_graph(configs, args.verbose)
+
+	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 conf in configs:
+				for comp in conf['build'].values():
+					add_volume(comp['sourcedir'], 1)
+					add_volume(comp['builddir'], 1)
+
+			rt.start()
+
+			ugraph.execute(graph,
+				       args.tasks,
+				       args.verbose,
+				       not args.no_color)
+
+
+def _filter(name, graph, args):
+	components = []
+	pruned = {}
+
+	for arg in args:
+		try:
+			conf, comp = arg.split('.', maxsplit=1)
+			if conf == name:
+				components.append(comp)
+		except ValueError:
+			components.append(arg)
+
+	if len(components) == 0:
+		return graph
+
+	for c in components:
+		if c not in graph:
+			raise Exception(f'Bad filter: {c} not a '
+					f'component of {name}')
+		pruned[c] = []
+
+	return pruned