LOBSTER Tool for JSON
Project description
LOBSTER
The Lightweight Open BMW Software Traceability Evidence Report allows you to demonstrate software traceability and requirements coverage, which is essential for meeting standards such as ISO 26262.
This package contains a tool extract tracing tags from JSON files. The tool expects a json file with a list of objects, for which you can specify members to extract by name. It is extremely simplistic but it may be good enough to support some use-cases.
If you have a more complex file format you will likely need to provide your own tool for your own files.
Tools
lobster-json
: Extract activities from JSON files
Usage
Some projects store their test vectors in JSON files. This tool can be used to expose these to LOBSTER. Consider this example:
[
{"name" : "XOR Test 1",
"values" : [false, false],
"expectation" : false,
"tags" : "example.req_xor"},
{"name" : "XOR Test 2",
"values" : [false, true],
"expectation" : true,
"tags" : "example.req_xor"},
{"name" : "Potato Test 1",
"values" : [false, false],
"expectation" : true,
"tags" : null,
"justification" : "Unlinked on purpose"}
]
Here we have a list of three tests. You can configure the
lobster-json
tool to extract the relevant information:
$ lobster-json --name-attribute "name" \
--tag-attribute "tags" \
--justification-attribute "justification" \
FILENAME
The name attribute is optional. If your test files do not contain names for the tests then a name is synthesised using the filename and the index of the test (e.g. foo_1, foo_2, foo_3, etc.).
The justification attribute is also optional.
The tag attribute is not, and it needs to be present in each test object.
The specification of these attributes can be nested, for example if your test objects instead look like this:
[
{"meta" : {"name" : "XOR Test 1",
"asil" : "B",
"req" : "example.req_xor"},
"test" : {"inputs" : [false, false],
"expect" : false}
},
...
Then you can get to the data like so:
$ lobster-json --name-attribute "meta.name" \
--tag-attribute "meta.req" \
--justification-attribute "meta.just" \
FILENAME
Finally, if your list of tests is nested more deeply in an object, you
can use the --test-list
flag to identify where it is. For example:
{ "kind" : "tests",
"vectors" : [
{"meta" : {"name" : "XOR Test 1",
"asil" : "B",
"req" : "example.req_xor"},
"test" : {"inputs" : [false, false],
"expect" : false}
},
...
Then you can use --test-list=vectors
to identify the correct list.
Note: This tool is pretty limited. For the obvious cases it works pretty well, but if you have a more complex test definition in JSON then you will need to write your own adaptor using the documented schema.
Copyright & License information
The copyright holder of LOBSTER is the Bayerische Motoren Werke Aktiengesellschaft (BMW AG), and LOBSTER is published under the GNU Affero General Public License, Version 3.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for bmw_lobster_tool_json-0.9.18.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9477f77216d331ade7c51fbe3aa136159437f6ba101a6203d2922f96c4d0870a |
|
MD5 | b5afa1f4f6b7c353f9d3da075388eb5d |
|
BLAKE2b-256 | 0b1ef77513edeb62162fde32a0248a4686f06762a7985fba2201924355937518 |
Hashes for bmw_lobster_tool_json-0.9.18-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d5857228a76e9eaefec7f0e5006e6b5e7ff52f637fc06dca4ca254f039271e04 |
|
MD5 | 3e09428e5b86a4ef287fe929c39c0cca |
|
BLAKE2b-256 | 7fe24bca10d06a5d2a6673991af67f33fe92a592741036ee0dd009d70f9bb163 |