hawat.blueprints.timeline package

This file contains pluggable module for Hawat web interface containing features related to IDEA event timeline based visualisations.

class hawat.blueprints.timeline.APILegacySearchView[source]

Bases: AJAXMixin, AbstractSearchView

View responsible for querying IDEA event database and presenting the results in the form of JSON document.

Deprecated legacy implementation, kept only for the purposes of comparison.

classmethod get_view_name()[source]

Implementation of hawat.view.BaseView.get_view_name().

methods: t.ClassVar[t.Optional[t.Collection[str]]] = ['GET', 'POST']

The methods this view is registered for. Uses the same default (["GET", "HEAD", "OPTIONS"]) as route and add_url_rule by default.

class hawat.blueprints.timeline.APISearchView[source]

Bases: AJAXMixin, AbstractSearchView

View responsible for querying IDEA event database and presenting the results in the form of JSON document.

get_aggregations(form_args)[source]

Returns a list of aggregations which should be calculated

get_blocked_response_context_keys()[source]

Returns a list of reponse context keys that will be removed in the hawat.view.mixin.AJAXMixin.process_response_context()

Returns

a list of response context keys to be removed

classmethod get_view_name()[source]

Implementation of hawat.view.BaseView.get_view_name().

methods: t.ClassVar[t.Optional[t.Collection[str]]] = ['GET', 'POST']

The methods this view is registered for. Uses the same default (["GET", "HEAD", "OPTIONS"]) as route and add_url_rule by default.

class hawat.blueprints.timeline.AbstractLegacySearchView[source]

Bases: PsycopgMixin, BaseSearchView

Base class for view responsible for searching IDEA event database and presenting the results in timeline-based manner.

authentication = True

Similar to the decorators mechanism in Flask pluggable views, you may use this class variable to specify, that the view is protected by authentication. During the process of registering the view into the blueprint in hawat.app.hawatBlueprint.register_view_class() the view will be automatically decorated with flask_login.login_required() decorator.

The advantage of using this in favor of decorators is that the application menu can automatically hide/show items inaccessible to current user.

This is a scalar variable that must contain boolean True or False.

This hook method will be called after successfull search.

do_before_response(**kwargs)[source]

This method will be called just before generating the response. By providing some meaningfull implementation you can use it for some simple item and response context mangling tasks.

Parameters

kwargs – Custom additional arguments.

This hook method will be called before search attempt.

classmethod get_menu_title(**kwargs)[source]

Return menu entry title for the view.

Default implementation returns the return value of hawat.view.BaseView.get_view_title() method by default.

Parameters

kwargs (dict) – Optional parameters.

Returns

Menu entry title for the view.

Return type

str

static get_qtype()[source]

Get type of the event select query.

static get_search_form(request_args)[source]

Must return instance of flask_wtf.FlaskForm appropriate for searching given type of items.

classmethod get_view_icon()[source]

Implementation of mydojo.base.BaseView.get_view_name().

classmethod get_view_title(**kwargs)[source]

Return title for the view, that will be displayed in the title tag of HTML head element and also as the content of page header in h2 tag.

Default implementation returns the return value of hawat.view.BaseView.get_menu_title() method by default.

Parameters

kwargs (dict) – Optional parameters.

Returns

Title for the view.

Return type

str

url_params_unsupported = ('page', 'limit', 'sortby')

List of URL parameters, that are not supported by this view and should be removed before generating the URL.

class hawat.blueprints.timeline.AbstractSearchView[source]

Bases: PsycopgMixin, CustomSearchView

Base class for view responsible for searching IDEA event database and presenting the results in timeline-based manner.

authentication = True

Similar to the decorators mechanism in Flask pluggable views, you may use this class variable to specify, that the view is protected by authentication. During the process of registering the view into the blueprint in hawat.app.hawatBlueprint.register_view_class() the view will be automatically decorated with flask_login.login_required() decorator.

The advantage of using this in favor of decorators is that the application menu can automatically hide/show items inaccessible to current user.

This is a scalar variable that must contain boolean True or False.

Perform actual search with given query.

This hook method will be called after successfull search.

do_before_response(**kwargs)[source]

This method will be called just before generating the response. By providing some meaningfull implementation you can use it for some simple item and response context mangling tasks.

Parameters

kwargs – Custom additional arguments.

This hook method will be called before search attempt.

get_aggregations(form_args)[source]

Returns a list of aggregations which should be calculated

classmethod get_menu_title(**kwargs)[source]

Return menu entry title for the view.

Default implementation returns the return value of hawat.view.BaseView.get_view_title() method by default.

Parameters

kwargs (dict) – Optional parameters.

Returns

Menu entry title for the view.

Return type

str

static get_search_form(request_args)[source]

Must return instance of flask_wtf.FlaskForm appropriate for searching given type of items.

classmethod get_view_icon()[source]

Implementation of mydojo.base.BaseView.get_view_name().

classmethod get_view_title(**kwargs)[source]

Return title for the view, that will be displayed in the title tag of HTML head element and also as the content of page header in h2 tag.

Default implementation returns the return value of hawat.view.BaseView.get_menu_title() method by default.

Parameters

kwargs (dict) – Optional parameters.

Returns

Title for the view.

Return type

str

url_params_unsupported = ('page', 'sortby')

List of URL parameters, that are not supported by this view and should be removed before generating the URL.

hawat.blueprints.timeline.BLUEPRINT_NAME = 'timeline'

Name of the blueprint as module global constant.

class hawat.blueprints.timeline.SearchView[source]

Bases: HTMLMixin, AbstractSearchView

View responsible for querying IDEA event database and presenting the results in the form of HTML page.

get_aggregations(form_args)[source]

Returns a list of aggregations which should be calculated

classmethod get_breadcrumbs_menu()[source]

Get breadcrumbs menu.

methods: t.ClassVar[t.Optional[t.Collection[str]]] = ['GET']

The methods this view is registered for. Uses the same default (["GET", "HEAD", "OPTIONS"]) as route and add_url_rule by default.

class hawat.blueprints.timeline.TimelineBlueprint(name, import_name, **kwargs)[source]

Bases: HawatBlueprint

Pluggable module - IDEA event timelines (timeline).

classmethod get_module_title()[source]

Get human readable name for this blueprint/module.

Returns

Name (short summary) of the blueprint/module.

Return type

str

register_app(app)[source]

Hook method: Custom callback, which will be called from hawat.app.Hawat.register_blueprint() method and which can perform additional tweaking of Hawat application object.

Parameters

app (hawat.app.Hawat) – Application object.

hawat.blueprints.timeline.get_blueprint()[source]

Mandatory interface for hawat.Hawat and factory function. This function must return a valid instance of hawat.app.HawatBlueprint or flask.Blueprint.