FireflyDB Python Client

A Python client library for the FireflyDB database.

Features

Connect to FireflyDB servers
String operations (get, set, delete)
List operations (push, pop, range)
Hash operations (hget, hset, hdel)
Comprehensive error handling
Logging support

Installation

Prerequisites

Python 3.13 or higher
FireflyDB server

Building from Source

Clone the repository:

git clone https://gitea.innovativedevsolutions.org/IDSolutions/firefly.git
cd firefly/ifireflylib

Run the build script:
```
python build.py
```
This will:
- Check for the native library
- Build the Python package
- Optionally install the package in development mode

Installing with pip

pip install ifireflylib

Usage

from ifireflylib import IFireflyClient

# Create a client
client = IFireflyClient(host="localhost", port=6379, password="yourpassword")

# Test the connection
if client.ping():
    print("Connected to Firefly server")
    
    # String operations
    client.string_ops.string_set("greeting", "Hello, Firefly!")
    value = client.string_ops.string_get("greeting")
    print(f"Got 'greeting': {value}")
    
    # List operations
    client.list_ops.list_right_push("fruits", "apple")
    client.list_ops.list_right_push("fruits", "banana")
    fruits = client.list_ops.list_range("fruits", 0, -1)
    print(f"List 'fruits': {fruits}")
    
    # Hash operations
    client.hash_ops.hash_set("user:1", "name", "John Doe")
    name = client.hash_ops.hash_get("user:1", "name")
    print(f"Got 'user:1.name': {name}")
    
    # Clean up
    client.string_ops.delete("greeting")
    client.string_ops.delete("fruits")
    client.string_ops.delete("user:1")
    
    # Close the connection
    client.close()

License

MIT License