add tests and ci workflow for running tests

This commit adds tests (using python3 pytest framework):
1. Test basic accel-cmd commands (show version, show stat, etc)
2. Test ipoe shared session up (dhcpv4) without radius
3. Test pppoe discovery (without PADO delay)
4. Test pppoe discovery (without PADO delay)
5. Test pppoe session up (ipv4) without radius
6. Test vlan creation using vlan-mon (pppoe)

These tests require external utils. Please read tests/README.md how to setup
environment, how to run the tests and how to generate coverage report
Also, run-tests.yml contains step-by-step instruction how to run the tests

Signed-off-by: Sergey V. Lobanov <sergey@lobanov.in>

1 files changed, 99 insertions, 0 deletions

diff --git a/tests/conftest.py b/tests/conftest.py
new file mode 100644
index 0000000..d373340
--- /dev/null
+++ b/tests/conftest.py
@@ -0,0 +1,99 @@
+import pytest
+from common import accel_pppd_process, config, veth
+
+
+def pytest_addoption(parser):
+    parser.addoption("--accel_cmd", action="store", default="accel-cmd")
+    parser.addoption("--accel_pppd", action="store", default="accel-pppd")
+    parser.addoption("--pppd", action="store", default="pppd")  # pppd client
+    parser.addoption(
+        "--dhclient", action="store", default="dhclient"
+    )  # isc-dhcp-client
+    parser.addoption(
+        "--accel_pppd_max_wait_time", action="store", default=5.0
+    )  # start timeout
+    parser.addoption(
+        "--accel_pppd_max_finish_time", action="store", default=10.0
+    )  # fininsh timeout (before kill)
+
+
+def pytest_configure(config):
+    config.addinivalue_line(
+        "markers",
+        "ipoe_driver: marks tests as related to ipoe kernel module (deselect with '-m \"not ipoe_driver\"')",
+    )
+    config.addinivalue_line(
+        "markers",
+        "vlan_mon_driver: marks tests as related to ipoe kernel module (deselect with '-m \"not vlan_mon_driver\"')",
+    )
+
+
+# accel-pppd executable file name
+@pytest.fixture()
+def accel_pppd(pytestconfig):
+    return pytestconfig.getoption("accel_pppd")
+
+
+# accel-cmd executable file name
+@pytest.fixture()
+def accel_cmd(pytestconfig):
+    return pytestconfig.getoption("accel_cmd")
+
+
+# accel-pppd configuration as string (should be redefined by specific test)
+@pytest.fixture()
+def accel_pppd_config():
+    return ""
+
+
+# accel-pppd configuration file name
+@pytest.fixture()
+def accel_pppd_config_file(accel_pppd_config):
+    # test setup:
+    filename = config.make_tmp(accel_pppd_config)
+
+    # test execution
+    yield filename
+
+    # test teardown:
+    config.delete_tmp(filename)
+
+
+# setup and teardown for tests that required running accel-pppd
+@pytest.fixture()
+def accel_pppd_instance(accel_pppd, accel_pppd_config_file, accel_cmd, pytestconfig):
+    # test setup:
+    is_started, accel_pppd_thread, accel_pppd_control = accel_pppd_process.start(
+        accel_pppd,
+        ["-c" + accel_pppd_config_file],
+        accel_cmd,
+        pytestconfig.getoption("accel_pppd_max_wait_time"),
+    )
+
+    # test execution:
+    yield is_started
+
+    # test teardown:
+    accel_pppd_process.end(
+        accel_pppd_thread,
+        accel_pppd_control,
+        accel_cmd,
+        pytestconfig.getoption("accel_pppd_max_finish_time"),
+    )
+
+# defines vlans that will be created over veth pair (might be redefined by specific test)
+@pytest.fixture()
+def veth_pair_vlans_config():
+    return {"vlans_a": [], "vlans_b": []}
+
+# setup and teardown for netns and veth pair
+@pytest.fixture()
+def veth_pair_netns(veth_pair_vlans_config):
+    # test setup:
+    veth_pair_netns_instance = veth.create_veth_pair_netns(veth_pair_vlans_config)
+
+    # test execution:
+    yield veth_pair_netns_instance
+
+    # test teardown:
+    veth.delete_veth_pair_netns(veth_pair_netns_instance)