sark-json 0.21.0

Borrowed JSON decoding and streaming encoding for sark
Documentation 
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

use std::{num::NonZero, task::Poll};

use crate::segment::{Admitted, Document, Outcome, input::Split};

/// Retains the source document until its admitted child transfer completes.
pub struct Project<'d> {
    pub(in crate::segment) doc: Document<'d>,
    parts: Option<Split<'d>>,
    field: usize,
    error: Option<Result<(), crate::parsing::Error<'d>>>,
}

impl<'d> Project<'d> {
    pub(in crate::segment) fn new(doc: Document<'d>, field: usize) -> Self {
        Self {
            doc,
            parts: None,
            field,
            error: None,
        }
    }

    pub(in crate::segment) fn with_parts(doc: Document<'d>, parts: Split<'d>) -> Self {
        Self {
            doc,
            parts: Some(parts),
            field: 0,
            error: None,
        }
    }

    pub fn release(&mut self, budget: &mut usize) -> Poll<()> {
        self.error.get_or_insert(Ok(()));
        if let Some(parts) = &mut self.parts
            && parts.release(budget).is_pending()
        {
            return Poll::Pending;
        }
        self.doc.retire(budget)
    }

    pub fn step(
        mut self,
        budget: NonZero<usize>,
    ) -> Outcome<'d, Self, (Document<'d>, Admitted<'d>)> {
        let mut left = budget.get();
        if self.error.is_some() {
            if self.release(&mut left).is_pending() {
                return Outcome::Pending(self);
            }
            if let Some(Err(error)) = self.error {
                return Outcome::Failed(error);
            }
            return Outcome::Pending(self);
        }
        match self.try_step(&mut left) {
            Ok(None) => Outcome::Pending(self),
            Ok(Some(input)) => Outcome::Ready((self.doc, Admitted { input })),
            Err(error) => {
                self.error = Some(Err(error.into()));
                Outcome::Pending(self)
            }
        }
    }

    fn try_step(
        &mut self,
        budget: &mut usize,
    ) -> crate::Result<Option<super::super::input::Input<'d>>> {
        if self.parts.is_none() {
            let value = self.doc.field(self.field)?.ok_or(crate::Error::Invalid)?;
            self.parts = Some(value.split()?);
        }
        match &mut self.parts {
            Some(parts) => parts.step(&self.doc.input, budget),
            None => Ok(None),
        }
    }
}