rustuya 0.1.0__tar.gz

rustuya-0.1.0/Cargo.toml

@@ -0,0 +1,61 @@
+[package]
+name = "rustuya"
+version = "0.1.0"
+authors = ["3735943886"]
+edition = "2024"
+license = "MIT"
+repository = "https://github.com/3735943886/rustuya"
+documentation = "https://docs.rs/rustuya"
+homepage = "https://github.com/3735943886/rustuya"
+description = "A fast and concurrent Tuya Local API implementation in Rust"
+keywords = ["tuya", "iot", "smart-home", "automation"]
+categories = ["hardware-support", "network-programming", "api-bindings"]
+include = [
+    "src/**/*",
+    "examples/*.rs",
+    "!examples/z_*.rs",
+    "Cargo.toml",
+    "README.md",
+    "LICENSE"
+]
+readme = "README.md"
+
+[lib]
+name = "rustuya"
+crate-type = ["rlib"]
+
+[dependencies]
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+aes = "0.8"
+aes-gcm = "0.10"
+hmac = "0.12"
+sha2 = "0.10"
+crc = "3.0"
+rand = "0.9"
+hex = "0.4"
+base64 = "0.22"
+md-5 = "0.10"
+thiserror = "2.0"
+log = "0.4"
+env_logger = "0.11"
+byteorder = "1.5"
+cipher = { version = "0.4", features = ["block-padding"] }
+block-padding = "0.3"
+ecb = "0.1"
+tokio = { version = "1.0", features = ["rt-multi-thread", "net", "sync", "time", "macros", "io-util"] }
+socket2 = { version = "0.5", features = ["all"] }
+async-stream = "0.3"
+tokio-stream = { version = "0.1", features = ["sync"] }
+tokio-util = { version = "0.7", features = ["rt"] }
+futures-core = "0.3"
+futures-util = "0.3"
+rlimit = "0.10"
+parking_lot = "0.12"
+
+[profile.release]
+opt-level = 3
+lto = true
+codegen-units = 1
+panic = "abort"
+strip = true

rustuya-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 3735943886
+
+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.

rustuya-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: rustuya
+Version: 0.1.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Summary: A fast and concurrent Tuya Local API implementation in Rust
+Keywords: tuya,iot,smart-home,automation
+Home-Page: https://github.com/3735943886/rustuya
+Author: 3735943886
+License: MIT
+Requires-Python: >=3.7
+Project-URL: Homepage, https://github.com/3735943886/rustuya
+Project-URL: Repository, https://github.com/3735943886/rustuya

rustuya-0.1.0/README.md

@@ -0,0 +1,58 @@
+# Rustuya
+
+[![Crates.io](https://img.shields.io/crates/v/rustuya.svg)](https://crates.io/crates/rustuya)
+[![Documentation](https://docs.rs/rustuya/badge.svg)](https://docs.rs/rustuya)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Rustuya** is an asynchronous Rust implementation of the Tuya Local API. It allows for local control and monitoring of Tuya-compatible devices without cloud dependencies.
+
+> [!WARNING]  
+> This project is in an **early development stage (v0.1.0)**. APIs are subject to change.
+
+
+## Installation
+
+Add `rustuya` to `Cargo.toml`:
+
+```bash
+cargo add rustuya tokio --features tokio/full
+```
+
+## Quick Start
+
+### Basic Device Control
+
+```rust
+use rustuya::sync::Device;
+use serde_json::json;
+
+fn main() {
+    let device = Device::new("DEVICE_ID", "DEVICE_ADDRESS", "DEVICE_KEY", "DEVICE_VERSION");
+
+    device.set_value(1, json!(true));
+}
+```
+
+### Real-time Status Monitoring
+
+```rust
+use rustuya::sync::Device;
+
+fn main() {
+    let device = Device::new("DEVICE_ID", "DEVICE_ADDRESS", "DEVICE_KEY", "DEVICE_VERSION");
+    let receiver = device.listener();
+
+    println!("Listening for messages...");
+    for message in receiver {
+        println!("Received: {:?}", message);
+    }
+}
+```
+
+## Credits
+
+This project references the communication protocols and cipher implementations from the [tinytuya](https://github.com/jasonacox/tinytuya) Python library.
+
+## License
+
+MIT

rustuya-0.1.0/examples/scanner_async.rs

@@ -0,0 +1,52 @@
+/**
+ * Scanner Example (Async)
+ *
+ * This example demonstrates how to use the asynchronous UDP scanner to find
+ * Tuya devices on the local network and detect their protocol versions.
+ *
+ * Author: 3735943886
+ */
+use rustuya::Scanner;
+use std::time::Duration;
+
+#[tokio::main]
+async fn main() {
+    // Initialize logger to see discovery details
+    env_logger::Builder::from_env(env_logger::Env::default().default_filter_or("info")).init();
+
+    println!("--- Rustuya - Scanner Async ---");
+    println!("Scanning the network for Tuya devices (18s)...");
+
+    // 1. Create a new scanner with a timeout of 18 seconds
+    let scanner = Scanner::new().with_timeout(Duration::from_secs(18));
+
+    // 2. Perform the scan
+    match scanner.scan().await {
+        Ok(devices) => {
+            let count = devices.len();
+            for dev in devices {
+                println!("-------------------------------------------");
+                // Mandatory fields
+                println!("ID:      {}", dev.id);
+                println!("IP:      {}", dev.ip);
+
+                // Optional: Version
+                if let Some(v) = dev.version {
+                    println!("Version: {}", v);
+                } else {
+                    println!("Version: Unknown");
+                }
+
+                // Optional: Product Key
+                if let Some(pk) = dev.product_key {
+                    println!("Product: {}", pk);
+                }
+            }
+            println!("-------------------------------------------");
+            println!("\nTotal: {} devices found.", count);
+        }
+        Err(e) => {
+            eprintln!("Scan failed: {}", e);
+        }
+    }
+}

rustuya-0.1.0/examples/scanner_sync.rs

@@ -0,0 +1,51 @@
+/**
+ * Scanner Example (Sync)
+ *
+ * This example demonstrates how to use the synchronous UDP scanner to find
+ * Tuya devices on the local network and detect their protocol versions.
+ *
+ * Author: 3735943886
+ */
+use rustuya::sync::Scanner;
+use std::time::Duration;
+
+fn main() {
+    // Initialize logger to see discovery details
+    env_logger::Builder::from_env(env_logger::Env::default().default_filter_or("info")).init();
+
+    println!("--- Rustuya - Scanner Sync ---");
+    println!("Scanning the network for Tuya devices (18s)...");
+
+    // 1. Create a new scanner with a timeout of 18 seconds
+    let scanner = Scanner::new().with_timeout(Duration::from_secs(18));
+
+    // 2. Perform the scan (Blocking)
+    match scanner.scan() {
+        Ok(devices) => {
+            let count = devices.len();
+            for dev in devices {
+                println!("-------------------------------------------");
+                // Mandatory fields
+                println!("ID:      {}", dev.id);
+                println!("IP:      {}", dev.ip);
+
+                // Optional: Version
+                if let Some(v) = dev.version {
+                    println!("Version: {}", v);
+                } else {
+                    println!("Version: Unknown");
+                }
+
+                // Optional: Product Key
+                if let Some(pk) = dev.product_key {
+                    println!("Product: {}", pk);
+                }
+            }
+            println!("-------------------------------------------");
+            println!("\nTotal: {} devices found.", count);
+        }
+        Err(e) => {
+            eprintln!("Scan failed: {}", e);
+        }
+    }
+}

rustuya-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["maturin>=1.0,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "rustuya"
+version = "0.1.0"
+description = "A fast and concurrent Tuya Local API implementation in Rust"
+authors = [
+    { name = "3735943886" }
+]
+requires-python = ">=3.7"
+license = { text = "MIT" }
+keywords = ["tuya", "iot", "smart-home", "automation"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: 3",
+]
+
+[project.urls]
+Homepage = "https://github.com/3735943886/rustuya"
+Repository = "https://github.com/3735943886/rustuya"
+
+[tool.maturin]
+features = ["pyo3/extension-module"]
+module-name = "rustuya"
+manifest-path = "python/Cargo.toml"