| commit | 78bf8b9008519a00f5bb2c226f049eb2f245a28c | [log] [tgz] |
|---|---|---|
| author | Daniel Latypov <dlatypov@google.com> | Wed Apr 07 13:59:02 2021 -0700 |
| committer | Daniel Latypov <dlatypov@google.com> | Thu Aug 05 16:37:18 2021 -0700 |
| tree | 4b359dc7708d46256f04fc6025c5e96653d4eb59 | |
| parent | a12f4478252a02f44c4b15be0a5824407597e0a1 [diff] |
mocking.rst: add start of write-up on mocking + function redirection Note: this isn't so much about mocking as it is about redirecting function calls (potentially to a mock). But kunit.dev/mocking will probably be more memorable and match more what people search for. In [1], a doc was presented on stream but couldn't be made publicly available. This is the start of the process of making it available. Unlike that doc, this page has a different audience and is intended to also try and give a basic feel for what mocking is and why you would/would not want to use it. This first patch includes the description of fakes vs mocks and a skeleton for the rest (the doc's overview of the different kinds of approaches to adding indirection). [1] https://events.linuxfoundation.org/mentorship-session-kunit-testing-strategies/ Change-Id: I54899388cc2ca07b1ba5d41dc7add4363cab2223 Signed-off-by: Daniel Latypov <dlatypov@google.com>
KUnit is a lightweight unit testing and mocking framework for the Linux kernel. These tests are able to be run locally on a developer’s workstation without a VM or special hardware.
KUnit is heavily inspired by JUnit, Python’s unittest.mock, and Googletest/Googlemock for C++. KUnit defines a way to mock out C style classes and functions and create expectations on methods called within the code under test.
This is a repository to host the source for the KUnit documentation.
NOTE: There is an important distinction between KUnit‘s documentation source and it’s documentation site. As a project meant primarily to serve the development of the Linux kernel, a significant portion of our code and documentation reside in the Linux kernel codebase. Consequently, the documentation that does not live in the Linux kernel follows many of the conventions of the Linux kernel. One of these conventions is that we use Sphinx for all of our documentation. Thus, because Sphinx requires documentation to be compiled from its source files, we must have a repository for all the Sphinx source files and a separate repository for all of the generated output files to actually host the site. This is the repository for the source.
https://kunit.googlesource.com
Documentation can be built by running:
make html
Our documentation is hosted at https://github.com/google/kunit-docs. The documentation may be updated by building the documentation as described above, and then:
./deploy.sh
You can copy the files over without committing and pushing the files with:
./deploy.sh --no-commit