codacle-graph-sdk 1.0.0

Python SDK for the Codacle Graph Service API

Codacle Graph SDK

Python SDK for the Codacle Graph Service API. Provides sync/async clients with statically typed models for Neo4j graph operations.

Installation

pip install codacle-graph-sdk

Quick Start

Sync Client

from codacle_graph_sdk import CodacleGraphClient

with CodacleGraphClient(
    url="https://api.codacle.com",
    api_key="your-api-key",
    alias="production-db",
) as client:
    # Natural language query
    result = client.natural_query("Find all classes")
    for node in result.get_nodes():
        print(node.name)

    # Direct Cypher query
    result = client.cypher_query("MATCH (c:Class) RETURN c LIMIT 10")

Async Client

import asyncio
from codacle_graph_sdk import AsyncCodacleGraphClient

async def main():
    async with AsyncCodacleGraphClient(
        url="https://api.codacle.com",
        api_key="your-api-key",
    ) as client:
        result = await client.natural_query("Find all modules")
        print(result.get_nodes())

asyncio.run(main())

Features

• Sync and async clients
• Typed node models (Client, Application, Module, Class, Subroutine, etc.)
• Typed relationship models
• Convenience methods for graph traversal
• Exception hierarchy mirroring API errors

License

MIT