Feature 307 integrate drf browsable api

[mina-atef-00]

Fixes #307

Type of change:

• New feature (change which adds functionality).

---

What's Changed:

• Added drf browsable api switch in env.template
• Added get_drf_template_mode() to return which drf template mode to use in DEFAULT_RENDERER_CLASSES reading the env

---

Screenshots:

1. DRF_BROWSABLE_API_MODE=yes
   

2. DRF_BROWSABLE_API_MODE=no
   

---

Affected URLs:

e.g. 127.0.0.1:8000/*

---

Checklist:

• My code follows the style guidelines of this project.
• I have performed a self-review of my own code.
• I have commented my code, particularly in hard-to-understand areas.
• My changes generate no new warnings.

[mina-atef-00]

@2ynn there are some forms like in HarvestViewset.list() (and the rest of the list functions) that aren't serializeable. (returned by get_filter_context() in api.py.

For example I get this error when requesting HTML format when the browsable api is on:

I think the list function needs refactoring for the context in general.

[mina-atef-00]

Also what do you think if we use a harvest list serializer that returns less data than the original serializer? using the big database made the whole site pretty unusable for me. Maybe this combined with pagination would make a lot of pages a lot faster.

[2ynn]

@mina-andajos for filtering we should use built-in rest filtering (to be tested in Browsable API)
https://www.django-rest-framework.org/api-guide/filtering/#filtering

Filter forms should already be generated for you without needing to pass them to context manually. See see venv/lib/python3.9/site-packages/rest_framework/templates/rest_framework/filters/*.html for example.

Crispy forms might be what you are looking for: https://django-filter.readthedocs.io/en/main/guide/rest_framework.html#crispy-forms

[mina-atef-00]

@mina-andajos for filtering we should use built-in rest filtering (to be tested in Browsable API)
https://www.django-rest-framework.org/api-guide/filtering/#filtering

Filter forms should already be generated for you without needing to pass them to context manually. See see venv/lib/python3.9/site-packages/rest_framework/templates/rest_framework/filters/*.html for example.

Crispy forms might be what you are looking for: https://django-filter.readthedocs.io/en/main/guide/rest_framework.html#crispy-forms

thanks, i looked into the rest filtering doc but was still confused on how to implement that.

[2ynn]

Nice! I'll approve now so you can move on but if you don't mind please move the function closer to where it's being used. Thanks!