mirror of
https://git.yoctoproject.org/poky
synced 2026-03-26 22:02:22 +01:00
e08025fe4c
To support running the bitbake self-tests using pytest, add a pytest.ini This enables these tests to be run using the following command from the bitbake directory. pytest For now, testpaths only includes the bitbake selftests. Add a note to the README. (Bitbake rev: 79bc14003000ab439262272dae6a99961f7c14c7) Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
61 lines
2.2 KiB
Plaintext
61 lines
2.2 KiB
Plaintext
Bitbake
|
|
=======
|
|
|
|
BitBake is a generic task execution engine that allows shell and Python tasks to be run
|
|
efficiently and in parallel while working within complex inter-task dependency constraints.
|
|
One of BitBake's main users, OpenEmbedded, takes this core and builds embedded Linux software
|
|
stacks using a task-oriented approach.
|
|
|
|
For information about Bitbake, see the OpenEmbedded website:
|
|
https://www.openembedded.org/
|
|
|
|
Bitbake plain documentation can be found under the doc directory or its integrated
|
|
html version at the Yocto Project website:
|
|
https://docs.yoctoproject.org
|
|
|
|
Bitbake requires Python version 3.8 or newer.
|
|
|
|
Contributing
|
|
------------
|
|
|
|
Please refer to
|
|
https://www.openembedded.org/wiki/How_to_submit_a_patch_to_OpenEmbedded
|
|
for guidelines on how to submit patches, just note that the latter documentation is intended
|
|
for OpenEmbedded (and its core) not bitbake patches (bitbake-devel@lists.openembedded.org)
|
|
but in general main guidelines apply. Once the commit(s) have been created, the way to send
|
|
the patch is through git-send-email. For example, to send the last commit (HEAD) on current
|
|
branch, type:
|
|
|
|
git send-email -M -1 --to bitbake-devel@lists.openembedded.org
|
|
|
|
Mailing list:
|
|
|
|
https://lists.openembedded.org/g/bitbake-devel
|
|
|
|
Source code:
|
|
|
|
https://git.openembedded.org/bitbake/
|
|
|
|
Testing
|
|
-------
|
|
|
|
Bitbake has a testsuite located in lib/bb/tests/ whichs aim to try and prevent regressions.
|
|
You can run this with "bitbake-selftest". In particular the fetcher is well covered since
|
|
it has so many corner cases. The datastore has many tests too. Testing with the testsuite is
|
|
recommended before submitting patches, particularly to the fetcher and datastore. We also
|
|
appreciate new test cases and may require them for more obscure issues.
|
|
|
|
To run the tests "zstd" and "git" must be installed.
|
|
|
|
The assumption is made that this testsuite is run from an initialized OpenEmbedded build
|
|
environment (i.e. `source oe-init-build-env` is used). If this is not the case, run the
|
|
testsuite as follows:
|
|
|
|
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):
|
|
|
|
pytest
|