magpie.ui.utils¶
Attributes¶
Classes¶
Base methods for Magpie UI pages. |
|
Regroups multiple administration-level operations to be dispatched to the API requests. |
Functions¶
|
|
|
Use a pyramid sub-request to request Magpie API routes via the UI. This avoids max retries and closed connections |
|
Redirects the contents to be rendered by the UI 'error' page. |
|
Decorator that encapsulates the operation in a try/except block, and redirects the response to the UI error page |
Module Contents¶
- magpie.ui.utils.check_response(response: magpie.typedefs.AnyResponseType) magpie.typedefs.AnyResponseType [source]¶
- Returns:
response if the HTTP status code is successful.
- Raises:
HTTPError – (of appropriate type) if the response corresponds to an HTTP error code
- magpie.ui.utils.request_api(request: pyramid.request.Request, path: magpie.typedefs.Str, method: magpie.typedefs.Str = 'GET', data: magpie.typedefs.JSON | magpie.typedefs.Str | None = None, headers: magpie.typedefs.HeadersType | None = None, cookies: magpie.typedefs.CookiesType | None = None) magpie.typedefs.AnyResponseType [source]¶
Use a pyramid sub-request to request Magpie API routes via the UI. This avoids max retries and closed connections when using 1 worker (eg: during tests).
Some information is retrieved from
request
to pass down to the sub-request (eg: cookies). If they are passed as argument, corresponding values will override the ones found inrequest
.All sub-requests to the API are assumed to be
magpie.common.CONTENT_TYPE_JSON
unless explicitly overridden withheaders
. Headers are also looked for additionalSet-Cookie
header in case they need to be passed down tocookies
.- Parameters:
request – incoming Magpie UI request that requires sub-request to Magpie API, to retrieve required details.
path – local Magpie API path (relative to root without URL).
method – HTTP method to send the API sub-request.
data – JSON dictionary or literal string content of the request body.
headers – override headers to employ for the API sub-request. Defaults to JSON Accept & Content-Type headers.
cookies – Override cookies to employ for the API sub-request. Defaults to current logged user. For empty cookies (no user), explicitly provide an empty dictionary.
- magpie.ui.utils.redirect_error(request: pyramid.request.Request, code: int = None, content: magpie.typedefs.JSON | None = None) magpie.typedefs.AnyResponseType [source]¶
Redirects the contents to be rendered by the UI ‘error’ page.
- Parameters:
request – incoming request that resulted into some kind of error.
code – explicit HTTP status code for the error response, extracted from contents if otherwise available.
content – any body content provided as error response from the API.
- magpie.ui.utils.handle_errors(func: Callable) Callable [source]¶
Decorator that encapsulates the operation in a try/except block, and redirects the response to the UI error page with API error contents.
In worst case scenario where the operation cannot figure out what to do with the exception response, raise the most basic
HTTPInternalServerError
that can be formulated from available details.See also
- class magpie.ui.utils.BaseViews(request)[source]¶
Bases:
object
Base methods for Magpie UI pages.
- MAGPIE_FIXED_USERS_REFS = [][source]¶
Special User that cannot have any relationship edited.
This includes both Group memberships and Permission references.
- MAGPIE_USER_PWD_LOCKED = [][source]¶
Special User that could self-edit themselves, but is disabled since conflicting with other policies.
- MAGPIE_USER_PWD_DISABLED = [][source]¶
Special User where password cannot be edited (managed by Magpie configuration settings).
- MAGPIE_ANONYMOUS_GROUP = None[source]¶
Reference to
magpie.constants.MAGPIE_ANONYMOUS_GROUP
for convenience in UI pages.
- add_template_data(data: Dict[magpie.typedefs.Str, Any] | None = None) Dict[magpie.typedefs.Str, Any] [source]¶
Adds required template data for the ‘heading’ mako template applied to every UI page.
- render(template: magpie.typedefs.Str, data: Dict[magpie.typedefs.Str, Any] | None = None) pyramid.response.Response [source]¶
Render the response with an explicit Mako template reference.
Views that are decorated by
pyramid.view.view_config()
or registered bypyramid.config.Configurator.add_view()
with arenderer
parameter do not require to call this function as it is auto-resolved with the submitteddata
.
- class magpie.ui.utils.AdminRequests(request)[source]¶
Bases:
BaseViews
Regroups multiple administration-level operations to be dispatched to the API requests.
- create_user_default_template_data(data)[source]¶
Generates all the default values for the various fields employed for display purposes of the user creation form.
- Parameters:
data – any template data that should override the defaults.
- Returns:
updated template data with defaults and overridden values.
- get_admin_session() magpie.typedefs.CookiesType [source]¶
Temporarily login as default administrator to execute an elevated operation that the current user cannot make.
Warning
Cookies MUST NOT be preserved or memorized, to avoid user gaining restricted access. This is intended only for basic operations such as validating information. Care must be taken such information retrieved this way do not provide a way of non-administrator to indirectly infer some otherwise protected information. User sparingly.
- Returns:
Cookies of the administrator login.
- get_group_users(group_name: magpie.typedefs.Str, user_group_status: magpie.models.UserGroupStatus = UserGroupStatus.ACTIVE) List[magpie.typedefs.Str] [source]¶
- update_group_info(group_name: magpie.typedefs.Str, group_info: magpie.typedefs.JSON) magpie.typedefs.JSON [source]¶
- get_user_groups(user_name: magpie.typedefs.Str, user_group_status: magpie.models.UserGroupStatus = UserGroupStatus.ACTIVE) List[magpie.typedefs.Str] [source]¶
- get_user_statuses(status: magpie.typedefs.Str | int = 0) List[magpie.typedefs.Str] [source]¶
Obtains all user names that have the corresponding status value.
- get_user_details(status: str | int | None = None, cookies: magpie.typedefs.CookiesType | None = None) List[magpie.typedefs.JSON] [source]¶
Obtains all user details, optionally filtered to by corresponding status value.
Employ this method to avoid multiple requests fetching individual information.
- get_resource_types()[source]¶
- Returns:
dictionary of all resources as {id: ‘resource_type’}
- Return type:
dict
- static flatten_tree_resource(resource_node, resource_dict)[source]¶
- Parameters:
resource_node – any-level dictionary composing the resources tree
resource_dict – reference of flattened dictionary across levels
- Returns:
flattened dictionary resource_dict of all {id: ‘resource_type’}
- Return type:
dict
- create_user(data)[source]¶
Processes the user creation form with fields input data.
All the fields are pre- and post-validated according to expected behaviour by the API. Pre-validations attempt soft checks to detect as many potential errors such that they can all be simultaneously displayed on the form, to avoid back-and-forth erroneous submissions by the user. Post-validations are the hard checks imposed by the API, which include some of the pre-checks.
Whenever some failure occurs, returned data will contain
is_error
withTrue
orFalse
accordingly. Following successful request without error, the User will be created. It is up to the calling function to redirect the response and further process the returned data as needed.- Parameters:
data – initial templated data overrides according to who is initiation the user creation.
- Returns:
updated template data with any relevant error messages and statuses if applicable.
- Raises:
HTTPException – any unhandled or unknown HTTP error received from the API.