OpenAPISpec#

class langchain_community.utilities.openapi.OpenAPISpec[source]#

OpenAPI Model that removes mis-formatted parts of the spec.

Attributes

base_url

Get the base url.

openapi

Methods

from_file(path)

Get an OpenAPI spec from a file path.

from_spec_dict(spec_dict)

Get an OpenAPI spec from a dict.

from_text(text)

Get an OpenAPI spec from a text.

from_url(url)

Get an OpenAPI spec from a URL.

get_cleaned_operation_id(operation, path, method)

Get a cleaned operation id from an operation id.

get_methods_for_path(path)

Return a list of valid methods for the specified path.

get_operation(path, method)

Get the operation object for a given path and HTTP method.

get_parameters_for_operation(operation)

Get the components for a given operation.

get_parameters_for_path(path)

get_referenced_schema(ref)

Get a schema (or nested reference) or err.

get_request_body_for_operation(operation)

Get the request body for a given operation.

get_schema(schema[, depth, max_depth])

parse_obj(obj)

classmethod from_file(path: str | Path) OpenAPISpec[source]#

Get an OpenAPI spec from a file path.

Parameters:

path (str | Path)

Return type:

OpenAPISpec

classmethod from_spec_dict(spec_dict: dict) OpenAPISpec[source]#

Get an OpenAPI spec from a dict.

Parameters:

spec_dict (dict)

Return type:

OpenAPISpec

classmethod from_text(text: str) OpenAPISpec[source]#

Get an OpenAPI spec from a text.

Parameters:

text (str)

Return type:

OpenAPISpec

classmethod from_url(url: str) OpenAPISpec[source]#

Get an OpenAPI spec from a URL.

Parameters:

url (str)

Return type:

OpenAPISpec

static get_cleaned_operation_id(operation: Operation, path: str, method: str) str[source]#

Get a cleaned operation id from an operation id.

Parameters:
  • operation (Operation)

  • path (str)

  • method (str)

Return type:

str

get_methods_for_path(path: str) List[str][source]#

Return a list of valid methods for the specified path.

Parameters:

path (str)

Return type:

List[str]

get_operation(path: str, method: str) Operation[source]#

Get the operation object for a given path and HTTP method.

Parameters:
  • path (str)

  • method (str)

Return type:

Operation

get_parameters_for_operation(operation: Operation) List[Parameter][source]#

Get the components for a given operation.

Parameters:

operation (Operation)

Return type:

List[Parameter]

get_parameters_for_path(path: str) List[Parameter][source]#
Parameters:

path (str)

Return type:

List[Parameter]

get_referenced_schema(ref: Reference) Schema[source]#

Get a schema (or nested reference) or err.

Parameters:

ref (Reference)

Return type:

Schema

get_request_body_for_operation(operation: Operation) RequestBody | None[source]#

Get the request body for a given operation.

Parameters:

operation (Operation)

Return type:

Optional[RequestBody]

get_schema(schema: Reference | Schema, depth: int = 0, max_depth: int | None = None) Schema[source]#
Parameters:
  • schema (Union[Reference, Schema])

  • depth (int)

  • max_depth (Optional[int])

Return type:

Schema

classmethod parse_obj(obj: dict) OpenAPISpec[source]#
Parameters:

obj (dict)

Return type:

OpenAPISpec