fast-feature 0.0.1__py3-none-any.whl

fast_feature/server/__init__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from .app import Application
+from .repository_factory import RepositoryFactory
+from .settings import Settings
+
+__all__ = ["Application", "RepositoryFactory", "Settings"]

fast_feature/server/app.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from fastapi import FastAPI
+
+from fast_feature.ofrep import OfrepRouter
+
+from .repository_factory import RepositoryFactory
+from .settings import Settings
+
+
+class Application:
+    """Composition root: wires settings -> repository -> routers into a FastAPI app."""
+
+    @classmethod
+    def create(cls, settings: Settings | None = None) -> FastAPI:
+        resolved = settings or Settings()
+        repository = RepositoryFactory.from_settings(resolved)
+
+        app = FastAPI(title="fast-feature")
+        app.include_router(OfrepRouter.build(repository))
+
+        if resolved.admin:
+            # Imported lazily so the admin distribution is only needed when enabled.
+            from fast_feature.admin import AdminRouter
+
+            app.include_router(AdminRouter.build(repository), prefix=resolved.admin_prefix)
+
+        return app

fast_feature/server/cli.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+import argparse
+from collections.abc import Sequence
+
+from .app import Application
+
+
+class Cli:
+    """The ``fast-feature`` command-line entry point."""
+
+    @classmethod
+    def run(cls, argv: Sequence[str] | None = None) -> None:
+        parser = argparse.ArgumentParser(prog="fast-feature")
+        subparsers = parser.add_subparsers(dest="command", required=True)
+        serve = subparsers.add_parser("serve", help="Run the OFREP server.")
+        serve.add_argument("--host", default="127.0.0.1")
+        serve.add_argument("--port", type=int, default=8000)
+
+        args = parser.parse_args(argv)
+        if args.command == "serve":
+            cls._serve(args.host, args.port)
+
+    @staticmethod
+    def _serve(host: str, port: int) -> None:
+        try:
+            import uvicorn
+        except ImportError as exc:  # pragma: no cover
+            raise SystemExit("Install fast-feature[standalone] to run the server.") from exc
+        uvicorn.run(Application.create(), host=host, port=port)

fast_feature/server/repository_factory.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from fast_feature.core import FlagRepository
+from fast_feature.storage.inmemory import InMemoryFlagRepository
+
+from .settings import Settings
+
+
+class RepositoryFactory:
+    """Builds the configured ``FlagRepository`` for the standalone server."""
+
+    @staticmethod
+    def from_settings(settings: Settings) -> FlagRepository:
+        if settings.backend == "postgresql":
+            if not settings.database_url:
+                raise ValueError("FAST_FEATURE_DATABASE_URL is required for the postgresql backend")
+            # Imported lazily so the dependency is only needed with the extra.
+            from fast_feature.storage.postgresql import PostgresStorage
+
+            return PostgresStorage.from_dsn(settings.database_url).repository
+        return InMemoryFlagRepository()

fast_feature/server/settings.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from typing import Literal
+
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    """Standalone-server configuration, read from ``FAST_FEATURE_*`` env vars."""
+
+    model_config = SettingsConfigDict(env_prefix="FAST_FEATURE_")
+
+    backend: Literal["inmemory", "postgresql"] = "inmemory"
+    database_url: str | None = None
+    admin: bool = False
+    admin_prefix: str = "/admin"

fast_feature-0.0.1.dist-info/METADATA

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: fast-feature
+Version: 0.0.1
+Summary: A lightweight, async, OpenFeature-compatible (OFREP) feature flag server.
+Keywords: feature-flags,openfeature,ofrep,json-logic,fastapi,async
+Author: byunjuneseok
+Author-email: byunjuneseok <byunjuneseok@gmail.com>
+License-Expression: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: FastAPI
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Dist: fast-feature-core==0.0.1
+Requires-Dist: fast-feature-engine==0.0.1
+Requires-Dist: fast-feature-ofrep==0.0.1
+Requires-Dist: fast-feature-storage-inmemory==0.0.1
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: fast-feature-admin==0.0.1 ; extra == 'admin'
+Requires-Dist: fast-feature-storage-postgresql==0.0.1 ; extra == 'all'
+Requires-Dist: fast-feature-admin==0.0.1 ; extra == 'all'
+Requires-Dist: uvicorn[standard]>=0.27 ; extra == 'all'
+Requires-Dist: fast-feature-storage-postgresql==0.0.1 ; extra == 'postgresql'
+Requires-Dist: uvicorn[standard]>=0.27 ; extra == 'standalone'
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/byunjuneseok/fast-feature
+Project-URL: Repository, https://github.com/byunjuneseok/fast-feature
+Project-URL: Issues, https://github.com/byunjuneseok/fast-feature/issues
+Provides-Extra: admin
+Provides-Extra: all
+Provides-Extra: postgresql
+Provides-Extra: standalone
+Description-Content-Type: text/markdown
+
+# fast-feature
+
+The umbrella distribution for [fast-feature](https://github.com/byunjuneseok/fast-feature):
+an async, OpenFeature-compatible (OFREP) feature flag server.
+
+```bash
+pip install "fast-feature[standalone]"        # + uvicorn, to run the server
+pip install "fast-feature[postgresql]"        # + PostgreSQL backend
+pip install "fast-feature[admin]"             # + admin console
+pip install "fast-feature[all]"
+```
+
+Run it:
+
+```bash
+FAST_FEATURE_BACKEND=inmemory fast-feature serve --host 0.0.0.0 --port 8000
+```
+
+Or embed it:
+
+```python
+from fast_feature.server import Application, Settings
+
+app = Application.create(Settings(admin=True))
+```
+
+See the [project README](https://github.com/byunjuneseok/fast-feature) for details.

fast_feature-0.0.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+fast_feature/server/__init__.py,sha256=qyFYriBQEFe1_zi382yRbH89z8e9d7WV2oh2DlPPL8U,206
+fast_feature/server/app.py,sha256=YzKqE0qSOc7dBwgGFEQBtGEi9CQ63L8vXALISUZBAt4,872
+fast_feature/server/cli.py,sha256=LfTmb11QLOTwmsZVVE35RcycEG-Zen45_-0_I3uVcOs,1038
+fast_feature/server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fast_feature/server/repository_factory.py,sha256=BG6vwvk68axhRjv7IdpPhYhVYvlnokaS5C10f--2nn0,821
+fast_feature/server/settings.py,sha256=y79qw_zD2hr_54UYoPszVYQyYnyWIPFQnSUSxmUxm3M,462
+fast_feature-0.0.1.dist-info/WHEEL,sha256=8ZlpUMJ7mlDirmlHRhDirEx_nPnARrwDjeE92mlk68E,81
+fast_feature-0.0.1.dist-info/entry_points.txt,sha256=UHFhHTikqmbG4PmtyoS-TnmyphLSdzecMzUg8Wno8fw,66
+fast_feature-0.0.1.dist-info/METADATA,sha256=eIo9M-jRc_0XQXYeL1FzXTdt3E6JPFJQitVBtPwljpc,2550
+fast_feature-0.0.1.dist-info/RECORD,,

fast_feature-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.21
+Root-Is-Purelib: true
+Tag: py3-none-any

fast_feature-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+fast-feature = fast_feature.server.cli:Cli.run
+