Merge pull request #832 from FyiurAmron/add_missing_methods_and_reorder

Add missing methods to (de)serializer interfaces and implementations

+semver:fix

Author: EdwardCooke

YamlDotNet/Serialization/Deserializer.cs

@@ -77,11 +77,26 @@ public T Deserialize<T>(TextReader input)
             return Deserialize<T>(new Parser(input));
         }
 
+        public T Deserialize<T>(IParser parser)
+        {
+            return (T)Deserialize(parser, typeof(T))!; // We really want an exception if we are trying to deserialize null into a non-nullable type
+        }
+        
+        public object? Deserialize(string input)
+        {
+            return Deserialize(input, typeof(object));
+        }
+        
         public object? Deserialize(TextReader input)
         {
             return Deserialize(input, typeof(object));
         }
 
+        public object? Deserialize(IParser parser)
+        {
+            return Deserialize(parser, typeof(object));
+        }
+        
         public object? Deserialize(string input, Type type)
         {
             using var reader = new StringReader(input);
@@ -93,16 +108,6 @@ public T Deserialize<T>(TextReader input)
             return Deserialize(new Parser(input), type);
         }
 
-        public T Deserialize<T>(IParser parser)
-        {
-            return (T)Deserialize(parser, typeof(T))!; // We really want an exception if we are trying to deserialize null into a non-nullable type
-        }
-
-        public object? Deserialize(IParser parser)
-        {
-            return Deserialize(parser, typeof(object));
-        }
-
         /// <summary>
         /// Deserializes an object of the specified type.
         /// </summary>

YamlDotNet/Serialization/IDeserializer.cs

@@ -29,12 +29,15 @@ public interface IDeserializer
     {
         T Deserialize<T>(string input);
         T Deserialize<T>(TextReader input);
-        object? Deserialize(TextReader input);
-        object? Deserialize(string input, Type type);
-        object? Deserialize(TextReader input, Type type);
         T Deserialize<T>(IParser parser);
+
+        object? Deserialize(string input);
+        object? Deserialize(TextReader input);
         object? Deserialize(IParser parser);
 
+        object? Deserialize(string input, Type type);
+        object? Deserialize(TextReader input, Type type);
+        
         /// <summary>
         /// Deserializes an object of the specified type.
         /// </summary>

YamlDotNet/Serialization/ISerializer.cs

@@ -28,17 +28,24 @@ namespace YamlDotNet.Serialization
     public interface ISerializer
     {
         /// <summary>
-        /// Serializes the specified object.
+        /// Serializes the specified object into a string.
         /// </summary>
-        /// <param name="writer">The <see cref="TextWriter" /> where to serialize the object.</param>
         /// <param name="graph">The object to serialize.</param>
-        void Serialize(TextWriter writer, object? graph);
+        string Serialize(object? graph);
 
         /// <summary>
         /// Serializes the specified object into a string.
         /// </summary>
         /// <param name="graph">The object to serialize.</param>
-        string Serialize(object? graph);
+        /// <param name="type">The static type of the object to serialize.</param> 
+        string Serialize(object? graph, Type type);
+        
+        /// <summary>
+        /// Serializes the specified object.
+        /// </summary>
+        /// <param name="writer">The <see cref="TextWriter" /> where to serialize the object.</param>
+        /// <param name="graph">The object to serialize.</param>
+        void Serialize(TextWriter writer, object? graph);
 
         /// <summary>
         /// Serializes the specified object.

YamlDotNet/Serialization/Serializer.cs

@@ -63,25 +63,37 @@ public static Serializer FromValueSerializer(IValueSerializer valueSerializer, E
         }
 
         /// <summary>
-        /// Serializes the specified object.
+        /// Serializes the specified object into a string.
         /// </summary>
-        /// <param name="writer">The <see cref="TextWriter" /> where to serialize the object.</param>
         /// <param name="graph">The object to serialize.</param>
-        public void Serialize(TextWriter writer, object? graph)
+        public string Serialize(object? graph)
         {
-            Serialize(new Emitter(writer, emitterSettings), graph);
+            using var buffer = new StringWriter();
+            Serialize(buffer, graph);
+            return buffer.ToString();
         }
 
         /// <summary>
         /// Serializes the specified object into a string.
         /// </summary>
         /// <param name="graph">The object to serialize.</param>
-        public string Serialize(object? graph)
+        /// <param name="type">The static type of the object to serialize.</param> 
+        public string Serialize(object? graph, Type type)
         {
             using var buffer = new StringWriter();
-            Serialize(buffer, graph);
+            Serialize(buffer, graph, type);
             return buffer.ToString();
         }
+        
+        /// <summary>
+        /// Serializes the specified object.
+        /// </summary>
+        /// <param name="writer">The <see cref="TextWriter" /> where to serialize the object.</param>
+        /// <param name="graph">The object to serialize.</param>
+        public void Serialize(TextWriter writer, object? graph)
+        {
+            Serialize(new Emitter(writer, emitterSettings), graph);
+        }
 
         /// <summary>
         /// Serializes the specified object.