https://github.com/spoje-net/python3-tapo
Unofficial Tapo API Client debian package
https://github.com/spoje-net/python3-tapo
Last synced: 7 months ago
JSON representation
Unofficial Tapo API Client debian package
- Host: GitHub
- URL: https://github.com/spoje-net/python3-tapo
- Owner: Spoje-NET
- Created: 2025-09-09T15:39:39.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-09-09T19:15:59.000Z (7 months ago)
- Last Synced: 2025-09-09T19:51:12.891Z (7 months ago)
- Language: Python
- Size: 3.13 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# python3-tapo - Debian Package
This repository contains the Debian packaging files for the [Tapo Python library](https://pypi.org/project/tapo/) - an unofficial API client for TP-Link Tapo smart devices.
## About Tapo
Tapo is a Rust-based Python library that provides an API client for controlling TP-Link Tapo smart devices. It supports a wide range of devices including:
- **Light bulbs**: L510, L520, L530, L535, L610, L630
- **Light strips**: L900, L920, L930
- **Smart plugs**: P100, P105, P110, P110M, P115
- **Power strips**: P300, P304M, P316M
- **Hubs**: H100
- **Switches**: S200B
- **Sensors**: KE100, T100, T110, T300, T310, T315
## Package Information
- **Package Name**: `python3-tapo`
- **Version**: 0.8.4-1
- **Architecture**: amd64
- **Section**: python
- **Priority**: optional
- **License**: MIT
## Dependencies
- Python 3.13+
- libc6 (>= 2.34)
- libgcc-s1 (>= 4.2)
## Automated CI/CD
This package includes a Jenkins pipeline (`debian/Jenkinsfile`) that:
1. **Automatically detects** the latest version from PyPI
2. **Downloads** the current wheel from PyPI
3. **Updates** `debian/changelog` with the new version
4. **Updates** `setup.py` with the current version
5. **Builds** packages for multiple distributions:
- Debian Trixie
- Debian Forky
- Ubuntu Jammy
- Ubuntu Noble
6. **Tests** package installation
7. **Archives** the built packages
## Manual Building
To build the Debian package manually:
```bash
# Install build dependencies
sudo apt update
sudo apt install -y debhelper dh-python python3-all python3-setuptools python3-pip python3-wheel
# Build the package (sources will be downloaded automatically)
dpkg-buildpackage -us -uc -b
```
This will:
1. Download the latest tapo wheel from PyPI
2. Extract the wheel contents
3. Create the Debian packages:
- `python3-tapo_X.Y.Z-1_amd64.deb` - Main package
- `python3-tapo-dbgsym_X.Y.Z-1_amd64.deb` - Debug symbols
## Installation
### From Vitex Software Repository (Recommended)
The easiest way to install this package is from the Vitex Software APT repository:
```bash
# Import the GPG key
sudo curl -fsSL http://repo.vitexsoftware.com/KEY.gpg \
-o /usr/share/keyrings/multiflexi-archive-keyring.gpg
# Add the repository (replace [distro] with your distribution codename)
# For example: bookworm, trixie, jammy, noble
echo "deb [signed-by=/usr/share/keyrings/multiflexi-archive-keyring.gpg] http://repo.vitexsoftware.com/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
# Update package lists and install
sudo apt update
sudo apt install python3-tapo
```
**Alternative using modern DEB822 format:**
Create `/etc/apt/sources.list.d/vitexsoftware.sources` with:
```
Types: deb
URIs: http://repo.vitexsoftware.com/
Suites: [distro]
Components: main
Signed-By: /usr/share/keyrings/multiflexi-archive-keyring.gpg
```
*Replace `[distro]` with your distribution codename (e.g., `bookworm`, `trixie`, `jammy`, `noble`)*
This method provides:
- **Automatic updates** when new versions are released
- **Dependency resolution** handled by APT
- **GPG signature verification** for security
- **Multi-architecture support** (amd64, arm64, armhf, i386, etc.)
### From Downloaded Package
Alternatively, install a manually downloaded package:
```bash
sudo dpkg -i python3-tapo_0.8.4-1_amd64.deb
```
## Usage
After installation, you can use the library in Python:
```python
import tapo
# Create API client
client = tapo.ApiClient("username", "password")
# Connect to a device (example with P110 smart plug)
device = await client.p110("192.168.1.100")
# Control the device
await device.on()
await device.off()
# Get device information
info = await device.get_device_info()
print(info)
```
## Files Structure
- `debian/` - Debian packaging files
- `control` - Package metadata and dependencies
- `copyright` - License information
- `changelog` - Version history (auto-updated by Jenkins)
- `rules` - Build rules with dynamic source download
- `source/format` - Source format specification
- `Jenkinsfile` - Automated CI/CD pipeline
- `setup.py` - Python setup script (version auto-updated)
- Source files are downloaded automatically during build
## Upstream Information
- **Homepage**: https://github.com/mihai-dinculescu/tapo
- **PyPI**: https://pypi.org/project/tapo/
- **Author**: Mihai Dinculescu
## Packaging Maintainer
- **Maintainer**: Vitex Software
- **Repository**: https://github.com/Spoje-NET/python3-tapo
## License
This packaging is released under the MIT License, same as the upstream project.