reflex 0.7.2a1__tar.gz → 0.7.2.dev1__tar.gz

{reflex-0.7.2a1 → reflex-0.7.2.dev1}/PKG-INFO

@@ -1,51 +1,45 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: reflex
-Version: 0.7.2a1
+Version: 0.7.2.dev1
 Summary: Web apps in pure Python.
-License: Apache-2.0
 Keywords: web,framework
-Author: Nikhil Rao
-Author-email: nikhil@reflex.dev
-Requires-Python: >=3.10,<4.0
-Classifier: Development Status :: 4 - Beta
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: alembic (>=1.11.1,<2.0)
-Requires-Dist: build (>=1.0.3,<2.0)
-Requires-Dist: charset-normalizer (>=3.3.2,<4.0)
-Requires-Dist: distro (>=1.8.0,<2.0) ; sys_platform == "linux"
-Requires-Dist: fastapi (>=0.96.0,!=0.111.0,!=0.111.1)
-Requires-Dist: gunicorn (>=20.1.0,<24.0)
-Requires-Dist: httpx (>=0.25.1,<1.0)
-Requires-Dist: jinja2 (>=3.1.2,<4.0)
-Requires-Dist: lazy_loader (>=0.4)
-Requires-Dist: packaging (>=23.1,<25.0)
-Requires-Dist: platformdirs (>=3.10.0,<5.0)
-Requires-Dist: psutil (>=5.9.4,<7.0)
-Requires-Dist: pydantic (>=1.10.21,<3.0)
-Requires-Dist: python-engineio (!=4.6.0)
-Requires-Dist: python-multipart (>=0.0.5,<0.1)
-Requires-Dist: python-socketio (>=5.7.0,<6.0)
-Requires-Dist: redis (>=4.3.5,<6.0)
-Requires-Dist: reflex-hosting-cli (>=0.1.29)
-Requires-Dist: rich (>=13.0.0,<14.0)
-Requires-Dist: setuptools (>=75.0)
-Requires-Dist: sqlmodel (>=0.0.14,<0.1)
-Requires-Dist: starlette-admin (>=0.11.0,<1.0)
-Requires-Dist: tomlkit (>=0.12.4,<1.0)
-Requires-Dist: twine (>=4.0.0,<7.0)
-Requires-Dist: typer (>=0.15.1,<1.0)
-Requires-Dist: typing_extensions (>=4.6.0)
-Requires-Dist: uvicorn (>=0.20.0)
-Requires-Dist: wheel (>=0.42.0,<1.0)
-Requires-Dist: wrapt (>=1.17.0,<2.0)
-Project-URL: Documentation, https://reflex.dev/docs/getting-started/introduction
-Project-URL: Homepage, https://reflex.dev
-Project-URL: Repository, https://github.com/reflex-dev/reflex
+Author: Elijah Ahianyo
+Author-Email: Nikhil Rao <nikhil@reflex.dev>, Alek Petuskey <alek@reflex.dev>, Masen Furer <masen@reflex.dev>, =?utf-8?q?Thomas_Brand=C3=A9ho?= <thomas@reflex.dev>, Khaleel Al-Adhami <khaleel@reflex.dev>
+Maintainer-Email: Masen Furer <masen@reflex.dev>, =?utf-8?q?Thomas_Brand=C3=A9ho?= <thomas@reflex.dev>, Khaleel Al-Adhami <khaleel@reflex.dev>
+License-Expression: Apache-2.0
+Project-URL: homepage, https://reflex.dev
+Project-URL: repository, https://github.com/reflex-dev/reflex
+Project-URL: documentation, https://reflex.dev/docs/getting-started/introduction
+Requires-Python: <4.0,>=3.10
+Requires-Dist: fastapi!=0.111.0,!=0.111.1,>=0.96.0
+Requires-Dist: gunicorn<24.0,>=20.1.0
+Requires-Dist: jinja2<4.0,>=3.1.2
+Requires-Dist: psutil<8.0,>=5.9.4
+Requires-Dist: pydantic<3.0,>=1.10.21
+Requires-Dist: python-multipart<0.1,>=0.0.5
+Requires-Dist: python-socketio<6.0,>=5.7.0
+Requires-Dist: redis<6.0,>=4.3.5
+Requires-Dist: rich<14.0,>=13.0.0
+Requires-Dist: sqlmodel<0.1,>=0.0.14
+Requires-Dist: typer<1.0,>=0.15.1
+Requires-Dist: uvicorn>=0.20.0
+Requires-Dist: starlette-admin<1.0,>=0.11.0
+Requires-Dist: alembic<2.0,>=1.11.1
+Requires-Dist: platformdirs<5.0,>=3.10.0
+Requires-Dist: distro<2.0,>=1.8.0; platform_system == "Linux"
+Requires-Dist: python-engineio!=4.6.0
+Requires-Dist: wrapt<2.0,>=1.17.0
+Requires-Dist: packaging<25.0,>=23.1
+Requires-Dist: reflex-hosting-cli>=0.1.29
+Requires-Dist: charset-normalizer<4.0,>=3.3.2
+Requires-Dist: wheel<1.0,>=0.42.0
+Requires-Dist: build<2.0,>=1.0.3
+Requires-Dist: setuptools>=75.0
+Requires-Dist: httpx<1.0,>=0.25.1
+Requires-Dist: twine<7.0,>=4.0.0
+Requires-Dist: tomlkit<1.0,>=0.12.4
+Requires-Dist: lazy_loader>=0.4
+Requires-Dist: typing_extensions>=4.6.0
 Description-Content-Type: text/markdown
 
 
@@ -307,4 +301,3 @@ We are actively looking for contributors, no matter your skill level or experien
 ## License
 
 Reflex is open-source and licensed under the [Apache License 2.0](LICENSE).
-

reflex-0.7.2.dev1/benchmarks/__init__.py

@@ -0,0 +1,3 @@
+"""Reflex benchmarks."""
+
+WINDOWS_SKIP_REASON = "Takes too much time as a result of npm"

reflex-0.7.2.dev1/benchmarks/benchmark_compile_times.py

@@ -0,0 +1,147 @@
+"""Extracts the compile times from the JSON files in the specified directory and inserts them into the database."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+from pathlib import Path
+
+from utils import send_data_to_posthog
+
+
+def extract_stats_from_json(json_file: str) -> list[dict]:
+    """Extracts the stats from the JSON data and returns them as a list of dictionaries.
+
+    Args:
+        json_file: The JSON file to extract the stats data from.
+
+    Returns:
+        list[dict]: The stats for each test.
+    """
+    with Path(json_file).open() as file:
+        json_data = json.load(file)
+
+    # Load the JSON data if it is a string, otherwise assume it's already a dictionary
+    data = json.loads(json_data) if isinstance(json_data, str) else json_data
+
+    # Initialize an empty list to store the stats for each test
+    test_stats = []
+
+    # Iterate over each test in the 'benchmarks' list
+    for test in data.get("benchmarks", []):
+        group = test.get("group", None)
+        stats = test.get("stats", {})
+        full_name = test.get("fullname")
+        file_name = (
+            full_name.split("/")[-1].split("::")[0].strip(".py") if full_name else None
+        )
+        test_name = test.get("name", "Unknown Test")
+
+        test_stats.append(
+            {
+                "test_name": test_name,
+                "group": group,
+                "stats": stats,
+                "full_name": full_name,
+                "file_name": file_name,
+            }
+        )
+    return test_stats
+
+
+def insert_benchmarking_data(
+    os_type_version: str,
+    python_version: str,
+    performance_data: list[dict],
+    commit_sha: str,
+    pr_title: str,
+    branch_name: str,
+    event_type: str,
+    pr_id: str,
+):
+    """Insert the benchmarking data into the database.
+
+    Args:
+        os_type_version: The OS type and version to insert.
+        python_version: The Python version to insert.
+        performance_data: The performance data of reflex web to insert.
+        commit_sha: The commit SHA to insert.
+        pr_title: The PR title to insert.
+        branch_name: The name of the branch.
+        event_type: Type of github event(push, pull request, etc).
+        pr_id: Id of the PR.
+    """
+    # Prepare the event data
+    properties = {
+        "os": os_type_version,
+        "python_version": python_version,
+        "distinct_id": commit_sha,
+        "pr_title": pr_title,
+        "branch_name": branch_name,
+        "event_type": event_type,
+        "performance": performance_data,
+        "pr_id": pr_id,
+    }
+
+    send_data_to_posthog("simple_app_benchmark", properties)
+
+
+def main():
+    """Runs the benchmarks and inserts the results."""
+    # Get the commit SHA and JSON directory from the command line arguments
+    parser = argparse.ArgumentParser(description="Run benchmarks and process results.")
+    parser.add_argument(
+        "--os", help="The OS type and version to insert into the database."
+    )
+    parser.add_argument(
+        "--python-version", help="The Python version to insert into the database."
+    )
+    parser.add_argument(
+        "--commit-sha", help="The commit SHA to insert into the database."
+    )
+    parser.add_argument(
+        "--benchmark-json",
+        help="The JSON file containing the benchmark results.",
+    )
+    parser.add_argument(
+        "--pr-title",
+        help="The PR title to insert into the database.",
+    )
+    parser.add_argument(
+        "--branch-name",
+        help="The current branch",
+        required=True,
+    )
+    parser.add_argument(
+        "--event-type",
+        help="The github event type",
+        required=True,
+    )
+    parser.add_argument(
+        "--pr-id",
+        help="ID of the PR.",
+        required=True,
+    )
+    args = parser.parse_args()
+
+    # Get the PR title from env or the args. For the PR merge or push event, there is no PR title, leaving it empty.
+    pr_title = args.pr_title or os.getenv("PR_TITLE", "")
+
+    # Get the results of pytest benchmarks
+    cleaned_benchmark_results = extract_stats_from_json(args.benchmark_json)
+    # Insert the data into the database
+    insert_benchmarking_data(
+        os_type_version=args.os,
+        python_version=args.python_version,
+        performance_data=cleaned_benchmark_results,
+        commit_sha=args.commit_sha,
+        pr_title=pr_title,
+        branch_name=args.branch_name,
+        event_type=args.event_type,
+        pr_id=args.pr_id,
+    )
+
+
+if __name__ == "__main__":
+    main()

reflex-0.7.2.dev1/benchmarks/benchmark_imports.py

@@ -0,0 +1,128 @@
+"""Extract and upload benchmarking data to PostHog."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+from pathlib import Path
+
+from utils import send_data_to_posthog
+
+
+def extract_stats_from_json(json_file: str) -> dict:
+    """Extracts the stats from the JSON data and returns them as dictionaries.
+
+    Args:
+        json_file: The JSON file to extract the stats data from.
+
+    Returns:
+        dict: The stats for each test.
+    """
+    with Path(json_file).open() as file:
+        json_data = json.load(file)
+
+    # Load the JSON data if it is a string, otherwise assume it's already a dictionary
+    data = json.loads(json_data) if isinstance(json_data, str) else json_data
+
+    result = data.get("results", [{}])[0]
+    return {
+        k: v
+        for k, v in result.items()
+        if k in ("mean", "stddev", "median", "min", "max")
+    }
+
+
+def insert_benchmarking_data(
+    os_type_version: str,
+    python_version: str,
+    performance_data: dict,
+    commit_sha: str,
+    pr_title: str,
+    branch_name: str,
+    pr_id: str,
+    app_name: str,
+):
+    """Insert the benchmarking data into the database.
+
+    Args:
+        os_type_version: The OS type and version to insert.
+        python_version: The Python version to insert.
+        performance_data: The imports performance data to insert.
+        commit_sha: The commit SHA to insert.
+        pr_title: The PR title to insert.
+        branch_name: The name of the branch.
+        pr_id: Id of the PR.
+        app_name: The name of the app being measured.
+    """
+    properties = {
+        "os": os_type_version,
+        "python_version": python_version,
+        "distinct_id": commit_sha,
+        "pr_title": pr_title,
+        "branch_name": branch_name,
+        "pr_id": pr_id,
+        "performance": performance_data,
+        "app_name": app_name,
+    }
+
+    send_data_to_posthog("import_benchmark", properties)
+
+
+def main():
+    """Runs the benchmarks and inserts the results."""
+    # Get the commit SHA and JSON directory from the command line arguments
+    parser = argparse.ArgumentParser(description="Run benchmarks and process results.")
+    parser.add_argument(
+        "--os", help="The OS type and version to insert into the database."
+    )
+    parser.add_argument(
+        "--python-version", help="The Python version to insert into the database."
+    )
+    parser.add_argument(
+        "--commit-sha", help="The commit SHA to insert into the database."
+    )
+    parser.add_argument(
+        "--benchmark-json",
+        help="The JSON file containing the benchmark results.",
+    )
+    parser.add_argument(
+        "--pr-title",
+        help="The PR title to insert into the database.",
+    )
+    parser.add_argument(
+        "--branch-name",
+        help="The current branch",
+        required=True,
+    )
+    parser.add_argument(
+        "--app-name",
+        help="The name of the app measured.",
+        required=True,
+    )
+    parser.add_argument(
+        "--pr-id",
+        help="ID of the PR.",
+        required=True,
+    )
+    args = parser.parse_args()
+
+    # Get the PR title from env or the args. For the PR merge or push event, there is no PR title, leaving it empty.
+    pr_title = args.pr_title or os.getenv("PR_TITLE", "")
+
+    cleaned_benchmark_results = extract_stats_from_json(args.benchmark_json)
+    # Insert the data into the database
+    insert_benchmarking_data(
+        os_type_version=args.os,
+        python_version=args.python_version,
+        performance_data=cleaned_benchmark_results,
+        commit_sha=args.commit_sha,
+        pr_title=pr_title,
+        branch_name=args.branch_name,
+        app_name=args.app_name,
+        pr_id=args.pr_id,
+    )
+
+
+if __name__ == "__main__":
+    main()

reflex-0.7.2.dev1/benchmarks/benchmark_lighthouse.py

@@ -0,0 +1,75 @@
+"""Extracts the Lighthouse scores from the JSON files in the specified directory and inserts them into the database."""
+
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+from utils import send_data_to_posthog
+
+
+def insert_benchmarking_data(
+    lighthouse_data: dict,
+    commit_sha: str,
+):
+    """Insert the benchmarking data into the database.
+
+    Args:
+        lighthouse_data: The Lighthouse data to insert.
+        commit_sha: The commit SHA to insert.
+    """
+    properties = {
+        "distinct_id": commit_sha,
+        "lighthouse_data": lighthouse_data,
+    }
+
+    # Send the data to PostHog
+    send_data_to_posthog("lighthouse_benchmark", properties)
+
+
+def get_lighthouse_scores(directory_path: str | Path) -> dict:
+    """Extracts the Lighthouse scores from the JSON files in the specified directory.
+
+    Args:
+        directory_path (str): The path to the directory containing the JSON files.
+
+    Returns:
+        dict: The Lighthouse scores.
+    """
+    scores = {}
+    directory_path = Path(directory_path)
+    try:
+        for filename in directory_path.iterdir():
+            if filename.suffix == ".json" and filename.stem != "manifest":
+                data = json.loads(filename.read_text())
+                # Extract scores and add them to the dictionary with the filename as key
+                scores[data["finalUrl"].replace("http://localhost:3000/", "/")] = {
+                    "performance_score": data["categories"]["performance"]["score"],
+                    "accessibility_score": data["categories"]["accessibility"]["score"],
+                    "best_practices_score": data["categories"]["best-practices"][
+                        "score"
+                    ],
+                    "seo_score": data["categories"]["seo"]["score"],
+                }
+    except Exception as e:
+        return {"error": e}
+
+    return scores
+
+
+def main():
+    """Runs the benchmarks and inserts the results into the database."""
+    # Get the commit SHA and JSON directory from the command line arguments
+    commit_sha = sys.argv[1]
+    json_dir = sys.argv[2]
+
+    # Get the Lighthouse scores
+    lighthouse_scores = get_lighthouse_scores(json_dir)
+
+    # Insert the data into the database
+    insert_benchmarking_data(lighthouse_scores, commit_sha)
+
+
+if __name__ == "__main__":
+    main()

reflex-0.7.2.dev1/benchmarks/benchmark_package_size.py

@@ -0,0 +1,135 @@
+"""Checks the size of a specific directory and uploads result to Posthog."""
+
+import argparse
+import os
+from pathlib import Path
+
+from utils import get_directory_size, get_python_version, send_data_to_posthog
+
+
+def get_package_size(venv_path: Path, os_name):
+    """Get the size of a specified package.
+
+    Args:
+        venv_path: The path to the venv.
+        os_name: Name of os.
+
+    Returns:
+        The total size of the package in bytes.
+
+    Raises:
+        ValueError: when venv does not exist or python version is None.
+    """
+    python_version = get_python_version(venv_path, os_name)
+    print("Python version:", python_version)
+    if python_version is None:
+        raise ValueError("Error: Failed to determine Python version.")
+
+    is_windows = "windows" in os_name
+
+    package_dir: Path = (
+        venv_path / "lib" / f"python{python_version}" / "site-packages"
+        if not is_windows
+        else venv_path / "Lib" / "site-packages"
+    )
+    if not package_dir.exists():
+        raise ValueError(
+            "Error: Virtual environment does not exist or is not activated."
+        )
+
+    total_size = get_directory_size(package_dir)
+    return total_size
+
+
+def insert_benchmarking_data(
+    os_type_version: str,
+    python_version: str,
+    commit_sha: str,
+    pr_title: str,
+    branch_name: str,
+    pr_id: str,
+    path: str,
+):
+    """Insert the benchmarking data into PostHog.
+
+    Args:
+        os_type_version: The OS type and version to insert.
+        python_version: The Python version to insert.
+        commit_sha: The commit SHA to insert.
+        pr_title: The PR title to insert.
+        branch_name: The name of the branch.
+        pr_id: The id of the PR.
+        path: The path to the dir or file to check size.
+    """
+    if "./dist" in path:
+        size = get_directory_size(Path(path))
+    else:
+        size = get_package_size(Path(path), os_type_version)
+
+    # Prepare the event data
+    properties = {
+        "path": path,
+        "os": os_type_version,
+        "python_version": python_version,
+        "distinct_id": commit_sha,
+        "pr_title": pr_title,
+        "branch_name": branch_name,
+        "pr_id": pr_id,
+        "size_mb": round(
+            size / (1024 * 1024), 3
+        ),  # save size in MB and round to 3 places
+    }
+
+    send_data_to_posthog("package_size", properties)
+
+
+def main():
+    """Runs the benchmarks and inserts the results."""
+    parser = argparse.ArgumentParser(description="Run benchmarks and process results.")
+    parser.add_argument(
+        "--os", help="The OS type and version to insert into the database."
+    )
+    parser.add_argument(
+        "--python-version", help="The Python version to insert into the database."
+    )
+    parser.add_argument(
+        "--commit-sha", help="The commit SHA to insert into the database."
+    )
+    parser.add_argument(
+        "--pr-title",
+        help="The PR title to insert into the database.",
+    )
+    parser.add_argument(
+        "--branch-name",
+        help="The current branch",
+        required=True,
+    )
+    parser.add_argument(
+        "--pr-id",
+        help="The pr id",
+        required=True,
+    )
+    parser.add_argument(
+        "--path",
+        help="The path to the vnenv.",
+        required=True,
+    )
+    args = parser.parse_args()
+
+    # Get the PR title from env or the args. For the PR merge or push event, there is no PR title, leaving it empty.
+    pr_title = args.pr_title or os.getenv("PR_TITLE", "")
+
+    # Insert the data into the database
+    insert_benchmarking_data(
+        os_type_version=args.os,
+        python_version=args.python_version,
+        commit_sha=args.commit_sha,
+        pr_title=pr_title,
+        branch_name=args.branch_name,
+        pr_id=args.pr_id,
+        path=args.path,
+    )
+
+
+if __name__ == "__main__":
+    main()

reflex-0.7.2.dev1/benchmarks/benchmark_web_size.py

@@ -0,0 +1,106 @@
+"""Checks the size of a specific directory and uploads result to Posthog."""
+
+import argparse
+import os
+from pathlib import Path
+
+from utils import get_directory_size, send_data_to_posthog
+
+
+def insert_benchmarking_data(
+    os_type_version: str,
+    python_version: str,
+    app_name: str,
+    commit_sha: str,
+    pr_title: str,
+    branch_name: str,
+    pr_id: str,
+    path: str,
+):
+    """Insert the benchmarking data into PostHog.
+
+    Args:
+        app_name: The name of the app being measured.
+        os_type_version: The OS type and version to insert.
+        python_version: The Python version to insert.
+        commit_sha: The commit SHA to insert.
+        pr_title: The PR title to insert.
+        branch_name: The name of the branch.
+        pr_id: The id of the PR.
+        path: The path to the dir or file to check size.
+    """
+    size = get_directory_size(Path(path))
+
+    # Prepare the event data
+    properties = {
+        "app_name": app_name,
+        "os": os_type_version,
+        "python_version": python_version,
+        "distinct_id": commit_sha,
+        "pr_title": pr_title,
+        "branch_name": branch_name,
+        "pr_id": pr_id,
+        "size_mb": round(
+            size / (1024 * 1024), 3
+        ),  # save size in MB and round to 3 places
+    }
+
+    send_data_to_posthog("web-size", properties)
+
+
+def main():
+    """Runs the benchmarks and inserts the results."""
+    parser = argparse.ArgumentParser(description="Run benchmarks and process results.")
+    parser.add_argument(
+        "--os", help="The OS type and version to insert into the database."
+    )
+    parser.add_argument(
+        "--python-version", help="The Python version to insert into the database."
+    )
+    parser.add_argument(
+        "--commit-sha", help="The commit SHA to insert into the database."
+    )
+    parser.add_argument(
+        "--pr-title",
+        help="The PR title to insert into the database.",
+    )
+    parser.add_argument(
+        "--branch-name",
+        help="The current branch",
+        required=True,
+    )
+    parser.add_argument(
+        "--app-name",
+        help="The name of the app measured.",
+        required=True,
+    )
+    parser.add_argument(
+        "--pr-id",
+        help="The pr id",
+        required=True,
+    )
+    parser.add_argument(
+        "--path",
+        help="The current path to app to check.",
+        required=True,
+    )
+    args = parser.parse_args()
+
+    # Get the PR title from env or the args. For the PR merge or push event, there is no PR title, leaving it empty.
+    pr_title = args.pr_title or os.getenv("PR_TITLE", "")
+
+    # Insert the data into the database
+    insert_benchmarking_data(
+        app_name=args.app_name,
+        os_type_version=args.os,
+        python_version=args.python_version,
+        commit_sha=args.commit_sha,
+        pr_title=pr_title,
+        branch_name=args.branch_name,
+        pr_id=args.pr_id,
+        path=args.path,
+    )
+
+
+if __name__ == "__main__":
+    main()