com.rallyhealth.weepickle.v1.implicits

Auto-generated picklers and unpicklers, used for creating the 22 versions of tuple-picklers and case-class picklers

This needs to be split into a separate trait due to https://github.com/scala/bug/issues/11768

Defines the name of a new field (not defined in the class itself) to serve as the discriminator property name for identifying subclasses.

For naming, consider that some implementations (e.g. vpack) may sort object keys, so symbol prefixes work well for ensuring the tag is the first property. Tos will fast path if this is the first field of the object. Otherwise, Tos will have to buffer the content and find the tag later.

You can also tag the subclasses with key to override values for this field, which will otherwise default to the FQCN of the classname.

If the value of the annotated field .equals() the default value at runtime, then the macro-generated From will omit both the key and value from the serialized blob.

==Example==

case class FooDefault(
  @dropDefault i: Int = 10,
  @dropDefault s: String = "lol"
)

write(FooDefault(i = 11, s = "lol"))  ==> """{"i":11}"""
write(FooDefault(i = 10, s = "lol"))  ==> """{}"""
write(FooDefault())                   ==> """{}"""

May be used on either:

1. subclasses to override discriminator values (default: FQCN)
2. class fields to override field name.