zephyr

History

Christophe Dufaza ee5c520326 edtlib: tests: refine coverage of Binding objects initialization Add a series of unit tests which try to cover somewhat systematically the possible inputs and what we finally get at the exit of the Binding constructor. Running the assumption that any (valid) YAML binding file is something we can make a Binding instance with: - check which properties are defined at which level (binding, child-binding, grandchild-binding, etc) and their specifications once the binding is initialized - check how including bindings are permitted to specialize the specifications of inherited properties - check the rules applied when overwriting a binding's description or compatible string (at the binding, child-binding, etc, levels) Some tests covering known issues are disabled by default: - this permits to document these issues - while not causing CI errors (when running the python-devicetree unit tests) - enabling these tests without causing errors should allow us to consider the related issues are fixed Signed-off-by: Christophe Dufaza <chris@openmarl.org>		2025-01-08 19:17:51 +01:00
..
python-devicetree	edtlib: tests: refine coverage of Binding objects initialization	2025-01-08 19:17:51 +01:00
edtlib_logger.py	scripts: dts: extract pickled EDT generation	2024-09-25 13:46:32 -05:00
gen_defines.py	style: edtlib: Use a better line continuation operator	2025-01-04 14:15:37 +01:00
gen_driver_kconfig_dts.py	scripts: dts: gen_driver_kconfig_dts: Skip empty yaml files	2023-02-19 20:46:44 -05:00
gen_dts_cmake.py	scripts: dts: properly escape string properties	2024-10-04 13:26:51 -05:00
gen_edt.py	scripts: dts: extract pickled EDT generation	2024-09-25 13:46:32 -05:00
README.txt

README.txt

This directory used to contain the edtlib.py and dtlib.py libraries
and tests, alongside the gen_defines.py script that uses them for
converting DTS to the C macros used by Zephyr.

The libraries and tests have now been moved to the 'python-devicetree'
subdirectory.

We are now in the process of extracting edtlib and dtlib into a
standalone source code library that we intend to share with other
projects.

Links related to the work making this standalone:

    https://pypi.org/project/devicetree/
    https://python-devicetree.readthedocs.io/en/latest/
    https://github.com/zephyrproject-rtos/python-devicetree

The 'python-devicetree' subdirectory you find here next to this
README.txt matches the standalone python-devicetree repository linked
above.

For now, the 'main' copy will continue to be hosted here in the zephyr
repository. We will mirror changes into the standalone repository as
needed; you can just ignore it for now.

Code in the zephyr repository which needs these libraries will import
devicetree.edtlib from now on, but the code will continue to be found
by manipulating sys.path for now.

Eventually, as APIs stabilize, the python-devicetree code in this
repository will disappear, and a standalone repository will be the
'main' one.