Serdelicacy

Fixed

- Add link to docs in readme

Added

- In-depth documentation. Lots of docstring updates!
- `serdelicacy.SerdeError` as part of the public API (mostly for documentation)

Added

- Explicit support for `enum.Enum` and its subtypes. I personally prefer `typing.Literal`, but `enum.Enum` might be preferred by others.

Note: breaking changes regarding validation and transformation.

Added

- Provide `Override` type, which provides metadata user-defined overrides for dataclass serde for the namespace-constrained `serdelicacy` key. Prevents namespace pollution and provides more type safety.

Removed

- Keys `transform_load`, `transform_postload`, and `validate` are no longer expected. Instead, use the key `serdelicacy` and pass it a `serdelicacy.Override` object.

Added

- Support for additional `dataclasses.field` `metadata` keys: `transform_load`, `transform_postload`, and `transform_dump`. These enable the user to specify functions to modify the specific value that is deserialized (loaded) and serialized (dumped).

Fixed

- Inconsistent documentation the referred to `UNDEFINED` has been corrected to refer to `MISSING`.

Removed

- Removed automatic conversion for primitive types. This special case created a lot of code complexity and is arguably unnecessary now that we provide support for validations and transformations with `dataclasses`.

Added

- Major validation improvement! Support for dataclass attribute validation using the `metadata` parameter to `dataclasses.field`, like `dataclasses.field(metadata={"validate": str.istitle})`. The function passed as the mapping value should either return `True` on positive validation / `False` on non-validation, or return nothing at all and instead rely on the raising of exceptions to indicate whether validation passed for failed.