feat: initial QNAP QTS driver scaffold

QTS is a Linux distribution, so the driver inherits the OS surface from LinuxDriver and adds QNAP's storage, QPKG and virtualisation layers. What is here: the class with its discovery fingerprints, per-session detection of the QTS major version and of the QPKG-local docker and virsh binaries, and explicit resolution of the MRO collisions that StorageDriver creates over LinuxDriver. What is not: the storage, QPKG and VM parsers. Those need real command output from QTS 4 and QTS 5 hardware to be written against, which is what tools/harvest.sh collects and tools/sanitize.py anonymises. Two tests are marked xfail(strict) as the specification for that work.
2026-08-21 09:53:13 +07:00
commit 26d723f417
11 changed files with 893 additions and 0 deletions
@@ -0,0 +1,81 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "napalm-qnap-qts"
+version = "0.1.0"
+description = "NAPALM driver for QNAP NAS systems running QTS via SSH"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "Apache-2.0" }
+authors = [
+    { name = "Christian Manivong", email = "christian@manivong.de" },
+]
+keywords = [
+    "napalm",
+    "network",
+    "automation",
+    "qnap",
+    "qts",
+    "nas",
+    "storage",
+    "ssh",
+    "driver",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Networking",
+    "Topic :: System :: Systems Administration",
+    "Typing :: Typed",
+]
+# napalm-linux is a hard dependency, not an optional one: QTS is a Linux system
+# and this driver inherits the whole OS surface (packages, services, users,
+# processes, Docker) from LinuxDriver rather than reimplementing it.
+dependencies = [
+    "napalm>=4.0",
+    "napalm-device-types>=0.5.0",
+    "napalm-linux>=0.1.0",
+    "netmiko>=4.0.0",
+    "paramiko>=5.0.0",  # CVE-2026-44405
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-cov",
+    "black",
+    "ruff",
+    "mypy",
+]
+
+[project.entry-points."napalm.drivers"]
+qnap_qts = "napalm_qnap_qts:QnapQtsDriver"
+
+[project.urls]
+Repository = "https://git.netork.io/christianmanivong/napalm-qnap-qts"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["napalm_qnap_qts*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+# Same rule set the netOrk repo gates on, so this driver is held to the
+# standard of the project that consumes it rather than to ruff's defaults.
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]