using System; using Newtonsoft.Json; using Newtonsoft.Json.Linq; namespace StardewModdingAPI.Toolkit.Serialization.Converters { /// Handles deserialization of . internal class SemanticVersionConverter : JsonConverter { /********* ** Fields *********/ /// Whether to allow non-standard extensions to semantic versioning. protected bool AllowNonStandard { get; set; } /********* ** Accessors *********/ /// Get whether this converter can read JSON. public override bool CanRead { get; } = true; /// Get whether this converter can write JSON. public override bool CanWrite { get; } = true; /********* ** Public methods *********/ /// Get whether this instance can convert the specified object type. /// The object type. public override bool CanConvert(Type objectType) { return typeof(ISemanticVersion).IsAssignableFrom(objectType); } /// Reads the JSON representation of the object. /// The JSON reader. /// The object type. /// The object being read. /// The calling serializer. public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) { string path = reader.Path; switch (reader.TokenType) { case JsonToken.Null: return null; case JsonToken.StartObject: return this.ReadObject(JObject.Load(reader)); case JsonToken.String: { string? value = JToken.Load(reader).Value(); return value is not null ? this.ReadString(value, path) : null; } default: throw new SParseException($"Can't parse {nameof(ISemanticVersion)} from {reader.TokenType} node (path: {reader.Path})."); } } /// Writes the JSON representation of the object. /// The JSON writer. /// The value. /// The calling serializer. public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) { writer.WriteValue(value?.ToString()); } /********* ** Private methods *********/ /// Read a JSON object. /// The JSON object to read. private ISemanticVersion ReadObject(JObject obj) { int major = obj.ValueIgnoreCase(nameof(ISemanticVersion.MajorVersion)); int minor = obj.ValueIgnoreCase(nameof(ISemanticVersion.MinorVersion)); int patch = obj.ValueIgnoreCase(nameof(ISemanticVersion.PatchVersion)); string? prereleaseTag = obj.ValueIgnoreCase(nameof(ISemanticVersion.PrereleaseTag)); return new SemanticVersion(major, minor, patch, prereleaseTag: prereleaseTag); } /// Read a JSON string. /// The JSON string value. /// The path to the current JSON node. private ISemanticVersion? ReadString(string str, string path) { if (string.IsNullOrWhiteSpace(str)) return null; if (!SemanticVersion.TryParse(str, allowNonStandard: this.AllowNonStandard, out ISemanticVersion? version)) throw new SParseException($"Can't parse semantic version from invalid value '{str}', should be formatted like 1.2, 1.2.30, or 1.2.30-beta (path: {path})."); return version; } } }