fastapi2cli.web package

Submodules

fastapi2cli.web.authentication module

class fastapi2cli.web.authentication.AuthenticationManager(authenticated_dependencies: list[Callable], authentication_resolver: AuthenticationResolverBase)

Bases: object

Manager for authentication.

This class manages authentication for dependencies and routes.

property cookies: dict[str, Any]

Get cookies for authentication.

Returns:

A dictionary containing cookies.

Return type:

dict[str, Any]

property headers: dict[str, Any]

Get headers for authentication.

Returns:

A dictionary containing headers.

Return type:

dict[str, Any]

is_dependency_authenticated(dependency: Dependant)

Check if a dependency is authenticated.

Parameters:

dependency (Dependant) – The dependency to check.

Returns:

True if the dependency is authenticated, False otherwise.

Return type:

bool

is_route_authenticated(route: APIRoute) → bool

Check if a route is authenticated.

Parameters:

route (APIRoute) – The route to check.

Returns:

True if the route is authenticated, False otherwise.

Return type:

bool

property query_parameters: dict[str, Any]

Get query parameters for authentication.

Returns:

A dictionary containing query parameters.

Return type:

dict[str, Any]

set_server_url(server_url: str) → None

set the server url for the authentication_resolver using the same server_url as the request. Called for each request.

Parameters:

server_url (str) – the server_url to use for authentication

class fastapi2cli.web.authentication.AuthenticationResolverBase

Bases: object

Base class for authentication resolver.

This class provides default implementations for authentication resolver methods.

get_cookies() → dict[str, Any]

Get cookies for authentication.

Returns:

A dictionary containing cookies.

Return type:

dict[str, Any]

get_headers() → dict[str, Any]

Get headers for authentication.

Returns:

A dictionary containing headers.

Return type:

dict[str, Any]

get_query_parameters() → dict[str, Any]

Get query parameters for authentication.

Returns:

A dictionary containing query parameters.

Return type:

dict[str, Any]

set_server_url(server_url: str)

Set the server url we are working on, useful for case where server_url is known only after parsing –server-url from cli. you should ignore this call if the authentication server is on a different server_url than the request one.

Parameters:

server_url (str) – the server_url to use for authentication

class fastapi2cli.web.authentication.NoAuthResolver

Bases: AuthenticationResolverBase

Authentication resolver for no authentication.

This class provides an implementation for authentication resolver methods when no authentication is required.

get_cookies() → dict[str, Any]

Get cookies for authentication.

Raises:

NoAuthResolverException – Always raised since no authentication cookies are available.

get_headers() → dict[str, Any]

Get headers for authentication.

Raises:

NoAuthResolverException – Always raised since no authentication headers are available.

get_query_parameters() → dict[str, Any]

Get query parameters for authentication.

Raises:

NoAuthResolverException – Always raised since no authentication query parameters are available.

exception fastapi2cli.web.authentication.NoAuthResolverException

Bases: Exception

Exception raised when authentication resolver is not available.

This exception is raised when attempting to access authenticated resources but no authentication resolver are provided.

fastapi2cli.web.parameters module

fastapi2cli.web.parameters.get_body(route: APIRoute, **http_parameters: Any) → BaseModel | None

Get the body parameters for a given route.

This function retrieves the body parameters for a given route from the provided HTTP parameters.

Parameters:

  • route (APIRoute) – The route for which to retrieve the body parameters.

  • http_parameters (Any) – HTTP parameters to retrieve the body parameters from.

Returns:

The body parameters.

Return type:

BaseModel | None

Get the cookie parameters for a given route.

This function retrieves the cookie parameters for a given route from the provided HTTP parameters.

Parameters:

  • route (APIRoute) – The route for which to retrieve the cookie parameters.

  • http_parameters (Any) – HTTP parameters to retrieve the cookie parameters from.

Returns:

The cookie parameters.

Return type:

dict[str, Any]

fastapi2cli.web.parameters.get_formatted_url(url: str, route: APIRoute, **http_parameters: Any) → str

Get the formatted URL for a given route.

This function formats the URL for a given route with the provided HTTP parameters.

Parameters:

  • url (str) – The base URL to format.

  • route (APIRoute) – The route for which to format the URL.

  • http_parameters (Any) – HTTP parameters to use for formatting the URL.

Returns:

The formatted URL.

Return type:

str

fastapi2cli.web.parameters.get_header_parameters(route: APIRoute, **http_parameters: Any) → dict[str, Any]

Get the header parameters for a given route.

This function retrieves the header parameters for a given route from the provided HTTP parameters.

Parameters:

  • route (APIRoute) – The route for which to retrieve the header parameters.

  • http_parameters (Any) – HTTP parameters to retrieve the header parameters from.

Returns:

The header parameters.

Return type:

dict[str, Any]

fastapi2cli.web.parameters.get_parameter_value(parameter_name: str, field_info: FieldInfo, **http_parameters: Any) → Any

Get the value of a parameter from HTTP parameters.

This function retrieves the value of a parameter from the provided HTTP parameters. It checks whether the parameter is required, and if not provided, it returns the default value defined in the field info.

Parameters:

  • parameter_name (str) – The name of the parameter to get the value of.

  • field_info (FieldInfo) – Information about the parameter field.

  • http_parameters (Any) – HTTP parameters to retrieve the value from.

Returns:

The value of the parameter.

Return type:

Any

Raises:

KeyError – If a required parameter is missing in the HTTP parameters.

fastapi2cli.web.parameters.get_parameters_values(parameter_definitions: dict[str, FieldInfo], **http_parameters)

Get the values of parameters from HTTP parameters.

This function retrieves the values of parameters defined by the given parameter definitions from the provided HTTP parameters.

Parameters:

  • parameter_definitions (dict[str, FieldInfo]) – Definitions of parameters to retrieve values for.

  • http_parameters (Any) – HTTP parameters to retrieve values from.

Returns:

The values of the parameters.

Return type:

dict[str, Any]

fastapi2cli.web.parameters.get_query_parameters(route: APIRoute, **http_parameters: Any) → dict[str, Any]

Get the query parameters for a given route.

This function retrieves the query parameters for a given route from the provided HTTP parameters.

Parameters:

  • route (APIRoute) – The route for which to retrieve the query parameters.

  • http_parameters (Any) – HTTP parameters to retrieve the query parameters from.

Returns:

The query parameters.

Return type:

dict[str, Any]

fastapi2cli.web.server_interactor module

class fastapi2cli.web.server_interactor.RequestExecutor(*args, **kwargs)

Bases: Protocol

A protocol representing an HTTP request executor.

This protocol defines the structure of an object that can execute HTTP requests.

request(method: str, url: str, params: dict[str, Any], headers: dict[str, Any], cookies: dict[str, Any], json: dict[str, Any] | None) → Response

Execute an HTTP request.

Parameters:

  • method (str) – The HTTP method to use for the request.

  • url (str) – The URL to send the request to.

  • params (dict[str, Any]) – The query parameters for the request.

  • headers (dict[str, Any]) – The headers for the request.

  • cookies (dict[str, Any]) – The cookies for the request.

  • json (dict[str, Any] | None) – The JSON payload for the request.

Returns:

The response to the request.

Return type:

Response

class fastapi2cli.web.server_interactor.ServerInteractor(server_url: str, request_executor: RequestExecutor, authentication_manager: AuthenticationManager)

Bases: object

Interacts with the server by sending requests and handling responses.

This class provides methods to interact with the server by sending requests and handling responses. It uses a request executor to send HTTP requests and an authentication manager to manage authentication.

get_response(route: APIRoute, **http_parameters: Any) → Response

Get the response from the server for a given route.

This method constructs the URL, parameters, headers, and cookies for the request based on the route and provided HTTP parameters. It then sends the request using the request executor and returns the response.

Parameters:

  • route (APIRoute) – The route for which to get the response.

  • http_parameters (Any) – The HTTP parameters for the request.

Returns:

The response from the server.

Return type:

Response

request(route: APIRoute, **http_parameters: Any) → T | list[T]

Send a request to the server and handle the response.

This method sends a request to the server for the given route with the provided HTTP parameters. It then handles the response based on the route’s response model.

Parameters:

  • route (APIRoute) – The route for which to send the request.

  • http_parameters (Any) – The HTTP parameters for the request.

Returns:

The response from the server.

Return type:

T | list[T]

Module contents