utils package

Submodules

utils.authentication module

Module containing a custom OAuth2 authentication class.

class utils.authentication.GPFOAuth2Authentication

Bases: OAuth2Authentication

Provide custom OAuth2 authentication.

This authentication class that will return a 401 error in the case that an invalid OAuth token has been provided. We need this behaviour as we have routes which will allow unauthenticated requests, which in turn prevents distinguishing requests with expired tokens from those that bear no authentication headers.

authenticate(request: HttpRequest) → tuple | None

Returns two-tuple of (user, token) if authentication succeeds, or None otherwise.

class utils.authentication.ReadOnlyDBAuthentication

Bases: BaseAuthentication

Authentication class intended to be used as a safeguard when we want the database to be read-only.

This is designed to be used when we want to migrate the production instance soon, and want to ensure that the database state is frozen, so that no new data can be missed during the migration.

authenticate(_request: Request) → None

Authenticate the request.

class utils.authentication.SessionAuthenticationWithUnauthenticatedCSRF

Bases: SessionAuthentication

Session authentication with unauthenticated CSRF.

authenticate(request: Request) → tuple | None

Return the currently logged-in user or None otherwise.

class utils.authentication.SessionAuthenticationWithoutCSRF

Bases: SessionAuthentication

enforce_csrf(request: Request) → None

Enforce CSRF validation for session based authentication.

utils.authentication.oauth_cookie_to_header(get_response: Callable[[HttpRequest], HttpResponse]) → Callable[[HttpRequest], HttpResponse]

Middleware patch to allow storing OAuth tokens as cookies.

utils.datasets module

utils.datasets.find_dataset_id_in_dict(dictionary: dict) → str | None

Find dataset_id in a dictionary.

utils.datasets.find_dataset_id_in_request(request: Any) → str | None

Find dataset_id in a DRF request.

utils.email_regex module

utils.email_regex.is_email_valid(email: str) → bool

utils.expand_gene_set module

utils.expand_gene_set.expand_gene_set(data: dict) → dict

Expand gene set to list of gene symbols.

utils.expand_gene_set.expand_gene_syms(data: dict) → dict

Expand gene set symbols.

utils.gene_sets module

utils.gene_sets.get_denovo_gene_set_spec(gene_sets_types: list[Any]) → dict[str, Any]

Convert typescript style gene sets types into python dict.

utils.logger module

utils.logger.log_filter(request: Request | WSGIRequest, message: str, *args: Any) → str

Filter request info for logging.

utils.logger.request_logging(logger: Logger) → Callable[[F], F]

Automatically log request info on views.

utils.logger.request_logging_function_view(logger: Logger) → Callable[[F], F]

Automatically log request info on view functions.

utils.pagination module

class utils.pagination.WdaePageNumberPagination

Bases: PageNumberPagination

Custom pagination class that handles empty pages.

get_paginated_response(data: list[Any]) → Response

page_size_query_param = 'page_size'

paginate_queryset(queryset: Any, request: Request, view: APIView | None = None) → list[Any] | None

Paginate and handle empty pages by returning 204.

utils.password_requirements module

utils.password_requirements.is_password_valid(password: str) → bool

Validate a password.

A password is considered valid if it is at least ten symbols long and is not a commonly used (blacklisted) password.

utils.query_params module

utils.query_params.parse_query_params(data: dict) → dict

utils.streaming_response_util module

utils.streaming_response_util.convert(obj: Any) → int | float

utils.streaming_response_util.iterator_to_json(variants: Generator[list[Any] | None, None, None]) → Generator[str, None, None]

Convert an iterator of dictionaries to a JSON array string generator.

utils.testing module

utils.testing.setup_t4c8_grr(root_path: Path) → GenomicResourceRepo

utils.testing.setup_t4c8_instance(root_path: Path) → GPFInstance

utils.testing.setup_wgpf_instance(root_path: Path) → WGPFInstance

Module contents