Use explicit declared serializer field label as oas title

[wonderbeyond]

NOTE: every serializer field has a non-empty label, when not declared it's derived from the field name. I think only explicitly declared labels are necessary to go into the OAS schema. So I read the label from field._kwargs, not field.label.

[tfranzel]

this looks like it is very similar to #191. please read through it first so we are on the same page.

[wonderbeyond]

this looks like it is very similar to #191. please read through it first so we are on the same page.

Yes, I share similar idea with #191. However I were not caring about filter parameters, and I think filters should be treated much differently with models and serializers. (about this idea, also refer #234 (comment))

@tfranzel below is your comment at page #191:

ideally spectacular could find out if verbose_name is explicitly set and only then put it in the schema. i looked at the django/drf code but i have not found a silver bullet there yet. having a flag would also be a solution, however i would like to exhaust the possiblity of an automatic solution first. once introduced, parameters will never go away

You want a way to find out if verbose_name is explicitly set and only then put it in the schema, I think just did it in a simple way.

[tfranzel]

@wonderbeyond, this is just as i suspected. as you see, a lot of tests are failing because the title gets added everywhere. This is exactly the same duplication problem, where name and title are just copies. this add alot noise to the schema with no additional info.

[wonderbeyond]

@wonderbeyond, this is just as i suspected. as you see, a lot of tests are failing because the title gets added everywhere. This is exactly the same duplication problem, where name and title are just copies. this add alot noise to the schema with no additional info.

I think these noises can be fixed in drf-spectacular's own code scope, though I've not read through enough code and can not help more. My intention is to find only explicit declared serializer field labels. I'm so sorry that I'm busy currently and have no spare time to give more comments...

[tfranzel]

@wonderbeyond sry for the long wait. field._kwargs did indeed help but failed on the PK fields with 'ID'. i took a different route and now it looks like it is working without the noise. feedback welcome. i'll close this PR as it is outdated now.