org.directives

Module Contents

Classes

HomepageWidgetAction	Register a cronjob.
ExportAction	Register an export.
UserlinkAction	Registers a user link group.
DirectorySearchWidgetAction	Registers a directory search widget.
EventSearchWidgetAction	Registers a text search widget.
SettingsView	Registers a settings view.
Boardlet	Registers a boardlet on the Dashboard.

Attributes

DirectoryEntryT

org.directives.DirectoryEntryT

class org.directives.HomepageWidgetAction(tag: str)

Bases: dectate.Action

Register a cronjob.

config

identifier(homepage_widget_registry: dict[str, RegisteredHomepageWidget]) → str

Returns an immutable that uniquely identifies this config.

Needs to be implemented by the Action subclass.

Used for overrides and conflict detection.

If two actions in the same group have the same identifier in the same configurable, those two actions are in conflict and a ConflictError is raised during commit().

If an action in an extending configurable has the same identifier as the configurable being extended, that action overrides the original one in the extending configurable.

Parameters:

**kw – a dictionary of configuration objects as specified by the config class attribute.

Returns:

an immutable value uniquely identifying this action.

perform(func: Callable[[], HomepageWidget], homepage_widget_registry: dict[str, RegisteredHomepageWidget]) → None

Do whatever configuration is needed for obj.

Needs to be implemented by the Action subclass.

Raise a DirectiveError to indicate that the action cannot be performed due to incorrect configuration.

Parameters:

• obj – the object that the action should be performed for. Typically a function or a class object.

• **kw – a dictionary of configuration objects as specified by the config class attribute.

class org.directives.ExportAction(id: str, **kwargs: Any)

Bases: dectate.Action

Register an export.

config

identifier(export_registry: dict[str, Any]) → str

Returns an immutable that uniquely identifies this config.

Needs to be implemented by the Action subclass.

Used for overrides and conflict detection.

If two actions in the same group have the same identifier in the same configurable, those two actions are in conflict and a ConflictError is raised during commit().

If an action in an extending configurable has the same identifier as the configurable being extended, that action overrides the original one in the extending configurable.

Parameters:

**kw – a dictionary of configuration objects as specified by the config class attribute.

Returns:

an immutable value uniquely identifying this action.

perform(cls: Callable[..., Any], export_registry: dict[str, Any]) → None

Do whatever configuration is needed for obj.

Needs to be implemented by the Action subclass.

Raise a DirectiveError to indicate that the action cannot be performed due to incorrect configuration.

Parameters:

• obj – the object that the action should be performed for. Typically a function or a class object.

• **kw – a dictionary of configuration objects as specified by the config class attribute.

class org.directives.UserlinkAction

Bases: dectate.Action

Registers a user link group.

config

counter

identifier(linkgroup_registry: list[LinkGroupFactory]) → int

Returns an immutable that uniquely identifies this config.

Needs to be implemented by the Action subclass.

Used for overrides and conflict detection.

If two actions in the same group have the same identifier in the same configurable, those two actions are in conflict and a ConflictError is raised during commit().

If an action in an extending configurable has the same identifier as the configurable being extended, that action overrides the original one in the extending configurable.

Parameters:

**kw – a dictionary of configuration objects as specified by the config class attribute.

Returns:

an immutable value uniquely identifying this action.

perform(func: LinkGroupFactory, linkgroup_registry: list[LinkGroupFactory]) → None

Do whatever configuration is needed for obj.

Needs to be implemented by the Action subclass.

Raise a DirectiveError to indicate that the action cannot be performed due to incorrect configuration.

Parameters:

• obj – the object that the action should be performed for. Typically a function or a class object.

• **kw – a dictionary of configuration objects as specified by the config class attribute.

class org.directives.DirectorySearchWidgetAction(name: str)

Bases: dectate.Action

Registers a directory search widget.

config

identifier(directory_search_widget_registry: DirectorySearchWidgetRegistry) → str

Returns an immutable that uniquely identifies this config.

Needs to be implemented by the Action subclass.

Used for overrides and conflict detection.

If two actions in the same group have the same identifier in the same configurable, those two actions are in conflict and a ConflictError is raised during commit().

If an action in an extending configurable has the same identifier as the configurable being extended, that action overrides the original one in the extending configurable.

Parameters:

**kw – a dictionary of configuration objects as specified by the config class attribute.

Returns:

an immutable value uniquely identifying this action.

perform(cls: type[DirectorySearchWidget[Any]], directory_search_widget_registry: DirectorySearchWidgetRegistry) → None

Do whatever configuration is needed for obj.

Needs to be implemented by the Action subclass.

Raise a DirectiveError to indicate that the action cannot be performed due to incorrect configuration.

Parameters:

• obj – the object that the action should be performed for. Typically a function or a class object.

• **kw – a dictionary of configuration objects as specified by the config class attribute.

class org.directives.EventSearchWidgetAction(name: str)

Bases: dectate.Action

Registers a text search widget.

config

identifier(event_search_widget_registry: EventSearchWidgetRegistry) → str

Returns an immutable that uniquely identifies this config.

Needs to be implemented by the Action subclass.

Used for overrides and conflict detection.

If two actions in the same group have the same identifier in the same configurable, those two actions are in conflict and a ConflictError is raised during commit().

If an action in an extending configurable has the same identifier as the configurable being extended, that action overrides the original one in the extending configurable.

Parameters:

**kw – a dictionary of configuration objects as specified by the config class attribute.

Returns:

an immutable value uniquely identifying this action.

perform(cls: type[EventSearchWidget], event_search_widget_registry: EventSearchWidgetRegistry) → None

Do whatever configuration is needed for obj.

Needs to be implemented by the Action subclass.

Raise a DirectiveError to indicate that the action cannot be performed due to incorrect configuration.

Parameters:

• obj – the object that the action should be performed for. Typically a function or a class object.

• **kw – a dictionary of configuration objects as specified by the config class attribute.

class org.directives.SettingsView(name: str, title: str, order: int = 0, icon: str = 'fa-cogs')

Bases: dectate.Action

Registers a settings view.

config

identifier(settings_view_registry: dict[str, SettingsDict]) → str

Returns an immutable that uniquely identifies this config.

Needs to be implemented by the Action subclass.

Used for overrides and conflict detection.

If two actions in the same group have the same identifier in the same configurable, those two actions are in conflict and a ConflictError is raised during commit().

If an action in an extending configurable has the same identifier as the configurable being extended, that action overrides the original one in the extending configurable.

Parameters:

**kw – a dictionary of configuration objects as specified by the config class attribute.

Returns:

an immutable value uniquely identifying this action.

perform(func: Any, settings_view_registry: dict[str, SettingsDict]) → None

Do whatever configuration is needed for obj.

Needs to be implemented by the Action subclass.

Raise a DirectiveError to indicate that the action cannot be performed due to incorrect configuration.

Parameters:

• obj – the object that the action should be performed for. Typically a function or a class object.

• **kw – a dictionary of configuration objects as specified by the config class attribute.

class org.directives.Boardlet(name: str, order: tuple[int, int])

Bases: dectate.Action

Registers a boardlet on the Dashboard.

config

identifier(boardlets_registry: dict[str, BoardletConfig]) → str

Returns an immutable that uniquely identifies this config.

Needs to be implemented by the Action subclass.

Used for overrides and conflict detection.

If two actions in the same group have the same identifier in the same configurable, those two actions are in conflict and a ConflictError is raised during commit().

If an action in an extending configurable has the same identifier as the configurable being extended, that action overrides the original one in the extending configurable.

Parameters:

**kw – a dictionary of configuration objects as specified by the config class attribute.

Returns:

an immutable value uniquely identifying this action.

perform(func: type[onegov.org.models.Boardlet], boardlets_registry: dict[str, BoardletConfig]) → None

Do whatever configuration is needed for obj.

Needs to be implemented by the Action subclass.

Raise a DirectiveError to indicate that the action cannot be performed due to incorrect configuration.

Parameters:

• obj – the object that the action should be performed for. Typically a function or a class object.

• **kw – a dictionary of configuration objects as specified by the config class attribute.