From e4ba41fd2cb6f043333c6ed3f547de3a67365e43 Mon Sep 17 00:00:00 2001
From: Jamie Magee <jamie.magee@gmail.com>
Date: Fri, 15 Aug 2025 22:14:19 -0700
Subject: [PATCH] python3Packages.russound: init at 0.1.8

---
 .../python-modules/russound/default.nix       | 37 +++++++++++++++++++
 pkgs/top-level/python-packages.nix            |  2 +
 2 files changed, 39 insertions(+)
 create mode 100644 pkgs/development/python-modules/russound/default.nix

diff --git a/pkgs/development/python-modules/russound/default.nix b/pkgs/development/python-modules/russound/default.nix
new file mode 100644
index 000000000000..1154fbcc19fa
--- /dev/null
+++ b/pkgs/development/python-modules/russound/default.nix
@@ -0,0 +1,37 @@
+{
+  lib,
+  buildPythonPackage,
+  fetchFromGitHub,
+  setuptools,
+  requests,
+}:
+
+buildPythonPackage rec {
+  pname = "russound";
+  version = "0.1.8";
+  pyproject = true;
+
+  src = fetchFromGitHub {
+    owner = "laf";
+    repo = "russound";
+    tag = version;
+    hash = "sha256-iAhHOZwgaLhgkN/oW3Oz9bazyoqlP8GIsaXpqyXs3/Y=";
+  };
+
+  build-system = [ setuptools ];
+
+  dependencies = [ requests ];
+
+  # Tests require actual hardware to connect to
+  doCheck = false;
+
+  pythonImportsCheck = [ "russound" ];
+
+  meta = {
+    description = "Python API for select Russound RNET commands to provide Russound support within home-assistant.io";
+    homepage = "https://github.com/laf/russound";
+    changelog = "https://github.com/laf/russound/releases/tag/${version}";
+    license = lib.licenses.gpl3Only;
+    maintainers = [ lib.maintainers.jamiemagee ];
+  };
+}
diff --git a/pkgs/top-level/python-packages.nix b/pkgs/top-level/python-packages.nix
index 74ca9d727350..d77a8bb6d871 100644
--- a/pkgs/top-level/python-packages.nix
+++ b/pkgs/top-level/python-packages.nix
@@ -16053,6 +16053,8 @@ self: super: with self; {
 
   runstats = callPackage ../development/python-modules/runstats { };
 
+  russound = callPackage ../development/python-modules/russound { };
+
   rustworkx = callPackage ../development/python-modules/rustworkx { };
 
   ruuvitag-ble = callPackage ../development/python-modules/ruuvitag-ble { };