Handle deprecated boolean property on params

(cherry picked from commit e1e1e33)

Author: russcam

src/ApiGenerator/Domain/Specification/QueryParameters.cs

@@ -6,6 +6,8 @@
 using System.Collections.Generic;
 using System.Linq;
 using ApiGenerator.Generator;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
 
 namespace ApiGenerator.Domain.Specification
 {
@@ -74,21 +76,23 @@ public string Obsolete
 			get
 			{
 				if (!string.IsNullOrEmpty(_obsolete)) return _obsolete;
+				if (Deprecated != null)
+				{
+					if (!string.IsNullOrEmpty(Deprecated.Version) && !string.IsNullOrEmpty(Deprecated.Description))
+						return $"Deprecated as of: {Deprecated.Version}, reason: {Deprecated.Description}";
+					if (!string.IsNullOrEmpty(Deprecated.Version))
+						return $"Deprecated as of: {Deprecated.Version}";
+					if (!string.IsNullOrEmpty(Deprecated.Description))
+						return $"reason: {Deprecated.Description}";
+
+					return "deprecated";
+				}
 
-				return Deprecated != null
-					? $"Deprecated as of: {Deprecated.Version}, reason: {Deprecated.Description}"
-					: null;
+				return null;
 			}
 			set => _obsolete = value;
 		}
 
-		public class QueryParameterDeprecation
-		{
-			public string Version { get; set; }
-
-			public string Description { get; set; }
-		}
-
 		public QueryParameterDeprecation Deprecated { get; set; }
 
 		public IEnumerable<string> Options { get; set; }
@@ -168,4 +172,27 @@ public string TypeLowLevel
 		public string InitializerGenerator(string @namespace, string type, string name, string key, string setter, params string[] doc) =>
 			CodeGenerator.Property(@namespace, type, name, key, setter, Obsolete, doc);
 	}
+
+	public class QueryParameterDeprecation
+	{
+		public string Version { get; set; }
+
+		public string Description { get; set; }
+	}
+
+	internal class QueryParameterDeprecationConverter : JsonConverter
+	{
+		public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer) => throw new NotImplementedException();
+
+		public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
+		{
+			if (reader.TokenType == JsonToken.Boolean)
+				return new QueryParameterDeprecation();
+
+			var jObject = JObject.Load(reader);
+			return jObject.ToObject<QueryParameterDeprecation>(JsonSerializer.CreateDefault());
+		}
+
+		public override bool CanConvert(Type objectType) => typeof(QueryParameterDeprecation).IsAssignableFrom(objectType);
+	}
 }

src/ApiGenerator/Generator/ApiEndpointFactory.cs

@@ -11,18 +11,22 @@
 using ApiGenerator.Domain;
 using ApiGenerator.Domain.Code;
 using ApiGenerator.Domain.Specification;
+using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
 
 namespace ApiGenerator.Generator
 {
 	public static class ApiEndpointFactory
 	{
+		private static readonly JsonSerializer Serializer = JsonSerializer.Create(
+			new JsonSerializerSettings { Converters = new List<JsonConverter> { new QueryParameterDeprecationConverter() } });
+
 		public static ApiEndpoint FromFile(string jsonFile)
 		{
 			var officialJsonSpec = JObject.Parse(File.ReadAllText(jsonFile));
 			TransformNewSpecStructureToOld(officialJsonSpec);
 			PatchOfficialSpec(officialJsonSpec, jsonFile);
-			var (name, endpoint) = officialJsonSpec.ToObject<Dictionary<string, ApiEndpoint>>().First();
+			var (name, endpoint) = officialJsonSpec.ToObject<Dictionary<string, ApiEndpoint>>(Serializer).First();
 
 			endpoint.FileName = Path.GetFileName(jsonFile);
 			endpoint.Name = name;