ngdp-client

Command-line interface for interacting with Blizzard's NGDP (Next Generation Distribution Pipeline) services.

Features

• 📦 Query product information from Ribbit protocol
• 📂 Manage local CASC storage (placeholder)
• ⬇️ Download content using TACT protocol (placeholder)
• 🔍 Inspect NGDP data structures
• 🔐 Download certificates by SKI/hash
• ⚙️ Configuration management
• 💾 Built-in caching for API responses
• 🔄 Automatic fallback from Ribbit to TACT on failures

Installation

cargo install --path .

Usage

Basic Commands

# Show help
ngdp --help

# List all products
ngdp products list

# Filter products by name
ngdp products list --filter wow

# Show product versions
ngdp products versions wow

# Show all regions for a product
ngdp products versions wow --all-regions

# Get product information (specific region)
ngdp products info wow --region eu

# Get product information (all regions)
ngdp products info wow

# Show CDN configuration for a specific region
ngdp products cdns wow --region us

Output Formats

The CLI supports multiple output formats:

# Default text output
ngdp products list

# JSON output
ngdp products list -o json

# Pretty-printed JSON
ngdp products list -o json-pretty

# Raw BPSV format
ngdp products list -o bpsv

Inspect Commands

# Parse and display BPSV data
ngdp inspect bpsv data.bpsv

# Show raw BPSV data
ngdp inspect bpsv data.bpsv --raw

# Inspect from URL
ngdp inspect bpsv https://example.com/data.bpsv

Certificate Commands

# Download a certificate by SKI/hash
ngdp certs download 5168ff90af0207753cccd9656462a212b859723b

# Download and show certificate details
ngdp certs download 5168ff90af0207753cccd9656462a212b859723b --details

# Save certificate to file
ngdp certs download 5168ff90af0207753cccd9656462a212b859723b --output cert.pem

# Download certificate in DER format
ngdp certs download 5168ff90af0207753cccd9656462a212b859723b --output cert.der --cert-format der

# Get certificate details as JSON
ngdp certs download 5168ff90af0207753cccd9656462a212b859723b --details -o json

Configuration

# Show current configuration
ngdp config show

# Get a specific config value
ngdp config get default_region

# Set a config value
ngdp config set default_region eu

# Reset configuration to defaults
ngdp config reset --yes

Caching and Fallback

The CLI includes built-in caching for both Ribbit and TACT API responses with automatic fallback:

# Disable caching for a single command
ngdp products list --no-cache

# Clear all cached data before running command
ngdp products list --clear-cache

Fallback Behavior:

• Primary: Ribbit protocol (TCP-based, official)
• Fallback: TACT HTTP protocol (when Ribbit fails)
• Both protocols return identical BPSV data
• Caching works transparently for both protocols
• SG region automatically falls back to US for TACT

Library Usage

The ngdp-client can also be used as a library:

use ngdp_client::{handle_products, OutputFormat, ProductsCommands};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let cmd = ProductsCommands::List {
        filter: Some("wow".to_string()),
        region: "us".to_string(),
    };

    handle_products(cmd, OutputFormat::Json).await?;
    Ok(())
}

Examples

See the examples/ directory for more usage examples.

Development

Running Tests

cargo test

Running Benchmarks

cargo bench

📄 License

This project is dual-licensed under either:

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT license (LICENSE-MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

🫶 Acknowledgments

This crate is part of the cascette-rs project, providing tools for World of Warcraft emulation development.