proj-flow 0.18.0__py3-none-any.whl → 0.20.0__py3-none-any.whl

proj_flow/ext/webidl/model/builders.py

@@ -0,0 +1,230 @@
+# Copyright (c) 2026 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+
+import copy
+import json
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any, Callable, cast
+
+from pywebidl2 import expr
+
+package_root = Path(__file__).parent.parent
+
+TR = list[str] | str | None
+
+
+@dataclass
+class TypeReplacement:
+    name: str
+    module_or_include: str | None = None
+
+    @staticmethod
+    def load_config(lang: str | None, types: Path | None):
+        data = {}
+        if lang:
+            path = package_root / "data" / "types" / f"{lang}.json"
+            with path.open(encoding="utf-8") as lang_file:
+                data.update(cast(dict, json.load(lang_file)))
+
+        if types:
+            with types.open(encoding="utf-8") as lang_file:
+                all_types_data = cast(dict[str, dict], json.load(lang_file))
+                if lang:
+                    data.update(all_types_data.get(lang, {}))
+                else:
+                    data.update(all_types_data.get("", {}))
+
+        result: dict[str, TypeReplacement] = {}
+        for key, value in data.items():
+            if value is None:
+                result[key] = TypeReplacement(name=key)
+
+            elif isinstance(value, str):
+                result[key] = TypeReplacement(name=value)
+
+            elif isinstance(value, list) and len(value) == 2:
+                mod, name = value
+                if isinstance(name, str) and (mod is None or isinstance(mod, str)):
+                    result[key] = TypeReplacement(name=name, module_or_include=mod)
+
+        return result
+
+
+def visit_flag_extended_attribute(
+    name: str, bag: dict[str, Any], attributes: dict[str, expr.ExtendedAttribute]
+):
+    bag[name] = attributes.get(name) != None
+
+
+def visit_string_extended_attribute(
+    name: str, bag: dict[str, Any], attributes: dict[str, expr.ExtendedAttribute]
+):
+    bag[name] = None
+    try:
+        attr = attributes[name]
+    except KeyError:
+        return
+
+    if attr.rhs:
+        bag[name] = cast(str, attr.rhs.value)
+
+
+def flag_extended_attribute(name: str):
+    def impl(bag: dict[str, Any], attributes: dict[str, expr.ExtendedAttribute]):
+        return visit_flag_extended_attribute(name, bag, attributes)
+
+    return impl
+
+
+def string_extended_attribute(name: str):
+    def impl(bag: dict[str, Any], attributes: dict[str, expr.ExtendedAttribute]):
+        return visit_string_extended_attribute(name, bag, attributes)
+
+    return impl
+
+
+ATTR_TYPE = {
+    "bool": flag_extended_attribute,
+    "str": string_extended_attribute,
+}
+
+ExtAttrsVisitor = Callable[[dict[str, Any], dict[str, expr.ExtendedAttribute]], None]
+
+
+@dataclass
+class ExtAttrsContextBuilder:
+    visitors: dict[str, ExtAttrsVisitor] = field(default_factory=dict)
+    applies_to_type: bool = False
+
+    def add_flag(self, name: str):
+        self.visitors[name] = flag_extended_attribute(name)
+
+    def add_string(self, name: str):
+        self.visitors[name] = string_extended_attribute(name)
+
+    def visit(self, bag: dict[str, Any], attributes: dict[str, expr.ExtendedAttribute]):
+        for visitor in self.visitors.values():
+            visitor(bag, attributes)
+
+    def merge(self, rhs: "ExtAttrsContextBuilder"):
+        left = copy.deepcopy(self.visitors)
+        right = copy.deepcopy(rhs.visitors)
+        left.update(right)
+        return ExtAttrsContextBuilder(
+            visitors=left,
+            applies_to_type=self.applies_to_type,
+        )
+
+
+class BuilderBuilder:
+    tgt: ExtAttrsContextBuilder
+
+    def __init__(self, applies_to_type: bool = False):
+        self.tgt = ExtAttrsContextBuilder(applies_to_type=applies_to_type)
+
+    def flag(self, name: str):
+        self.tgt.add_flag(name)
+        return self
+
+    def string(self, name: str):
+        self.tgt.add_string(name)
+        return self
+
+    def build(self):
+        return self.tgt
+
+
+@dataclass
+class ExtAttrsContextBuilders:
+    enum: ExtAttrsContextBuilder = field(default_factory=ExtAttrsContextBuilder)
+    interface: ExtAttrsContextBuilder = field(default_factory=ExtAttrsContextBuilder)
+    attribute: ExtAttrsContextBuilder = field(default_factory=ExtAttrsContextBuilder)
+    operation: ExtAttrsContextBuilder = field(default_factory=ExtAttrsContextBuilder)
+    return_type: ExtAttrsContextBuilder = field(default_factory=ExtAttrsContextBuilder)
+    argument: ExtAttrsContextBuilder = field(default_factory=ExtAttrsContextBuilder)
+    type: ExtAttrsContextBuilder = field(default_factory=ExtAttrsContextBuilder)
+
+    def from_idl(
+        self,
+        selector: Callable[["ExtAttrsContextBuilders"], ExtAttrsContextBuilder],
+        ext_attrs: list[expr.ExtendedAttribute],
+    ):
+        result: dict[str, Any] = {}
+        attributes = {attr.name: attr for attr in ext_attrs}
+        builder = selector(self)
+        builder.visit(result, attributes)
+        if builder.applies_to_type:
+            self.type.visit(result, attributes)
+        return result
+
+    def merge(self, rhs: "ExtAttrsContextBuilders"):
+        return ExtAttrsContextBuilders(
+            enum=self.enum.merge(rhs.enum),
+            interface=self.interface.merge(rhs.interface),
+            attribute=self.attribute.merge(rhs.attribute),
+            operation=self.operation.merge(rhs.operation),
+            return_type=self.return_type.merge(rhs.return_type),
+            argument=self.argument.merge(rhs.argument),
+            type=self.type.merge(rhs.type),
+        )
+
+    @staticmethod
+    def from_config(data: dict):
+        ext_attrs = cast(dict[str, dict[str, str]], data.get("ext_attrs", {}))
+        result = ExtAttrsContextBuilders()
+        targets = [
+            ("enum", result.enum),
+            ("interface", result.interface),
+            ("attribute", result.attribute),
+            ("operation", result.operation),
+            ("return_type", result.return_type),
+            ("argument", result.argument),
+        ]
+        for key, target in targets:
+            group = ext_attrs.get(key, {})
+            for name, type_name in group.items():
+                ctor = ATTR_TYPE.get(type_name)
+                if not ctor:
+                    message = f"unknown user-defined extended attribute `{type_name}' when reading {key}.{name}"
+                    raise RuntimeError(message)
+                target.visitors[name] = ctor(name)
+        return result
+
+    def property_fixup(self, type: dict[str, Any], parent: dict[str, Any]):
+        for key in self.type.visitors:
+            if key in parent:
+                value = parent[key]
+                del parent[key]
+                if isinstance(value, bool):
+                    type[key] = cast(bool, type.get(key, False)) or value
+                    continue
+
+                if isinstance(value, str):
+                    type[key] = cast(str, type.get(key, False)) or value
+                    continue
+
+    @staticmethod
+    def builtin():
+        return ExtAttrsContextBuilders(
+            attribute=BuilderBuilder().string("default").build(),
+            operation=BuilderBuilder()
+            .flag("in")
+            .flag("out")
+            .flag("mutable")
+            .flag("throws")
+            .build(),
+            argument=BuilderBuilder()
+            .flag("defaulted")
+            .string("default")
+            .flag("in")
+            .flag("out")
+            .build(),
+            type=BuilderBuilder()
+            .flag("unique")
+            .flag("span")
+            .flag("nullable")
+            .string("key")
+            .build(),
+        )

proj_flow/ext/webidl/registry.py

@@ -0,0 +1,23 @@
+# Copyright (c) 2026 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+from abc import ABC
+from typing import Any
+
+from pywebidl2 import expr
+
+from proj_flow.base.registry import Registry
+from proj_flow.ext.webidl.model.ast import MergedDefinitions
+
+
+class WebIDLVisitor(ABC):
+    def on_definitions(self, definitions: MergedDefinitions): ...
+
+
+class WebIDLCustomExtAttr(ABC):
+    def on_attribute(
+        self, name: str, ext_attrs: expr.ExtendedAttribute, result: dict[str, Any]
+    ): ...
+
+
+webidl_visitors = Registry[WebIDLVisitor]("WebIDLVisitor")

{proj_flow-0.18.0.dist-info → proj_flow-0.20.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proj-flow
-Version: 0.18.0
+Version: 0.20.0
 Summary: C++ project maintenance, automated
 Project-URL: Changelog, https://github.com/mzdun/proj-flow/blob/main/CHANGELOG.rst
 Project-URL: Documentation, https://proj-flow.readthedocs.io/en/latest/
@@ -20,6 +20,7 @@ Requires-Python: >=3.10
 Requires-Dist: argcomplete
 Requires-Dist: chevron2021
 Requires-Dist: prompt-toolkit
+Requires-Dist: pywebidl2
 Requires-Dist: pyyaml
 Requires-Dist: toml
 Description-Content-Type: text/markdown

{proj_flow-0.18.0.dist-info → proj_flow-0.20.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-proj_flow/__init__.py,sha256=NKmPob4vpoR5qg9Iu-9Lgm4XUtGqoXzml3X0ANaL0IM,277
+proj_flow/__init__.py,sha256=JbiePM36-RHE5KsHNVTeW0VHI6mPI0yAPfn8TEJwsXo,277
 proj_flow/__main__.py,sha256=HUar_qQ9Ndmchmryegtzu__5wukwCLrFN_SGRl5Ol_M,233
 proj_flow/dependency.py,sha256=CpcnR6El8AO9hlLc9lQtYQADYlkx3GMHlkLYbEAtdMI,4639
 proj_flow/api/__init__.py,sha256=gV2f6kll_5JXtvkGASvnx7CbOWr34PHOdck-4ce-qEk,378
@@ -7,7 +7,7 @@ proj_flow/api/completers.py,sha256=NapNVu6QAQ_iF6dqcAzOV5kDHKD9MAMVX209Bklq-Mw,2
 proj_flow/api/ctx.py,sha256=IJu0q0Chivo6b2M4MKkAlV09oi7Cn9VxtDFeAeL_tnc,6646
 proj_flow/api/env.py,sha256=rbNtMB6bBRhUb6bolNduWVWZ7a5CIsnv8EEZsamT9Ek,12678
 proj_flow/api/init.py,sha256=p4ZDGfq6fw4bXbJu2iq0vEmVxbS7nALIhZfe-XnEs44,565
-proj_flow/api/makefile.py,sha256=AxtGOvmypBtSvoyMEDJq1bGoaVD5yW9YYRZSdunUEeg,3856
+proj_flow/api/makefile.py,sha256=q0fBSsWTWfR5YwunwiRjWJKtiLeHdSKUgUTEgo5I7dE,3863
 proj_flow/api/release.py,sha256=IM4axJ6dfyilCmpwL_Z8q43XGKsfHaPoMAdqSziwT7s,2810
 proj_flow/api/step.py,sha256=C6LfjAN5edYjlpkhd6k9eMO9SLfLtyS2ZG1Rg_dLcjg,4926
 proj_flow/base/__cmake_version__.py,sha256=imja0GnhpBvS8Crz-64eOUKhc4i6FeRrjBGRB68x_p0,239
@@ -46,6 +46,32 @@ proj_flow/ext/python/version.py,sha256=pnyuKATyZwBh1p0gf9KmqbRSZx8hJ5285CiFK_tHE
 proj_flow/ext/sign/__init__.py,sha256=b9AN1_BalPtVy7YLBjvGhLamTujHEKcZP7npgDDDuSI,4296
 proj_flow/ext/sign/api.py,sha256=l5SO5RHiHTwxg0aexkGOfApRdojWDcIBY_cfbKSKsC0,2286
 proj_flow/ext/sign/win32.py,sha256=yMAmO-DdIWZdOi_NxycRym8XM9WIsrWKtFANdIwthJ4,4968
+proj_flow/ext/tools/__init__.py,sha256=m9iJeCkdmrqLjBWNx9hp4o1H2kgzIXpgypHiSf3SzKE,373
+proj_flow/ext/tools/pragma_once.py,sha256=BiNvX5X5pX_bGPZwBaKISlL6KkxJJGWFeZGSO-UDAgo,1218
+proj_flow/ext/tools/run_linter.py,sha256=_EdmTfITc_hwI5hgMc_mKFkbw4unnDGkWaFohs0RDr4,6145
+proj_flow/ext/webidl/__init__.py,sha256=StPcfYM0l6Q3QNoXj5DfDpes6WwvhgfNnARQlhEoZco,316
+proj_flow/ext/webidl/registry.py,sha256=x-UeflSrbUBMCH0nTSjpHisSnxZkQUNWfyXoSlDcavA,585
+proj_flow/ext/webidl/base/__init__.py,sha256=VJs_ODnF7-8DE0MbYKX-Bs-JDNqHgGdMkk2w142bcYQ,101
+proj_flow/ext/webidl/base/config.py,sha256=0r_E6NQldQJZXwL1FrU49WbIE6-y8T9O25mxv0UFgyU,13489
+proj_flow/ext/webidl/cli/__init__.py,sha256=MBNjnuj5X4X-ich2zez3aQTqvEImFwN3nFJPm6SwhdI,402
+proj_flow/ext/webidl/cli/cmake.py,sha256=ytK_eafS6lkH-6xv3LNGGCQ0TO0_hPtDiCQq4msqEP0,2446
+proj_flow/ext/webidl/cli/depfile.py,sha256=XQdPDmxFSSRtm6uUNbX8lleTPXDWbGY-0UQn9jx6Tok,2442
+proj_flow/ext/webidl/cli/gen.py,sha256=zwFVjxFudqADwSJHrjkmoFqSa5eE2-FT2fb_mqedtQM,5468
+proj_flow/ext/webidl/cli/init.py,sha256=zYd1ElULZt_5nJEhvXAKQLQgRCQFSTk8RCKOHCLz1_U,841
+proj_flow/ext/webidl/cli/root.py,sha256=wPznV0XU0UQ2dXrbfP7t5_6v4Uam1R3S0f0xESj_Zns,300
+proj_flow/ext/webidl/cli/updater.py,sha256=usRfIsKkjN4x1FvYMna0EcdJuJha2lkBxQsCR7dF0NU,541
+proj_flow/ext/webidl/data/init/flow_webidl.cmake,sha256=EBqToWUDex1HIcwFKyEo4AkGWORtRUGJd0Z2APIrcN8,876
+proj_flow/ext/webidl/data/templates/cmake.mustache,sha256=tmi7AnnmosDmrPqgL52shkcRCIbs2Ze1fi9NZ8D9NpQ,1205
+proj_flow/ext/webidl/data/templates/depfile.mustache,sha256=rdynmTyn1HhIZCZ9LYfnbkOCJNASeZHlKFfrU4BuaTY,108
+proj_flow/ext/webidl/data/templates/partials/cxx/attribute-decl.mustache,sha256=lbH_9vRK9FuHSx25ScC9F3n11SEGHLwzkKaZpaijNnM,120
+proj_flow/ext/webidl/data/templates/partials/cxx/in-out.mustache,sha256=92Zf2jVQ5LhYRCTt-zpQ9F_cPrrWCnBtIOczj8ZUxAs,120
+proj_flow/ext/webidl/data/templates/partials/cxx/includes.mustache,sha256=FNQ6JRifRJQlpHdQX6NTpI_XTIvtNRLusVlimz18jl0,129
+proj_flow/ext/webidl/data/templates/partials/cxx/operation-decl.mustache,sha256=-g46nh8AGfJwDDl3z0vSvsKmkz8-zbAZy8--jp4K_X4,588
+proj_flow/ext/webidl/data/templates/partials/cxx/type.mustache,sha256=Oc6Dds-Waybwp_uch7Xk373I6VSdBClYfP5Pj4yRHBU,250
+proj_flow/ext/webidl/data/types/cxx.json,sha256=f31q4U2hQIf4RwZylRK__MZroRQKbbQDjud2rwMf2eM,1545
+proj_flow/ext/webidl/model/__init__.py,sha256=VJs_ODnF7-8DE0MbYKX-Bs-JDNqHgGdMkk2w142bcYQ,101
+proj_flow/ext/webidl/model/ast.py,sha256=_CzJPAarYruonVbK6mxfUc7MgFoxFDpXWjX4OEkOp3M,19238
+proj_flow/ext/webidl/model/builders.py,sha256=7MpSJm9NflY1rDbK8msWuKkq3X5jWzUEFCHytOZeKCY,7534
 proj_flow/flow/__init__.py,sha256=5Zo97zJsR7HMbl64jeMB9PbUuxCxpOlNuLmo3apWSVU,277
 proj_flow/flow/configs.py,sha256=PQZ5pLPmWwHJtSWmuy04bsnO-VvfWcJyP_UyKjiaG1g,6535
 proj_flow/flow/layer.py,sha256=IUANtCSOvlfzNSnq0VDdGdaXfB70Yr-rDGFxPDQTmpg,6187
@@ -134,8 +160,8 @@ proj_flow/template/licenses/MIT.mustache,sha256=NncPoQaNsuy-WmRmboik3fyhJJ8m5pc2
 proj_flow/template/licenses/Unlicense.mustache,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
 proj_flow/template/licenses/WTFPL.mustache,sha256=lvF4V_PrKKfZPa2TC8CZo8tlqaKvs3Bpv9G6XsWWQ4k,483
 proj_flow/template/licenses/Zlib.mustache,sha256=uIj-mhSjes2HJ3rRapyy2ALflKRz4xQgS4mVM9827C0,868
-proj_flow-0.18.0.dist-info/METADATA,sha256=RtXLpv1l2n0-RHGb0o9QHJpG0TFYfo5htPhxYUYNTVE,2980
-proj_flow-0.18.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-proj_flow-0.18.0.dist-info/entry_points.txt,sha256=d_OmGKZzpY7FCWz0sZ4wnBAPZC75oMEzTgJZWtpDELo,49
-proj_flow-0.18.0.dist-info/licenses/LICENSE,sha256=vpOQJ5QlrTedF3coEWvA4wJzVJH304f66ZitR7Od4iU,1068
-proj_flow-0.18.0.dist-info/RECORD,,
+proj_flow-0.20.0.dist-info/METADATA,sha256=1LA8i5cUZclr3qRQEW9fo7XDmBB0_wgSiVJ39Vyn5BI,3005
+proj_flow-0.20.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+proj_flow-0.20.0.dist-info/entry_points.txt,sha256=d_OmGKZzpY7FCWz0sZ4wnBAPZC75oMEzTgJZWtpDELo,49
+proj_flow-0.20.0.dist-info/licenses/LICENSE,sha256=vpOQJ5QlrTedF3coEWvA4wJzVJH304f66ZitR7Od4iU,1068
+proj_flow-0.20.0.dist-info/RECORD,,