platzky 1.4.1__py3-none-any.whl → 1.4.2__py3-none-any.whl

platzky/__init__.py

@@ -1,4 +1,5 @@
 from platzky.engine import Engine as Engine
+from platzky.feature_flags import BUILTIN_FLAGS as BUILTIN_FLAGS
 from platzky.feature_flags import FakeLogin as FakeLogin
 from platzky.feature_flags import FeatureFlag as FeatureFlag
 from platzky.feature_flags import all_flags as all_flags

platzky/config.py

@@ -12,7 +12,6 @@ from pydantic import BaseModel, ConfigDict, Field, field_validator
 from platzky.attachment.constants import BLOCKED_EXTENSIONS, DEFAULT_MAX_ATTACHMENT_SIZE
 from platzky.db.db import DBConfig
 from platzky.db.db_loader import get_db_module
-from platzky.feature_flags import build_flag_set
 from platzky.feature_flags_wrapper import FeatureFlagSet
 
 
@@ -257,7 +256,7 @@ class Config(BaseModel):
     debug: bool = Field(default=False, alias="DEBUG")
     testing: bool = Field(default=False, alias="TESTING")
     feature_flags: FeatureFlagSet = Field(
-        default_factory=build_flag_set,
+        default_factory=lambda: FeatureFlagSet({}),
         alias="FEATURE_FLAGS",
     )
     telemetry: TelemetryConfig = Field(default_factory=TelemetryConfig, alias="TELEMETRY")
@@ -270,9 +269,9 @@ class Config(BaseModel):
         if isinstance(v, FeatureFlagSet):
             return v
         if isinstance(v, dict):
-            return build_flag_set(v)
+            return FeatureFlagSet(v)
         if v is None:
-            return build_flag_set()
+            return FeatureFlagSet({})
         return v
 
     @classmethod
@@ -286,8 +285,7 @@ class Config(BaseModel):
     ) -> "Config":
         """Validate and construct Config from dictionary.
 
-        Parses the raw FEATURE_FLAGS dict into a frozenset of enabled
-        FeatureFlag types via ``parse_flags()``.
+        Parses the raw FEATURE_FLAGS dict into a ``FeatureFlagSet``.
 
         Args:
             obj: Configuration dictionary

platzky/feature_flags.py

@@ -1,8 +1,9 @@
-"""Feature flags system with instance-based registration.
+"""Feature flags system for Platzky.
 
-Flags are created as instances of ``FeatureFlag``. Each instance is
-automatically registered and discovered via ``all_flags()``. The primary
-API is ``engine.is_enabled(flag_instance)``.
+Flags are created as instances of ``FeatureFlag``. The primary API is
+``engine.is_enabled(flag_instance)``.  Resolution is dynamic — the
+``FeatureFlagSet`` checks the raw config dict using each flag's ``alias``
+and ``default`` at lookup time.  No global registry is needed.
 
 Example::
 
@@ -16,11 +17,11 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+import deprecation
+
 if TYPE_CHECKING:
     from platzky.feature_flags_wrapper import FeatureFlagSet
 
-_registry: set[FeatureFlag] = set()
-
 
 class FeatureFlag:
     """A feature flag.
@@ -52,7 +53,6 @@ class FeatureFlag:
         default: bool = False,
         description: str = "",
         production_warning: bool = False,
-        register: bool = True,
     ) -> None:
         if not alias:
             raise ValueError("FeatureFlag requires a non-empty 'alias'")
@@ -60,8 +60,6 @@ class FeatureFlag:
         self.default = default
         self.description = description
         self.production_warning = production_warning
-        if register:
-            _registry.add(self)
 
     def __repr__(self) -> str:
         return f"FeatureFlag(alias={self.alias!r})"
@@ -82,60 +80,63 @@ FakeLogin = FeatureFlag(
     production_warning=True,
 )
 
+BUILTIN_FLAGS: tuple[FeatureFlag, ...] = (FakeLogin,)
 
-def all_flags() -> frozenset[FeatureFlag]:
-    """Return all registered feature flags.
 
-    Note: The returned frozenset has no guaranteed iteration order.
-    Use ``sorted(all_flags(), key=lambda f: f.alias)`` when
-    deterministic ordering is needed (e.g., documentation generation).
-    """
-    return frozenset(_registry)
+# ---------------------------------------------------------------------------
+# Deprecated shims — will be removed in 2.0.0
+# ---------------------------------------------------------------------------
 
 
-def unregister(flag: FeatureFlag) -> None:
-    """Remove a flag from the registry."""
-    _registry.discard(flag)
-
-
-def clear_registry() -> None:
-    """Remove all flags from the registry. Intended for test isolation."""
-    _registry.clear()
+@deprecation.deprecated(
+    deprecated_in="1.5.0",
+    removed_in="2.0.0",
+    details="Use BUILTIN_FLAGS instead.",
+)
+def all_flags() -> frozenset[FeatureFlag]:
+    """Return all built-in feature flags."""
+    return frozenset(BUILTIN_FLAGS)
 
 
+@deprecation.deprecated(
+    deprecated_in="1.5.0",
+    removed_in="2.0.0",
+    details="Use FeatureFlagSet(raw_data) and check membership with 'flag in flag_set' instead.",
+)
 def parse_flags(
     raw_data: dict[str, bool] | None = None,
 ) -> frozenset[FeatureFlag]:
-    """Build a frozenset of *enabled* flags from raw config data.
-
-    Uses ``all_flags()`` for discovery. Unknown keys in *raw_data* are
-    silently ignored.
-
-    Args:
-        raw_data: Dict of flag alias -> value from config / YAML.
-
-    Returns:
-        A frozenset containing the enabled FeatureFlag instances.
-    """
+    """Build a frozenset of enabled flags from raw config data."""
     if raw_data is None:
         raw_data = {}
-
-    return frozenset(flag for flag in all_flags() if raw_data.get(flag.alias, flag.default))
+    return frozenset(flag for flag in BUILTIN_FLAGS if raw_data.get(flag.alias, flag.default))
 
 
+@deprecation.deprecated(
+    deprecated_in="1.5.0",
+    removed_in="2.0.0",
+    details="Use FeatureFlagSet(raw_data) directly.",
+)
 def build_flag_set(raw_data: dict[str, bool] | None = None) -> FeatureFlagSet:
-    """Build a FeatureFlagSet from raw config data.
-
-    Preserves ALL keys (including unregistered ones) for backward
-    compatibility with consumers that use dict-like access.
-    """
+    """Build a FeatureFlagSet from raw config data."""
     from platzky.feature_flags_wrapper import FeatureFlagSet
 
-    if raw_data is None:
-        raw_data = {}
+    return FeatureFlagSet(raw_data or {})
+
+
+@deprecation.deprecated(
+    deprecated_in="1.5.0",
+    removed_in="2.0.0",
+    details="No replacement needed — the global registry has been removed.",
+)
+def unregister(_flag: FeatureFlag) -> None:
+    """No-op. The global registry has been removed."""
 
-    enabled_flags = frozenset(
-        flag for flag in all_flags() if raw_data.get(flag.alias, flag.default)
-    )
 
-    return FeatureFlagSet(enabled_flags, raw_data)
+@deprecation.deprecated(
+    deprecated_in="1.5.0",
+    removed_in="2.0.0",
+    details="No replacement needed — the global registry has been removed.",
+)
+def clear_registry() -> None:
+    """No-op. The global registry has been removed."""

platzky/feature_flags_wrapper.py

@@ -42,16 +42,8 @@ class FeatureFlagSet(dict[str, bool]):
     - ``flag_set.KEY`` -- deprecated Jinja2 attribute access.
     """
 
-    _enabled_flags: frozenset[FeatureFlag]
-
-    def __init__(
-        self,
-        enabled_flags: frozenset[FeatureFlag],
-        raw_data: dict[str, bool],
-    ) -> None:
+    def __init__(self, raw_data: dict[str, bool]) -> None:
         super().__init__(raw_data)
-        # Use object.__setattr__ to bypass __getattr__ override
-        object.__setattr__(self, "_enabled_flags", enabled_flags)
 
     def __getitem__(self, key: str) -> bool:
         """Dict bracket access with deprecation warning."""
@@ -77,7 +69,9 @@ class FeatureFlagSet(dict[str, bool]):
     def __contains__(self, item: object) -> bool:
         """Support both FeatureFlag membership and string key lookup."""
         if isinstance(item, FeatureFlag):
-            return item in self._enabled_flags
+            if super().__contains__(item.alias):
+                return bool(super().__getitem__(item.alias))
+            return item.default
         return super().__contains__(item)
 
     def __getattr__(self, name: str) -> bool:
@@ -86,8 +80,3 @@ class FeatureFlagSet(dict[str, bool]):
             return self[name]
         except KeyError:
             raise AttributeError(f"'{type(self).__name__}' has no attribute {name!r}") from None
-
-    @property
-    def enabled_flags(self) -> frozenset[FeatureFlag]:
-        """The set of enabled typed FeatureFlag instances."""
-        return self._enabled_flags

{platzky-1.4.1.dist-info → platzky-1.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: platzky
-Version: 1.4.1
+Version: 1.4.2
 Summary: Not only blog engine
 License: MIT
 License-File: LICENSE

{platzky-1.4.1.dist-info → platzky-1.4.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-platzky/__init__.py,sha256=jn2Ua0ZpKBI3Fb5tFYcRm3kEaR0SytlNBh6guUtO2jg,558
+platzky/__init__.py,sha256=kqK72dPH79dNogz8yB5K8XnwNM3PTC7rd-tCVgULks0,623
 platzky/admin/admin.py,sha256=_4Q1nId_QGrbSMaAZzl7ziquza3syQxXlBYYXjD_4XM,1660
 platzky/admin/templates/admin.html,sha256=zgjROhSezayZqnNFezvVa0MEfgmXLvOM8HRRaZemkQw,688
 platzky/admin/templates/login.html,sha256=oBNuv130iMTwXrtRnDUDcGIGvu0O2VsIbjQxw-Tjd7Y,380
@@ -10,7 +10,7 @@ platzky/attachment/mime_validation.py,sha256=VO272nF7K_Mx_Zefuw-10M-Tapj0ZxX197s
 platzky/blog/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 platzky/blog/blog.py,sha256=UaAS7QpcEsMswMrdAcyoSyuDX1NNQX05ll8D7MKSR3w,5468
 platzky/blog/comment_form.py,sha256=yOuXvX9PZLc6qQLIWZWLFcbwFQD4a849X82PlXKUzdk,805
-platzky/config.py,sha256=vldHCB6C_Y9NllkacSJ0-jd3vo3eIw9sG6eDpGQpyOU,11589
+platzky/config.py,sha256=Op4Bbrqvny48JKL7mWQRCP7aCSppTcysAkSgAtB75kc,11504
 platzky/db/README.md,sha256=IO-LoDsd4dLBZenaz423EZjvEOQu_8m2OC0G7du170w,1753
 platzky/db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 platzky/db/db.py,sha256=gi5uxvY8Ww8O4y2rxaH1Zj_12Yno8SbILvIaWnQPbYQ,4778
@@ -25,8 +25,8 @@ platzky/debug/__init__.py,sha256=5VUFjOOJzuXTuCgzQRe9aNjXHoCJSVUerR3RLKCTZC0,301
 platzky/debug/blueprint.py,sha256=_rtrtrOOsj4Pz8AKE_5kLFVedEtipAyN42j-pBVZqnM,1893
 platzky/debug/fake_login.py,sha256=3AmS11Kb4h5gDwWjUY26iDMif0b0x69S97veotnXUp4,3390
 platzky/engine.py,sha256=JeyRS-A0R0fK2BLude_Y4U8G3d-7nRUkuu4OeX86sRI,7400
-platzky/feature_flags.py,sha256=BD-DcPDYfYr2xuMrc61qyw5s6QQBqI1ro_H3-h3vWeo,3947
-platzky/feature_flags_wrapper.py,sha256=NqBoix90VODiILEkO6esRMRKsKZQVHgOa3VUWV3PPmU,3138
+platzky/feature_flags.py,sha256=6y5ErUgTAiKYNyvbUkGMVJl15sc7ouOvrqnMVIRCbuc,4095
+platzky/feature_flags_wrapper.py,sha256=_tH4aeAx33Czv7gvPEyYYLbiSRhWYiRooAFEtoikeF4,2822
 platzky/locale/en/LC_MESSAGES/messages.po,sha256=WaZGlFAegKRq7CSz69dWKic-mKvQFhVvssvExxNmGaU,1400
 platzky/locale/pl/LC_MESSAGES/messages.po,sha256=sUPxMKDeEOoZ5UIg94rGxZD06YVWiAMWIby2XE51Hrc,1624
 platzky/models.py,sha256=Ws5ZSWf5EhcpFxl3Yeze2pQiesjnjAA_haBJ90bN6lk,7435
@@ -50,7 +50,7 @@ platzky/templates/post.html,sha256=GSgjIZsOQKtNx3cEbquSjZ5L4whPnG6MzRyoq9k4B8Q,1
 platzky/templates/robots.txt,sha256=2_j2tiYtYJnzZUrANiX9pvBxyw5Dp27fR_co18BPEJ0,116
 platzky/templates/sitemap.xml,sha256=iIJZ91_B5ZuNLCHsRtsGKZlBAXojOTP8kffqKLacgvs,578
 platzky/www_handler.py,sha256=pF6Rmvem1sdVqHD7z3RLrDuG-CwAqfGCti50_NPsB2w,725
-platzky-1.4.1.dist-info/METADATA,sha256=7sZy3c0h0DRh_uEVwK1t_hqrV8XLaWarDbpLj2SA4xM,2595
-platzky-1.4.1.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
-platzky-1.4.1.dist-info/licenses/LICENSE,sha256=wCdfk-qEosi6BDwiBulMfKMi0hxp1UXV0DdjLrRm788,1077
-platzky-1.4.1.dist-info/RECORD,,
+platzky-1.4.2.dist-info/METADATA,sha256=TeusSpm8WupVralLVXnSzZ_UxPefW0AIdbevUTWW4yg,2595
+platzky-1.4.2.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+platzky-1.4.2.dist-info/licenses/LICENSE,sha256=wCdfk-qEosi6BDwiBulMfKMi0hxp1UXV0DdjLrRm788,1077
+platzky-1.4.2.dist-info/RECORD,,

{platzky-1.4.1.dist-info → platzky-1.4.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.3.0
+Generator: poetry-core 2.3.1
 Root-Is-Purelib: true
 Tag: py3-none-any