tiled.client.from_tree¶
- tiled.client.from_tree(tree, structure_clients='numpy', *, authentication=None, server_settings=None, query_registry=None, serialization_registry=None, compression_registry=None, validation_registry=None, cache=None, offline=False, username=None, auth_provider=None, api_key=None, token_cache='/home/runner/.cache/tiled/tokens', headers=None, timeout=None, prompt_for_reauthentication=None)[source]¶
Connect to a Node directly, running the app in this same process.
NOTE: This is experimental. It may need to be re-designed or even removed.
In this configuration, we are using the server, but we are communicating with it directly within this process, not over a local network. It is generally faster.
Specifically, we are using HTTP over ASGI rather than HTTP over TCP. There are no sockets or network-related syscalls.
- Parameters:
- treeNode
- structure_clientsstr or dict, optional
Use “dask” for delayed data loading and “numpy” for immediate in-memory structures (e.g. normal numpy arrays, pandas DataFrames). For advanced use, provide dict mapping a structure_family or a spec to a client object.
- authenticationdict, optional
Dict of authentication configuration.
- usernamestr, optional
Username for authenticated access.
- auth_providerstr, optional
Name of an authentication provider. If None and the server supports multiple provides, the user will be interactively prompted to choose from a list.
- api_keystr, optional
API key based authentication. Cannot mix with username/auth_provider.
- cacheCache, optional
- offlinebool, optional
False by default. If True, rely on cache only.
- token_cachestr, optional
Path to directory for storing refresh tokens.
- prompt_for_reauthenticationbool, optional
If True, prompt interactively for credentials if needed. If False, raise an error. By default, attempt to detect whether terminal is interactive (is a TTY).
- timeouthttpx.Timeout, optional
If None, use Tiled default settings. (To disable timeouts, use httpx.Timeout(None)).