Metadata-Version: 2.4
Name: feory
Version: 1.0.0
Summary: Universal Real-Time Python SDK for Feory Android App - Dynamic UI Builder, Live Terminal & Bot Control Bridge
Home-page: https://github.com/zizo0/feory
Author: zizo0
Author-email: zizo0 <zly30257@gmail.com>
Project-URL: Homepage, https://github.com/zizo0/feory
Project-URL: Bug Tracker, https://github.com/zizo0/feory/issues
Keywords: feory,android,bot,ui-builder,automation,telegram,bridge,remote-control,bento-ui
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Communications
Classifier: Topic :: Home Automation
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# Feory Python SDK & Android App ⚡

Universal Python SDK & Real-Time Bridge for **Feory Android App**.
Build dynamic Bento-style Android UIs, manage bots, handle bi-directional events, stream live console logs, and control servers directly from your mobile device.

---

## 🚀 Installation

```bash
pip install feory
```

---

## 🛠️ Quick Start

```python
import feory

# 1. Initialize with your bot token from the Feory App
client = feory.Client(
    token="feory_tok_core_829a1b",
    bot_name="My Production Python Bot",
    port=8765
)

# 2. Register Dynamic UI Widgets into Feory Engine
client.register_button(
    id="btn_start_pipeline",
    label="Start Automation Pipeline",
    category="general",
    color_scheme="LILAC",
    icon="play"
)

client.register_slider(
    id="slider_threads",
    label="Worker Threads",
    min_value=1,
    max_value=32,
    default_value=8
)

client.register_metric_card(
    id="stat_processed",
    title="Items Processed",
    value="12,450",
    badge="+14% today",
    accent_color="GREEN"
)

# 3. Handle Bi-Directional Events from Feory Android App
@client.on_action("btn_start_pipeline")
def handle_pipeline(payload):
    client.log("Starting data processing tasks...", "INFO")
    # Your automation logic here
    return {"status": "started", "items": 100}

@client.on_value_change("slider_threads")
def handle_thread_change(new_val):
    client.log(f"Thread pool updated to: {new_val}", "INFO")

# 4. Keep your bot server running
if __name__ == "__main__":
    client.run_forever()
```

---

## 📱 App Navigation Structure

The Feory Android App interface consists of **3 Core Modules**:
1. 📟 **الكونسول (Console)**: Live real-time terminal streaming, color-coded execution logs (`INFO`, `SUCCESS`, `WARN`, `ERROR`), log filtering, search, and direct terminal command execution.
2. ⚡ **المحرك (Engine)**: Pure, clean dynamic engine canvas that displays injected widgets directly from connected Python bots.
3. 🔑 **التوكنات (Tokens)**: Complete token management, device pairing, and connection credentials.

---

## 🔒 Authentication & Tokens

Every bot connects securely using its unique **Feory Token** (`feory_tok_...`). You can create, manage, and copy tokens directly inside the **التوكنات (Tokens)** screen of the Feory Android App.

---

## 👤 Author

Developed by **zizo0**  
Email: `zly30257@gmail.com`
