Override keyword args for automatically generated serializer fields

[j4mie]

Fixes #98

This adds optional keyword arguments to the out object (when used as either a decorator or using the >> approach) which are passed to the constructor of the serializer field. This provides a way to add useful attributes to the field (like label and help_text) without throwing away the automagic model introspection behaviour.

class SomeView(SpecMixin, RetrieveAPIView):
    queryset = SomeModel.objects.all()
    spec = [
        ...,
        "title" >> out(label="The title of the object")
        ...,
    ]

Thanks @carltongibson for the API suggestion.

[j4mie]

Just calling out that this does change an internal API: previously, the serializer field was added to an attribute named out, now we have a generic _readers_annotation dictionary. This is undocumented behaviour so does not require a major version bump.

[carltongibson]

Here, it may be worth checking that kwargs are empty too. 🤔

[j4mie]

I've decided to explicitly support passing both a field, and also kwargs. See the tests for some examples. I know it's a redundant thing to do (you could just as easily pass the kwargs into the field constructor directly), but it felt more consistent and less surprising to have it "just work"...

[carltongibson]

Great. No problem 👍