feat: support from_reader (#113)

examples/serde.rs

@@ -1,3 +1,5 @@
+use std::fs::File;
+
 use sonic_rs::{Deserialize, Serialize};
 
 #[derive(Serialize, Deserialize)]
@@ -8,6 +10,7 @@ struct Person {
 }
 
 fn main() {
+    // parse a string
     let data = r#"{
   "name": "Xiaoming",
   "age": 18,
@@ -20,4 +23,12 @@ fn main() {
     assert_eq!(p.name, "Xiaoming");
     let out = sonic_rs::to_string_pretty(&p).unwrap();
     assert_eq!(out, data);
+
+    // parse a file reader
+    let p: Person =
+        sonic_rs::from_reader(File::open("examples/testdata/person.json").unwrap()).unwrap();
+    assert_eq!(p.age, 18);
+    assert_eq!(p.name, "Xiaoming");
+    let out = sonic_rs::to_string_pretty(&p).unwrap();
+    assert_eq!(out, data);
 }

examples/testdata/person.json

@@ -0,0 +1,5 @@
+{
+  "name": "Xiaoming",
+  "age": 18,
+  "phones": ["+123456"]
+}

src/error.rs

@@ -164,7 +164,6 @@ impl From<Error> for std::io::Error {
 pub enum Category {
     /// The error was caused by a failure to read or write bytes on an I/O
     /// stream.
-    /// TODO: support stream reader in the future
     Io,
 
     /// The error was caused by input that was not syntactically valid JSON.

src/lib.rs

@@ -41,9 +41,9 @@ pub use crate::lazyvalue::{
 pub use crate::pointer::{JsonPointer, PointerNode, PointerTree};
 #[doc(inline)]
 pub use crate::serde::{
-    from_slice, from_slice_unchecked, from_str, to_string, to_string_pretty, to_vec, to_vec_pretty,
-    to_writer, to_writer_pretty, Deserializer, JsonNumberTrait, Number, RawNumber, Serializer,
-    StreamDeserializer,
+    from_reader, from_slice, from_slice_unchecked, from_str, to_string, to_string_pretty, to_vec,
+    to_vec_pretty, to_writer, to_writer_pretty, Deserializer, JsonNumberTrait, Number, RawNumber,
+    Serializer, StreamDeserializer,
 };
 #[doc(inline)]
 pub use crate::value::{

src/serde/de.rs

@@ -1370,3 +1370,16 @@ where
 {
     from_trait(Read::new(s.as_bytes(), false))
 }
+
+/// Deserialize an instance of type `T` from a Reader
+pub fn from_reader<R, T>(mut reader: R) -> Result<T>
+where
+    R: std::io::Read,
+    T: de::DeserializeOwned,
+{
+    let mut data = Vec::new();
+    if let Err(e) = reader.read_to_end(&mut data) {
+        return Err(Error::io(e));
+    };
+    from_slice(data.as_slice())
+}

src/serde/mod.rs

@@ -7,7 +7,9 @@ pub(crate) mod ser;
 
 pub(crate) use self::de::tri;
 pub use self::{
-    de::{from_slice, from_slice_unchecked, from_str, Deserializer, StreamDeserializer},
+    de::{
+        from_reader, from_slice, from_slice_unchecked, from_str, Deserializer, StreamDeserializer,
+    },
     number::{JsonNumberTrait, Number},
     rawnumber::RawNumber,
     ser::{