API¶

The public API for Flask-Copilot.

Copilot¶

class flask_copilot.Copilot(app=None)[source]¶

The Flask-Copilot extension.

Parameters:	app (Optional[flask.Flask]) – The application instance that this copilot should be registered to.

init_app(app)[source]¶

Register the extension with the application.

Parameters:	app (flask.Flask) – The application to register with.

register_entry(navbar_kwargs)[source]¶

Register a navbar entry with the copilot.

Parameters:	navbar_kwargs (dict) – Arguments passed to the `NavbarEntry` instance.

class flask_copilot.NavbarEntry(name, endpoint, url_for_kwargs=None, order=None, when=None)[source]¶

Stores information related to a routing rule’s navbar position.

Parameters:

name (str) – The text of the link in the navbar. This element is converted to a str when added to the navbar and used for display and sorting purposes. This value should be unique within a group (i.e. a single name should not have more than one URL rule associated with it).
endpoint (str) – The endpoint assigned to the URL rule this NavbarEntry belongs to. This should be used to generate the URL for the link.
url_for_kwargs (dict) – Keyword arguments to be passed to url_for when generating URLs from endpoint.
order – An object used to sort the navigation entries. If not provided, the entry’s name (the last element of path) will be used. All entries in the same group must be orderable together.
when (Optional[callable]) – If provided, the link will appear only when the value returned by when() is truthy.

url(default_href='#')[source]¶

Return a rendered URL for this entry.

Parameters:	default_href (str) – The value to return if no endpoint is assigned to this entry. Defaults to `'#'`.

visible¶

Return True when this entry should be visible.

Rules dictating visibility, in order or precedence:

If an entry has a when method, its result is returned.
If an entry has children and no endpoint (i.e. it exists solely as a container for other links), it is visible when any of its children are.
Finally, when the first two rules don’t apply, visibility defaults to True.