manydns

A Rust library providing a provider-agnostic API for managing DNS zones and records.

Overview

manydns defines abstract traits for DNS zone and record management, with concrete implementations for multiple DNS providers. The API design is inspired by the Go libdns project, adapting its conventions for Rust idioms while maintaining familiar semantics for developers coming from that ecosystem.

Installation

Add manydns to your project with the provider you need:

[dependencies]
manydns = { version = "1.0", features = ["cloudflare"] }

Quick Start

use manydns::{Provider, Zone, CreateRecord, DeleteRecord, RecordData};
use manydns::cloudflare::CloudflareProvider;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    // Create a provider with your API credentials
    let provider = CloudflareProvider::new("your_api_token")?;

    // Get a zone by domain name
    let zone = provider.get_zone("example.com").await?;
    println!("Zone: {} (ID: {})", zone.domain(), zone.id());

    // List all records in the zone
    let records = zone.list_records().await?;
    for record in &records {
        println!("  {} {} -> {:?}", record.host, record.data.get_type(), record.data);
    }

    // Create a new A record
    let record = zone.create_record(
        "www",                                    // host (use "@" for apex)
        &RecordData::A("192.0.2.1".parse()?),    // record data
        300,                                      // TTL in seconds
    ).await?;
    println!("Created record: {}", record.id);

    // Delete a record by ID
    zone.delete_record(&record.id).await?;

    Ok(())
}

Supported Providers

Enable providers via feature flags:

Core Traits

The library uses a capability-based trait design:

// Provider: entry point for zone access
pub trait Provider {
    type Zone: Zone;
    async fn list_zones(&self) -> Result<Vec<Self::Zone>, ...>;
    async fn get_zone(&self, zone_id: &str) -> Result<Self::Zone, ...>;
}

// Zone: record management within a zone
pub trait Zone {
    fn id(&self) -> &str;
    fn domain(&self) -> &str;
    async fn list_records(&self) -> Result<Vec<Record>, ...>;
    async fn get_record(&self, record_id: &str) -> Result<Record, ...>;
}

// Optional capabilities
pub trait CreateRecord: Zone { ... }
pub trait DeleteRecord: Zone { ... }
pub trait CreateZone: Provider { ... }
pub trait DeleteZone: Provider { ... }

Record Types

Supported DNS record types:

• A - IPv4 address
• AAAA - IPv6 address
• CNAME - Canonical name (alias)
• MX - Mail exchange
• NS - Name server
• TXT - Text record
• SRV - Service record
• Other - Pass-through for provider-specific types

Record Naming Convention

Record names are relative to the zone, following the same convention as Go libdns:

• "www" refers to www.example.com in zone example.com
• "@" refers to the zone apex (example.com itself)
• "sub.domain" refers to sub.domain.example.com

Network Configuration

All providers support HttpClientConfig for controlling outbound connections:

use manydns::HttpClientConfig;
use manydns::cloudflare::CloudflareProvider;

// Bind to a specific source IP address
let config = HttpClientConfig::new()
    .local_address("192.168.1.100".parse().unwrap())
    .timeout(std::time::Duration::from_secs(60));

let provider = CloudflareProvider::with_config("your_api_token", config)?;

Available options:

• local_address(IpAddr) - Bind outgoing connections to a specific local IP
• interface(&str) - Bind to a network interface (Linux/macOS only, e.g., "eth0")
• timeout(Duration) - Set request timeout

TLS Backend

Provider implementations use reqwest for HTTP. By default, default-tls is enabled. Alternative backends:

# Use rustls instead of native TLS
manydns = { version = "1.0", default-features = false, features = ["rustls-tls", "cloudflare"] }

Available: default-tls (default), rustls-tls, native-tls, native-tls-vendored

Comparison with Go libdns

This library adapts the Go libdns API for Rust:

Record naming conventions (@ for apex, relative names) are intentionally identical.

Contributing

Contributions welcome! See the existing provider implementations for patterns to follow when adding new providers.

License

0BSD