Integration testing via pytest-docker

.github/workflows/py3.yml

@@ -23,7 +23,7 @@ jobs:
           python-version: ${{ matrix.python }}
 
       - name: Install pynetbox and testing packages.
-        run: pip install . black==19.10b0 pytest
+        run: pip install . black==19.10b0 pytest pytest-docker faker
 
       - name: Run Linter
         run: black --diff --check pynetbox tests

.gitignore

@@ -96,4 +96,8 @@ ENV/
 /site
 
 # mypy
-.mypy_cache/
+.mypy_cache/
+
+# Other git repos checked out locally
+.netbox-docker-*/
+.devicetype-library/

tests/conftest.py

@@ -0,0 +1,43 @@
+from packaging import version
+
+
+DEFAULT_NETBOX_VERSIONS = "2.7, 2.8, 2.9, 2.10"
+
+
+def pytest_addoption(parser):
+    """Hook on the pytest option parser setup.
+
+    Add some extra options to the parser.
+    """
+    parser.addoption(
+        "--netbox-versions",
+        action="store",
+        default=DEFAULT_NETBOX_VERSIONS,
+        help=(
+            "The versions of netbox to run integration tests against, as a"
+            " comma-separated list. Default: %s" % DEFAULT_NETBOX_VERSIONS
+        ),
+    )
+
+    parser.addoption(
+        "--no-cleanup",
+        dest="cleanup",
+        action="store_false",
+        help=(
+            "Skip any cleanup steps after the pytest session finishes. Any containers"
+            " created will be left running and the docker-compose files used to"
+            " create them will be left on disk."
+        ),
+    )
+
+
+def pytest_configure(config):
+    """Hook that runs after test collection is completed.
+
+    Here we can modify items in the collected tests or parser args.
+    """
+    # verify the netbox versions parse correctly and split them
+    config.option.netbox_versions = [
+        version.Version(version_string)
+        for version_string in config.option.netbox_versions.split(",")
+    ]