DriveThruRPG SDK (Rust)

A Rust SDK for the DriveThruRPG API.

Provides configuration, authentication/session lifecycle, and an async library client for listing orders, product lists, and preparing downloads.

MSRV: 1.95.0 (see rust-toolchain.toml).

Installation

cargo add dtrpg-sdk

Building from source

This repository uses the dtrpg-api repository as a submodule (API/). build.rs reads API/openapi.yaml at compile time and generates Rust OpenAPI metadata into Cargo's OUT_DIR, exposed through dtrpg_sdk::openapi. Clone with submodules, or initialize them after cloning:

git clone --recursive https://github.com/pilgrimagesoftware/dtrpg-sdk.rs.git

# or, if already cloned:
git submodule update --init --recursive

Quick Start

use dtrpg_sdk::{Config, DriveThruRpgSdk, AuthTokenResponse};

let mut sdk = DriveThruRpgSdk::with_config(Config::new("my-app-key"));

// After receiving an auth response from the API:
let response = AuthTokenResponse::new("jwt-token", "refresh-token", 1_800_000_000);
let session = sdk.apply_auth_response(response).unwrap();
assert_eq!(session.token(), "jwt-token");

// Create an authenticated library client:
let client = sdk.library_client().unwrap();
// client.list_order_products(Default::default()).await ...

See the crate's rustdoc for the full API reference, including Config, AuthSession/AuthState, LibraryClient, and the library model types (OrderProductItem, ProductListItem, etc.).

Development

cargo check --all-targets
cargo clippy --all-targets --all-features -- -D warnings
cargo fmt --all -- --check
cargo test --all-features --workspace
cargo doc --no-deps -- -D warnings

Release Process

See RELEASE.md.

License

MIT — see LICENSE.md.