weaver.wps_restapi.api

Module Contents

weaver.wps_restapi.api.LOGGER[source]
weaver.wps_restapi.api.api_frontpage(request)[source]

Frontpage of Weaver.

weaver.wps_restapi.api.api_frontpage_body(settings: weaver.typedefs.SettingsType)weaver.typedefs.JSON[source]

Generates the JSON body describing the Weaver API and documentation references.

weaver.wps_restapi.api.api_versions(request: pyramid.request.Request)pyramid.httpexceptions.HTTPException[source]

Weaver versions information.

weaver.wps_restapi.api.api_conformance(request: pyramid.request.Request)pyramid.httpexceptions.HTTPException[source]

Weaver specification conformance information.

weaver.wps_restapi.api.get_openapi_json(http_scheme: str = 'http', http_host: str = 'localhost', base_url: Optional[str] = None, use_refs: bool = True, use_docstring_summary: bool = True, settings: Optional[weaver.typedefs.SettingsType] = None)weaver.typedefs.JSON[source]

Obtains the JSON schema of Weaver OpenAPI from request and response views schemas.

Parameters
  • http_scheme – Protocol scheme to use for building the API base if not provided by base URL parameter.

  • http_host – Hostname to use for building the API base if not provided by base URL parameter.

  • base_url – Explicit base URL to employ of as API base instead of HTTP scheme/host parameters.

  • use_refs – Generate schemas with $ref definitions or expand every schema content.

  • use_docstring_summary – Extra function docstring to auto-generate the summary field of responses.

  • settings – Application settings to retrieve further metadata details to be added to the OpenAPI.

weaver.wps_restapi.api.openapi_json_cached(*args, **kwargs)[source]
weaver.wps_restapi.api.openapi_json(request: pyramid.request.Request)dict[source]

Weaver OpenAPI schema definitions.

weaver.wps_restapi.api.swagger_ui_cached(request)[source]
weaver.wps_restapi.api.api_swagger_ui(request)[source]

Weaver OpenAPI schema definitions rendering using Swagger-UI viewer.

weaver.wps_restapi.api.redoc_ui_cached(request)[source]
weaver.wps_restapi.api.api_redoc_ui(request)[source]

Weaver OpenAPI schema definitions rendering using Redoc viewer.

weaver.wps_restapi.api.get_request_info(request: pyramid.request.Request, detail: Optional[str] = None)weaver.typedefs.JSON[source]

Provided additional response details based on the request and execution stack on failure.

weaver.wps_restapi.api.ows_json_format(function)[source]

Decorator that adds additional detail in the response’s JSON body if this is the returned content-type.

weaver.wps_restapi.api.not_found_or_method_not_allowed(request)[source]

Overrides the default is HTTPNotFound [404] by appropriate HTTPMethodNotAllowed [405] when applicable.

Not found response can correspond to underlying process operation not finding a required item, or a completely unknown route (path did not match any existing API definition). Method not allowed is more specific to the case where the path matches an existing API route, but the specific request method (GET, POST, etc.) is not allowed on this path.

Without this fix, both situations return [404] regardless.

weaver.wps_restapi.api.unauthorized_or_forbidden(request)[source]

Overrides the default is HTTPForbidden [403] by appropriate HTTPUnauthorized [401] when applicable.

Unauthorized response is for restricted user access according to credentials and/or authorization headers. Forbidden response is for operation refused by the underlying process operations.

Without this fix, both situations return [403] regardless.