Struct Dsn 

pub struct Dsn { /* private fields */ }

Parsed DSN (Data Source Name) for Geode connections.

Contains all connection parameters extracted from a DSN string.

Implementations

impl Dsn

pub fn parse(dsn: &str) -> Result<Self>

Parse a DSN string into a Dsn struct.

Supported formats

• quic://host:port?options - QUIC transport (recommended)
• grpc://host:port?options - gRPC transport
• host:port?options - Defaults to QUIC

Supported options (query parameters)

• tls - Enable/disable TLS (0/1/true/false, default: true)
• insecure, skip_verify, insecure_skip_verify - Skip TLS verification
• page_size - Results page size (default: 1000)
• client_name or hello_name - Client name
• client_version or hello_ver - Client version
• conformance - GQL conformance level
• username or user - Authentication username
• password or pass - Authentication password
• ca or ca_cert - Path to CA certificate
• cert or client_cert - Path to client certificate (mTLS)
• key or client_key - Path to client key (mTLS)
• server_name - SNI server name
• connect_timeout or timeout - Connection timeout in seconds

Errors

Returns Error::InvalidDsn if:

• DSN is empty
• Scheme is unsupported
• Host is missing
• Port is invalid

Examples

use geode_client::dsn::Dsn;

let dsn = Dsn::parse("quic://localhost:3141").unwrap();
let dsn = Dsn::parse("grpc://127.0.0.1:50051?tls=0").unwrap();
let dsn = Dsn::parse("grpc://[::1]:50051").unwrap();

pub fn transport(&self) -> Transport

Get the transport protocol.

pub fn host(&self) -> &str

Get the host.

pub fn port(&self) -> u16

Get the port.

pub fn username(&self) -> Option<&str>

Get the username if specified.

pub fn password(&self) -> Option<&str>

Get the password if specified.

pub fn tls_enabled(&self) -> bool

Check if TLS is enabled.

pub fn skip_verify(&self) -> bool

Check if TLS verification should be skipped.

pub fn page_size(&self) -> usize

Get the page size.

pub fn client_name(&self) -> &str

Get the client name.

pub fn client_version(&self) -> &str

Get the client version.

pub fn conformance(&self) -> &str

Get the conformance level.

pub fn options(&self) -> &HashMap<String, String>

Get additional options.

pub fn ca_cert(&self) -> Option<&str>

Get the CA certificate path if specified.

pub fn client_cert(&self) -> Option<&str>

Get the client certificate path if specified.

pub fn client_key(&self) -> Option<&str>

Get the client key path if specified.

pub fn server_name(&self) -> Option<&str>

Get the SNI server name if specified.

pub fn connect_timeout_secs(&self) -> Option<u64>

Get the connection timeout in seconds if specified.

pub fn address(&self) -> String

Get the host:port address string.

Trait Implementations

impl Clone for Dsn

fn clone(&self) -> Dsn

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Dsn

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Dsn

fn default() -> Self

Returns the “default value” for a type.