reflex 0.7.13a1__py3-none-any.whl → 0.7.14__py3-none-any.whl

reflex/utils/format.py

@@ -73,7 +73,8 @@ def get_close_char(open: str, close: str | None = None) -> str:
     if close is not None:
         return close
     if open not in WRAP_MAP:
-        raise ValueError(f"Invalid wrap open: {open}, must be one of {WRAP_MAP.keys()}")
+        msg = f"Invalid wrap open: {open}, must be one of {WRAP_MAP.keys()}"
+        raise ValueError(msg)
     return WRAP_MAP[open]
 
 
@@ -187,8 +188,7 @@ def to_camel_case(text: str, treat_hyphens_as_underscores: bool = True) -> str:
     # Capitalize the first letter of each word except the first one
     if len(words) == 1:
         return words[0]
-    converted_word = words[0] + "".join([w.capitalize() for w in words[1:]])
-    return converted_word
+    return words[0] + "".join([w.capitalize() for w in words[1:]])
 
 
 def to_title_case(text: str, sep: str = "") -> str:
@@ -264,17 +264,13 @@ def _escape_js_string(string: str) -> str:
         if segment.startswith("${") and segment.endswith("}"):
             # Return the `${}` segment unchanged
             return segment
-        else:
-            # Escape backticks in the segment
-            segment = segment.replace(r"\`", "`")
-            segment = segment.replace("`", r"\`")
-            return segment
+        # Escape backticks in the segment
+        return segment.replace(r"\`", "`").replace("`", r"\`")
 
     # Split the string into parts, keeping the `${}` segments
     parts = re.split(r"(\$\{.*?\})", string)
     escaped_parts = [escape_outside_segments(part) for part in parts]
-    escaped_string = "".join(escaped_parts)
-    return escaped_string
+    return "".join(escaped_parts)
 
 
 def _wrap_js_string(string: str) -> str:
@@ -287,8 +283,7 @@ def _wrap_js_string(string: str) -> str:
         The wrapped string.
     """
     string = wrap(string, "`")
-    string = wrap(string, "{")
-    return string
+    return wrap(string, "{")
 
 
 def format_string(string: str) -> str:
@@ -402,13 +397,13 @@ def format_prop(
             return str(Var.create(prop))
 
         # Handle other types.
-        elif isinstance(prop, str):
+        if isinstance(prop, str):
             if is_wrapped(prop, "{"):
                 return prop
             return json_dumps(prop)
 
         # For dictionaries, convert any properties to strings.
-        elif isinstance(prop, dict):
+        if isinstance(prop, dict):
             prop = serializers.serialize_dict(prop)  # pyright: ignore [reportAttributeAccessIssue]
 
         else:
@@ -417,11 +412,13 @@ def format_prop(
     except exceptions.InvalidStylePropError:
         raise
     except TypeError as e:
-        raise TypeError(f"Could not format prop: {prop} of type {type(prop)}") from e
+        msg = f"Could not format prop: {prop} of type {type(prop)}"
+        raise TypeError(msg) from e
 
     # Wrap the variable in braces.
     if not isinstance(prop, str):
-        raise ValueError(f"Invalid prop: {prop}. Expected a string.")
+        msg = f"Invalid prop: {prop}. Expected a string."
+        raise ValueError(msg)
     return wrap(prop, "{", check_first=False)
 
 
@@ -591,9 +588,8 @@ def format_queue_events(
         elif isinstance(spec, type(lambda: None)):
             specs = call_event_fn(spec, args_spec or _default_args_spec)  # pyright: ignore [reportAssignmentType, reportArgumentType]
             if isinstance(specs, Var):
-                raise ValueError(
-                    f"Invalid event spec: {specs}. Expected a list of EventSpecs."
-                )
+                msg = f"Invalid event spec: {specs}. Expected a list of EventSpecs."
+                raise ValueError(msg)
         payloads.extend(format_event(s) for s in specs)
 
     # Return the final code snippet, expecting queueEvents, processEvent, and socket to be in scope.
@@ -662,12 +658,14 @@ def format_library_name(library_fullname: str | dict[str, Any]) -> str:
     # If input is a dictionary, extract the 'name' key
     if isinstance(library_fullname, dict):
         if "name" not in library_fullname:
-            raise KeyError("Dictionary input must contain a 'name' key")
+            msg = "Dictionary input must contain a 'name' key"
+            raise KeyError(msg)
         library_fullname = library_fullname["name"]
 
     # Process the library name as a string
     if not isinstance(library_fullname, str):
-        raise TypeError("Library name must be a string")
+        msg = "Library name must be a string"
+        raise TypeError(msg)
 
     if library_fullname.startswith("https://"):
         return library_fullname
@@ -764,9 +762,8 @@ def format_data_editor_column(col: str | dict):
     if isinstance(col, Var):
         return col
 
-    raise ValueError(
-        f"unexpected type ({(type(col).__name__)}: {col}) for column header in data_editor"
-    )
+    msg = f"unexpected type ({(type(col).__name__)}: {col}) for column header in data_editor"
+    raise ValueError(msg)
 
 
 def format_data_editor_cell(cell: Any):

reflex/utils/imports.py

@@ -127,10 +127,11 @@ class ImportVar:
         """
         if self.alias:
             return (
-                self.alias if self.is_default else " as ".join([self.tag, self.alias])  # pyright: ignore [reportCallIssue,reportArgumentType]
+                self.alias
+                if self.is_default
+                else (self.tag + " as " + self.alias if self.tag else self.alias)
             )
-        else:
-            return self.tag or ""
+        return self.tag or ""
 
 
 ImportTypes = str | ImportVar | list[str | ImportVar] | list[ImportVar]

reflex/utils/lazy_loader.py

@@ -65,7 +65,7 @@ def attach(
     def __getattr__(name: str):  # noqa: N807
         if name in submodules:
             return importlib.import_module(f"{package_name}.{name}")
-        elif name in attr_to_modules:
+        if name in attr_to_modules:
             submod_path = f"{package_name}.{attr_to_modules[name]}"
             submod = importlib.import_module(submod_path)
             attr = getattr(submod, name)
@@ -78,8 +78,8 @@ def attach(
                 pkg.__dict__[name] = attr
 
             return attr
-        else:
-            raise AttributeError(f"No {package_name} attribute {name}")
+        msg = f"No {package_name} attribute {name}"
+        raise AttributeError(msg)
 
     def __dir__():  # noqa: N807
         return __all__

reflex/utils/misc.py

@@ -20,5 +20,6 @@ async def run_in_thread(func: Callable) -> Any:
         Any: The return value of the function.
     """
     if asyncio.coroutines.iscoroutinefunction(func):
-        raise ValueError("func must be a non-async function")
+        msg = "func must be a non-async function"
+        raise ValueError(msg)
     return await asyncio.get_event_loop().run_in_executor(None, func)

reflex/utils/net.py

@@ -19,7 +19,7 @@ def _httpx_verify_kwarg() -> bool:
     Returns:
         True if SSL verification is enabled, False otherwise
     """
-    from ..config import environment
+    from reflex.environment import environment
 
     return not environment.SSL_NO_VERIFY.get()
 
@@ -131,7 +131,7 @@ def _httpx_local_address_kwarg() -> str:
     Returns:
         The local address to bind to
     """
-    from ..config import environment
+    from reflex.environment import environment
 
     return environment.REFLEX_HTTP_CLIENT_BIND_ADDRESS.get() or (
         "::" if _should_use_ipv6() else "0.0.0.0"

reflex/utils/path_ops.py

@@ -9,7 +9,8 @@ import shutil
 import stat
 from pathlib import Path
 
-from reflex.config import environment, get_config
+from reflex.config import get_config
+from reflex.environment import environment
 
 # Shorthand for join.
 join = os.linesep.join
@@ -300,7 +301,8 @@ def update_directory_tree(src: Path, dest: Path):
         ValueError: If the source is not a directory
     """
     if not src.is_dir():
-        raise ValueError(f"Source {src} is not a directory")
+        msg = f"Source {src} is not a directory"
+        raise ValueError(msg)
 
     # Ensure the destination directory exists
     dest.mkdir(parents=True, exist_ok=True)

reflex/utils/prerequisites.py

@@ -36,7 +36,8 @@ from redis.exceptions import RedisError
 
 from reflex import constants, model
 from reflex.compiler import templates
-from reflex.config import Config, environment, get_config
+from reflex.config import Config, get_config
+from reflex.environment import environment
 from reflex.utils import console, net, path_ops, processes, redir
 from reflex.utils.decorator import once
 from reflex.utils.exceptions import SystemPackageMissingError
@@ -129,7 +130,6 @@ def check_latest_package_version(package_name: str):
             )
     except Exception:
         console.debug(f"Failed to check for the latest version of {package_name}.")
-        pass
 
 
 def get_or_set_last_reflex_version_check_datetime():
@@ -255,9 +255,8 @@ def get_nodejs_compatible_package_managers(
     package_managers = list(filter(None, package_managers))
 
     if not package_managers and raise_on_none:
-        raise FileNotFoundError(
-            "Bun or npm not found. You might need to rerun `reflex init` or install either."
-        )
+        msg = "Bun or npm not found. You might need to rerun `reflex init` or install either."
+        raise FileNotFoundError(msg)
 
     return package_managers
 
@@ -310,9 +309,8 @@ def get_js_package_executor(raise_on_none: bool = False) -> Sequence[Sequence[st
     package_managers = list(filter(None, package_managers))
 
     if not package_managers and raise_on_none:
-        raise FileNotFoundError(
-            "Bun or npm not found. You might need to rerun `reflex init` or install either."
-        )
+        msg = "Bun or npm not found. You might need to rerun `reflex init` or install either."
+        raise FileNotFoundError(msg)
 
     return package_managers
 
@@ -345,10 +343,11 @@ def _check_app_name(config: Config):
         RuntimeError: If the app name is not set in the config.
     """
     if not config.app_name:
-        raise RuntimeError(
+        msg = (
             "Cannot get the app module because `app_name` is not set in rxconfig! "
             "If this error occurs in a reflex test case, ensure that `get_app` is mocked."
         )
+        raise RuntimeError(msg)
 
 
 def get_app(reload: bool = False) -> ModuleType:
@@ -395,11 +394,14 @@ def get_app(reload: bool = False) -> ModuleType:
         return app
 
 
-def get_and_validate_app(reload: bool = False) -> AppInfo:
+def get_and_validate_app(
+    reload: bool = False, check_if_schema_up_to_date: bool = False
+) -> AppInfo:
     """Get the app instance based on the default config and validate it.
 
     Args:
         reload: Re-import the app module from disk
+        check_if_schema_up_to_date: If True, check if the schema is up to date.
 
     Returns:
         The app instance and the app module.
@@ -412,23 +414,34 @@ def get_and_validate_app(reload: bool = False) -> AppInfo:
     app_module = get_app(reload=reload)
     app = getattr(app_module, constants.CompileVars.APP)
     if not isinstance(app, App):
-        raise RuntimeError(
-            "The app instance in the specified app_module_import in rxconfig must be an instance of rx.App."
-        )
+        msg = "The app instance in the specified app_module_import in rxconfig must be an instance of rx.App."
+        raise RuntimeError(msg)
+
+    if check_if_schema_up_to_date:
+        check_schema_up_to_date()
+
     return AppInfo(app=app, module=app_module)
 
 
-def validate_app(reload: bool = False) -> None:
+def validate_app(
+    reload: bool = False, check_if_schema_up_to_date: bool = False
+) -> None:
     """Validate the app instance based on the default config.
 
     Args:
         reload: Re-import the app module from disk
+        check_if_schema_up_to_date: If True, check if the schema is up to date.
     """
-    get_and_validate_app(reload=reload)
+    get_and_validate_app(
+        reload=reload, check_if_schema_up_to_date=check_if_schema_up_to_date
+    )
 
 
 def get_compiled_app(
-    reload: bool = False, export: bool = False, dry_run: bool = False
+    reload: bool = False,
+    export: bool = False,
+    dry_run: bool = False,
+    check_if_schema_up_to_date: bool = False,
 ) -> ModuleType:
     """Get the app module based on the default config after first compiling it.
 
@@ -436,11 +449,14 @@ def get_compiled_app(
         reload: Re-import the app module from disk
         export: Compile the app for export
         dry_run: If True, do not write the compiled app to disk.
+        check_if_schema_up_to_date: If True, check if the schema is up to date.
 
     Returns:
         The compiled app based on the default config.
     """
-    app, app_module = get_and_validate_app(reload=reload)
+    app, app_module = get_and_validate_app(
+        reload=reload, check_if_schema_up_to_date=check_if_schema_up_to_date
+    )
     # For py3.9 compatibility when redis is used, we MUST add any decorator pages
     # before compiling the app in a thread to avoid event loop error (REF-2172).
     app._apply_decorated_pages()
@@ -449,7 +465,10 @@ def get_compiled_app(
 
 
 def compile_app(
-    reload: bool = False, export: bool = False, dry_run: bool = False
+    reload: bool = False,
+    export: bool = False,
+    dry_run: bool = False,
+    check_if_schema_up_to_date: bool = False,
 ) -> None:
     """Compile the app module based on the default config.
 
@@ -457,8 +476,14 @@ def compile_app(
         reload: Re-import the app module from disk
         export: Compile the app for export
         dry_run: If True, do not write the compiled app to disk.
+        check_if_schema_up_to_date: If True, check if the schema is up to date.
     """
-    get_compiled_app(reload=reload, export=export, dry_run=dry_run)
+    get_compiled_app(
+        reload=reload,
+        export=export,
+        dry_run=dry_run,
+        check_if_schema_up_to_date=check_if_schema_up_to_date,
+    )
 
 
 def _can_colorize() -> bool:
@@ -503,20 +528,23 @@ def _can_colorize() -> bool:
         return file.isatty()
 
 
-def compile_or_validate_app(compile: bool = False) -> bool:
+def compile_or_validate_app(
+    compile: bool = False, check_if_schema_up_to_date: bool = False
+) -> bool:
     """Compile or validate the app module based on the default config.
 
     Args:
         compile: Whether to compile the app.
+        check_if_schema_up_to_date: If True, check if the schema is up to date.
 
     Returns:
         If the app is compiled successfully.
     """
     try:
         if compile:
-            compile_app()
+            compile_app(check_if_schema_up_to_date=check_if_schema_up_to_date)
         else:
-            validate_app()
+            validate_app(check_if_schema_up_to_date=check_if_schema_up_to_date)
     except Exception as e:
         if isinstance(e, click.exceptions.Exit):
             return False
@@ -575,9 +603,8 @@ def parse_redis_url() -> str | None:
     if not config.redis_url:
         return None
     if not config.redis_url.startswith(("redis://", "rediss://", "unix://")):
-        raise ValueError(
-            "REDIS_URL must start with 'redis://', 'rediss://', or 'unix://'."
-        )
+        msg = "REDIS_URL must start with 'redis://', 'rediss://', or 'unix://'."
+        raise ValueError(msg)
     return config.redis_url
 
 
@@ -1157,15 +1184,16 @@ def download_and_run(url: str, *args, show_status: bool = False, **env):
         raise click.exceptions.Exit(1) from None
 
     # Save the script to a temporary file.
-    script = Path(tempfile.NamedTemporaryFile().name)
+    with tempfile.NamedTemporaryFile() as tempfile_file:
+        script = Path(tempfile_file.name)
 
-    script.write_text(response.text)
+        script.write_text(response.text)
 
-    # Run the script.
-    env = {**os.environ, **env}
-    process = processes.new_process(["bash", str(script), *args], env=env)
-    show = processes.show_status if show_status else processes.show_logs
-    show(f"Installing {url}", process)
+        # Run the script.
+        env = {**os.environ, **env}
+        process = processes.new_process(["bash", str(script), *args], env=env)
+        show = processes.show_status if show_status else processes.show_logs
+        show(f"Installing {url}", process)
 
 
 def install_bun():
@@ -1213,7 +1241,8 @@ def install_bun():
         )
     else:
         if path_ops.which("unzip") is None:
-            raise SystemPackageMissingError("unzip")
+            msg = "unzip"
+            raise SystemPackageMissingError(msg)
 
         # Run the bun install script.
         download_and_run(
@@ -1262,13 +1291,15 @@ def cached_procedure(
         ValueError: If both cache_file and cache_file_fn are provided.
     """
     if cache_file and cache_file_fn is not None:
-        raise ValueError("cache_file and cache_file_fn cannot both be provided.")
+        msg = "cache_file and cache_file_fn cannot both be provided."
+        raise ValueError(msg)
 
     def _inner_decorator(func: Callable):
         def _inner(*args, **kwargs):
             _cache_file = cache_file_fn() if cache_file_fn is not None else cache_file
             if not _cache_file:
-                raise ValueError("Unknown cache file, cannot cache result.")
+                msg = "Unknown cache file, cannot cache result."
+                raise ValueError(msg)
             payload = _read_cached_procedure_file(_cache_file)
             new_payload = payload_fn(*args, **kwargs)
             if payload != new_payload:
@@ -1446,7 +1477,7 @@ def validate_bun(bun_path: Path | None = None):
                 "Failed to obtain bun version. Make sure the specified bun path in your config is correct."
             )
             raise click.exceptions.Exit(1)
-        elif bun_version < version.parse(constants.Bun.MIN_VERSION):
+        if bun_version < version.parse(constants.Bun.MIN_VERSION):
             console.warn(
                 f"Reflex requires bun version {constants.Bun.MIN_VERSION} or higher to run, but the detected version is "
                 f"{bun_version}. If you have specified a custom bun path in your config, make sure to provide one "
@@ -1657,8 +1688,7 @@ def fetch_app_templates(version: str) -> dict[str, Template]:
     if asset is None:
         console.warn(f"Templates metadata not found for version {version}")
         return {}
-    else:
-        templates_url = asset["browser_download_url"]
+    templates_url = asset["browser_download_url"]
 
     templates_data = net.get(templates_url, follow_redirects=True).json()["templates"]
 
@@ -1864,7 +1894,7 @@ def initialize_app(app_name: str, template: str | None = None) -> str | None:
     # Check if the app is already initialized.
     if constants.Config.FILE.exists():
         telemetry.send("reinit")
-        return
+        return None
 
     templates: dict[str, Template] = {}
 

reflex/utils/processes.py

@@ -19,7 +19,7 @@ from redis.exceptions import RedisError
 from rich.progress import Progress
 
 from reflex import constants
-from reflex.config import environment
+from reflex.environment import environment
 from reflex.utils import console, path_ops, prerequisites
 from reflex.utils.registry import get_npm_registry
 
@@ -137,11 +137,10 @@ def handle_port(service_name: str, port: int, auto_increment: bool) -> int:
         return port
     if auto_increment:
         return change_port(port, service_name)
-    else:
-        console.error(
-            f"{service_name.capitalize()} port: {port} is already in use by PID: {process.pid}."
-        )
-        raise click.exceptions.Exit()
+    console.error(
+        f"{service_name.capitalize()} port: {port} is already in use by PID: {process.pid}."
+    )
+    raise click.exceptions.Exit
 
 
 @overload
@@ -316,7 +315,6 @@ def stream_logs(
                 # But if the process is still running that is weird.
                 raise
             # If the process exited, break out of the loop for post processing.
-            pass
 
     # Check if the process failed (not printing the logs for SIGINT).