WIP - Road to v2

[Chuckame]

Bug fixes

• Kotlin Pair<A, B> schema is generated as Union<A, B> instead of record #166

Improvements

• Revamp the Avro entrypoint completely to reduce the complexity and improve extensibility. Example: Json class in kotlinx serialization. See Beautify the Avro api entrypoint #163
  • More extensible serialization (allow bytes headers for custom format wrappers like confluent schema registry, or the other avro file standards like single object)
• Handle BigDecimal custom rounding mode  #162
• Replace AvroDescriptor by a @CustomSchemaGenerator(MyCustomGenerator::class) for allowing generating custom schemas without using reflection, also usable with custom serializers. See feat!: No more reflection and customizable logical types #175 Handle BigDecimal custom rounding mode  #162 No more reflection feat!: No more reflection and customizable logical types #175
• Caching of schema and other internal processes (record & field namings, aliases, ...). See Cache Schemas for classes #159
• Replace AvroName and AvroNamespace by just SerialName, natively working with kotlinx. See Remove AvroName and AvroNamespace in favour of native SerialName #165
• Rename NamingStrategy to FieldNamingStrategy #178
• Reduce the dependencies to the minimum and set some as optional. See Make snappy-java an optional dependency #149 -> has been removed, so the users have to declare it explicitly
• Allow more types for the map key. See Allow non-string while string-able values as map keys #114 Value classes not working (feature request ?) #131
  • Now able to put many non-null scalar types (string, int, long, double, float, boolean, enum)
• Better contribution guidelines, with semantics checks and more complete code formatter in .editorconfig

New features

• Implement duration logical type Support duration logical type #206
• Handle all the possible schemas as root schema, and not only records. See encodeToByteArray() fails when applied with primitives #80
  • works for both generic and binary encodings

Non goals

• kotlin multiplatform, as it needs to implement everything ourselves instead of just using the apache avro java library. But still, it'll be taken into account in the new Avro entrypoint design for better extensibility.
• Direct encoding: Same as the previous line, since we would have a better extensibility, selecting different mode of serialization should be easily done, like also writing into json Done in Direct encoding #215, profiting the v2 to include some related breaking changes in the Avro entry point.
• Keeping all the exact same features: By example, AvroName and AvroNamespace will be changed to the native single annotation SerialName

Maybe ?

• Support avro single object encoding #141 (maybe, as if we succeed of revamping the Avro entrypoint, we could more easily use the apache avro library standard encoders like single object, json, and more)
• Add type-safe for AvroDefault #158 (maybe, because it's not really mandatory, as we currently have the workaround of json)

[Chuckame]

Released in v2.0.0