1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51
//! This crate provides convenient traits and functions //! for converting between TOML and serializable values. //! //! # Examples //! //! Converts from a TOML string to a serializable value: //! //! ``` //! extern crate serde; //! #[macro_use] //! extern crate serde_derive; //! extern crate tomlconv; //! //! use tomlconv::FromToml; //! //! // Defines a deserializable struct. //! #[derive(Deserialize)] //! struct Foo { //! bar: String, //! baz: usize //! } //! impl FromToml for Foo {} //! //! # fn main() { //! // Converts from the TOML string to a `Foo` value. //! let toml = r#" //! bar = "aaa" //! baz = 123 //! "#; //! let foo = Foo::from_toml_str(toml).unwrap(); //! assert_eq!(foo.bar, "aaa"); //! assert_eq!(foo.baz, 123); //! # } //! ``` #![warn(missing_docs)] extern crate serde; extern crate toml; #[macro_use] extern crate trackable; pub use convert::{from_toml, from_toml_str, from_toml_reader, from_toml_file}; pub use convert::{to_toml, to_toml_string, to_toml_writer, to_toml_file}; pub use error::{Error, ErrorKind}; pub use traits::{FromToml, ToToml}; mod convert; mod error; mod traits; /// A specialized `Result` type for this crate. pub type Result<T> = ::std::result::Result<T, Error>;