blob: 506b3c0fb5ba77c0fcbefbcb386ec12897eab474 [file] [log] [blame]
.. SPDX-FileCopyrightText: 2021 Open Networking Foundation <info@opennetworking.org>
.. SPDX-License-Identifier: Apache-2.0
P4 Pipeline Tests (PTF)
=======================
`PTF <https://github.com/p4lang/PTF>`_ is a Python based data plane test framework.
It is based on unittest, which is included in the standard Python distribution.
To test the P4 pipeline, we are using the following components:
* PTF framework and tests
* Installs table entries to the device.
* Generate and verify the traffic.
* Stratum: the software that process P4Runtime requests from PTF and configures the device.
* The device under tests: can be software device like Tofino Model, or a hardware device.
* TRex server: for the line rate test.
.. image:: ../images/pipeline-test-arch.svg
:width: 800px
Test plans
----------
See `test plans <https://github.com/stratum/fabric-tna/tree/main/ptf#the-unary-test-plan>`_ section in the fabric-TNA repository
Run tests
---------
See `step to run tests <https://github.com/stratum/fabric-tna/tree/main/ptf#steps-to-run-tests-on-tofino-model-with-stratum>`_
section in the Fabric-TNA repository.
Test result
-----------
See `test result <https://github.com/stratum/fabric-tna/tree/main/ptf#test-result>`_
section in the Fabric-TNA repository.
Contribute new test cases
-------------------------
See `contribute new test cases <https://github.com/stratum/fabric-tna/tree/main/ptf#contribute-new-test-cases>`_
section in the Fabric-TNA repository.