prefect-client 3.2.2__tar.gz → 3.2.3__tar.gz

prefect_client-3.2.3/.gitignore

@@ -0,0 +1,88 @@
+# Python artifacts
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+build/
+dist/
+sdist/
+# We likely ought to eventually include uv.lock
+uv.lock
+
+# Build metadata
+src/prefect/_build_info.py
+src/prefect/_version.py
+
+# Test artifacts
+.benchmarks/
+.coverage
+.coverage.*.*
+.prefect-results
+.pytest_cache/
+
+# Type checking artifacts
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+
+# IPython
+profile_default/
+ipython_config.py
+*.ipynb_checkpoints/*
+
+# Profiling
+/prof
+
+# Environments
+.python-version
+.env
+.venv
+env/
+venv/
+
+# Documentation artifacts
+# gschema.json
+site/
+.cache/
+src/mkdocs-material
+
+# UI artifacts
+src/prefect/server/ui/*
+src/prefect/server/ui_build/*
+**/node_modules
+
+# Databases
+*.db
+
+# API artifacts
+
+# MacOS
+.DS_Store
+
+# Dask
+dask-worker-space/
+
+# Editors
+.idea/
+.vscode/
+!ui/.vscode/
+
+# Prefect files
+prefect.toml
+prefect.yaml
+
+# Deployment recipes
+!src/prefect/deployments/recipes/*/**
+
+# For development doc server if link
+libcairo.2.dylib
+
+# setuptools-scm generated files
+src/prefect/_version.py
+src/integrations/*/**/_version.py
+*.log
+
+# Pyright type analysis report
+prefect-analysis.json

{prefect-client-3.2.2/src/prefect_client.egg-info → prefect_client-3.2.3}/PKG-INFO

@@ -1,20 +1,18 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.2.2
+Version: 3.2.3
 Summary: Workflow orchestration and management.
-Home-page: https://www.prefect.io
-Author: Prefect Technologies, Inc.
-Author-email: help@prefect.io
-License: UNKNOWN
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
 Project-URL: Source, https://github.com/PrefectHQ/prefect
 Project-URL: Tracker, https://github.com/PrefectHQ/prefect/issues
-Platform: UNKNOWN
-Classifier: Natural Language :: English
+Author-email: "Prefect Technologies, Inc." <help@prefect.io>
+License: Apache-2.0
+License-File: LICENSE
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
 Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -22,9 +20,48 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.9
-Description-Content-Type: text/markdown
+Requires-Dist: anyio<5.0.0,>=4.4.0
+Requires-Dist: asgi-lifespan<3.0,>=1.0
+Requires-Dist: cachetools<6.0,>=5.3
+Requires-Dist: cloudpickle<4.0,>=2.0
+Requires-Dist: coolname<3.0.0,>=1.0.4
+Requires-Dist: croniter<7.0.0,>=1.0.12
+Requires-Dist: exceptiongroup>=1.0.0
+Requires-Dist: fastapi<1.0.0,>=0.111.0
+Requires-Dist: fsspec>=2022.5.0
+Requires-Dist: graphviz>=0.20.1
+Requires-Dist: griffe<2.0.0,>=0.49.0
+Requires-Dist: httpcore<2.0.0,>=1.0.5
+Requires-Dist: httpx[http2]!=0.23.2,>=0.23
+Requires-Dist: importlib-metadata>=4.4; python_version < '3.10'
+Requires-Dist: jsonpatch<2.0,>=1.32
+Requires-Dist: jsonschema<5.0.0,>=4.0.0
+Requires-Dist: opentelemetry-api<2.0.0,>=1.27.0
+Requires-Dist: orjson<4.0,>=3.7
+Requires-Dist: packaging<24.3,>=21.3
+Requires-Dist: pathspec>=0.8.0
+Requires-Dist: pendulum<4,>=3.0.0
+Requires-Dist: prometheus-client>=0.20.0
+Requires-Dist: pydantic!=2.10.0,<3.0.0,>=2.9
+Requires-Dist: pydantic-core<3.0.0,>=2.12.0
+Requires-Dist: pydantic-extra-types<3.0.0,>=2.8.2
+Requires-Dist: pydantic-settings>2.2.1
+Requires-Dist: python-dateutil<3.0.0,>=2.8.2
+Requires-Dist: python-slugify<9.0,>=5.0
+Requires-Dist: python-socks[asyncio]<3.0,>=2.5.3
+Requires-Dist: pyyaml<7.0.0,>=5.4.1
+Requires-Dist: rfc3339-validator<0.2.0,>=0.1.4
+Requires-Dist: rich<14.0,>=11.0
+Requires-Dist: ruamel-yaml>=0.17.0
+Requires-Dist: sniffio<2.0.0,>=1.3.0
+Requires-Dist: toml>=0.10.0
+Requires-Dist: typing-extensions<5.0.0,>=4.5.0
+Requires-Dist: ujson<6.0.0,>=5.8.0
+Requires-Dist: uvicorn!=0.29.0,>=0.14.0
+Requires-Dist: websockets<14.0,>=10.4
 Provides-Extra: notifications
-License-File: LICENSE
+Requires-Dist: apprise<2.0.0,>=1.1.0; extra == 'notifications'
+Description-Content-Type: text/markdown
 
 <p align="center"><img src="https://github.com/PrefectHQ/prefect/assets/3407835/c654cbc6-63e8-4ada-a92a-efd2f8f24b85" width=1000></p>
 
@@ -135,5 +172,3 @@ All community forums, including code contributions, issue discussions, and Slack
 See our [documentation on contributing to Prefect](https://docs.prefect.io/contributing/overview/).
 
 Thanks for being part of the mission to build a new kind of workflow system and, of course, **happy engineering!**
-
-

prefect_client-3.2.3/pyproject.toml

@@ -0,0 +1,98 @@
+[build-system]
+requires = ["hatchling", "versioningit"]
+build-backend = "hatchling.build"
+
+[project]
+name = "prefect-client"
+dynamic = ["version"]
+description = "Workflow orchestration and management."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "Apache-2.0" }
+authors = [{ name = "Prefect Technologies, Inc.", email = "help@prefect.io" }]
+classifiers = [
+    "Natural Language :: English",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    # Client dependencies
+    "anyio>=4.4.0,<5.0.0",
+    "asgi-lifespan>=1.0,<3.0",
+    "cachetools>=5.3,<6.0",
+    "cloudpickle>=2.0,<4.0",
+    "coolname>=1.0.4,<3.0.0",
+    "croniter>=1.0.12,<7.0.0",
+    "exceptiongroup>=1.0.0",
+    "fastapi>=0.111.0,<1.0.0",
+    "fsspec>=2022.5.0",
+    "graphviz>=0.20.1",
+    "griffe>=0.49.0,<2.0.0",
+    "httpcore>=1.0.5,<2.0.0",
+    "httpx[http2]>=0.23,!=0.23.2",
+    "importlib_metadata>=4.4;python_version<'3.10'",
+    "jsonpatch>=1.32,<2.0",
+    "jsonschema>=4.0.0,<5.0.0",
+    "opentelemetry-api>=1.27.0,<2.0.0",
+    "orjson>=3.7,<4.0",
+    "packaging>=21.3,<24.3",
+    "pathspec>=0.8.0",
+    "pendulum>=3.0.0,<4",
+    "prometheus-client>=0.20.0",
+    "pydantic>=2.9,<3.0.0,!=2.10.0",
+    "pydantic_core>=2.12.0,<3.0.0",
+    "pydantic_extra_types>=2.8.2,<3.0.0",
+    "pydantic_settings>2.2.1",
+    "python-dateutil>=2.8.2,<3.0.0",
+    "python-slugify>=5.0,<9.0",
+    "python-socks[asyncio]>=2.5.3,<3.0",
+    "pyyaml>=5.4.1,<7.0.0",
+    "rfc3339-validator>=0.1.4,<0.2.0",
+    "rich>=11.0,<14.0",
+    "ruamel.yaml>=0.17.0",
+    "sniffio>=1.3.0,<2.0.0",
+    "toml>=0.10.0",
+    "typing_extensions>=4.5.0,<5.0.0",
+    "ujson>=5.8.0,<6.0.0",
+    "uvicorn>=0.14.0,!=0.29.0",
+    "websockets>=10.4,<14.0",
+]
+[project.urls]
+Changelog = "https://github.com/PrefectHQ/prefect/releases"
+Documentation = "https://docs.prefect.io"
+Source = "https://github.com/PrefectHQ/prefect"
+Tracker = "https://github.com/PrefectHQ/prefect/issues"
+[project.optional-dependencies]
+notifications = ["apprise>=1.1.0, <2.0.0"]
+
+
+[tool.hatch.version]
+source = "versioningit"
+
+[tool.versioningit.vcs]
+match = ["[0-9]*.[0-9]*.[0-9]*", "[0-9]*.[0-9]*.[0-9]*.dev[0-9]*"]
+
+[tool.versioningit.write]
+method = { module = "write_build_info", value = "write_build_info", module-dir = "tools" }
+path = "src/prefect/_build_info.py"
+
+[tool.versioningit.format]
+distance = "{base_version}+{distance}.{vcs}{rev}"
+dirty = "{base_version}"
+distance-dirty = "{base_version}+{distance}.{vcs}{rev}"
+
+[tool.hatch.build]
+artifacts = ["src/prefect/_build_info.py"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src/prefect", "/README.md", "/LICENSE", "/pyproject.toml"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/prefect"]

{prefect-client-3.2.2 → prefect_client-3.2.3}/src/prefect/__init__.py

@@ -3,7 +3,7 @@
 # Setup version and path constants
 
 import sys
-from . import _version
+from . import _build_info
 import importlib
 import pathlib
 from typing import TYPE_CHECKING, Any, Optional, TypedDict, cast
@@ -24,16 +24,14 @@ if TYPE_CHECKING:
         unmapped,
         serve,
         aserve,
-        deploy,
         pause_flow_run,
         resume_flow_run,
         suspend_flow_run,
     )
+    from prefect.deployments.runner import deploy
 
     __spec__: ModuleSpec
 
-    # Versioneer provides version information as dictionaries
-    # with these keys
     class VersionInfo(TypedDict("_FullRevisionId", {"full-revisionid": str})):
         version: str
         dirty: Optional[bool]
@@ -41,8 +39,17 @@ if TYPE_CHECKING:
         date: Optional[str]
 
 
-__version_info__: "VersionInfo" = cast("VersionInfo", _version.get_versions())
-__version__ = __version_info__["version"]
+__version__ = _build_info.__version__
+__version_info__: "VersionInfo" = cast(
+    "VersionInfo",
+    {
+        "version": __version__,
+        "date": _build_info.__build_date__,
+        "full-revisionid": _build_info.__git_commit__,
+        "error": None,
+        "dirty": _build_info.__dirty__,
+    },
+)
 
 # The absolute path to this module
 __module_path__: pathlib.Path = pathlib.Path(__file__).parent
@@ -56,12 +63,12 @@ __ui_static_subpath__: pathlib.Path = __module_path__ / "server" / "ui_build"
 # The absolute path to the built UI within the Python module
 __ui_static_path__: pathlib.Path = __module_path__ / "server" / "ui"
 
-del _version, pathlib
+del _build_info, pathlib
 
 _public_api: dict[str, tuple[Optional[str], str]] = {
     "allow_failure": (__spec__.parent, ".main"),
     "aserve": (__spec__.parent, ".main"),
-    "deploy": (__spec__.parent, ".main"),
+    "deploy": (__spec__.parent, ".deployments.runner"),
     "flow": (__spec__.parent, ".main"),
     "Flow": (__spec__.parent, ".main"),
     "get_client": (__spec__.parent, ".main"),

prefect_client-3.2.3/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.2.3"
+__build_date__ = "2025-02-18 19:56:33.826730+00:00"
+__git_commit__ = "b31bfa353b4421ce133091e87cb9f661152a48bb"
+__dirty__ = False

{prefect-client-3.2.2 → prefect_client-3.2.3}/src/prefect/client/orchestration/__init__.py

@@ -149,19 +149,30 @@ T = TypeVar("T")
 
 
 @overload
-def get_client(  # type: ignore # TODO
-    *,
-    httpx_settings: Optional[dict[str, Any]] = ...,
-    sync_client: Literal[False] = False,
+def get_client(
+    httpx_settings: Optional[dict[str, Any]],
+    sync_client: Literal[False],
 ) -> "PrefectClient": ...
 
 
+@overload
+def get_client(*, httpx_settings: Optional[dict[str, Any]]) -> "PrefectClient": ...
+
+
+@overload
+def get_client(*, sync_client: Literal[False] = False) -> "PrefectClient": ...
+
+
 @overload
 def get_client(
-    *, httpx_settings: Optional[dict[str, Any]] = ..., sync_client: Literal[True] = ...
+    httpx_settings: Optional[dict[str, Any]], sync_client: Literal[True]
 ) -> "SyncPrefectClient": ...
 
 
+@overload
+def get_client(*, sync_client: Literal[True]) -> "SyncPrefectClient": ...
+
+
 def get_client(
     httpx_settings: Optional[dict[str, Any]] = None, sync_client: bool = False
 ) -> Union["SyncPrefectClient", "PrefectClient"]:

{prefect-client-3.2.2 → prefect_client-3.2.3}/src/prefect/main.py

@@ -1,6 +1,5 @@
 # Import user-facing API
 from typing import Any
-from prefect.deployments import deploy
 from prefect.states import State
 from prefect.logging import get_run_logger
 from prefect.flows import FlowDecorator, flow, Flow, serve, aserve
@@ -77,7 +76,6 @@ __all__ = [
     "unmapped",
     "serve",
     "aserve",
-    "deploy",
     "pause_flow_run",
     "resume_flow_run",
     "suspend_flow_run",

prefect_client-3.2.3/src/prefect/server/api/__init__.py

@@ -0,0 +1,34 @@
+from . import (
+    artifacts,
+    admin,
+    automations,
+    block_capabilities,
+    block_documents,
+    block_schemas,
+    block_types,
+    collections,
+    concurrency_limits,
+    concurrency_limits_v2,
+    csrf_token,
+    dependencies,
+    deployments,
+    events,
+    flow_run_notification_policies,
+    flow_run_states,
+    flow_runs,
+    flows,
+    logs,
+    middleware,
+    root,
+    run_history,
+    saved_searches,
+    task_run_states,
+    task_runs,
+    task_workers,
+    templates,
+    ui,
+    variables,
+    work_queues,
+    workers,
+)
+from . import server  # Server relies on all of the above routes

prefect_client-3.2.3/src/prefect/server/api/admin.py

@@ -0,0 +1,85 @@
+"""
+Routes for admin-level interactions with the Prefect REST API.
+"""
+
+from fastapi import Body, Depends, Response, status
+
+import prefect
+import prefect.settings
+from prefect.server.database import PrefectDBInterface, provide_database_interface
+from prefect.server.utilities.server import PrefectRouter
+
+router: PrefectRouter = PrefectRouter(prefix="/admin", tags=["Admin"])
+
+
+@router.get("/settings")
+async def read_settings() -> prefect.settings.Settings:
+    """
+    Get the current Prefect REST API settings.
+
+    Secret setting values will be obfuscated.
+    """
+    return prefect.settings.get_current_settings()
+
+
+@router.get("/version")
+async def read_version() -> str:
+    """Returns the Prefect version number"""
+    return prefect.__version__
+
+
+@router.post("/database/clear", status_code=status.HTTP_204_NO_CONTENT)
+async def clear_database(
+    db: PrefectDBInterface = Depends(provide_database_interface),
+    confirm: bool = Body(
+        False,
+        embed=True,
+        description="Pass confirm=True to confirm you want to modify the database.",
+    ),
+    response: Response = None,  # type: ignore
+) -> None:
+    """Clear all database tables without dropping them."""
+    if not confirm:
+        response.status_code = status.HTTP_400_BAD_REQUEST
+        return
+    async with db.session_context(begin_transaction=True) as session:
+        # work pool has a circular dependency on pool queue; delete it first
+        await session.execute(db.WorkPool.__table__.delete())
+        for table in reversed(db.Base.metadata.sorted_tables):
+            await session.execute(table.delete())
+
+
+@router.post("/database/drop", status_code=status.HTTP_204_NO_CONTENT)
+async def drop_database(
+    db: PrefectDBInterface = Depends(provide_database_interface),
+    confirm: bool = Body(
+        False,
+        embed=True,
+        description="Pass confirm=True to confirm you want to modify the database.",
+    ),
+    response: Response = None,
+) -> None:
+    """Drop all database objects."""
+    if not confirm:
+        response.status_code = status.HTTP_400_BAD_REQUEST
+        return
+
+    await db.drop_db()
+
+
+@router.post("/database/create", status_code=status.HTTP_204_NO_CONTENT)
+async def create_database(
+    db: PrefectDBInterface = Depends(provide_database_interface),
+    confirm: bool = Body(
+        False,
+        embed=True,
+        description="Pass confirm=True to confirm you want to modify the database.",
+    ),
+    response: Response = None,
+) -> None:
+    """Create all database objects."""
+    if not confirm:
+        response.status_code = status.HTTP_400_BAD_REQUEST
+        return
+
+    await db.create_db()