Skip to main content

DagCbor

Enum DagCbor 

Source
pub enum DagCbor {
    Null,
    Bool(bool),
    Unsigned(u64),
    Negative(i128),
    Bytes(Vec<u8>),
    Text(String),
    List(Vec<DagCbor>),
    Map(Vec<(DagCbor, DagCbor)>),
    Link(Cid),
}
Expand description

A typed DAG-CBOR value.

Construction is deliberate (no From<&str> footguns): callers build the exact shape they need via DagCbor::map / DagCbor::list / etc., so the determinism rules (sorted keys, minimal ints, tag-42 links) are enforced at encode time rather than relying on the input order.

Variants§

§

Null

§

Bool(bool)

§

Unsigned(u64)

Non-negative integer (CBOR major 0).

§

Negative(i128)

Negative integer (CBOR major 1); -1 - n.

Invariant: the wrapped value MUST be < 0. The variant encodes as CBOR major type 1 (-1 - n); a non-negative n has no valid encoding there and is a programmer error caught (loudly, in release too) at DagCbor::encode. Construct negatives via literal i128 values (DagCbor::Negative(-1)) — never compute Negative(x) from an unbounded x without first checking x < 0.

§

Bytes(Vec<u8>)

Byte string (major 2).

§

Text(String)

UTF-8 text string (major 3).

§

List(Vec<DagCbor>)

Array (major 4), in given order.

§

Map(Vec<(DagCbor, DagCbor)>)

Map (major 5). Keys are stored in the existing native lexical text-byte order at construction; public AT ordering is applied by crate::atproto_cbor at its explicit boundary.

CID link — encoded as CBOR tag 42.

Implementations§

Source§

impl DagCbor

Source

pub fn map() -> Self

Convenience: empty map.

Source

pub fn str_map( pairs: impl IntoIterator<Item = (impl Into<String>, DagCbor)>, ) -> Self

Convenience: build a map from key/value string pairs, sorted canonically.

Only string keys are supported here (the common case for records/commits). For non-string keys build the Map variant manually.

Source

pub fn list(items: impl IntoIterator<Item = DagCbor>) -> Self

Convenience: build a list.

Source

pub fn encode(&self) -> Vec<u8> ⓘ

Encode to canonical DAG-CBOR bytes.

Source

pub fn decode(input: &[u8]) -> Result<Self>

Decode canonical DAG-CBOR bytes, enforcing the determinism constraints: sorted text keys, no duplicates, bounded recursion, and minimal integer and length widths on the wire.

Source

pub fn as_str(&self) -> Result<&str>

Source

pub fn as_bytes(&self) -> Result<&[u8]>

Source

pub fn as_unsigned(&self) -> Result<u64>

Source

pub fn as_map(&self) -> Result<&[(DagCbor, DagCbor)]>

Source

pub fn as_list(&self) -> Result<&[DagCbor]>

Source

pub fn get(&self, key: &str) -> Option<&DagCbor>

Look up a string-keyed entry in a map.

Source

pub fn is_null(&self) -> bool

Trait Implementations§

Source§

impl Clone for DagCbor

Source§

fn clone(&self) -> DagCbor

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for DagCbor

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for DagCbor

Source§

fn eq(&self, other: &DagCbor) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl StructuralPartialEq for DagCbor

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
§

impl<T> ServiceExt for T

§

fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>
where Self: Sized,

Apply a transformation to the response body. Read more
§

fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using HTTP status codes. Read more
§

fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using gRPC headers. Read more
§

fn follow_redirects(self) -> FollowRedirect<Self>
where Self: Sized,

Follow redirect resposes using the Standard policy. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> TerminalState for T
where T: Clone + Send + Sync,