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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

//! [<img alt="github" src="https://img.shields.io/badge/github-udoprog/musli-8da0cb?style=for-the-badge&logo=github" height="20">](https://github.com/udoprog/musli)
//! [<img alt="crates.io" src="https://img.shields.io/crates/v/musli-value.svg?style=for-the-badge&color=fc8d62&logo=rust" height="20">](https://crates.io/crates/musli-value)
//! [<img alt="docs.rs" src="https://img.shields.io/badge/docs.rs-musli--value-66c2a5?style=for-the-badge&logoColor=white&logo=data:image/svg+xml;base64,PHN2ZyByb2xlPSJpbWciIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgdmlld0JveD0iMCAwIDUxMiA1MTIiPjxwYXRoIGZpbGw9IiNmNWY1ZjUiIGQ9Ik00ODguNiAyNTAuMkwzOTIgMjE0VjEwNS41YzAtMTUtOS4zLTI4LjQtMjMuNC0zMy43bC0xMDAtMzcuNWMtOC4xLTMuMS0xNy4xLTMuMS0yNS4zIDBsLTEwMCAzNy41Yy0xNC4xIDUuMy0yMy40IDE4LjctMjMuNCAzMy43VjIxNGwtOTYuNiAzNi4yQzkuMyAyNTUuNSAwIDI2OC45IDAgMjgzLjlWMzk0YzAgMTMuNiA3LjcgMjYuMSAxOS45IDMyLjJsMTAwIDUwYzEwLjEgNS4xIDIyLjEgNS4xIDMyLjIgMGwxMDMuOS01MiAxMDMuOSA1MmMxMC4xIDUuMSAyMi4xIDUuMSAzMi4yIDBsMTAwLTUwYzEyLjItNi4xIDE5LjktMTguNiAxOS45LTMyLjJWMjgzLjljMC0xNS05LjMtMjguNC0yMy40LTMzLjd6TTM1OCAyMTQuOGwtODUgMzEuOXYtNjguMmw4NS0zN3Y3My4zek0xNTQgMTA0LjFsMTAyLTM4LjIgMTAyIDM4LjJ2LjZsLTEwMiA0MS40LTEwMi00MS40di0uNnptODQgMjkxLjFsLTg1IDQyLjV2LTc5LjFsODUtMzguOHY3NS40em0wLTExMmwtMTAyIDQxLjQtMTAyLTQxLjR2LS42bDEwMi0zOC4yIDEwMiAzOC4ydi42em0yNDAgMTEybC04NSA0Mi41di03OS4xbDg1LTM4Ljh2NzUuNHptMC0xMTJsLTEwMiA0MS40LTEwMi00MS40di0uNmwxMDItMzguMiAxMDIgMzguMnYuNnoiPjwvcGF0aD48L3N2Zz4K" height="20">](https://docs.rs/musli-value)
//!
//! Value support for [Müsli] suitable for buffering and interchange between
//! formats.
//!
//! [Müsli]: https://github.com/udoprog/musli

#![deny(missing_docs)]
#![no_std]
#![cfg_attr(doc_cfg, feature(doc_cfg))]

#[cfg(feature = "alloc")]
extern crate alloc;

#[cfg(feature = "std")]
extern crate std;

mod de;
mod en;
mod error;
mod type_hint;
mod value;

/// Convenient result alias for use with `musli_value`.
pub type Result<T, E = Error> = core::result::Result<T, E>;

#[doc(inline)]
pub use self::value::{AsValueDecoder, Value};
#[doc(inline)]
pub use error::Error;

use en::ValueEncoder;
use musli::mode::Binary;
use musli::{Decode, Encode};
use musli_utils::Options;

const OPTIONS: Options = musli_utils::options::new().build();

/// Encode something that implements [Encode] into a [Value].
pub fn encode<T>(value: T) -> Result<Value, Error>
where
    T: Encode<Binary>,
{
    use musli::en::Encoder;

    let mut output = Value::Unit;

    musli_utils::allocator::with(|alloc| {
        let cx = musli_utils::context::Same::<_, Binary, Error>::new(&alloc);
        ValueEncoder::<OPTIONS, _, _>::new(&cx, &mut output).encode(value)?;
        Ok(output)
    })
}

/// Decode a [Value] into a type which implements [Decode].
pub fn decode<'de, T>(value: &'de Value) -> Result<T, Error>
where
    T: Decode<'de, Binary>,
{
    use musli::de::Decoder;

    musli_utils::allocator::with(|alloc| {
        let cx = musli_utils::context::Same::<_, Binary, Error>::new(&alloc);
        value.decoder::<OPTIONS, _>(&cx).decode()
    })
}

/// Decode a [Value] into a type which implements [Decode] using a custom
/// context.
pub fn decode_with<'de, C, T>(cx: &C, value: &'de Value) -> Result<T, C::Error>
where
    C: ?Sized + musli::Context,
    T: Decode<'de, C::Mode>,
{
    use musli::de::Decoder;

    cx.clear();
    value.decoder::<OPTIONS, _>(cx).decode()
}