Introduce from_str_owned in the json module

merde_core/src/error.rs

@@ -2,7 +2,7 @@
 // Error Handling and Field Type
 // -------------------------------------------------------------------------
 
-use crate::{deserialize2::EventType, CowStr, IntoStatic, Value};
+use crate::{deserialize::EventType, CowStr, IntoStatic, Value};
 
 /// A content-less variant of the [`Value`] enum, used for reporting errors, see [`MerdeError::MismatchedType`].
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]

merde_core/src/lib.rs

@@ -20,13 +20,13 @@ pub use with_lifetime::WithLifetime;
 mod value;
 pub use value::Value;
 
-mod deserialize2;
-pub use deserialize2::ArrayStart;
-pub use deserialize2::Deserialize;
-pub use deserialize2::DeserializeOwned;
-pub use deserialize2::Deserializer;
-pub use deserialize2::Event;
-pub use deserialize2::EventType;
+mod deserialize;
+pub use deserialize::ArrayStart;
+pub use deserialize::Deserialize;
+pub use deserialize::DeserializeOwned;
+pub use deserialize::Deserializer;
+pub use deserialize::Event;
+pub use deserialize::EventType;
 
 rubicon::compatibility_check! {
     ("merde_core_pkg_version", env!("CARGO_PKG_VERSION")),

merde_json/src/deserialize2.rs → merde_json/src/deserialize.rs

@@ -204,7 +204,7 @@ pub(crate) fn cowify<'j>(src: &'j [u8], s: &str) -> CowStr<'j> {
 
 #[cfg(test)]
 mod tests {
-    use crate::deserialize2::cowify;
+    use crate::deserialize::cowify;
 
     use super::JsonDeserializer;
     use merde_core::{Array, CowStr, Deserialize, Deserializer, Event, EventType, Map, MerdeError};

merde_json/src/lib.rs

@@ -1,13 +1,15 @@
 #![deny(missing_docs)]
 #![doc = include_str!("../README.md")]
 
-mod deserialize2;
-pub use deserialize2::JsonDeserializer;
+mod deserialize;
+pub use deserialize::JsonDeserializer;
 
 mod jiter_lite;
 
 use jiter_lite::errors::JiterError;
-use merde_core::{Array, CowStr, Deserialize, Deserializer, IntoStatic, Map, MerdeError, Value};
+use merde_core::{
+    Array, CowStr, Deserialize, DeserializeOwned, Deserializer, IntoStatic, Map, MerdeError, Value,
+};
 
 use std::borrow::Cow;
 use std::collections::HashMap;
@@ -604,6 +606,16 @@ where
     deser.deserialize::<T>()
 }
 
+/// Deserialize an instance of type `T` from a string of JSON text,
+/// and return its static variant e.g. (CowStr<'static>, etc.)
+pub fn from_str_owned<T>(s: &str) -> Result<T, MerdeJsonError<'_>>
+where
+    T: DeserializeOwned,
+{
+    let mut deser = JsonDeserializer::new(s);
+    T::deserialize_owned(&mut deser)
+}
+
 /// Serialize the given data structure as a String of JSON.
 pub fn to_string<T: JsonSerialize>(value: &T) -> String {
     value.to_json_string()