Project

fizzy-sdk

0.0
The project is in a healthy, maintained state
A Ruby SDK for the Fizzy API with automatic retry, exponential backoff, Link header pagination, and observability hooks.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 1.15
~> 6.0
~> 13.0
~> 3.24
~> 0.9
~> 8.0
~> 1.0

Runtime

~> 2.0
~> 2.6
 Project Readme

Fizzy SDK

Official multi-language SDK for the Fizzy API.

Languages

Go

import "github.com/basecamp/fizzy-sdk/go/pkg/fizzy"

client := fizzy.NewClient(cfg, fizzy.NewStaticTokenProvider(token))
account := client.ForAccount("12345")

boards, err := account.Boards.List(ctx, nil)

TypeScript

import { createFizzyClient } from "@37signals/fizzy";

const client = createFizzyClient({ accessToken: "tok_..." });
const account = client.forAccount("12345");

const boards = await account.boards.list();

Ruby

require "fizzy"

client = Fizzy.client(access_token: "tok_...")
account = client.for_account("12345")

boards = account.boards.list

Swift

import Fizzy

let client = FizzyClient(accessToken: "tok_...", userAgent: "MyApp/1.0")
let account = client.forAccount("12345")

let boards = try await account.boards.list()

Kotlin

val client = FizzyClient {
    accessToken("tok_...")
}
val account = client.forAccount("12345")

val boards = account.boards.list()

Rust

use fizzy_sdk::{Client, Config, StaticTokenProvider};

let client = Client::new(Config::default(), StaticTokenProvider::new("tok_..."))?;
let account = client.for_account("12345")?;

let boards = account.boards().list().await?;

cargo add fizzy-sdk tokio --features tokio/macros,tokio/rt-multi-thread — the client is async on Tokio, so the snippet runs inside a #[tokio::main] function; rustls TLS, MSRV 1.88. On crates.io and docs.rs; the crate README covers auth, pagination, errors, hooks and the develop loop.

Features

Feature Go TS Ruby Swift Kotlin Rust
Bearer token auth ✓ ✓ ✓ ✓ ✓ ✓
Cookie session auth ✓ ✓ ✓ ✓ ✓ ✓
Magic link flow ✓ ✓ ✓ ✓ ✓ ✓
Retry + backoff ✓ ✓ ✓ ✓ ✓ ✓
Pagination ✓ ✓ ✓ ✓ ✓ ✓
ETag caching ✓ ✓ ✓ ✓ ✓ ✓
Webhook verification ✓ ✓ ✓ ✓ ✓ ✓
Observability hooks ✓ ✓ ✓ ✓ ✓ ✓
Structured errors ✓ ✓ ✓ ✓ ✓ ✓
Circuit breaker ✓ ✓ ✓ ✓ ✓ ✓

License

MIT