fast-feature 0.0.1__tar.gz

fast_feature-0.0.1/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,27 @@
+# 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/pyproject.toml

@@ -0,0 +1,64 @@
+[project]
+name = "fast-feature"
+version = "0.0.1"
+description = "A lightweight, async, OpenFeature-compatible (OFREP) feature flag server."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.10"
+authors = [
+    { name = "byunjuneseok", email = "byunjuneseok@gmail.com" },
+]
+keywords = ["feature-flags", "openfeature", "ofrep", "json-logic", "fastapi", "async"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: FastAPI",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Typing :: Typed",
+]
+dependencies = [
+    "fast-feature-core==0.0.1",
+    "fast-feature-engine==0.0.1",
+    "fast-feature-ofrep==0.0.1",
+    "fast-feature-storage-inmemory==0.0.1",
+    "pydantic-settings>=2.0",
+]
+
+[project.optional-dependencies]
+postgresql = ["fast-feature-storage-postgresql==0.0.1"]
+admin = ["fast-feature-admin==0.0.1"]
+standalone = ["uvicorn[standard]>=0.27"]
+all = [
+    "fast-feature-storage-postgresql==0.0.1",
+    "fast-feature-admin==0.0.1",
+    "uvicorn[standard]>=0.27",
+]
+
+[project.scripts]
+fast-feature = "fast_feature.server.cli:Cli.run"
+
+[project.urls]
+Homepage = "https://github.com/byunjuneseok/fast-feature"
+Repository = "https://github.com/byunjuneseok/fast-feature"
+Issues = "https://github.com/byunjuneseok/fast-feature/issues"
+
+[build-system]
+requires = ["uv_build>=0.11.17,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "fast_feature.server"
+
+[tool.uv.sources]
+fast-feature-core = { workspace = true }
+fast-feature-engine = { workspace = true }
+fast-feature-ofrep = { workspace = true }
+fast-feature-storage-inmemory = { workspace = true }
+fast-feature-storage-postgresql = { workspace = true }
+fast-feature-admin = { workspace = true }

fast_feature-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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"