Client SDKs

Angzarr provides client libraries for multiple languages, enabling polyglot teams to build event-sourced applications using their preferred language.

Client Libraries Are Optional

Any language with gRPC support can integrate with Angzarr using the proto bindings alone — the client libraries simply reduce boilerplate. If your language isn't listed below, you can generate gRPC stubs from the proto definitions and interact with Angzarr directly.

Supported Languages

Client libraries are provided for the top TIOBE languages. Additional languages (Ruby, Kotlin, TypeScript, etc.) can be added as demand materializes — the libraries are intentionally lightweight, so adding new language support is straightforward.

Language	Package	Status
Rust	angzarr-client	Production
Go	github.com/benjaminabbitt/angzarr/client/go	Production
Python	angzarr-client	Production
Java	dev.angzarr:angzarr-client	Production
C#	Angzarr.Client	Production
C++	angzarr-client	Production

Installation

Rust

[dependencies]
angzarr-client = "0.1"

Go

go get github.com/benjaminabbitt/angzarr/client/go

Python

pip install angzarr-client

Java

<dependency>
    <groupId>dev.angzarr</groupId>
    <artifactId>angzarr-client</artifactId>
    <version>0.1.0</version>
</dependency>

C#

dotnet add package Angzarr.Client

C++

include(FetchContent)
FetchContent_Declare(
    angzarr-client
    GIT_REPOSITORY https://github.com/benjaminabbitt/angzarr.git
    GIT_TAG main
    SOURCE_SUBDIR client/cpp
)
FetchContent_MakeAvailable(angzarr-client)

target_link_libraries(your_target PRIVATE angzarr-client)

Quick Start

Connect to an aggregate coordinator and send a command:

Rust

use angzarr_client::DomainClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = DomainClient::connect("http://localhost:1310").await?;

    let response = client.aggregate.handle(command).await?;

    Ok(())
}

Go

client, err := angzarr.NewAggregateClient("localhost:1310")
if err != nil {
    log.Fatal(err)
}
defer client.Close()

response, err := client.Handle(ctx, command)

Python

from angzarr_client import DomainClient

client = DomainClient.connect("localhost:1310")

response = client.aggregate.handle(command)

Java

try (DomainClient client = DomainClient.connect("localhost:1310")) {
    CommandResponse response = client.execute(command);
}

C#

using var client = DomainClient.Connect("http://localhost:1310");

var response = client.Execute(command);

C++

auto client = angzarr::DomainClient::connect("localhost:1310");

auto response = client->execute(command);

Client Types

All SDKs provide the same set of client types:

Client	Purpose
QueryClient	Query events from aggregates
AggregateClient	Send commands to aggregates
SpeculativeClient	Dry-run commands without persistence
DomainClient	Combined query + aggregate for a domain
Client	Full client with all capabilities

SDK Contents

• Clients — Client types and connection patterns
• Builders — Fluent CommandBuilder and QueryBuilder
• Error Handling — Error types and introspection
• Speculative Execution — What-if scenarios without persistence

Language-Specific Documentation

Each SDK has its own repository with detailed documentation:

Language	Repository
Rust	angzarr-client-rust
Go	angzarr-client-go
Python	angzarr-client-python
Java	angzarr-client-java
C#	angzarr-client-csharp
C++	angzarr-client-cpp