![<date/time> <footer> 12
Fixtures of Pynvme
• create/delete test objects. in conftest.py:
• nvme0
• nvme0n1
• pcie
• ...
• parametrize of tests
• @pytest.mark.parametrize("qcount", [1, 2, 4, 8, 15])
• @pytest.mark.parametrize("repeat", range(10))
• test control
• @pytest.mark.skip("nvme over tcp")
• doc: https://docs.pytest.org/en/latest/fixture.html](https://image.slidesharecdn.com/pynvmeintroduction-190308045125/85/Pynvme-introduction-12-320.jpg)
Pynvme introduction
- 1. Pynvme: test NVMe devices in Python https://github.com/cranechu/pynvme
- 2. <date/time> <footer> 2 Pynvme Pynvme is a python extension module. Users can operate NVMe SSD intuitively by Python scripts. It is designed for NVMe SSD testing with performance considered. With third-party tools, e.g. emacs, pycharm and pytest, pynvme is a convenient and professional NVMe device test solution.
- 3. <date/time> <footer> 3 Pynvme in Python IDLE SPDK pynvme
- 4. <date/time> <footer> 4 Pynvme is based on SPDK
- 5. <date/time> <footer> 5 Pynvme Architecture Test driver (driver.c) Python interface (driver_wrap.pyx) Python library (nvme.so) Build python library with Cython: • setup.py • driver.c • driver.h • cdriver.pxd • driver_wrap.pyx • Makefile
- 6. <date/time> <footer> 6 Pynvme Architecture Test driver (driver.c) Python interface (driver_wrap.pyx) Python library (nvme.so) Organize test cases in pytest: • mvme.so • pytest.ini • conftest.py • driver_test.py Python test scripts (driver_test.py) Pytest fixtures (conftest.py)
- 7. <date/time> <footer> 7 Why Python? √ Many beautiful mature libraries • pytest • logging • multiprocessing • numpy • matplotlib • pydoc • os, io, time, pytemperature, statistics, yaml, json, struct, ... √ Friendly IDEs for developing, debugging, and testing • Pycharm, emacs, vscode √ CI: develop firmware softly
- 8. <date/time> <footer> 8 Pynvme CI Status
- 9. <date/time> <footer> 9 Config and Compile − git clone https://github.com/cranechu/pynvme; cd pynvme − git submodule update --init –recursive − sudo ./spdk/scripts/pkgdep.sh − sudo dnf install python3-pip -y − sudo python3 -m pip install -r requirements.txt − cd spdk; ./configure --without-isal; cd .. − make spdk; make − Fedora29 is recommended. − find script examples in driver_test.py. − find more => https://github.com/cranechu/pynvme
- 10. <date/time> <footer> 10 Test Scripts pytest cases are started with test_ create qpair and buffer for write commands write data, and then read in the callback pytest fixtures callback functions called when cmds are completed fill buffer with identify data
- 11. <date/time> <footer> 11 IOWorker send IO in a separated process define IO patterns in ioworker's parameter list wait ioworkers till finish, and collect result data
- 12. <date/time> <footer> 12 Fixtures of Pynvme • create/delete test objects. in conftest.py: • nvme0 • nvme0n1 • pcie • ... • parametrize of tests • @pytest.mark.parametrize("qcount", [1, 2, 4, 8, 15]) • @pytest.mark.parametrize("repeat", range(10)) • test control • @pytest.mark.skip("nvme over tcp") • doc: https://docs.pytest.org/en/latest/fixture.html
- 13. <date/time> <footer> 13 Test Files import pytest import nvme test functions test file name pytest collects test files and cases before execution
- 14. <date/time> <footer> 14 Pytest Execution • '''The pytest framework makes it easy to write small tests, yet scales to support complex functional testing for applications and libraries.''' • '''pytest fixtures offer dramatic improvements over the classic xUnit style of setup/teardown functions''' • pytest test_mod.py # run tests in a module • pytest testing/ # run tests in a directory • pytest test_mod.py::test_func # run a specific test case • pytest test_mod.py -s # run tests without log capturing • https://media.readthedocs.org/pdf/pytest/latest/pytest.pdf
- 15. <date/time> <footer> 15 Pycharm: show case Test status Test log Test scripts
- 16. <date/time> <footer> 16 Welcome to use and contribute https://github.com/cranechu/pynvme