blob: aa2abd757c48d9827f2afd836abfae2c941d93db (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
.. TRex Stateless Python API documentation
contain the root `toctree` directive.
TRex Stateless Python API
==============================================
TRex is a **traffic generator**
This site covers the Python API of TRex and explains how to utilize it to your needs.
To understand the entirely how the API works and how to set up the server side, check out the `trex-core Wiki <https://github.com/cisco-system-traffic-generator/trex-core/wiki>`_ under the documentation section of TRex website.
**Use the table of contents below or the menu to your left to navigate through the site**
How to Install
===============
.. toctree::
:maxdepth: 2
| TRex package contains trex_client.tar.gz
| Put it at any place you like, preferably same place as your scripts.
| (If it's not at same place as your scripts, you will need to ensure trex_client directory is in sys.path)
Un-pack it using command::
tar -xzf trex_client.tar.gz
How to pyATS
==================
.. sectionauthor:: David Shen
pyATS Compatibility
TRex supports both Python2 and Python3 pyATS.
* Install python2/python3 pyats
/auto/pyats/bin/pyats-install --python2
/auto/pyats/bin/pyats-install --python3
* setenv TREX_PATH to the trex stateless lib path
setenv TREX_PATH <your path>/automation/trex_control_plane/stl
* In the script or job file, add the TREX_PATH to sys.path::
import sys, os; sys.path.append(os.environ['TREX_PATH'])
* Source trex stateless libs in scripts::
from trex_stl_lib.api import *
from scapy.contrib.mpls import *
from trex_stl_lib.trex_stl_hltapi import *
If using trex_client package, import syntax is::
from trex_client.stl.api import *
API Reference
==============
.. toctree::
:maxdepth: 2
api/index
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
.. rubric:: Footnotes
|
