🐍 HeroDB Python SDK

Official Python SDK for HeroDB — High-performance NoSQL for the modern web.

HeroDB-SDK provides a robust and efficient way to interact with your HeroDB cluster directly from Python.

🚀 Quick Start

Installation

pip install herodb-sdk

Basic Usage

from herodb import HeroDBClient

# Initialize and connect
client = HeroDBClient('127.0.0.1', 8080)
client.connect()

# Insert a document
client.insert({
    '_id': 'hero_1',
    'name': 'Death Legion Commander',
    'specialty': 'Massive Scale'
})

# Retrieve data
result = client.find('hero_1')
print(f\"Retrieved: {result['doc']}\")

client.close()

🛠 Key Features

• High Performance: Native TCP implementation for minimal latency.
• Pythonic API: Simple and intuitive methods for all CRUD operations.
• Scalable: Built-in support for sharded clusters via HeroDB Router.
• JSON First: Direct mapping between Python dictionaries and HeroDB documents.

📖 API Reference

• HeroDBClient(host, port): Create a new client.
• connect(): Open the connection.
• insert(doc): Save a dictionary as a document.
• find(id=None): Search by ID or list all.
• delete(id): Remove a document by ID.
• close(): Clean up the connection.

Developed with 💀 by the Death Legion Team.