alwayson-py 0.3.0

Python bindings for ThingWorx AlwaysOn protocol encoding/decoding

AlwaysOn Python

Python bindings for the alwayson-codec Rust library, enabling efficient encoding and decoding of ThingWorx AlwaysOn protocol messages in Python.

Features

• 🚀 High Performance - Rust-powered encoding/decoding
• 🐍 Pythonic API - Familiar Python interfaces
• 📦 Zero Dependencies - Self-contained binary wheels
• 🔧 Complete Protocol Support - All ThingWorx primitive types and messages
• 🛡️ Type Safety - Comprehensive type hints
• 📊 Multipart Messages - Handle large message splitting/merging

Installation

pip install alwayson-py

Quick Start

import alwayson

# Create an authentication message
auth_msg = alwayson.TwxMessage.build_auth(12345, "your-app-key")
binary_data = auth_msg.to_bytes()

# Parse binary message
parsed_msg = alwayson.TwxMessage.from_bytes(binary_data)

# Work with InfoTables
shape = alwayson.DataShape()
shape.add_field("temperature", alwayson.BaseType.NUMBER)
shape.add_field("timestamp", alwayson.BaseType.DATETIME)

table = alwayson.InfoTable(shape)
table.add_row({
    "temperature": 23.5,
    "timestamp": alwayson.datetime_now()
})

Development

This project is built with PyO3 and maturin.

Setup

# Clone the repository
git clone https://github.com/xudesheng/alwayson_py.git
cd alwayson_py

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install maturin
pip install maturin[patchelf]

# Development build
maturin develop

Testing

pip install pytest pytest-asyncio
pytest tests/

Related Projects

• alwayson-codec - The underlying Rust library
• alwayson-base - Full ThingWorx client implementation

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Desheng Xu [e-mail]