shelly-cli 0.1.0__py3-none-win_amd64.whl

shelly_cli/__init__.py

@@ -0,0 +1,10 @@
+"""
+shelly-cli: A fast CLI for discovering, monitoring, and controlling Shelly devices.
+"""
+
+try:
+    from importlib.metadata import version
+    __version__ = version("shelly-cli")
+except ImportError:
+    from importlib_metadata import version
+    __version__ = version("shelly-cli")

shelly_cli/__main__.py

@@ -0,0 +1,49 @@
+"""
+Command-line interface for shelly-cli.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+import subprocess
+from pathlib import Path
+
+
+def find_native_binary() -> str:
+    """Find the native Rust binary."""
+    project_root = Path(__file__).resolve().parent.parent.parent
+    target_binary = project_root / "target" / "release" / "shelly"
+    if target_binary.exists() and not target_binary.is_dir():
+        return str(target_binary)
+
+    if sys.platform == "win32":
+        target_binary = project_root / "target" / "release" / "shelly.exe"
+        if target_binary.exists() and not target_binary.is_dir():
+            return str(target_binary)
+
+    raise FileNotFoundError(
+        "Could not find the native shelly binary. "
+        "Please ensure it was built with 'cargo build --release'."
+    )
+
+
+def main() -> int:
+    """Run the shelly command line tool."""
+    try:
+        native_binary = find_native_binary()
+        args = [native_binary] + sys.argv[1:]
+
+        if sys.platform == "win32":
+            completed_process = subprocess.run(args)
+            return completed_process.returncode
+        else:
+            os.execv(native_binary, args)
+            return 0
+    except FileNotFoundError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

shelly_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: shelly-cli
+Version: 0.1.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Home Automation
+License-File: LICENSE
+Summary: CLI for managing and controlling Shelly devices
+Home-Page: https://github.com/rvben/shelly-cli
+Author-email: Ruben Jongejan <ruben.jongejan@gmail.com>
+License: MIT
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/rvben/shelly-cli
+Project-URL: Repository, https://github.com/rvben/shelly-cli.git
+
+# shelly
+
+A fast CLI for discovering, monitoring, and controlling Shelly smart home devices.
+
+![CI](https://github.com/rvben/shelly-cli/actions/workflows/ci.yml/badge.svg) [![crates.io](https://img.shields.io/crates/v/shelly-cli.svg)](https://crates.io/crates/shelly-cli) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Features
+
+- Auto-discovery of Shelly devices on the local network
+- Unified Gen1 + Gen2/Gen3 support (transparent protocol handling)
+- Interactive watch dashboard with live power, temperature, WiFi monitoring -- and switch control
+- Device health checks (temperature, WiFi signal, firmware, uptime)
+- Device groups with filter-based and name-based definitions
+- Firmware check and update across all devices
+- Device renaming from the CLI
+- Structured JSON output for scripting and AI agent integration
+- Shell completions (bash, zsh, fish, powershell)
+- Fuzzy device name matching with "did you mean?" suggestions
+- Color output with automatic detection
+
+## Install
+
+### uv (recommended)
+
+```bash
+uv tool install shelly-cli
+```
+
+### pip
+
+```bash
+pip install shelly-cli
+```
+
+### Cargo
+
+```bash
+cargo install shelly-cli
+```
+
+### Homebrew (macOS/Linux)
+
+```bash
+brew install rvben/tap/shelly-cli
+```
+
+### Pre-built binaries
+
+Download from [GitHub Releases](https://github.com/rvben/shelly-cli/releases).
+
+### From source
+
+```bash
+git clone https://github.com/rvben/shelly-cli.git
+cd shelly-cli
+cargo install --path .
+```
+
+## Quick Start
+
+```bash
+# 1. Discover devices on your network
+shelly discover --subnet 192.168.1.0/24
+
+# 2. See what you found
+shelly devices
+
+# 3. Check device health
+shelly health
+```
+
+## Usage
+
+### Device control
+
+```bash
+shelly on "Kitchen Light"          # Turn on
+shelly off "Kitchen Light"         # Turn off
+shelly toggle -n "Living Room"     # Toggle
+shelly status -n "Kitchen Light"   # Get status
+```
+
+### Monitoring
+
+```bash
+shelly watch                       # Interactive dashboard
+shelly health                      # Health check all devices
+shelly power -a                    # Power usage for all devices
+```
+
+### Device management
+
+```bash
+shelly rename -n "old-name" "New Name"    # Rename device
+shelly firmware check -a                   # Check for updates
+shelly firmware update -a                  # Update all firmware
+shelly reboot -n "Kitchen Light"          # Reboot device
+```
+
+### Groups
+
+```bash
+shelly group add lights "Kitchen" "Living Room" "Bedroom"
+shelly group list
+shelly -g lights off               # Turn off all lights
+shelly -g lights status            # Status of all lights
+```
+
+### Configuration
+
+```bash
+shelly config get -n "Kitchen"     # Get device config
+shelly completions zsh             # Generate shell completions
+```
+
+## Agent Integration
+
+Designed for scripting and AI agent use with structured, machine-readable output.
+
+```bash
+# Structured JSON output (auto-enabled when piped)
+shelly status -a | jq '.data'
+
+# Consistent envelope: {"ok": true, "data": ...} or {"ok": false, "error": {...}}
+shelly -n "nonexistent" status
+# {"ok": false, "error": {"code": "DEVICE_NOT_FOUND", "message": "..."}}
+
+# Machine-readable schema
+shelly schema
+```
+
+## Groups Configuration
+
+Groups are defined in a TOML file:
+
+```toml
+# ~/.config/shelly-cli/groups.toml (Linux)
+# ~/Library/Application Support/shelly-cli/groups.toml (macOS)
+
+[groups]
+lights = ["Kitchen Light", "Living Room Light", "Bedroom Light"]
+gen1 = { filter = "gen1" }
+gen3 = { filter = "gen3" }
+all = { filter = "all" }
+```
+
+Or manage via CLI: `shelly group add`, `shelly group remove`, `shelly group show`.
+
+## Supported Devices
+
+| Generation | Examples | Status |
+|---|---|---|
+| Gen1 | Shelly 1, 1PM, 2.5, Plug S, Dimmer | Supported (switch, power, firmware) |
+| Gen2 | Shelly Plus 1, Plus 1PM, Plus 2PM | Supported (switch, power, firmware) |
+| Gen3 | Shelly Mini 1PM G3, Plus series G3 | Supported (switch, power, firmware) |
+
+## License
+
+MIT License -- see [LICENSE](LICENSE) file.
+

shelly_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+shelly_cli/__init__.py,sha256=LFXz8WH0VBmDz4h96zD9rcQ8psVvfwtKWTgPRLHa_EU,294
+shelly_cli/__main__.py,sha256=rrROt7VhrYCakadWAIUVrz5U83Ris75zi64JhiEv3p4,1394
+shelly_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+shelly_cli-0.1.0.data/scripts/shelly.exe,sha256=0WmojkcTxOgolRnh2LoLDAPvaqt7Tih8KcgaRpdrqR4,5857280
+shelly_cli-0.1.0.dist-info/METADATA,sha256=13eBxO8Uv9cfd5mjBnKKS3rPoEIgD-DX3tWrF-xARb0,4943
+shelly_cli-0.1.0.dist-info/WHEEL,sha256=uJOc2U-Q1x95AlblQcqMRb3iR4QnPtdI7X2ycPN99rM,94
+shelly_cli-0.1.0.dist-info/licenses/LICENSE,sha256=YyJnikhAW7_HwaUPeO-iJud1fh2UplNX6MZP1zd1OXY,1092
+shelly_cli-0.1.0.dist-info/sboms/shelly-cli.cyclonedx.json,sha256=x55VHperaL4ETSIcYSyknccyNSxG4wEnh8Ra1hzNN78,179667
+shelly_cli-0.1.0.dist-info/RECORD,,

shelly_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.12.6)
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64

shelly_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ruben Jongejan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.