You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 

22 lines
977 B

from typing import Any, Callable, Union
from .. import globals # pylint: disable=redefined-builtin
def open(target: Union[Callable[..., Any], str], new_tab: bool = False) -> None: # pylint: disable=redefined-builtin
"""Open
Can be used to programmatically trigger redirects for a specific client.
Note that *all* clients (i.e. browsers) connected to the page will open the target URL *unless* a socket is specified.
User events like button clicks provide such a socket.
:param target: page function or string that is a an absolute URL or relative path from base URL
:param new_tab: whether to open the target in a new tab
"""
path = target if isinstance(target, str) else globals.page_routes[target]
client = globals.get_client()
if client.has_socket_connection:
client.open(path, new_tab)
else:
globals.log.error('Cannot open page because client is not connected, try RedirectResponse from FastAPI instead')