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

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

@@ -0,0 +1,297 @@
+# 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.tables module
+# Generated files: client/anvil/tables/__init__.pyi, server/anvil/tables/__init__.pyi
+
+from typing import Any, Generic, TypeVar, Iterator, Callable, overload
+
+_T = TypeVar("_T", bound="Row")
+_F = TypeVar("_F", bound="Callable[..., Any]")
+
+class Row:
+    """Base class for table rows.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+    def __init_subclass__(
+        cls,
+        *,
+        attrs: bool = False,
+        buffered: bool = False,
+        client_writable: bool = False,
+        client_updatable: bool = False,
+        client_creatable: bool = False,
+        client_deletable: bool = False,
+        **kwargs: Any
+    ) -> None: ...
+    def __getitem__(self, key: str, /) -> Any: ...
+    def __setitem__(self, key: str, value: Any, /) -> None: ...
+    def update(self, **kwargs: Any) -> None:
+        """Update multiple columns of this row at once.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def delete(self) -> None:
+        """Delete this row from the table.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def get_id(self) -> str:
+        """Get the unique ID of this row.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def save(self) -> None:
+        """Save buffered changes to this row.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def reset(self) -> None:
+        """Reset buffered changes to this row.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def buffer_changes(self, buffered: bool | None = None) -> Any:
+        """Context manager for buffered mode.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    @property
+    def buffered_changes(self) -> dict[str, Any] | None:
+        """Pending buffered changes for this row.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def refresh(self, fetch: Any = None) -> None:
+        """Refresh this row from the database.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def fetch(self, fetch: Any) -> None:
+        """Fetch specific columns for this row.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def values(self) -> Iterator[Any]:
+        """Iterator of column values.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def keys(self) -> Iterator[str]:
+        """Iterator of column names.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def items(self) -> Iterator[tuple[str, Any]]:
+        """Iterator of (name, value) pairs.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+
+class SearchIterator(Generic[_T], Iterator[_T]):
+    """Iterator returned by table.search().
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+    def __iter__(self) -> "SearchIterator[_T]": ...
+    def __next__(self) -> _T: ...
+    def __len__(self) -> int: ...
+    @overload
+    def __getitem__(self, index: int) -> _T: ...
+    @overload
+    def __getitem__(self, index: slice) -> list[_T]: ...
+    def __getitem__(self, index: int | slice) -> _T | list[_T]: ...
+
+class Table(Generic[_T]):
+    """Base class for tables.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+    Row: type[_T]
+    def get(self, **kwargs: Any) -> _T | None:
+        """Get a single row matching the given criteria.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def get_by_id(self, row_id: str, /) -> _T | None:
+        """Get a row by its unique ID.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def search(self, *args: Any, **kwargs: Any) -> SearchIterator[_T]:
+        """Search for rows matching the given criteria.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def add_row(self, **kwargs: Any) -> _T:
+        """Add a new row to this table.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def list_columns(self) -> list[dict[str, Any]]:
+        """List all columns in this table.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def delete_all_rows(self) -> None:
+        """Delete all rows from this table.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code)"""
+        ...
+    def client_readable(self, **kwargs: Any) -> "Table[_T]":
+        """Return a view of this table that clients can read.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-security)"""
+        ...
+    def client_writable(self, **kwargs: Any) -> "Table[_T]":
+        """Return a view of this table that clients can write to.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-security)"""
+        ...
+    def client_writable_cascade(self, **kwargs: Any) -> "Table[_T]":
+        """Return a view of this table that clients can write to, with cascading permissions.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-security)"""
+        ...
+
+# Query operators
+def order_by(column: str, /, ascending: bool = True) -> Any:
+    """Create an ordering query operator.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+    ...
+
+class _Query:
+    """Query operators for searching tables.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+    @staticmethod
+    def any_of(*args: Any) -> Any:
+        """Match any of the given conditions.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def all_of(*args: Any) -> Any:
+        """Match all of the given conditions.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def none_of(*args: Any) -> Any:
+        """Match none of the given conditions.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def like(pattern: str) -> Any:
+        """Match using SQL LIKE pattern (case-sensitive).
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def ilike(pattern: str) -> Any:
+        """Match using SQL LIKE pattern (case-insensitive).
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def full_text_match(query: str, raw: bool = False) -> Any:
+        """Full-text search.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def greater_than(value: Any) -> Any:
+        """Match values greater than the given value.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def greater_than_or_equal_to(value: Any) -> Any:
+        """Match values greater than or equal to the given value.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def less_than(value: Any) -> Any:
+        """Match values less than the given value.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def less_than_or_equal_to(value: Any) -> Any:
+        """Match values less than or equal to the given value.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def between(min_value: Any, max_value: Any, min_inclusive: bool = True, max_inclusive: bool = False) -> Any:
+        """Match values between the given bounds.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+    @staticmethod
+    def not_(value: Any) -> Any:
+        """Negate a query condition.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/data-tables-in-code#searching-and-querying-data-tables)"""
+        ...
+
+q: _Query
+
+# Exceptions
+class TableError(Exception):
+    """Superclass of all table exceptions.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/transactions)"""
+    ...
+
+class TransactionConflict(TableError):
+    """Raised when a transaction conflicts and has been aborted.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/transactions)"""
+    ...
+
+class NoSuchColumnError(TableError):
+    """Raised when attempting to access a column that does not exist in this table."""
+    ...
+
+class QuotaExceededError(TableError):
+    """Raised when an app has exceeded its quota."""
+    ...
+
+class RowDeleted(TableError):
+    """Raised when attempting to access a table row that has been deleted."""
+    ...
+
+# Transaction support
+class Transaction:
+    """A database transaction context manager.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/transactions)"""
+    def __init__(self, relaxed: bool = False) -> None: ...
+    def __enter__(self) -> "Transaction": ...
+    def __exit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> bool: ...
+    def abort(self) -> None:
+        """Abort this transaction and roll back all changes.
+
+        [Anvil Docs](https://anvil.works/docs/data-tables/transactions)"""
+        ...
+
+
+def get_table_by_id(table_id: str) -> Table[Row]:
+    """Get a table by id. Can pass a row id in, and the table the row belongs to will be returned.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/accelerated-tables)"""
+    ...
+
+
+# app_tables will be dynamically typed based on db_schema
+class _AppTables:
+    """Container for all app tables. Individual tables are generated from db_schema.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables)"""
+    def __getattr__(self, name: str) -> Table[Row]: ...
+    def __getitem__(self, name: str) -> Table[Row]: ...
+
+app_tables: _AppTables

package/dist/anvil-typeshed/client/anvil/tables/query.pyi

@@ -0,0 +1,88 @@
+# 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.tables.query module
+# Generated files: client/anvil/tables/query.pyi, server/anvil/tables/query.pyi
+
+from typing import Any
+
+def like(pattern: str, /) -> Any:
+    """Match values using a case-sensitive LIKE query, using the % wildcard character."""
+    ...
+
+def ilike(pattern: str, /) -> Any:
+    """Match values using a case-insensitive ILIKE query, using the % wildcard character."""
+    ...
+
+def greater_than(value: Any, /) -> Any:
+    """Match values greater than the provided value."""
+    ...
+
+def less_than(value: Any, /) -> Any:
+    """Match values less than the provided value."""
+    ...
+
+def greater_than_or_equal_to(value: Any, /) -> Any:
+    """Match values greater than or equal to the provided value."""
+    ...
+
+def less_than_or_equal_to(value: Any, /) -> Any:
+    """Match values less than or equal to the provided value."""
+    ...
+
+def between(
+    min: Any,
+    max: Any,
+    *,
+    min_inclusive: bool = True,
+    max_inclusive: bool = False,
+) -> Any:
+    """Match values between the provided min and max, optionally inclusive."""
+    ...
+
+def full_text_match(query: str, *, raw: bool = False) -> Any:
+    """Match values that match the provided full-text search query."""
+    ...
+
+def all_of(*query_expressions: Any, **kwargs: Any) -> Any:
+    """Match all query parameters given as arguments and keyword arguments."""
+    ...
+
+def any_of(*query_expressions: Any, **kwargs: Any) -> Any:
+    """Match any query parameters given as arguments and keyword arguments."""
+    ...
+
+def none_of(*query_expressions: Any, **kwargs: Any) -> Any:
+    """Match none of the query parameters given as arguments and keyword arguments."""
+    ...
+
+def not_(value: Any, /) -> Any:
+    """Match none of the query parameters given as arguments and keyword arguments."""
+    ...
+
+def page_size(rows: int) -> Any:
+    """Define the number of rows that are fetched per round trip to the server."""
+    ...
+
+def fetch_only(*only_cols: str, **linked_cols: Any) -> Any:
+    """Control which columns are loaded from a table search to speed up queries by only fetching the data you need.
+
+    Args:
+        only_cols: Column names to fetch from the table.
+            Example: fetch_only('email', group=q.fetch_only('name'))
+        linked_cols: Linked columns to fetch, specified as keyword arguments.
+            Each value must be another fetch_only() object.
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/accelerated-tables#explicit-cache-control)"""
+    ...
+
+def only_cols(*cols: str) -> Any:
+    """Control which columns are accessible from a view, restricting access to specific columns.
+
+    Args:
+        cols: Column names to make accessible in the view.
+            Example: only_cols('email', 'enabled')
+
+    [Anvil Docs](https://anvil.works/docs/data-tables/accelerated-tables#column-restricted-views)"""
+    ...

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

@@ -0,0 +1,92 @@
+# AUTO-GENERATED FILE - DO NOT EDIT
+# Edit the source file in anvil-typeshed/source/ instead, then run:
+#   npm run generate-anvil-stubs
+#
+"""Timezone utilities for Anvil applications.
+
+This module provides timezone classes for working with datetime objects.
+"""
+
+import datetime
+
+class tzoffset(datetime.tzinfo):
+    """Create a timezone with a specific offset.
+
+    Use an offset in seconds, minutes or hours. Only one of the three
+    keyword arguments should be provided.
+
+    Args:
+        seconds: Offset from UTC in seconds.
+        minutes: Offset from UTC in minutes.
+        hours: Offset from UTC in hours.
+
+    Example:
+        ```python
+        import anvil.tz
+        import datetime
+
+        # Create a timezone 5 hours behind UTC
+        eastern = anvil.tz.tzoffset(hours=-5)
+        dt = datetime.datetime.now(eastern)
+        ```
+    """
+
+    def __init__(
+        self,
+        *,
+        seconds: int | None = None,
+        minutes: int | None = None,
+        hours: int | None = None,
+    ) -> None: ...
+    def utcoffset(self, dt: datetime.datetime | None) -> datetime.timedelta: ...
+    def dst(self, dt: datetime.datetime | None) -> datetime.timedelta: ...
+    def tzname(self, dt: datetime.datetime | None) -> str | None: ...
+
+class tzlocal(tzoffset):
+    """Use the local timezone of the browser.
+
+    Creates a timezone object representing the local timezone where the
+    code is running (browser for client code, server for server code).
+
+    Example:
+        ```python
+        import anvil.tz
+        import datetime
+
+        local_tz = anvil.tz.tzlocal()
+        local_time = datetime.datetime.now(local_tz)
+        ```
+    """
+
+    def __init__(self) -> None: ...
+
+class tzutc(tzoffset):
+    """Create a timezone set to UTC.
+
+    Creates a timezone object representing Coordinated Universal Time (UTC).
+
+    Example:
+        ```python
+        import anvil.tz
+        import datetime
+
+        utc_tz = anvil.tz.tzutc()
+        utc_time = datetime.datetime.now(utc_tz)
+        ```
+    """
+
+    def __init__(self) -> None: ...
+
+UTC: tzutc
+"""An object representing the UTC timezone.
+
+A pre-instantiated `tzutc` object for convenience.
+
+Example:
+    ```python
+    import anvil.tz
+    import datetime
+
+    utc_time = datetime.datetime.now(anvil.tz.UTC)
+    ```
+"""

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

@@ -0,0 +1,191 @@
+# 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.users module
+# Generated files: client/anvil/users/__init__.pyi, server/anvil/users/__init__.pyi
+
+from typing import Any
+from anvil.tables import Row
+from anvil.users import mfa as mfa
+
+# Exceptions (available in both environments)
+class UserExists(Exception): ...
+class AuthenticationFailed(Exception): ...
+class EmailNotConfirmed(AuthenticationFailed): ...
+class AccountIsNotEnabled(AuthenticationFailed): ...
+class TooManyPasswordFailures(AuthenticationFailed): ...
+class PasswordNotAcceptable(Exception): ...
+class MFARequired(AuthenticationFailed): ...
+class MFAException(AuthenticationFailed): ...
+class PasswordResetRequested(Exception): ...
+
+# Functions available in both environments
+def get_user(allow_remembered: bool = True) -> Row | None:
+    """Get the row from the users table that corresponds to the currently logged-in user. If allow_remembered is true (the default), the user may have logged in in a previous session. Returns None if no user is logged in.
+
+    [Anvil Docs](https://anvil.works/docs/users)"""
+    ...
+
+def logout(invalidate_client_objects: bool = False) -> None:
+    """Forget the current logged-in user.
+
+If invalidate_client_objects is true, all live objects (table rows, Capabilities, unfetched Media, etc) will be invalidated
+
+    [Anvil Docs](https://anvil.works/docs/users)"""
+    ...
+
+def login_with_email(email: str, password: str, remember: bool = False) -> Row | None:
+    """Log in with the specified email address and password. Raises anvil.users.AuthenticationFailed exception if the login failed.
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/email_login)"""
+    ...
+
+def signup_with_email(email: str, password: str, remember: bool = False) -> Row | None:
+    """Sign up for a new account with the specified email address and password. Raises anvil.users.UserExists if an account is already registered with this email address.
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/email_login)"""
+    ...
+
+def send_password_reset_email(email_address: str) -> None:
+    """Send a password-reset email to the specified user
+
+    [Anvil Docs](https://anvil.works/docs/users/email_login)"""
+    ...
+
+def send_token_login_email(email_address: str) -> None:
+    """Send a login link email to the specified user
+
+    [Anvil Docs](https://anvil.works/docs/users/email_login)"""
+    ...
+
+def reset_password(old_password: str, new_password: str) -> None:
+    """Reset the password for the current user
+
+    [Anvil Docs](https://anvil.works/docs/users/email_login)"""
+    ...
+
+def send_mfa_reset_email(email_address: str) -> None:
+    """Send a two-factor authentication reset email to the specified user.
+
+    [Anvil Docs](https://anvil.works/docs/users/mfa)"""
+    ...
+
+
+def login_with_google(additional_scopes: list[str] | None = None, remember: bool = False) -> Row | None:
+    """Log in with a Google account. Prompts the user to authenticate with Google, then logs in with their Google email address (if that user exists). Returns None if the login was cancelled or we have no record of this user.
+
+additional_scopes: If supplied, these are passed on to anvil.google.auth.login().
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/google)"""
+    ...
+
+def signup_with_google(additional_scopes: list[str] | None = None, remember: bool = False) -> Row | None:
+    """Sign up for a new account with the email address associated with the user's Google account. Prompts the user to authenticate with Google, then registers a new user with that email address. Raises anvil.users.UserExists if this email address is already registered; returns new user or None if cancelled.
+
+additional_scopes: If supplied, these are passed on to anvil.google.auth.login().
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/google)"""
+    ...
+
+def login_with_facebook(additional_scopes: list[str] | None = None, remember: bool = False) -> Row | None:
+    """Log in with a Facebook account. Prompts the user to authenticate with Facebook, then logs in with their Facebook email address (if that user exists). Returns None if the login was cancelled or we have no record of this user.
+
+additional_scopes: If supplied, these are passed on to anvil.facebook.auth.login().
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/facebook)"""
+    ...
+
+def signup_with_facebook(additional_scopes: list[str] | None = None, remember: bool = False) -> Row | None:
+    """Sign up for a new account with the email address associated with the user's Facebook account. Prompts the user to authenticate with Facebook, then registers a new user with that email address. Raises anvil.users.UserExists if this email address is already registered; returns new user or None if cancelled.
+
+additional_scopes: If supplied, these are passed on to anvil.facebook.auth.login().
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/facebook)"""
+    ...
+
+def login_with_microsoft(additional_scopes: list[str] | None = None, remember: bool = False) -> Row | None:
+    """Log in with a Microsoft account. Prompts the user to authenticate with Microsoft, then logs in with their Microsoft email address (if that user exists). Returns None if the login was cancelled or we have no record of this user.
+
+additional_scopes: If supplied, these are passed on to anvil.microsoft.auth.login().
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/microsoft)"""
+    ...
+
+def signup_with_microsoft(additional_scopes: list[str] | None = None, remember: bool = False) -> Row | None:
+    """Sign up for a new account with the email address associated with the user's Microsoft account. Prompts the user to authenticate with Microsoft, then registers a new user with that email address. Raises anvil.users.UserExists if this email address is already registered; returns new user or None if cancelled.
+
+additional_scopes: If supplied, these are passed on to anvil.microsoft.auth.login().
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/microsoft)"""
+    ...
+
+def login_with_saml(remember: bool = False) -> Row | None:
+    """Log in via a SAML Identity Provider. Prompts the user to authenticate with SAML, then logs in with their email address (if that user exists). Returns None if the login was cancelled or we have no record of this user.
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/saml)"""
+    ...
+
+def signup_with_saml(remember: bool = False) -> Row | None:
+    """Sign up for a new account with the email address associated with the user's SAML account. Prompts the user to authenticate via SAML, then registers a new user with that email address. Raises anvil.users.UserExists if this email address is already registered; returns new user or None if cancelled.
+
+By default, login status is not remembered between sessions; set remember=True to remember login status.
+
+    [Anvil Docs](https://anvil.works/docs/users/saml)"""
+    ...
+
+def login_with_form(show_signup_option: bool = True, remember_by_default: bool = True, allow_remembered: bool = True, allow_cancel: bool = False, initial_email: str | None = None) -> Row | None:
+    """Display a login form and allow user to log in. Returns user object if logged in, or None if cancelled.
+
+show_signup_option: if True, the form will also show the option to sign up for a new account.
+
+remember_by_default: if True, the 'remember me' checkbox will be enabled by default.
+
+allow_remembered: if False, users with remembered login status will still be required to log in.
+
+allow_cancel: if True, the login form has a Cancel button that the user can use to dismiss the form.
+
+initial_email: Optional email address to pre-fill the Email box with when email login is enabled.
+
+    [Anvil Docs](https://anvil.works/docs/users/authentication_forms)"""
+    ...
+
+def signup_with_form(remember_by_default: bool = True, allow_cancel: bool = False) -> Row | None:
+    """Display a sign-up form allowing a user to create a new account. Returns the new user object, or None if cancelled.
+
+remember_by_default: if True, the 'remember me' checkbox will be enabled by default.
+
+allow_cancel: if True, the signup form has a Cancel button that the user can use to dismiss the form.
+
+    [Anvil Docs](https://anvil.works/docs/users/authentication_forms)"""
+    ...
+
+def change_password_with_form(require_old_password: bool = True) -> None:
+    """Display a form allowing the current user to reset their password.
+
+    [Anvil Docs](https://anvil.works/docs/users/authentication_forms)"""
+    ...
+
+def configure_account_with_form() -> None:
+    """Display a form allowing the current user to configure their account. The form contains links for password reset and two-factor authentication configuration.
+
+    [Anvil Docs](https://anvil.works/docs/users/authentication_forms)"""
+    ...