[Buildroot] [git commit] support/scripts: generate a list of virtual packages
Thomas Petazzoni
thomas.petazzoni at free-electrons.com
Sun Jun 8 15:11:05 UTC 2014
commit: http://git.buildroot.net/buildroot/commit/?id=4d922634da3464bc7e98f992469df708433d30a6
branch: http://git.buildroot.net/buildroot/commit/?id=refs/heads/master
Generate an asciidoc table that can be included in the manual, that
lists the existing virtual packages, the corresponding symbols, and
their providers (and sub-options thereof).
The core of this change is the addition of a new formatter for virtual
packages. This formatter is a bit tricky, as it has to catter for a
bunch of corner cases:
- provider is not a package, but is sub-options of a package
- such a sub-option may be itself 'select'-ed by one or more
other sub-options
- legacy packages should not be considered as a provider
Those cases are real:
- sub-options of mesa3d provide EGL or GLES
- selected sub-options of mesa3d provide GL
- udev is a legacy package, but it provides udev
Signed-off-by: "Yann E. MORIN" <yann.morin.1998 at free.fr>
Cc: Samuel Martin <s.martin49 at gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni at free-electrons.com>
---
support/scripts/gen-manual-lists.py | 84 ++++++++++++++++++++++++++++++++++-
1 files changed, 83 insertions(+), 1 deletions(-)
diff --git a/support/scripts/gen-manual-lists.py b/support/scripts/gen-manual-lists.py
index 74d115d..69f4c7e 100644
--- a/support/scripts/gen-manual-lists.py
+++ b/support/scripts/gen-manual-lists.py
@@ -173,6 +173,13 @@ class Buildroot:
'format': "_format_symbol_prompt",
'sorted': True,
},
+ 'virtual-packages': {
+ 'filename': "virtual-package-list",
+ 'root_menu': "Target packages",
+ 'filter': "_is_virtual_package",
+ 'format': "_format_symbol_virtual",
+ 'sorted': True,
+ },
'deprecated': {
'filename': "deprecated-list",
'root_menu': None,
@@ -231,6 +238,8 @@ class Buildroot:
return False
if type == 'real' and not symbol.prompts:
return False
+ if type == 'virtual' and symbol.prompts:
+ return False
if not self.re_pkg_prefix.match(symbol.get_name()):
return False
pkg_name = self._get_pkg_name(symbol)
@@ -265,11 +274,17 @@ class Buildroot:
if type == 'real':
if pattern.match(pkg) and not self._exists_virt_symbol(pkg):
return True
+ if type == 'virtual':
+ if pattern.match('has_' + pkg):
+ return True
return False
def _is_real_package(self, symbol):
return self._is_package(symbol, 'real')
+ def _is_virtual_package(self, symbol):
+ return self._is_package(symbol, 'virtual')
+
def _exists_virt_symbol(self, pkg_name):
""" Return True if a symbol exists that defines the package as
a virtual package, False otherwise
@@ -346,6 +361,71 @@ class Buildroot:
message += "Allowed values are: 'layout', 'header' and 'symbol'"
raise Exception(message)
+ def _format_symbol_virtual(self, what=None, symbol=None, root=None,
+ enable_choice=False, header=None,
+ get_label_func=lambda x: "?"):
+ def _symbol_is_legacy(symbol):
+ selects = [ s.get_name() for s in symbol.get_selected_symbols() ]
+ return ("BR2_LEGACY" in selects)
+
+ def _get_parent_package(sym):
+ if self._is_real_package(sym):
+ return None
+ # Trim the symbol name from its last component (separated with
+ # underscores), until we either find a symbol which is a real
+ # package, or until we have no component (i.e. just 'BR2')
+ name = sym.get_name()
+ while name != "BR2":
+ name = name.rsplit("_", 1)[0]
+ s = self.config.get_symbol(name)
+ if s is None:
+ continue
+ if self._is_real_package(s):
+ return s
+ return None
+
+ def _get_providers(config, symbol):
+ providers = list()
+ for sym in self.config:
+ if not sym.is_symbol():
+ continue
+ selects = sym.get_selected_symbols()
+ if not selects:
+ continue
+ for s in selects:
+ if s == symbol:
+ if _symbol_is_legacy(sym):
+ continue
+ if sym.prompts:
+ l = self._get_symbol_label(sym,False)
+ parent_pkg = _get_parent_package(sym)
+ if parent_pkg is not None:
+ l = self._get_symbol_label(parent_pkg, False) \
+ + " (w/ " + l + ")"
+ providers.append(l)
+ else:
+ providers.extend(_get_providers(config,sym))
+ return providers
+
+ if what == "layout":
+ return ( "100%", "^1,4,4" )
+
+ if what == "header":
+ return "| {0:<20} <| {1:<32} <| Providers\n".format("Virtual packages", "Symbols")
+
+ if what == "symbol":
+ pkg = re.sub(r"^BR2_PACKAGE_HAS_(.+)$", r"\1", symbol.get_name())
+ providers = _get_providers(self.config, symbol)
+
+ return "| {0:<20} <| {1:<32} <| {2}\n".format(pkg.lower(),
+ '+' + symbol.get_name() + '+',
+ ", ".join(providers))
+
+ message = "Invalid argument 'what': '%s'\n" % str(what)
+ message += "Allowed values are: 'layout', 'header' and 'symbol'"
+ raise Exception(message)
+
+
def print_list(self, list_type, enable_choice=True, enable_deprecated=True,
dry_run=False, output=None):
""" Print the requested list. If not dry run, then the list is
@@ -414,7 +494,7 @@ class Buildroot:
if __name__ == '__main__':
- list_types = ['target-packages', 'host-packages', 'deprecated']
+ list_types = ['target-packages', 'host-packages', 'virtual-packages', 'deprecated']
parser = ArgumentParser()
parser.add_argument("list_type", nargs="?", choices=list_types,
help="""\
@@ -425,6 +505,8 @@ Generate the given list (generate all lists if unspecified)""")
help="Output target package file")
parser.add_argument("--output-host", dest="output_host",
help="Output host package file")
+ parser.add_argument("--output-virtual", dest="output_virtual",
+ help="Output virtual package file")
parser.add_argument("--output-deprecated", dest="output_deprecated",
help="Output deprecated file")
args = parser.parse_args()
More information about the buildroot
mailing list