Enables a wireless network connection. Note: The function is executed in a "fire and forget" manner, to prevent the HTTP request from failing

Enforce client authentication checks by default.

A JSON response for a failed request. Args: original_error: The original error object Returns: A `flask.Response` object wit

* @param {TouchEvent} evt - See: * - https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent * - https://developer.mozilla.org/en-US

* @param {TouchEvent} evt - See: * - https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent * - https://developer.mozilla.org/en-US

Returns a connection to the SQlite database. Within a Flask app context, this function applies a caching mechanism to avoid redundant initial

Retrieves the current state of the update process. Checks the state of any actively running update jobs or jobs that have finished in the las

Looks up a user account by their username. Returns: The user, if found (as `User` object) Raises: db.users.UserDoesNotExistE

Get or (re-)create a secret key. If a secret key doesn't exist, a new one will be created and returned. If it finds the key file to be corru

Determines the hostname of the machine. Returns: On success, a JSON data structure with the following properties: hostname: strin

Changes the machine’s hostname. Expects a JSON data structure in the request body that contains the new hostname as string. Example: {

* Checks whether the preconditions are met for this event to be dispatched. * @returns {boolean}

Checks whether a session’s auth state is valid. This method effectively performs a combined authentication and authorization check (short: “a

Checks whether authentication is required to access the system. Returns: True if users are required to authenticate.

Retrieves the latest version of TinyPilot. Returns: On success, a JSON data structure with the following properties: version: str

Requests the latest release info from the TinyPilot Gatekeeper REST API. Returns: An UpdateInfo object, containing the information about

Retrieves the current TinyPilot update settings. Parses the contents of settings file and generates a settings object that represents the val

Read the current local version string from the version file. If run locally, in development, where a version file is not present, then a dumm

Starts a cookie-based session for a logged-in user. This method assumes that the user has been correctly authenticated and that a correspondi

Ends the session of the currently logged-in user. Note: we use crypto-based sessions rather than a server-side session store, so this will on

Logs out the current user and clears the session. Returns: Empty response on success, error object otherwise.

Decorator that monitors the session’s auth state of the socket. When socket events come in, it checks whether the session still satisfies the

Returns the current status of the available network interfaces. Returns: On success, a JSON data structure with the following: in

Disables the WiFi network connection. Returns: Empty response on success, error object otherwise.

Enables a wireless network connection. Expects a JSON data structure in the request body that contains a country code, an SSID, and optionall

Returns the current WiFi settings, if present. Returns: On success, a JSON data structure with the following properties: countryC

Decorator to exempt an endpoint from any auth check altogether. The endpoint will be publicly accessible by anyone, regardless of the system’

Returns a timezone-aware datetime for the current time in UTC.

* @param {KeyboardEvent} evt - https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent

* @function handleNewLogs * @param {string} logs - The newly received logs. * * Run a function when new logs are received. * @param {handl

Parses an ISO-8601-formatted string into a datetime object. Args: iso_8601_string: The ISO-8601-formatted string to parse (e.g.,

Parses the username, password and role from the Flask request body. Args: request: Flask request with the following fields in the body:

Parses the credentials (username/password) from the Flask request body. Args: request: Flask request with the following fields in the bod

Parses the username from the Flask request body. Args: request: Flask request with the username field as string in the body. Returns

Parses the STUN address (server + port) from a request. The server can be a valid domain name, or an IP address (IPv4 / IPv6). The server and

Parses the hostname property from the request. Parses the hostname from a JSON request and checks whether the hostname is valid according to

Parse a request with a JSON payload. Args: request: A flask.Request object that caller expects to carry a JSON dictionary payload.

Parses HID keystrokes from the request. Args: request: Flask request with the following fields in the JSON body: (str) text

Parses a mouse event from a JSON dictionary. Args: message: A JSON dictionary with the following fields: (int) buttons

Parses the password from the Flask request body. Args: request: Flask request with the following field in the body: (str) pas

Parses WiFi settings from the request. Returns: WifiSettings Raises: InvalidWifiSettings

Pastes text onto the target machine. Expects a JSON data structure in the request body that contains the following parameters: - text: st