apis_core.generic package

Subpackages

• apis_core.generic.forms package
  • GenericFilterSetForm
    • GenericFilterSetForm.base_fields
    • GenericFilterSetForm.clean()
    • GenericFilterSetForm.columns_exclude
    • GenericFilterSetForm.declared_fields
    • GenericFilterSetForm.media
  • GenericImportForm
    • GenericImportForm.Meta
      • GenericImportForm.Meta.fields
    • GenericImportForm.base_fields
    • GenericImportForm.declared_fields
    • GenericImportForm.media
  • GenericModelForm
    • GenericModelForm.Meta
      • GenericModelForm.Meta.fields
    • GenericModelForm.base_fields
    • GenericModelForm.declared_fields
    • GenericModelForm.media
  • Submodules
  • apis_core.generic.forms.fields module
    • ModelImportChoiceField
      • ModelImportChoiceField.to_python()
  • apis_core.generic.forms.widgets module
    • JSONListWidget
      • JSONListWidget.Media
      • JSONListWidget.format_value()
      • JSONListWidget.input_type
      • JSONListWidget.media
      • JSONListWidget.template_name
      • JSONListWidget.value_from_datadict()
    • NewlineSeparatedListWidget
      • NewlineSeparatedListWidget.Media
      • NewlineSeparatedListWidget.format_value()
      • NewlineSeparatedListWidget.input_type
      • NewlineSeparatedListWidget.media
      • NewlineSeparatedListWidget.template_name
      • NewlineSeparatedListWidget.value_from_datadict()

Submodules

apis_core.generic.abc module

class apis_core.generic.abc.GenericModel

Bases: object

get_absolute_url()

classmethod get_add_permission()

get_api_detail_endpoint()

classmethod get_change_permission()

get_create_success_url()

classmethod get_createview_url()

classmethod get_delete_permission()

get_delete_url()

get_edit_url()

classmethod get_listview_url()

get_update_success_url()

apis_core.generic.api_views module

class apis_core.generic.api_views.ModelViewSet(**kwargs)

Bases: ModelViewSet

API ViewSet for a generic model. The queryset is overridden by the first match from the first_member_match helper. The serializer class is overridden by the first match from the first_member_match helper.

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

basename = None

description = None

detail = None

dispatch(*args, **kwargs)

.dispatch() is pretty much the same as Django’s regular dispatch, but with extra hooks for startup, finalize, and exception handling.

filter_backends = [<class 'apis_core.generic.filterbackends.GenericFilterBackend'>]

get_queryset()

Get the list of items for this view. This must be an iterable, and may be a queryset. Defaults to using self.queryset.

This method should always be used rather than accessing self.queryset directly, as self.queryset gets evaluated only once, and those results are cached for all subsequent requests.

You may want to override this if you need to provide different querysets depending on the incoming request.

(Eg. return a list of items that is specific to the user)

get_serializer_class()

Return the class to use for the serializer. Defaults to using self.serializer_class.

You may want to override this if you need to provide different serializations depending on the incoming request.

(Eg. admins get full serialization, others get basic serialization)

name = None

suffix = None

apis_core.generic.filterbackends module

class apis_core.generic.filterbackends.GenericFilterBackend

Bases: DjangoFilterBackend

get_filterset_class(view, queryset=None)

Return the FilterSet class used to filter the queryset.

apis_core.generic.filtersets module

class apis_core.generic.filtersets.GenericFilterSet(data=None, queryset=None, *, request=None, prefix=None)

Bases: FilterSet

Our GenericFilterSet sets the default form to be our GenericFilterSetForm, which is set up to ignore the columns field of the form.

class Meta

Bases: object

form

alias of GenericFilterSetForm

base_filters = {}

declared_filters = {}

apis_core.generic.filtersets.filterset_factory(model, filterset=<class 'django_filters.filterset.FilterSet'>, fields='__all__')

apis_core.generic.generators module

class apis_core.generic.generators.CustomEndpointEnumerator(patterns=None, urlconf=None)

Bases: EndpointEnumerator

get_api_endpoints(patterns=None, prefix='')

Call the EndpointEnumerator’s get_api_endpoints method to get all the automatically found endpoints, remove the ones that we want to override and the add our custom endpoints to this list.

class apis_core.generic.generators.CustomSchemaGenerator(*args, **kwargs)

Bases: SchemaGenerator

endpoint_inspector_cls

alias of CustomEndpointEnumerator

apis_core.generic.helpers module

apis_core.generic.helpers.first_member_match(dotted_path_list: tuple[str], fallback=None) → object

apis_core.generic.helpers.generate_search_filter(model, query, fields_to_search=None, prefix='')

Generate a default search filter that searches for the query in all the CharFields and TextFields of a model (case-insensitive) or in the fields listed in the models default_search_fields attribute or in the fields listed in the fields_to_search argument This helper can be used by autocomplete querysets if nothing fancier is needed. If the prefix is set, the field names will be prefixed with that string - this can be useful if you want to use the generate_search_filter in a Q combined query while searching over multiple models.

apis_core.generic.helpers.import_string(dotted_path)

apis_core.generic.helpers.makeclassprefix(string: str) → str

apis_core.generic.helpers.module_paths(model, path: str = '', suffix: str = '') → list

apis_core.generic.helpers.mro_paths(model)

Create a list of MRO classes for a Django model

apis_core.generic.helpers.permission_fullname(action: str, model: object) → str

apis_core.generic.helpers.template_names_via_mro(model, suffix='')

Use the MRO to generate a list of template names for a model

apis_core.generic.importers module

apis_core.generic.importers.GenericModelImporter(uri, model)

A generic importer class It provides the standard methods for importing data from an URI and creating a model instance of it. By default it fetches a resource, first tries to parse it using our rdf parser, if that fails tries to parse it using json and then extracts the fields whose keys match the model field names. Projects can inherit from this class and override the default methods or simple write their own from scratch.

apis_core.generic.renderers module

class apis_core.generic.renderers.GenericRDFBaseRenderer

Bases: BaseRenderer

render(data, accepted_media_type=None, renderer_context=None)

class apis_core.generic.renderers.GenericRDFN3Renderer

Bases: GenericRDFBaseRenderer

format = 'rdf+n3'

media_type = 'text/n3'

class apis_core.generic.renderers.GenericRDFTurtleRenderer

Bases: GenericRDFBaseRenderer

format = 'rdf+turtle'

media_type = 'text/turtle'

class apis_core.generic.renderers.GenericRDFXMLRenderer

Bases: GenericRDFBaseRenderer

format = 'rdf+xml'

media_type = 'application/rdf+xml'

apis_core.generic.routers module

class apis_core.generic.routers.CustomAPIRootView(**kwargs)

Bases: APIRootView

The default basic root view for CustomDefaultRouter

This view lists the output of the default APIRootView of the Django Rest Framework. In addition, it injects the routes of the genericmodelapi (those are not hardcoded registered but autogenerated based on the models that inherit from GenericModel).

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

get(request, *args, **kwargs)

class apis_core.generic.routers.CustomDefaultRouter(*args, **kwargs)

Bases: DefaultRouter

The CustomDefaultRouter only diverts from the Django Rest Framework DefaultRouter by setting the APIRootView to our CustomAPIRootView.

APIRootView

alias of CustomAPIRootView

apis_core.generic.serializers module

class apis_core.generic.serializers.ContentTypeInstanceSerializer(*args, **kwargs)

Bases: Serializer

When a field is instantiated, we store the arguments that were used, so that we can present a helpful representation of the object.

to_internal_value(data)

Dict of native values <- Dict of primitive datatypes.

class apis_core.generic.serializers.GenericHyperlinkedIdentityField(*args, **kwargs)

Bases: GenericHyperlinkedRelatedField

When a field is instantiated, we store the arguments that were used, so that we can present a helpful representation of the object.

class apis_core.generic.serializers.GenericHyperlinkedModelSerializer(*args, **kwargs)

Bases: HyperlinkedModelSerializer

When a field is instantiated, we store the arguments that were used, so that we can present a helpful representation of the object.

serializer_related_field

alias of GenericHyperlinkedRelatedField

serializer_url_field

alias of GenericHyperlinkedIdentityField

class apis_core.generic.serializers.GenericHyperlinkedRelatedField(*args, **kwargs)

Bases: HyperlinkedRelatedField

When a field is instantiated, we store the arguments that were used, so that we can present a helpful representation of the object.

get_url(obj, view_name, request, format)

Given an object, return the URL that hyperlinks to the object.

May raise a NoReverseMatch if the view_name and lookup_field attributes are not configured to correctly match the URL conf.

use_pk_only_optimization()

class apis_core.generic.serializers.SimpleObjectSerializer(*args, **kwargs)

Bases: Serializer

When a field is instantiated, we store the arguments that were used, so that we can present a helpful representation of the object.

class Meta

Bases: object

fields = ['url', 'label', 'content_type_key', 'content_type_name']

get_content_type_key(obj) → str

get_content_type_name(obj) → str

get_label(obj) → str

apis_core.generic.serializers.serializer_factory(model, serializer=<class 'apis_core.generic.serializers.GenericHyperlinkedModelSerializer'>, fields='__all__', **kwargs)

apis_core.generic.tables module

class apis_core.generic.tables.ActionColumn(*args, **kwargs)

Bases: CustomTemplateColumn

A custom template column with some additional attributes for actions.

attrs = {'td': {'style': 'width:1%;'}}

exclude_from_export = True

orderable = False

render(record, table, *args, **kwargs)

Return the content for a specific cell.

This method can be overridden by table.render_FOO methods on the table or by subclassing .Column.

If the value for this cell is in .empty_values, this method is skipped and an appropriate default value is rendered instead. Subclasses should set .empty_values to () if they want to handle all values in .render.

verbose_name = ''

class apis_core.generic.tables.CustomTemplateColumn(*args, **kwargs)

Bases: TemplateColumn

A custom template column - the tables.TemplateColumn class does not allow to set attributes via class variables. Therefor we use this CustomTemplateColumn to set some arguments based on class attributes and override the attributes in child classes.

exclude_from_export = False

orderable = None

template_name = None

verbose_name = None

class apis_core.generic.tables.DeleteColumn(*args, **kwargs)

Bases: ActionColumn

A column showing a delete button

permission = 'delete'

template_name = 'columns/delete.html'

class apis_core.generic.tables.DescriptionColumn(*args, **kwargs)

Bases: CustomTemplateColumn

A column showing a model description

orderable = False

template_name = 'columns/description.html'

class apis_core.generic.tables.EditColumn(*args, **kwargs)

Bases: ActionColumn

A column showing an edit button

permission = 'change'

template_name = 'columns/edit.html'

class apis_core.generic.tables.GenericTable(data=None, order_by=None, orderable=None, empty_text=None, exclude=None, attrs=None, row_attrs=None, pinned_row_attrs=None, sequence=None, prefix=None, order_by_field=None, page_field=None, per_page_field=None, template_name=None, default=None, request=None, show_header=None, show_footer=True, extra_columns=None)

Bases: Table

A generic table that contains an edit button column, a delete button column and a description column

class Meta

Bases: object

fields = ['id', 'desc']

sequence = ('...', 'view', 'edit', 'delete')

base_columns = {'delete': <apis_core.generic.tables.DeleteColumn object>, 'desc': <apis_core.generic.tables.DescriptionColumn object>, 'edit': <apis_core.generic.tables.EditColumn object>, 'view': <apis_core.generic.tables.ViewColumn object>}

class apis_core.generic.tables.ViewColumn(*args, **kwargs)

Bases: ActionColumn

A column showing a view button

permission = 'view'

template_name = 'columns/view.html'

apis_core.generic.urls module

class apis_core.generic.urls.ContenttypeConverter

Bases: object

A converter that converts from a string representation of a model (app_label.model) to the actual Django model class.

regex = '\\w+\\.\\w+'

to_python(value)

to_url(value)

apis_core.generic.views module

class apis_core.generic.views.Autocomplete(**kwargs)

Bases: GenericModelMixin, PermissionRequiredMixin, Select2QuerySetView

Autocomplete view for a generic model. Access requires the <model>_view permission. The queryset is overridden by the first match from the first_member_match helper.

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

create_field = 'thisisnotimportant'

create_object(value)

Create an object given a text.

get_queryset()

Filter the queryset with GET[‘q’].

get_results(context)

Return data for the ‘results’ key of the response.

permission_action_required = 'view'

post(request, *args, **kwargs)

Create an object given a text after checking permissions.

Runs self.validate() if self.validate_create is True.

setup(*args, **kwargs)

Initialize attributes shared by all view methods.

template_name_suffix = '_autocomplete_result'

class apis_core.generic.views.Create(**kwargs)

Bases: GenericModelMixin, PermissionRequiredMixin, CreateView

Create view for a generic model. Access requires the <model>_add permission. The form class is overridden by the first match from the first_member_match helper.

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

get_form_class()

Return the form class to use in this view.

get_success_url()

Return the URL to redirect to after processing a valid form.

permission_action_required = 'add'

template_name = 'generic/generic_form.html'

class apis_core.generic.views.Delete(**kwargs)

Bases: GenericModelMixin, PermissionRequiredMixin, DeleteView

Delete view for a generic model. Access requires the <model>_delete permission.

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

delete(*args, **kwargs)

Call the delete() method on the fetched object and then redirect to the success URL.

get_success_url()

Return the URL to redirect to after processing a valid form.

permission_action_required = 'delete'

class apis_core.generic.views.Detail(**kwargs)

Bases: GenericModelMixin, PermissionRequiredMixin, DetailView

Detail view for a generic model. Access requires the <model>_view permission.

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

permission_action_required = 'view'

class apis_core.generic.views.GenericModelMixin

Bases: object

A mixin providing the common functionality for all the views working with generic models - that is models that are accessed via the contenttype framework (using app_label.model). It sets the .model of the view and generates a list of possible template names (based on the MRO of the model). If the view has a permission_action_required attribute, this is used to set the permission required to access the view for this specific model.

get_permission_required()

get_template_names()

setup(*args, **kwargs)

class apis_core.generic.views.Import(**kwargs)

Bases: GenericModelMixin, PermissionRequiredMixin, FormView

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

form_valid(form)

If the form is valid, redirect to the supplied URL.

get_form_class()

Return the form class to use.

get_success_url()

Return the URL to redirect to after processing a valid form.

permission_action_required = 'add'

template_name = 'generic/generic_import_form.html'

template_name_suffix = '_import'

class apis_core.generic.views.List(**kwargs)

Bases: ListViewObjectFilterMixin, GenericModelMixin, PermissionRequiredMixin, SingleTableMixin, FilterView

List view for a generic model. Access requires the <model>_view permission. It is based on django-filters FilterView and django-tables SingleTableMixin. The table class is overridden by the first match from the first_member_match helper. The filterset class is overridden by the first match from the first_member_match helper. The queryset is overridden by the first match from the first_member_match helper.

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

get_filterset(filterset_class)

We override the get_filterset method, so we can inject a columns selector into the form

get_filterset_class()

Returns the filterset class to use in this view

get_queryset()

Return the list of items for this view.

The return value must be an iterable and may be an instance of QuerySet in which case QuerySet specific behavior will be enabled.

get_table_class()

Return the class to use for the table.

get_table_kwargs()

Return the keyword arguments for instantiating the table.

Allows passing customized arguments to the table constructor, for example, to remove the buttons column, you could define this method in your View:

def get_table_kwargs(self):
    return {
        'exclude': ('buttons', )
    }

permission_action_required = 'view'

template_name_suffix = '_list'

class apis_core.generic.views.Overview(**kwargs)

Bases: TemplateView

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

template_name = 'generic/overview.html'

class apis_core.generic.views.Update(**kwargs)

Bases: GenericModelMixin, PermissionRequiredMixin, UpdateView

Update view for a generic model. Access requires the <model>_change permission. The form class is overridden by the first match from the first_member_match helper.

Constructor. Called in the URLconf; can contain helpful extra keyword arguments, and other things.

get_form_class()

Return the form class to use in this view.

get_success_url()

Return the URL to redirect to after processing a valid form.

permission_action_required = 'change'