From: Joshua Watt <jpewhac...@gmail.com>
Defines a common schema for layer setup that can be consumed by tools to
know how to fetch and assemble layers for end users. Also includes an
example of the layer setup that constructs poky/meta-intel/imaginary product
layer
for reference.
The schema can be used to validate a layer setup file with the commands:
$ python3 -m pip install jsonschema
$ jsonschema -i meta/files/layers.example.json meta/files/layers.schema.json
Signed-off-by: Joshua Watt <jpewhac...@gmail.com>
Alex: I made the following modifications to Joshua's original commit:
- moved the files from meta/lib to meta/files
- the example json showcases a multi-repo, multi-layer setup with additional
configurations and machines, instead of just poky - closer to a typical product
- added oe-selftest that validates the example json against the schema using
python3-jsonschema-native
- the schema is modified so that:
-- all lists (sources, layers, remotes) are replaced by objects keyed by 'name'
properties of the list items.
This allows using them as dicts inside Python, and makes the json more compact
and readable.
-- added 'contains_this_file' property to source object
-- added 'buildconfigs', 'machines' and 'distros' properties to layer objects.
-- replaced 'remote' property with a 'oneOf' definition for git with a specific
'git-remote' property. 'oneOf' is problematic when schema validation fails:
the diagnostic is only that none of oneOf variants matched, which is too
non-specific.
-- added 'describe' property to 'git-remote' object.
-- removed description property for a layer source: it is not clear how to add
that
when auto-generating the json
Signed-off-by: Alexander Kanavin <a...@linutronix.de>
---
meta/files/layers.example.json | 115 +++++++++++++++++++++
meta/files/layers.schema.json | 121 +++++++++++++++++++++++
meta/lib/oeqa/selftest/cases/bblayers.py | 16 ++-
3 files changed, 251 insertions(+), 1 deletion(-)
create mode 100644 meta/files/layers.example.json
create mode 100644 meta/files/layers.schema.json
diff --git a/meta/files/layers.example.json b/meta/files/layers.example.json
new file mode 100644
index 0000000000..b6e35c615d
--- /dev/null
+++ b/meta/files/layers.example.json
@@ -0,0 +1,115 @@
+{
+ "sources": {
+ "meta-alex": {
+ "contains_this_file": true,
+ "git-remote": {
+ "branch": "master",
+ "describe": "",
+ "remotes": {
+ "remote-alex": {
+ "uri": "https://github.com/kanavin/meta-alex";
+ }
+ },
+ "rev": "05b25605fb8b2399e4706d7323828676bf0da0b5"
+ },
+ "layers": {
+ "meta-alex": {
+ "buildconfigs": {
+ "conf/templates/configuration-gadget": {},
+ "conf/templates/configuration-gizmo": {}
+ },
+ "subpath": ""
+ }
+ },
+ "path": "meta-alex"
+ },
+ "meta-intel": {
+ "git-remote": {
+ "branch": "master",
+ "describe": "15.0-hardknott-3.3-310-g0a96edae",
+ "remotes": {
+ "origin": {
+ "uri": "git://git.yoctoproject.org/meta-intel"
+ }
+ },
+ "rev": "0a96edae609a3f48befac36af82cf1eed6786b4a"
+ },
+ "layers": {
+ "meta-intel": {
+ "machines": {
+ "intel-core2-32": {},
+ "intel-corei7-64": {},
+ "intel-skylake-64": {}
+ },
+ "subpath": ""
+ }
+ },
+ "path": "meta-intel"
+ },
+ "poky": {
+ "git-remote": {
+ "branch": "akanavin/setup-layers",
+ "describe": "4.1_M1-374-g9dda719b2a",
+ "remotes": {
+ "origin": {
+ "uri": "git://git.yoctoproject.org/poky"
+ },
+ "poky-contrib": {
+ "uri": "ssh://g...@push.yoctoproject.org/poky-contrib"
+ }
+ },
+ "rev": "9dda719b2a4727a4d43a6ab8d9e23f8ca68790ec"
+ },
+ "layers": {
+ "meta": {
+ "distros": {
+ "defaultsetup": {}
+ },
+ "machines": {
+ "qemuarm": {},
+ "qemuarm64": {},
+ "qemuarmv5": {},
+ "qemumips": {},
+ "qemumips64": {},
+ "qemuppc": {},
+ "qemuppc64": {},
+ "qemuriscv32": {},
+ "qemuriscv64": {},
+ "qemux86": {},
+ "qemux86-64": {}
+ },
+ "subpath": "meta"
+ },
+ "meta-poky": {
+ "buildconfigs": {
+ "conf": {}
+ },
+ "distros": {
+ "poky": {},
+ "poky-altcfg": {},
+ "poky-bleeding": {},
+ "poky-tiny": {}
+ },
+ "subpath": "meta-poky"
+ },
+ "meta-selftest": {
+ "machines": {
+ "qemux86copy": {}
+ },
+ "subpath": "meta-selftest"
+ },
+ "meta-yocto-bsp": {
+ "machines": {
+ "beaglebone-yocto": {},
+ "edgerouter": {},
+ "genericx86": {},
+ "genericx86-64": {}
+ },
+ "subpath": "meta-yocto-bsp"
+ }
+ },
+ "path": "poky"
+ }
+ },
+ "version": "1.0"
+}
diff --git a/meta/files/layers.schema.json b/meta/files/layers.schema.json
new file mode 100644
index 0000000000..2603fae8f7
--- /dev/null
+++ b/meta/files/layers.schema.json
@@ -0,0 +1,121 @@
+{
+ "description": "OpenEmbedder Layer Setup Manifest",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "version"
+ ],
+ "properties": {
+ "version": {
+ "description": "The version of this document; currently '1.0'",
+ "enum": ["1.0"]
+ },
+ "sources": {
+ "description": "The dict of layer sources",
+ "type": "object",
+ "patternProperties": { ".*" : {
+ "type": "object",
+ "description": "The upstream source from which a set of layers
may be fetched",
+ "additionalProperties": false,
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "description": "The path where this layer source will
be placed when fetching",
+ "type": "string"
+ },
+ "contains_this_file": {
+ "description": "Whether the directory with the layer
source also contains this json description. Tools may want to skip the checkout
of the source then.",
+ "type": "boolean"
+ },
+ "layers": {
+ "description": "The dict of layers to be used from
this upstream source",
+ "type": "object",
+ "patternProperties": { ".*" : {
+ "description": "A layer from the upstream source",
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "subpath": {
+ "description": "The subpath (relative to
the source root) for this layer. Omit if the source root is the layer path",
+ "type": "string"
+ },
+ "buildconfigs": {
+ "description": "A dict of template build
configurations in the layer, keyed by relative path to the layer root",
+ "type": "object",
+ "patternProperties": { ".*" : {
+ "description": "Properties of a build
confuguration template",
+ "type": "object",
+ "additionalProperties": false,
+ "properties":{}
+ }}
+ },
+ "machines": {
+ "description": "A dict of machine
definitions in the layer",
+ "type": "object",
+ "patternProperties": { ".*" : {
+ "description": "Properties of a
machine definition",
+ "type": "object",
+ "additionalProperties": false,
+ "properties":{}
+ }}
+ },
+ "distros": {
+ "description": "A dict of distro
definitions in the layer",
+ "type": "object",
+ "patternProperties": { ".*" : {
+ "description": "Properties of a distro
definition",
+ "type": "object",
+ "additionalProperties": false,
+ "properties":{}
+ }}
+ }
+ }
+ }}
+ },
+ "git-remote": {
+ "description": "A remote git source from which
to fetch",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "rev"
+ ],
+ "properties": {
+ "branch": {
+ "description": "The git branch to
fetch (optional)",
+ "type": "string"
+ },
+ "rev": {
+ "description": "The git revision to
checkout",
+ "type": "string"
+ },
+ "describe": {
+ "description": "The output of 'git
describe' (human readable description of the revision using tags in revision
history).",
+ "type": "string"
+ },
+ "remotes": {
+ "description": "The dict of git
remotes to add to this repository",
+ "type": "object",
+ "patternProperties": { ".*" : {
+ "description": "A git remote",
+ "type": "object",
+ "addtionalProperties": false,
+ "required": [
+ "uri"
+ ],
+ "properties": {
+ "uri": {
+ "description": "The URI
for the remote",
+ "type": "string"
+ }
+ }
+ }}
+ }
+ }
+ }
+ }
+ }
+ }}
+ }
+}
diff --git a/meta/lib/oeqa/selftest/cases/bblayers.py
b/meta/lib/oeqa/selftest/cases/bblayers.py
index 8aa45e432e..4f4952f3eb 100644
--- a/meta/lib/oeqa/selftest/cases/bblayers.py
+++ b/meta/lib/oeqa/selftest/cases/bblayers.py
@@ -6,12 +6,16 @@ import os
import re
import oeqa.utils.ftools as ftools
-from oeqa.utils.commands import runCmd, get_bb_var, get_bb_vars
+from oeqa.utils.commands import runCmd, get_bb_var, get_bb_vars, bitbake
from oeqa.selftest.case import OESelftestTestCase
class BitbakeLayers(OESelftestTestCase):
+ def setUpLocal(self):
+ bitbake("python3-jsonschema-native")
+ bitbake("-c addto_recipe_sysroot python3-jsonschema-native")
+
def test_bitbakelayers_layerindexshowdepends(self):
result = runCmd('bitbake-layers layerindex-show-depends meta-poky')
find_in_contents = re.search("openembedded-core", result.output)
@@ -126,3 +130,13 @@ class BitbakeLayers(OESelftestTestCase):
self.assertTrue(os.path.isfile(recipe_file), msg = "Can't find recipe
file for %s" % recipe)
return os.path.basename(recipe_file)
+
+ def validate_layersjson(self, json):
+ python = os.path.join(get_bb_var('STAGING_BINDIR',
'python3-jsonschema-native'), 'nativepython3')
+ jsonvalidator = os.path.join(get_bb_var('STAGING_BINDIR',
'python3-jsonschema-native'), 'jsonschema')
+ jsonschema = os.path.join(get_bb_var('COREBASE'),
'meta/files/layers.schema.json')
+ result = runCmd("{} {} -i {} {}".format(python, jsonvalidator, json,
jsonschema))
+
+ def test_validate_examplelayersjson(self):
+ json = os.path.join(get_bb_var('COREBASE'),
"meta/files/layers.example.json")
+ self.validate_layersjson(json)
--
2.30.2
-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#168782):
https://lists.openembedded.org/g/openembedded-core/message/168782
Mute This Topic: https://lists.openembedded.org/mt/92770559/21656
Group Owner: openembedded-core+ow...@lists.openembedded.org
Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub
[arch...@mail-archive.com]
-=-=-=-=-=-=-=-=-=-=-=-
