Skip to contentSkip to conversation

doc: improve BitBake README testing instructions

PATCH New Mohamed Ayman 1 participant 2 messages Aug 18, 2025

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: improve BitBake README testing instructions

Clarified the testing section by:
- Adding context on setting PATH before running selftests
- Documenting how to install pytest using pip
- Providing an example command for running pytest on lib/bb/tests

These additions make it easier for new contributors to run the testsuite and ensure consistent testing practices.

---
 bitbake/README | 7 +++++++
 1 file changed, 7 insertions(+)
bitbake/README +7 -0
index e9f4c858ee..938eec47ce 100644
@@ -54,10 +54,17 @@ The assumption is made that this testsuite is run from an initialized OpenEmbedd
 environment (i.e. `source oe-init-build-env` is used). If this is not the case, run the
 testsuite as follows:
 
+# ensure local tools are on PATH and run the selftest script
     export PATH=$(pwd)/bin:$PATH
     bin/bitbake-selftest
 
 The testsuite can alternatively be executed using pytest, e.g. obtained from PyPI (in this
 case, the PATH is configured automatically):
 
+# install pytest into a virtualenv or pipx (recommended)
+python -m pip install --user pytest
+
+# run tests (example)
+python -m pytest lib/bb/tests -q
+
     pytest
Signature · 1 line
2.34.1
#1 lore raw

PATCH 1/1 doc: improve BitBake README testing instructions

Clarified the testing section by:
- Adding context on setting PATH before running selftests
- Documenting how to install pytest using pip
- Providing an example command for running pytest on lib/bb/tests

These additions make it easier for new contributors to run the testsuite and ensure consistent testing practices.

---
 bitbake/README | 7 +++++++
 1 file changed, 7 insertions(+)
bitbake/README +7 -0
index e9f4c858ee..938eec47ce 100644
@@ -54,10 +54,17 @@ The assumption is made that this testsuite is run from an initialized OpenEmbedd
 environment (i.e. `source oe-init-build-env` is used). If this is not the case, run the
 testsuite as follows:
 
+# ensure local tools are on PATH and run the selftest script
     export PATH=$(pwd)/bin:$PATH
     bin/bitbake-selftest
 
 The testsuite can alternatively be executed using pytest, e.g. obtained from PyPI (in this
 case, the PATH is configured automatically):
 
+# install pytest into a virtualenv or pipx (recommended)
+python -m pip install --user pytest
+
+# run tests (example)
+python -m pytest lib/bb/tests -q
+
     pytest
Signature · 1 line
2.34.1