@anvil-works/anvil-pyright 0.0.1 → 0.0.2-canary

package/dist/anvil-typeshed/client/anvil/media.pyi

@@ -0,0 +1,46 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.media module
+# Generated files: client/anvil/media.pyi, server/anvil/media.pyi
+
+from typing import IO, Any
+
+from anvil import Media
+
+def print_media(media: Media, /) -> None:
+    """Print the given Media Object immediately in the user's browser."""
+    ...
+
+def download(media: Media, /) -> None:
+    """Download the given Media Object immediately in the user's browser."""
+    ...
+
+class TempUrl:
+    """Creates a temporary client-side URL for a Media object, even if the media has no permanent URL.
+
+    This URL should be revoked when you are finished with it. If you use TempUrl as a context
+    manager ('with TempUrl(media) as url:'), this happens automatically; if you instantiate it
+    manually you must call 'revoke()' on the instance.
+
+    The download argument only affects LazyMedia objects."""
+
+    url: str
+    """The temporary URL."""
+
+    def __init__(self, media: Media, *, download: bool = True) -> None: ...
+    def __enter__(self) -> str:
+        """Get the url using a 'with' block."""
+        ...
+    def __exit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:
+        """Revoke a url when exiting a 'with' block."""
+        ...
+    def revoke(self) -> None:
+        """Revoke a url from a media object."""
+        ...
+
+
+def write_to_file(media: Media, filename: str) -> None:
+    """Write a Media object to the given file."""
+    ...

package/dist/anvil-typeshed/client/anvil/microsoft/__init__.pyi

@@ -0,0 +1,8 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.microsoft module
+# Generated files: client/anvil/microsoft/__init__.pyi, server/anvil/microsoft/__init__.pyi
+
+from anvil.microsoft import auth as auth

package/dist/anvil-typeshed/client/anvil/microsoft/auth.pyi

@@ -0,0 +1,34 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.microsoft.auth module
+# Generated files: client/anvil/microsoft/auth.pyi, server/anvil/microsoft/auth.pyi
+
+def login() -> None:
+    """Prompt the user to log in with their Microsoft account."""
+    ...
+
+def get_user_email() -> str | None:
+    """Get the email address of the currently-logged-in Microsoft user.
+
+    To log in with Microsoft, call anvil_microsoft.auth.login() from form code."""
+    ...
+
+def get_user_access_token() -> str | None:
+    """Get the secret access token of the currently-logged-in Microsoft user, for use with the Microsoft REST API.
+
+    Requires this app to have its own Microsoft client ID and secret."""
+    ...
+
+def get_user_refresh_token() -> str | None:
+    """Get the secret refresh token of the currently-logged-in Microsoft user, for use with the Microsoft REST API.
+
+    Requires this app to have its own Microsoft client ID and secret."""
+    ...
+
+def refresh_access_token(refresh_token: str, /) -> str:
+    """Get a new access token from a refresh token you have saved, for use with the Microsoft REST API.
+
+    Requires this app to have its own Microsoft client ID and secret."""
+    ...

package/dist/anvil-typeshed/client/anvil/mpl_util.pyi

@@ -0,0 +1,29 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.mpl_util module
+# Generated files: client/anvil/mpl_util.pyi, server/anvil/mpl_util.pyi
+
+from typing import Any
+
+from anvil import Media
+
+def plot_image(
+    *,
+    dpi: int | None = None,
+    facecolor: Any | None = None,
+    edgecolor: Any | None = None,
+    format: str | None = None,
+    transparent: bool | None = None,
+    frameon: bool | None = None,
+    bbox_inches: str | Any | None = None,
+    pad_inches: float | None = None,
+    filename: str | None = None,
+) -> Media:
+    """Return the current Matplotlib figure as a PNG image.
+
+    Returns an Anvil Media object that can be displayed in Image components.
+
+    Optional arguments have the same meaning as for 'savefig()'."""
+    ...

package/dist/anvil-typeshed/client/anvil/plotly_templates.pyi

@@ -0,0 +1,15 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.plotly_templates module
+# Generated files: client/anvil/plotly_templates.pyi, server/anvil/plotly_templates.pyi
+
+from typing import Any
+
+templates: dict[str, Any]
+"""A dictionary of custom templates for anvil themes."""
+
+def set_default(template: str | Any) -> None:
+    """Sets the default plotly template."""
+    ...

package/dist/anvil-typeshed/client/anvil/saml/__init__.pyi

@@ -0,0 +1,8 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.saml module
+# Generated files: client/anvil/saml/__init__.pyi, server/anvil/saml/__init__.pyi
+
+from anvil.saml import auth as auth

package/dist/anvil-typeshed/client/anvil/saml/auth.pyi

@@ -0,0 +1,24 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.saml.auth module
+# Generated files: client/anvil/saml/auth.pyi, server/anvil/saml/auth.pyi
+
+from typing import Any
+
+def login() -> None:
+    """Prompt the user to log in via SAML."""
+    ...
+
+def get_user_email() -> str | None:
+    """Get the email address of the currently-logged-in SAML user.
+
+    To log in with SAML, call anvil.saml.auth.login() from form code."""
+    ...
+
+def get_user_attributes() -> dict[str, Any] | None:
+    """Get the user attributes of the currently-logged-in SAML user.
+
+    The exact attributes available will depend on your SAML Identity Provider."""
+    ...

package/dist/anvil-typeshed/client/anvil/secrets.pyi

@@ -0,0 +1,22 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.secrets module
+# Generated files: client/anvil/secrets.pyi, server/anvil/secrets.pyi
+
+class SecretError(Exception):
+    """Secret access or encryption error."""
+    ...
+
+def get_secret(secret_name: str) -> str:
+    """Retrieve the named secret."""
+    ...
+
+def encrypt_with_key(key_name: str, value: str) -> str:
+    """Encrypt a string with a cryptographic key derived from the named secret."""
+    ...
+
+def decrypt_with_key(key_name: str, value: str) -> str:
+    """Decrypt a string with a cryptographic key derived from the named secret."""
+    ...

package/dist/anvil-typeshed/client/anvil/server.pyi

@@ -0,0 +1,376 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.server module
+# Generated files: client/anvil/server.pyi, server/anvil/server.pyi
+
+from typing import Any, Callable, TypeVar, overload, ParamSpec, Literal
+from contextlib import contextmanager
+
+_T = TypeVar("_T")
+_P = ParamSpec("_P")
+
+
+# ============================================================================
+# Exceptions
+# ============================================================================
+
+class SerializationError(Exception):
+    """Raised when serialization fails."""
+    ...
+
+
+class AppOfflineError(Exception):
+    """Raised when the app is offline."""
+    ...
+
+
+# ============================================================================
+# Capabilities
+# ============================================================================
+
+class Capability:
+    """A Capability represents the ability to perform an action.
+
+    [Anvil Docs](https://anvil.works/docs/server/capabilities)"""
+
+    ANY: Any
+    """Sentinel value for unwrap_capability."""
+
+    scope: list[Any]
+    """A list representing what this capability represents.
+
+    It can be extended by calling narrow(), but not shortened.
+    Eg: ['my_resource', 42, 'foo']"""
+
+    is_valid: bool
+    """True if this Capability is still valid; False if it has been invalidated."""
+
+    def narrow(self, additional_scope: Any) -> "Capability":
+        """Return a new capability that is narrower than this one.
+
+        Appends additional scope element(s) to it."""
+        ...
+
+    def set_update_handler(
+        self,
+        apply_update: Callable[..., Any],
+        get_update: Callable[..., Any] | None = None,
+    ) -> None:
+        """Set a handler for what happens when an update is sent to this capability.
+
+        Optionally provide a function for aggregating updates."""
+        ...
+
+    def send_update(self, update: Any) -> None:
+        """Send an update to the update handler for this capability."""
+        ...
+
+
+def unwrap_capability(capability: Capability, scope_pattern: list[Any]) -> list[Any]:
+    """Check that the first argument is a valid Capability and its scope matches the pattern.
+
+    To match, the scope must:
+    - Be at least as broad as the pattern (ie the same length or shorter)
+    - Contain the same values in the same position as the pattern - unless that
+      position in the pattern is Capability.ANY, which matches any value
+
+    Returns a list of matched scope elements, of the same length as the pattern."""
+    ...
+
+
+# ============================================================================
+# Call Context
+# ============================================================================
+
+class _ClientInfo:
+    """Information about the client that initiated the current session."""
+
+    type: str
+    """The type of client (e.g., 'browser', 'uplink')."""
+
+    ip: str | None
+    """The IP address of the client."""
+
+    location: "_Location | None"
+    """The location of the client, if available."""
+
+
+class _Location:
+    """Geographic location information."""
+
+    city: str | None
+    country: str | None
+    latitude: float | None
+    longitude: float | None
+
+
+class _StackFrame:
+    """Information about a call stack frame."""
+
+    type: str
+    """The execution environment type."""
+
+    is_trusted: bool
+    """Whether this call is from trusted (server-side) code."""
+
+
+class CallContext:
+    """Contains information about what triggered the currently running code."""
+
+    client: _ClientInfo
+    """An object that describes the client that initiated the current session."""
+
+    type: str
+    """The execution environment this code is running in.
+
+    May be 'browser', 'server_module' or 'uplink'."""
+
+    remote_caller: _StackFrame | None
+    """An object describing the code that called this @anvil.server.callable function."""
+
+    background_task_id: str | None
+    """The ID of the currently running background task, if there is one."""
+
+
+context: CallContext
+"""Contains information about what triggered the currently running code."""
+
+# Call a server function
+def call(fn_name: str, /, *args: Any, **kwargs: Any) -> Any:
+    """Call a server function by name.
+
+    [Anvil Docs](https://anvil.works/docs/server)"""
+    ...
+
+def call_s(fn_name: str, /, *args: Any, **kwargs: Any) -> Any:
+    """Call a server function by name without showing a loading indicator.
+
+    [Anvil Docs](https://anvil.works/docs/server)"""
+    ...
+
+
+# Server method decorator (for methods in portable classes)
+@overload
+def server_method(fn: Callable[_P, _T]) -> Callable[_P, _T]: ...
+@overload
+def server_method(*, require_user: bool | Callable[..., bool] | None = None) -> Callable[[Callable[_P, _T]], Callable[_P, _T]]: ...
+def server_method(
+    fn: Callable[_P, _T] | None = ...,
+    *,
+    require_user: bool | Callable[..., bool] | None = None
+) -> Callable[_P, _T] | Callable[[Callable[_P, _T]], Callable[_P, _T]]:
+    """Mark a method in a portable class as callable from client code.
+
+    Methods decorated with @anvil.server.server_method can be called on portable
+    class instances from client code, and will execute on the server.
+
+    [Anvil Docs](https://anvil.works/docs/server/portable-classes#server-methods)"""
+    ...
+
+# Background task decorator
+@overload
+def background_task(fn: Callable[_P, _T]) -> Callable[_P, _T]: ...
+@overload
+def background_task() -> Callable[[Callable[_P, _T]], Callable[_P, _T]]: ...
+def background_task(fn: Callable[_P, _T] | None = None) -> Callable[_P, _T] | Callable[[Callable[_P, _T]], Callable[_P, _T]]:
+    """Mark a function as a background task.
+
+    [Anvil Docs](https://anvil.works/docs/background-tasks)"""
+    ...
+
+# Launch a background task
+def launch_background_task(task_name: str, /, *args: Any, **kwargs: Any) -> Any:
+    """Launch a background task by name.
+
+    [Anvil Docs](https://anvil.works/docs/background-tasks)"""
+    ...
+
+# Request context
+class request:
+    """HTTP request context for http_endpoint handlers.
+
+    [Anvil Docs](https://anvil.works/docs/server/http-endpoints)"""
+    method: str
+    path: str
+    body: bytes
+    body_json: Any | None
+    remote_address: str
+    headers: dict[str, str]
+    query_params: dict[str, str]
+    form_params: dict[str, str]
+    cookies: dict[str, str]
+    @staticmethod
+    def get_header(name: str) -> str | None: ...
+
+# Session handling
+class session:
+    """Server-side session storage.
+
+    [Anvil Docs](https://anvil.works/docs/server/sessions)"""
+    @staticmethod
+    def get(key: str, default: Any = None) -> Any: ...
+    @staticmethod
+    def set(key: str, value: Any) -> None: ...
+    @staticmethod
+    def clear() -> None: ...
+
+# HTTP endpoint decorator
+def http_endpoint(path: str, methods: list[str] | None = None, authenticate_users: bool = False, enable_cors: bool = False, cross_site_session: bool = False) -> Callable[[Callable[_P, _T]], Callable[_P, _T]]:
+    """Decorator to create an HTTP endpoint.
+
+    [Anvil Docs](https://anvil.works/docs/server/http-endpoints)"""
+    ...
+
+
+# Connect to other servers
+def connect(url: str, /, **kwargs: Any) -> Any:
+    """Connect to an Anvil Uplink server.
+
+    [Anvil Docs](https://anvil.works/docs/uplink)"""
+    ...
+
+# Portable classes
+def portable_class(cls: type[_T], /) -> type[_T]:
+    """Decorator to make a class portable across client and server.
+
+    [Anvil Docs](https://anvil.works/docs/server/portable-classes)"""
+    ...
+
+
+# ============================================================================
+# URL and Origin Functions
+# ============================================================================
+
+def get_app_origin(environment_type: Literal["published"] | None = None) -> str:
+    """Returns the root URL for the current app.
+
+    By default, this function returns the URL for the current environment,
+    which might be private or temporary. If you want the URL for the published
+    branch, pass 'published' as an argument.
+
+    [Anvil Docs](https://anvil.works/docs/http-apis/creating-http-endpoints#getting-the-url-for-your-api)"""
+    ...
+
+
+def get_api_origin(environment_type: Literal["published"] | None = None) -> str:
+    """Returns the root URL of the API for the current app.
+
+    By default, this function returns the URL for the current environment,
+    which might be private or temporary. If you want the URL for the published
+    branch, pass 'published' as an argument.
+
+    [Anvil Docs](https://anvil.works/docs/http-apis/creating-http-endpoints#getting-the-url-for-your-api)"""
+    ...
+
+
+# ============================================================================
+# Session Functions
+# ============================================================================
+
+def get_session_id() -> str | None:
+    """Get the current session ID, if any."""
+    ...
+
+
+def reset_session() -> None:
+    """Reset the current session."""
+    ...
+
+
+# ============================================================================
+# Background Tasks
+# ============================================================================
+
+class BackgroundTaskState:
+    """Information about a background task."""
+
+    task_id: str
+    """The ID of the background task."""
+
+    def get_id(self) -> str:
+        """Get the ID of this background task."""
+        ...
+
+    def get_state(self) -> dict[str, Any]:
+        """Get the current state of this background task."""
+        ...
+
+    def get_return_value(self) -> Any:
+        """Get the return value of this background task, if completed."""
+        ...
+
+    def get_error(self) -> Exception | None:
+        """Get the error from this background task, if it failed."""
+        ...
+
+    def is_completed(self) -> bool:
+        """Check if this background task has completed."""
+        ...
+
+    def is_running(self) -> bool:
+        """Check if this background task is still running."""
+        ...
+
+    def kill(self) -> None:
+        """Kill this background task."""
+        ...
+
+
+def get_background_task(id: str, /) -> BackgroundTaskState:
+    """Returns the Task object of a background task from its id.
+
+    You can get the task id from task.get_id().
+
+    [Anvil Docs](https://anvil.works/docs/background-tasks/communicating-back)"""
+    ...
+
+
+def list_background_tasks(all_environments: bool = False) -> list[BackgroundTaskState]:
+    """Returns a list of all Tasks running in the current environment.
+
+    If all_environments is True, this function will return all of the app's
+    running Tasks regardless of environment.
+
+    [Anvil Docs](https://anvil.works/docs/background-tasks#list-background-tasks-from-code)"""
+    ...
+
+
+# ============================================================================
+# Loading Indicator (client-only)
+# ============================================================================
+
+class _NoLoadingIndicator:
+    """Context manager to suppress the loading indicator."""
+
+    def __enter__(self) -> None: ...
+    def __exit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None: ...
+
+
+no_loading_indicator: _NoLoadingIndicator
+"""Use `with anvil.server.no_loading_indicator:` to suppress the loading indicator when making server calls."""
+
+
+@contextmanager
+def loading_indicator(
+    *,
+    component_name: Any | None = None,
+    min_height: int | None = None,
+) -> Any:
+    """Create a loading indicator manually.
+
+    By default, a loading indicator is displayed when your app is retrieving data.
+    This context manager allows you to create loading indicators manually.
+
+    Args:
+        component_name: Optionally give the component or container that the loading
+            indicator should overlay.
+        min_height: Optionally set the minimum height of the loading indicator."""
+    ...
+
+
+# ============================================================================
+# HTTP Response Classes
+# ============================================================================
+

package/dist/anvil-typeshed/client/anvil/stripe.pyi

@@ -0,0 +1,23 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+# Type stubs for anvil.stripe module
+# Generated files: client/anvil/stripe.pyi, server/anvil/stripe.pyi
+
+from typing import Any
+
+class Customer:
+    """A Stripe Customer object."""
+
+    id: str
+    email: str
+    def __getattr__(self, name: str) -> Any: ...
+
+def new_customer(email_address: str, token: str | None = None) -> Customer:
+    """Create a new Stripe Customer record."""
+    ...
+
+def get_customer(customer_id: str, /) -> Customer:
+    """Retrieve a Stripe Customer record by its ID."""
+    ...