Vendor dependencies

notes-service/vendor/dyn-clone/src/lib.rs

@@ -0,0 +1,218 @@
+//! [![github]](https://github.com/dtolnay/dyn-clone) [![crates-io]](https://crates.io/crates/dyn-clone) [![docs-rs]](https://docs.rs/dyn-clone)
+//!
+//! [github]: https://img.shields.io/badge/github-8da0cb?style=for-the-badge&labelColor=555555&logo=github
+//! [crates-io]: https://img.shields.io/badge/crates.io-fc8d62?style=for-the-badge&labelColor=555555&logo=rust
+//! [docs-rs]: https://img.shields.io/badge/docs.rs-66c2a5?style=for-the-badge&labelColor=555555&logo=docs.rs
+//!
+//! <br>
+//!
+//! This crate provides a [`DynClone`] trait that can be used in trait objects,
+//! and a [`clone_box`] function that can clone any sized or dynamically sized
+//! implementation of `DynClone`. Types that implement the standard library's
+//! [`std::clone::Clone`] trait are automatically usable by a `DynClone` trait
+//! object.
+//!
+//! # Example
+//!
+//! ```
+//! use dyn_clone::DynClone;
+//!
+//! trait MyTrait: DynClone {
+//!     fn recite(&self);
+//! }
+//!
+//! impl MyTrait for String {
+//!     fn recite(&self) {
+//!         println!("{} ♫", self);
+//!     }
+//! }
+//!
+//! fn main() {
+//!     let line = "The slithy structs did gyre and gimble the namespace";
+//!
+//!     // Build a trait object holding a String.
+//!     // This requires String to implement MyTrait and std::clone::Clone.
+//!     let x: Box<dyn MyTrait> = Box::new(String::from(line));
+//!
+//!     x.recite();
+//!
+//!     // The type of x2 is a Box<dyn MyTrait> cloned from x.
+//!     let x2 = dyn_clone::clone_box(&*x);
+//!
+//!     x2.recite();
+//! }
+//! ```
+//!
+//! This crate includes a macro for concisely implementing `impl
+//! std::clone::Clone for Box<dyn MyTrait>` in terms of `dyn_clone::clone_box`.
+//!
+//! ```
+//! # use dyn_clone::DynClone;
+//! #
+//! // As before.
+//! trait MyTrait: DynClone {
+//!     /* ... */
+//! }
+//!
+//! dyn_clone::clone_trait_object!(MyTrait);
+//!
+//! // Now data structures containing Box<dyn MyTrait> can derive Clone:
+//! #[derive(Clone)]
+//! struct Container {
+//!     trait_object: Box<dyn MyTrait>,
+//! }
+//! ```
+//!
+//! The `clone_trait_object!` macro expands to just the following, which you can
+//! handwrite instead if you prefer:
+//!
+//! ```
+//! # use dyn_clone::DynClone;
+//! #
+//! # trait MyTrait: DynClone {}
+//! #
+//! impl Clone for Box<dyn MyTrait> {
+//!     fn clone(&self) -> Self {
+//!         dyn_clone::clone_box(&**self)
+//!     }
+//! }
+//!
+//! // and similar for Box<dyn MyTrait + Send>, Box<dyn MyTrait + Sync>, Box<dyn MyTrait + Send + Sync>
+//! ```
+
+#![doc(html_root_url = "https://docs.rs/dyn-clone/1.0.20")]
+#![no_std]
+#![allow(
+    clippy::missing_panics_doc,
+    clippy::needless_doctest_main,
+    clippy::ptr_as_ptr
+)]
+
+extern crate alloc;
+
+#[cfg(doc)]
+extern crate core as std;
+
+#[macro_use]
+mod macros;
+
+// Not public API.
+#[doc(hidden)]
+pub mod __private {
+    #[doc(hidden)]
+    pub use core::clone::Clone;
+    #[doc(hidden)]
+    pub use core::marker::{Send, Sync};
+
+    #[doc(hidden)]
+    pub type Box<T> = alloc::boxed::Box<T>;
+}
+
+mod sealed {
+    pub trait Sealed {}
+    impl<T: Clone> Sealed for T {}
+    impl Sealed for str {}
+    impl<T: Clone> Sealed for [T] {}
+    pub struct Private;
+}
+
+use crate::sealed::{Private, Sealed};
+use alloc::boxed::Box;
+use alloc::rc::Rc;
+#[cfg(target_has_atomic = "ptr")]
+use alloc::sync::Arc;
+use core::ptr;
+
+/// This trait is implemented by any type that implements [`std::clone::Clone`].
+pub trait DynClone: Sealed {
+    // Not public API
+    #[doc(hidden)]
+    fn __clone_box(&self, _: Private) -> *mut ();
+}
+
+/// `&T`&ensp;&mdash;&blacktriangleright;&ensp;`T`
+pub fn clone<T>(t: &T) -> T
+where
+    T: DynClone,
+{
+    unsafe { *Box::from_raw(<T as DynClone>::__clone_box(t, Private) as *mut T) }
+}
+
+/// `&T`&ensp;&mdash;&blacktriangleright;&ensp;`Box<T>`
+pub fn clone_box<T>(t: &T) -> Box<T>
+where
+    T: ?Sized + DynClone,
+{
+    let mut fat_ptr = t as *const T;
+    unsafe {
+        let data_ptr = ptr::addr_of_mut!(fat_ptr) as *mut *mut ();
+        assert_eq!(*data_ptr as *const (), t as *const T as *const ());
+        *data_ptr = <T as DynClone>::__clone_box(t, Private);
+    }
+    unsafe { Box::from_raw(fat_ptr as *mut T) }
+}
+
+/// `&mut Arc<T>`&ensp;&mdash;&blacktriangleright;&ensp;`&mut T`
+#[cfg(target_has_atomic = "ptr")]
+pub fn arc_make_mut<T>(arc: &mut Arc<T>) -> &mut T
+where
+    T: ?Sized + DynClone,
+{
+    // Atomic. Find out whether the Arc in the argument is the single holder of
+    // a reference count (strong or weak) on the target object. If yes, it is
+    // guaranteed to remain that way throughout the rest of this function
+    // because no other threads could bump the reference count through any other
+    // Arc (because no others exist) or through this Arc (because the current
+    // thread holds an exclusive borrow of it).
+    let is_unique = Arc::get_mut(arc).is_some();
+    if !is_unique {
+        // Non-atomic.
+        let clone = Arc::from(clone_box(&**arc));
+        // Atomic. Check the reference counts again to find out whether the old
+        // object needs to be dropped. Probably not, but it can happen if all
+        // the other holders of a reference count went away during the time that
+        // the clone operation took.
+        *arc = clone;
+    }
+    // Non-atomic. TODO: replace with Arc::get_mut_unchecked when stable.
+    let ptr = Arc::as_ptr(arc) as *mut T;
+    unsafe { &mut *ptr }
+}
+
+/// `&mut Rc<T>`&ensp;&mdash;&blacktriangleright;&ensp;`&mut T`
+pub fn rc_make_mut<T>(rc: &mut Rc<T>) -> &mut T
+where
+    T: ?Sized + DynClone,
+{
+    let is_unique = Rc::get_mut(rc).is_some();
+    if !is_unique {
+        let clone = Rc::from(clone_box(&**rc));
+        *rc = clone;
+    }
+    let ptr = Rc::as_ptr(rc) as *mut T;
+    unsafe { &mut *ptr }
+}
+
+impl<T> DynClone for T
+where
+    T: Clone,
+{
+    fn __clone_box(&self, _: Private) -> *mut () {
+        Box::<T>::into_raw(Box::new(self.clone())) as *mut ()
+    }
+}
+
+impl DynClone for str {
+    fn __clone_box(&self, _: Private) -> *mut () {
+        Box::<str>::into_raw(Box::from(self)) as *mut ()
+    }
+}
+
+impl<T> DynClone for [T]
+where
+    T: Clone,
+{
+    fn __clone_box(&self, _: Private) -> *mut () {
+        Box::<[T]>::into_raw(self.iter().cloned().collect()) as *mut ()
+    }
+}

notes-service/vendor/dyn-clone/src/macros.rs

@@ -0,0 +1,121 @@
+use crate::DynClone;
+
+/// Implement the standard library `Clone` for a trait object that has
+/// `DynClone` as a supertrait.
+///
+/// ```
+/// use dyn_clone::DynClone;
+///
+/// trait MyTrait: DynClone {
+///     /* ... */
+/// }
+///
+/// dyn_clone::clone_trait_object!(MyTrait);
+///
+/// // Now data structures containing Box<dyn MyTrait> can derive Clone.
+/// #[derive(Clone)]
+/// struct Container {
+///     trait_object: Box<dyn MyTrait>,
+/// }
+/// ```
+///
+/// The macro supports traits that have type parameters and/or `where` clauses.
+///
+/// ```
+/// use dyn_clone::DynClone;
+/// use std::io::Read;
+///
+/// trait Difficult<R>: DynClone where R: Read {
+///     /* ... */
+/// }
+///
+/// dyn_clone::clone_trait_object!(<R> Difficult<R> where R: Read);
+/// ```
+#[macro_export]
+macro_rules! clone_trait_object {
+    ($($path:tt)+) => {
+        $crate::__internal_clone_trait_object!(begin $($path)+);
+    };
+}
+
+#[doc(hidden)]
+#[macro_export]
+macro_rules! __internal_clone_trait_object {
+    // Invocation started with `<`, parse generics.
+    (begin < $($rest:tt)*) => {
+        $crate::__internal_clone_trait_object!(generics () () $($rest)*);
+    };
+
+    // Invocation did not start with `<`.
+    (begin $first:tt $($rest:tt)*) => {
+        $crate::__internal_clone_trait_object!(path () ($first) $($rest)*);
+    };
+
+    // End of generics.
+    (generics ($($generics:tt)*) () > $($rest:tt)*) => {
+        $crate::__internal_clone_trait_object!(path ($($generics)*) () $($rest)*);
+    };
+
+    // Generics open bracket.
+    (generics ($($generics:tt)*) ($($brackets:tt)*) < $($rest:tt)*) => {
+        $crate::__internal_clone_trait_object!(generics ($($generics)* <) ($($brackets)* <) $($rest)*);
+    };
+
+    // Generics close bracket.
+    (generics ($($generics:tt)*) (< $($brackets:tt)*) > $($rest:tt)*) => {
+        $crate::__internal_clone_trait_object!(generics ($($generics)* >) ($($brackets)*) $($rest)*);
+    };
+
+    // Token inside of generics.
+    (generics ($($generics:tt)*) ($($brackets:tt)*) $first:tt $($rest:tt)*) => {
+        $crate::__internal_clone_trait_object!(generics ($($generics)* $first) ($($brackets)*) $($rest)*);
+    };
+
+    // End with `where` clause.
+    (path ($($generics:tt)*) ($($path:tt)*) where $($rest:tt)*) => {
+        $crate::__internal_clone_trait_object!(impl ($($generics)*) ($($path)*) ($($rest)*));
+    };
+
+    // End without `where` clause.
+    (path ($($generics:tt)*) ($($path:tt)*)) => {
+        $crate::__internal_clone_trait_object!(impl ($($generics)*) ($($path)*) ());
+    };
+
+    // Token inside of path.
+    (path ($($generics:tt)*) ($($path:tt)*) $first:tt $($rest:tt)*) => {
+        $crate::__internal_clone_trait_object!(path ($($generics)*) ($($path)* $first) $($rest)*);
+    };
+
+    // The impl.
+    (impl ($($generics:tt)*) ($($path:tt)*) ($($bound:tt)*)) => {
+        #[allow(unknown_lints, non_local_definitions)] // false positive: https://github.com/rust-lang/rust/issues/121621
+        impl<'clone, $($generics)*> $crate::__private::Clone for $crate::__private::Box<dyn $($path)* + 'clone> where $($bound)* {
+            fn clone(&self) -> Self {
+                $crate::clone_box(&**self)
+            }
+        }
+
+        #[allow(unknown_lints, non_local_definitions)]
+        impl<'clone, $($generics)*> $crate::__private::Clone for $crate::__private::Box<dyn $($path)* + $crate::__private::Send + 'clone> where $($bound)* {
+            fn clone(&self) -> Self {
+                $crate::clone_box(&**self)
+            }
+        }
+
+        #[allow(unknown_lints, non_local_definitions)]
+        impl<'clone, $($generics)*> $crate::__private::Clone for $crate::__private::Box<dyn $($path)* + $crate::__private::Sync + 'clone> where $($bound)* {
+            fn clone(&self) -> Self {
+                $crate::clone_box(&**self)
+            }
+        }
+
+        #[allow(unknown_lints, non_local_definitions)]
+        impl<'clone, $($generics)*> $crate::__private::Clone for $crate::__private::Box<dyn $($path)* + $crate::__private::Send + $crate::__private::Sync + 'clone> where $($bound)* {
+            fn clone(&self) -> Self {
+                $crate::clone_box(&**self)
+            }
+        }
+    };
+}
+
+clone_trait_object!(DynClone);