cowbird.handlers

Subpackages

• cowbird.handlers.impl
  • cowbird.handlers.impl.catalog
  • cowbird.handlers.impl.filesystem
  • cowbird.handlers.impl.geoserver
  • cowbird.handlers.impl.magpie
  • cowbird.handlers.impl.nginx
  • cowbird.handlers.impl.thredds

Submodules

• cowbird.handlers.handler
• cowbird.handlers.handler_factory

Package Contents

Classes

Handler	Helper class that provides a standard way to create an ABC using
HandlerFactory	Create handler instance using handler name.

Functions

get_handlers(→ List[handler.Handler])

Obtains the handlers managed by the application.

Attributes

AnySettingsContainer

class cowbird.handlers.Handler(settings: cowbird.typedefs.SettingsType, name: str, **kwargs: Any)

Bases: abc.ABC

Helper class that provides a standard way to create an ABC using inheritance.

Parameters:

• settings – Cowbird settings for convenience

• name – Handler name

• kwargs – The base class handle, but doesn’t require the following variables:

• url – Location of the web service represented by the cowbird handler

• workspace_dir – Workspace directory

• priority – Relative priority between handlers while handling events. Lower value has higher priority, default value is last.

abstract property required_params: List[AnyHandlerParameter]

__slots__

Handler interface used to notify implemented handlers of users/permissions changes.

Todo

At some point we will need a consistency function that goes through all Magpie users and make sure that handlers are up-to-date.

json() → cowbird.typedefs.JSON

_user_workspace_dir(user_name: str) → str

abstract user_created(user_name: str) → None

abstract user_deleted(user_name: str) → None

abstract permission_created(permission: cowbird.permissions_synchronizer.Permission) → None

abstract permission_deleted(permission: cowbird.permissions_synchronizer.Permission) → None

abstract resync() → None

class cowbird.handlers.HandlerFactory

Create handler instance using handler name.

create_handler(name: Literal[Catalog]) → cowbird.handlers.impl.catalog.Catalog

create_handler(name: Literal[FileSystem]) → cowbird.handlers.impl.filesystem.FileSystem

create_handler(name: Literal[Geoserver]) → cowbird.handlers.impl.geoserver.Geoserver

create_handler(name: Literal[Magpie]) → cowbird.handlers.impl.magpie.Magpie

create_handler(name: Literal[Nginx]) → cowbird.handlers.impl.nginx.Nginx

create_handler(name: Literal[Thredds]) → cowbird.handlers.impl.thredds.Thredds

create_handler(name: str) → cowbird.handlers.handler.Handler | None

Instantiates a new Handler implementation using its name, overwriting an existing instance if required.

get_handler(name: Literal[Catalog]) → cowbird.handlers.impl.catalog.Catalog

get_handler(name: Literal[FileSystem]) → cowbird.handlers.impl.filesystem.FileSystem

get_handler(name: Literal[Geoserver]) → cowbird.handlers.impl.geoserver.Geoserver

get_handler(name: Literal[Magpie]) → cowbird.handlers.impl.magpie.Magpie

get_handler(name: Literal[Nginx]) → cowbird.handlers.impl.nginx.Nginx

get_handler(name: Literal[Thredds]) → cowbird.handlers.impl.thredds.Thredds

get_handler(name: str) → cowbird.handlers.handler.Handler | None

Instantiates a Handler implementation using its name if it doesn’t exist or else returns the existing one from cache.

get_active_handlers() → List[cowbird.handlers.handler.Handler]

Return a sorted list by priority of Handler implementation activated in the config.

cowbird.handlers.AnySettingsContainer

cowbird.handlers.get_handlers(container: cowbird.typedefs.AnySettingsContainer | None = None) → List[handler.Handler]

Obtains the handlers managed by the application.