medea-jason 0.9.1

Client library for Medea media server.
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

//! Rust side representation of a Dart side [`List`].
//!
//! [`List`]: https://api.dart.dev/stable/dart-core/List-class.html

use dart_sys::Dart_Handle;
use derive_more::with_trait::From;
use medea_macro::dart_bridge;

use crate::{
    api::DartValue,
    platform::dart::utils::{NonNullDartValueArgExt as _, handle::DartHandle},
};

#[dart_bridge("flutter/lib/src/native/ffi/list.g.dart")]
mod list {
    use std::ptr;

    use dart_sys::Dart_Handle;

    use crate::{
        api::{DartValue, DartValueArg},
        platform::{Error, dart::utils::handle::DartHandle},
    };

    extern "C" {
        /// Returns an element by the provided `index` from the provided
        /// [`List`].
        ///
        /// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
        pub fn get(
            list: Dart_Handle,
            index: u32,
        ) -> Result<ptr::NonNull<DartValueArg<Option<DartHandle>>>, Error>;

        /// Returns [`length`] of the provided [`List`].
        ///
        /// [`length`]: https://api.dart.dev/stable/dart-core/List/length.html
        /// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
        pub fn length(list: Dart_Handle) -> Result<u32, Error>;

        /// Initializes a new empty [`List`].
        ///
        /// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
        pub fn init() -> Result<Dart_Handle, Error>;

        /// Adds the provided [`DartValue`] to the provided [`List`].
        ///
        /// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
        pub fn add(map: Dart_Handle, value: DartValue) -> Result<(), Error>;
    }
}

/// Rust side representation of a Dart side [`List`].
///
/// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
#[derive(Debug, From)]
pub struct DartList(DartHandle);

impl DartList {
    /// Creates a new empty [`DartList`].
    #[must_use]
    pub fn new() -> Self {
        let map = unsafe { list::init() }.unwrap();

        Self(unsafe { DartHandle::new(map) })
    }

    /// Adds the provided [`DartValue`] to the end of this [`DartList`],
    /// extending the length by one.
    pub fn add(&mut self, value: DartValue) {
        unsafe { list::add(self.0.get(), value) }.unwrap();
    }

    /// Returns an element by the provided `index` from this [`DartList`].
    #[expect(clippy::unwrap_in_result, reason = "unrelated")]
    #[must_use]
    pub fn get(&self, index: usize) -> Option<DartHandle> {
        #[expect( // intended
            clippy::cast_possible_truncation,
            reason = "overflow is unexpected"
        )]
        let item_ptr =
            unsafe { list::get(self.0.get(), index as u32) }.unwrap();
        unsafe { item_ptr.unbox() }.try_into().unwrap()
    }

    /// Returns [`length`] of this [`DartList`].
    ///
    /// [`length`]: https://api.dart.dev/stable/dart-core/List/length.html
    #[must_use]
    pub fn length(&self) -> usize {
        unsafe { list::length(self.0.get()).unwrap() as usize }
    }

    /// Returns the underlying [`Dart_Handle`] of this [`DartList`].
    #[must_use]
    pub fn handle(&self) -> Dart_Handle {
        self.0.get()
    }
}

impl<T: From<DartHandle>> From<DartList> for Vec<T> {
    fn from(list: DartList) -> Self {
        let len = list.length();
        let mut out = Self::with_capacity(len);
        for i in 0..len {
            if let Some(v) = list.get(i) {
                out.push(v.into());
            }
        }
        out
    }
}

impl Default for DartList {
    fn default() -> Self {
        Self::new()
    }
}