Crate dxr

dxr

This crate provides an implementation of XML-RPC types, (de)serialization support, and conversion between XML-RPC values and Rust values (with optional support for non-standard i8 and nil types, which can be enabled with the respective feature flags).

Support for writing XML-RPC clients / servers is provided in separate crates:

• dxr_client: generic XML-RPC client code and a default implementation based on reqwest
• dxr_server: generic XML-RPC server code and a default implementation based on axum

The table below lists XML-RPC types and their equivalent Rust types.

XML-RPC value type	Rust type
i4	i32
i8	i64
boolean	bool
string	String / &str
double	f64
dateTime.iso8601	chrono::NaiveDateTime
base64	Vec<u8>
nil	Option<T>

Additionally, the TryFromValue and TryToValue traits (which implement the conversion between XML-RPC value types and Rust types) are implemented for

• Vec<T>, slices &[T], and fixed-size arrays [T; N],
• smart pointer types like Box<T>, Cow<T>, Rc<T>, and Arc<T>,
• mappings like HashMap<String, T> / HashMap<&str, T>,
• tuples (T, ...) with up to eight members

(as long as the inner type T also implement these traits).

Features

This crate provides optional features, all of which are disabled by default:

• derive: include procedural macros for deriving the TryFromValue and TryToValue traits for custom structs
• i8: enable support for the non-standard i8 value type
• nil: enable support for the non-standard nil value type

Re-exports

• pub use chrono;

Structs

• Fault
  XML-RPC server fault (consisting of a numeric error code and a message)
• FaultResponse
  XML-RPC fault response type
• MethodCall
  XML-RPC method call type
• MethodResponse
  XML-RPC method response type
• Value
  XML-RPC value type

Enums

• DxrError
  Error type representing conversion errors between XML-RPC values and Rust values.

Constants

• XML_RPC_DATE_FORMAT
  Date & time format used by the XML-RPC dateTime.iso8601 value type

Traits

• TryFromParams
  Trait for converting from XML-RPC method call argument lists to Rust values.
• TryFromValue
  Trait for converting from XML-RPC values to Rust values.
• TryToParams
  Trait for converting from Rust values to XML-RPC method call arguments.
• TryToValue
  Trait for converting from Rust values to XML-RPC values.

Functions

• deserialize_xml
  Function for deserializing values from XML.
• from_multicall_paramsmulticall
  Convenience method for reconstructing method calls from “system.multicall” arguments.
• into_multicall_paramsmulticall
  Convenience method for constructing arguments for “system.multicall” calls.
• into_multicall_responsemulticall
  Convenience method for constructing return values for “system.multicall” calls.
• serialize_xml
  Custom function for serializing values as XML.

Derive Macros

• TryFromValuederive
  Procedural macro for deriving an implementation of the TryFromValue trait for structs.
• TryToValuederive
  Procedural macro for deriving an implementation of the TryToValue trait for structs.