galaxy.work package

Submodules

galaxy.work.context module

class galaxy.work.context.WorkRequestContext(app, user=None, history=None, workflow_building_mode=False, url_builder=None, galaxy_session: GalaxySession | None = None)

Bases: ProvidesHistoryContext

Stripped down implementation of Galaxy web transaction god object for work request handling outside of web threads - uses mix-ins shared with GalaxyWebTransaction to provide app, user, and history context convenience methods - but nothing related to HTTP handling, mako views, etc….

Things that only need app shouldn’t be consuming trans - but there is a need for actions potentially tied to users and histories and hopefully this can define that stripped down interface providing access to user and history information - but not dealing with web request and response objects.

__init__(app, user=None, history=None, workflow_building_mode=False, url_builder=None, galaxy_session: GalaxySession | None = None)

property app

Provide access to the Galaxy app object.

property url_builder

Provide access to Galaxy URLs (if available).

Parameters:

qualified (bool) – if True, the fully qualified URL is returned, else a relative URL is returned (default False).

get_history(create=False)

property history

Provide access to the user’s current history model object.

Return type:

Optional[galaxy.model.History]

get_user()

Return the current user if logged in or None.

get_current_user_roles()

set_user(user)

Set the current user.

property user

Return the current user if logged in or None.

class galaxy.work.context.GalaxyAbstractRequest

Bases: object

Abstract interface to provide access to some request properties.

abstract property base: str

Base URL of the request.

abstract property host: str

The host address.

abstract property is_secure: bool

Was this a secure (https) request.

abstract get_cookie(name)

Return cookie.

class galaxy.work.context.GalaxyAbstractResponse

Bases: object

Abstract interface to provide access to some response utilities.

abstract property headers: dict

The response headers.

set_content_type(content_type: str)

Sets the Content-Type header

get_content_type()

abstract set_cookie(key: str, value: str = '', max_age: int | None = None, expires: int | None = None, path: str = '/', domain: str | None = None, secure: bool = False, httponly: bool = False, samesite: typing_extensions.Literal[lax, strict, none] | None = 'lax') → None

Set a cookie.

class galaxy.work.context.SessionRequestContext(**kwargs)

Bases: WorkRequestContext

Like WorkRequestContext, but provides access to request.

__init__(**kwargs)

property host

property request: GalaxyAbstractRequest

property response: GalaxyAbstractResponse

get_galaxy_session()

set_history(history)

galaxy.work.context.proxy_work_context_for_history(trans: ProvidesHistoryContext, history: History | None = None, workflow_building_mode=False)

Create a WorkContext for supplied context with potentially different history.

This provides semi-structured access to a transaction/work context with a supplied target history that is different from the user’s current history (which also might change during the request).