resforge 0.3.0__tar.gz → 0.4.0__tar.gz

{resforge-0.3.0 → resforge-0.4.0}/.github/workflows/ci.yml

@@ -16,35 +16,33 @@ jobs:
     steps:
       - uses: actions/checkout@v5
 
-      - name: Set up Python ${{ matrix.python-version }}
+      - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-          cache: "pip"
 
-      - name: Install dependencies
-        run: |
-          pip install -e ".[dev]"
+      - name: Install Hatch
+        run: pip install hatch
 
       - name: Run tests
-        run: pytest tests/ -v
+        run: hatch run pytest
 
-  lint-package:
+  lint-and-check:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
 
       - name: Set up Python
         uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-          cache: "pip"
 
-      - name: Install build tools
-        run: pip install build twine
+      - name: Install Hatch
+        run: pip install hatch
+
+      - name: Lint
+        run: hatch run ruff check .
 
-      - name: Build distribution
-        run: python -m build
+      - name: Type check
+        run: hatch run basedpyright
 
-      - name: Verify package metadata
-        run: twine check dist/*
+      - name: Verify Build Metadata
+        run: hatch build

{resforge-0.3.0 → resforge-0.4.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Ondrej Kipila
+Copyright (c) 2026 Kipila Ltd
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{resforge-0.3.0 → resforge-0.4.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: resforge
-Version: 0.3.0
+Version: 0.4.0
 Summary: A type-safe Python DSL for cross-platform mobile resource generation
 Project-URL: Homepage, https://kipila.dev
-Project-URL: Repository, https://github.com/ok100/resforge
-Author-email: Ondrej Kipila <ondrej@kipila.dev>
+Project-URL: Repository, https://github.com/kipila-dev/resforge
+Author-email: Kipila Ltd <hello@kipila.dev>
 License: MIT
 License-File: LICENSE
 Keywords: android-xml,automation,code-generation,design-tokens,dsl,mobile-infra,type-safety,white-label,xcassets
@@ -16,21 +16,21 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Build Tools
 Requires-Python: >=3.12
-Provides-Extra: dev
-Requires-Dist: defusedxml; extra == 'dev'
-Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: coloraide
 Description-Content-Type: text/markdown
 
 # resforge
 
-A type-safe Python DSL for generating native Android and iOS resources from design tokens.
+A type-safe Python DSL for generating native Android and iOS resources from
+design tokens.
 
 ## Features
 
 - Fluent, Pythonic API
-- Jetpack Compose theme generation with type-safe color and dimension properties
+- Jetpack Compose theme generation for colors and dimensions
 - Supports all Android `res/values/` types
-- Native Apple Asset Catalog (`.xcassets`) with dark mode support
+- Native Apple Asset Catalog (`.xcassets`) support
+- Wide Gamut support with automatic sRGB fallbacks
 - Built-in validation for resource names and color formats
 
 ## Installation
@@ -44,27 +44,30 @@ pip install resforge
 ### Android (Jetpack Compose)
 
 ```python
-from resforge.android import ComposeWriter, dp
-
-with ComposeWriter("Theme.kt", "dev.kipila.example") as compose:
-    compose.dimension(border=dp(8))
-    with compose.object_("AppColors") as colors:
-        colors.color(primary="#FF0000", background="#FFFFFF")
+from resforge.android import ComposeWriter
+
+with ComposeWriter("Color.kt", "com.example.myapplication.ui.theme") as compose:
+    compose.color(
+        Purple80="#D0BCFF",
+        PurpleGrey80="#CCC2DC",
+        Pink80="#EFB8C8",
+        Purple40="#6650a4",
+        PurpleGrey40="#625b71",
+        Pink40="#7D5260",
+    )
 ```
 
 ```kotlin
-package dev.kipila.example
+package com.example.myapplication.ui.theme
 
 import androidx.compose.ui.graphics.Color
-import androidx.compose.ui.unit.Dp
-import androidx.compose.ui.unit.dp
-
-val border: Dp = 8.dp
 
-object AppColors {
-    val primary: Color = Color(0xFFFF0000)
-    val background: Color = Color(0xFFFFFFFF)
-}
+val Purple80: Color = Color(0xFFD0BCFF)
+val PurpleGrey80: Color = Color(0xFFCCC2DC)
+val Pink80: Color = Color(0xFFEFB8C8)
+val Purple40: Color = Color(0xFF6650A4)
+val PurpleGrey40: Color = Color(0xFF625B71)
+val Pink40: Color = Color(0xFF7D5260)
 ```
 
 ### Android (XML Resources)
@@ -77,12 +80,10 @@ with ValuesWriter("res/values/resources.xml") as res:
         app_name="My App",
         welcome_message="Welcome!",
     )
-
     res.color(
-        primary="#FF6200EE",
-        secondary="#FF03DAC5",
+        primary="#6200EE",
+        secondary="#03DAC5",
     )
-
     res.dimension(
         padding_small=dp(8),
         text_body=sp(16),
@@ -90,13 +91,12 @@ with ValuesWriter("res/values/resources.xml") as res:
 ```
 
 ```xml
+<?xml version='1.0' encoding='utf-8'?>
 <resources>
     <string name="app_name">My App</string>
     <string name="welcome_message">Welcome!</string>
-
     <color name="primary">#FF6200EE</color>
-    <color name="secondary">#FF03DAC5</color>
-
+    <color name="secondary">#FF00FF00</color>
     <dimen name="padding_small">8dp</dimen>
     <dimen name="text_body">16sp</dimen>
 </resources>
@@ -105,15 +105,15 @@ with ValuesWriter("res/values/resources.xml") as res:
 ### Asset Catalog (iOS)
 
 ```python
+from resforge import Color
 from resforge.apple import Appearance, AppleColor, AssetCatalog
 
-with AssetCatalog("App", "Assets") as ac:
-    ac.colorset(
-        "Background",
-        "#ffffff",
+with AssetCatalog("App", "Assets") as catalog:
+    catalog.colorset(
+        "MyColor",
+        AppleColor(Color.p3(0.0, 1.0, 0.0)),
         AppleColor("#000000", appearances=[Appearance.Dark]),
     )
-
 ```
 
 ```json
@@ -127,14 +127,27 @@ with AssetCatalog("App", "Assets") as ac:
       "idiom": "universal",
       "color": {
         "components": {
-          "red": "1.000",
+          "red": "0.000",
           "green": "1.000",
-          "blue": "1.000",
+          "blue": "0.000",
           "alpha": "1.000"
         },
         "color-space": "srgb"
       }
     },
+    {
+      "idiom": "universal",
+      "color": {
+        "components": {
+          "red": "0.000",
+          "green": "1.000",
+          "blue": "0.000",
+          "alpha": "1.000"
+        },
+        "color-space": "display-p3"
+      },
+      "display-gamut": "display-P3"
+    },
     {
       "idiom": "universal",
       "color": {
@@ -159,9 +172,9 @@ with AssetCatalog("App", "Assets") as ac:
 
 ## Roadmap
 
-- SwiftUI color extension generation (`SwiftUIWriter`)
-- Asset Catalog image support (ImageSet, IconSet)
-- Android `res/drawable` vector asset support
+- SwiftUI dimensions
+- Typography
+- Images (ImageSet, IconSet, `res/drawable` vectors)
 
 ## License
 

{resforge-0.3.0 → resforge-0.4.0}/README.md

@@ -1,13 +1,15 @@
 # resforge
 
-A type-safe Python DSL for generating native Android and iOS resources from design tokens.
+A type-safe Python DSL for generating native Android and iOS resources from
+design tokens.
 
 ## Features
 
 - Fluent, Pythonic API
-- Jetpack Compose theme generation with type-safe color and dimension properties
+- Jetpack Compose theme generation for colors and dimensions
 - Supports all Android `res/values/` types
-- Native Apple Asset Catalog (`.xcassets`) with dark mode support
+- Native Apple Asset Catalog (`.xcassets`) support
+- Wide Gamut support with automatic sRGB fallbacks
 - Built-in validation for resource names and color formats
 
 ## Installation
@@ -21,27 +23,30 @@ pip install resforge
 ### Android (Jetpack Compose)
 
 ```python
-from resforge.android import ComposeWriter, dp
-
-with ComposeWriter("Theme.kt", "dev.kipila.example") as compose:
-    compose.dimension(border=dp(8))
-    with compose.object_("AppColors") as colors:
-        colors.color(primary="#FF0000", background="#FFFFFF")
+from resforge.android import ComposeWriter
+
+with ComposeWriter("Color.kt", "com.example.myapplication.ui.theme") as compose:
+    compose.color(
+        Purple80="#D0BCFF",
+        PurpleGrey80="#CCC2DC",
+        Pink80="#EFB8C8",
+        Purple40="#6650a4",
+        PurpleGrey40="#625b71",
+        Pink40="#7D5260",
+    )
 ```
 
 ```kotlin
-package dev.kipila.example
+package com.example.myapplication.ui.theme
 
 import androidx.compose.ui.graphics.Color
-import androidx.compose.ui.unit.Dp
-import androidx.compose.ui.unit.dp
-
-val border: Dp = 8.dp
 
-object AppColors {
-    val primary: Color = Color(0xFFFF0000)
-    val background: Color = Color(0xFFFFFFFF)
-}
+val Purple80: Color = Color(0xFFD0BCFF)
+val PurpleGrey80: Color = Color(0xFFCCC2DC)
+val Pink80: Color = Color(0xFFEFB8C8)
+val Purple40: Color = Color(0xFF6650A4)
+val PurpleGrey40: Color = Color(0xFF625B71)
+val Pink40: Color = Color(0xFF7D5260)
 ```
 
 ### Android (XML Resources)
@@ -54,12 +59,10 @@ with ValuesWriter("res/values/resources.xml") as res:
         app_name="My App",
         welcome_message="Welcome!",
     )
-
     res.color(
-        primary="#FF6200EE",
-        secondary="#FF03DAC5",
+        primary="#6200EE",
+        secondary="#03DAC5",
     )
-
     res.dimension(
         padding_small=dp(8),
         text_body=sp(16),
@@ -67,13 +70,12 @@ with ValuesWriter("res/values/resources.xml") as res:
 ```
 
 ```xml
+<?xml version='1.0' encoding='utf-8'?>
 <resources>
     <string name="app_name">My App</string>
     <string name="welcome_message">Welcome!</string>
-
     <color name="primary">#FF6200EE</color>
-    <color name="secondary">#FF03DAC5</color>
-
+    <color name="secondary">#FF00FF00</color>
     <dimen name="padding_small">8dp</dimen>
     <dimen name="text_body">16sp</dimen>
 </resources>
@@ -82,15 +84,15 @@ with ValuesWriter("res/values/resources.xml") as res:
 ### Asset Catalog (iOS)
 
 ```python
+from resforge import Color
 from resforge.apple import Appearance, AppleColor, AssetCatalog
 
-with AssetCatalog("App", "Assets") as ac:
-    ac.colorset(
-        "Background",
-        "#ffffff",
+with AssetCatalog("App", "Assets") as catalog:
+    catalog.colorset(
+        "MyColor",
+        AppleColor(Color.p3(0.0, 1.0, 0.0)),
         AppleColor("#000000", appearances=[Appearance.Dark]),
     )
-
 ```
 
 ```json
@@ -104,14 +106,27 @@ with AssetCatalog("App", "Assets") as ac:
       "idiom": "universal",
       "color": {
         "components": {
-          "red": "1.000",
+          "red": "0.000",
           "green": "1.000",
-          "blue": "1.000",
+          "blue": "0.000",
           "alpha": "1.000"
         },
         "color-space": "srgb"
       }
     },
+    {
+      "idiom": "universal",
+      "color": {
+        "components": {
+          "red": "0.000",
+          "green": "1.000",
+          "blue": "0.000",
+          "alpha": "1.000"
+        },
+        "color-space": "display-p3"
+      },
+      "display-gamut": "display-P3"
+    },
     {
       "idiom": "universal",
       "color": {
@@ -136,9 +151,9 @@ with AssetCatalog("App", "Assets") as ac:
 
 ## Roadmap
 
-- SwiftUI color extension generation (`SwiftUIWriter`)
-- Asset Catalog image support (ImageSet, IconSet)
-- Android `res/drawable` vector asset support
+- SwiftUI dimensions
+- Typography
+- Images (ImageSet, IconSet, `res/drawable` vectors)
 
 ## License
 

{resforge-0.3.0 → resforge-0.4.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "resforge"
-version = "0.3.0"
+dynamic = ["version"]
 description = "A type-safe Python DSL for cross-platform mobile resource generation"
 readme = "README.md"
 requires-python = ">=3.12"
 license = { text = "MIT" }
-authors = [{ name = "Ondrej Kipila", email = "ondrej@kipila.dev" }]
+authors = [{ name = "Kipila Ltd", email = "hello@kipila.dev" }]
 keywords = [
   "dsl",
   "design-tokens",
@@ -30,60 +30,42 @@ classifiers = [
   "Intended Audience :: Developers",
   "Topic :: Software Development :: Build Tools",
 ]
-
-[project.optional-dependencies]
-dev = ["pytest", "defusedxml"]
+dependencies = ["coloraide"]
 
 [project.urls]
 Homepage = "https://kipila.dev"
-Repository = "https://github.com/ok100/resforge"
+Repository = "https://github.com/kipila-dev/resforge"
+
+[tool.hatch.version]
+path = "src/resforge/__init__.py"
+
+[tool.hatch.envs.default]
+dependencies = ["basedpyright", "defusedxml", "pytest", "ruff"]
 
 [tool.ruff]
 target-version = "py312"
-line-length = 120
 
 [tool.ruff.lint]
 select = ["ALL"]
-ignore = [
+ignore = ["D100", "D104", "D105", "ANN401", "PLR2004", "E741"]
+
+[tool.ruff.lint.extend-per-file-ignores]
+"tests/**/*.py" = [
   "ANN001",
-  "ANN002",
-  "ANN003",
-  "COM812",
-  "COM819",
-  "D100",
+  "ANN201",
+  "D101",
   "D102",
-  "D104",
-  "D105",
-  "D107",
-  "D206",
-  "D300",
-  "D401",
-  "E111",
-  "E114",
-  "E117",
-  "FIX",
-  "I001",
-  "PLR2004",
-  "Q000",
-  "Q001",
-  "Q002",
-  "Q003",
-  "TD",
-  "W191",
+  "D103",
+  "EM101",
+  "S101",
+  "TRY301",
 ]
-fixable = ["ALL"]
 
-[tool.ruff.lint.per-file-ignores]
-"tests/**/*.py" = [
-   "ANN201",
-   "D101",
-   "D103",
-   "EM101",
-   "S101",
-   "TRY301",
-]
+[tool.ruff.lint.pydocstyle]
+convention = "google"
 
 [tool.basedpyright]
-venvPath = "."
-venv = ".venv"
-typeCheckingMode = "standard"
+include = ["src"]
+typeCheckingMode = "recommended"
+pythonVersion = "3.12"
+reportUnusedCallResult = "none"

resforge-0.4.0/src/resforge/__init__.py

@@ -0,0 +1,4 @@
+from .color import Color
+
+__all__ = ["Color"]
+__version__ = "0.4.0"

{resforge-0.3.0/resforge/codegen → resforge-0.4.0/src/resforge/_codegen}/kotlin.py

@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Literal, Self
+from typing import IO, Literal, Self, final
 
 PropertyMutability = Literal["val", "var"]
 
@@ -18,6 +18,7 @@ class KotlinProperty:
         return f"{self.mutability} {self.name}: {self.type_} = {self.value}"
 
 
+@final
 class KotlinObject:
     """A Kotlin object declaration."""
 
@@ -33,7 +34,7 @@ class KotlinObject:
         mutability: PropertyMutability = "val",
     ) -> Self:
         self._properties.append(
-            KotlinProperty(name=name, type_=type_, value=value, mutability=mutability)
+            KotlinProperty(name=name, type_=type_, value=value, mutability=mutability),
         )
         return self
 
@@ -47,6 +48,7 @@ class KotlinObject:
         return "\n".join(lines)
 
 
+@final
 class KotlinFile:
     """A Kotlin file declaration."""
 
@@ -60,7 +62,11 @@ class KotlinFile:
         return self
 
     def property(
-        self, name: str, type_: str, value: str, mutability: PropertyMutability = "val"
+        self,
+        name: str,
+        type_: str,
+        value: str,
+        mutability: PropertyMutability = "val",
     ) -> Self:
         self._members.append(KotlinProperty(name, type_, value, mutability))
         return self
@@ -75,7 +81,7 @@ class KotlinFile:
         if self._imports:
             sections.append("\n".join(f"import {fqn}" for fqn in sorted(self._imports)))
 
-        current_props = []
+        current_props: list[str] = []
         for member in self._members:
             if isinstance(member, KotlinProperty):
                 current_props.append(member.render())
@@ -90,8 +96,11 @@ class KotlinFile:
 
         return "\n\n".join(sections) + "\n"
 
-    def write(self, path: str | Path) -> None:
-        path = Path(path)
-        path.parent.mkdir(parents=True, exist_ok=True)
-        with path.open("w") as f:
-            f.write(self.render())
+    def write(self, dest: str | Path | IO[bytes]) -> None:
+        if isinstance(dest, (str, Path)):
+            path = Path(dest)
+            path.parent.mkdir(parents=True, exist_ok=True)
+            with path.open("wb") as f:
+                f.write(self.render().encode())
+        else:
+            dest.write(self.render().encode())

resforge-0.4.0/src/resforge/_utils.py

@@ -0,0 +1,82 @@
+import os
+import shutil
+from collections.abc import Callable, Generator
+from contextlib import contextmanager, suppress
+from functools import wraps
+from pathlib import Path
+from tempfile import NamedTemporaryFile
+from typing import IO, Concatenate, Protocol, runtime_checkable
+
+__all__ = ["atomic_write", "require_context"]
+
+
+@runtime_checkable
+class _HasActiveContext(Protocol):
+    _active: bool
+
+
+def require_context[T: _HasActiveContext, **P, R](
+    func: Callable[Concatenate[T, P], R],
+) -> Callable[Concatenate[T, P], R]:
+    """Ensures a method is only called within an active context.
+
+    Raises:
+        RuntimeError: If the method is called while the instance's
+            `_active` attribute is False.
+
+    """
+
+    @wraps(func)
+    def wrapper(self: T, *args: P.args, **kwargs: P.kwargs) -> R:
+        if not self._active:  # pyright: ignore[reportPrivateUsage]
+            msg = f"'{func.__name__}' requires an active 'with' context."
+            raise RuntimeError(msg)
+        return func(self, *args, **kwargs)
+
+    return wrapper
+
+
+@contextmanager
+def atomic_write(target_path: Path) -> Generator[IO[bytes], None, None]:
+    """Yields a temporary file, then atomically replaces target_path on success.
+
+    Preserves file permissions of target_path, if target_path already exists.
+    """
+    target_path = Path(target_path)
+    target_path.parent.mkdir(parents=True, exist_ok=True)
+
+    temp_path = None
+    try:
+        with NamedTemporaryFile(
+            dir=target_path.parent,
+            delete=False,
+            suffix=".tmp",
+        ) as tf:
+            temp_path = Path(tf.name)
+            yield tf
+
+            tf.flush()
+            os.fsync(tf.fileno())
+
+        try:
+            shutil.copymode(target_path, temp_path)
+        except OSError:
+            mask = os.umask(0)
+            os.umask(mask)
+            temp_path.chmod(0o666 & ~mask)
+
+        temp_path.replace(target_path)
+
+        if os.name == "posix":
+            flags = os.O_RDONLY
+            if hasattr(os, "O_DIRECTORY"):
+                flags |= os.O_DIRECTORY
+            dir_fd = os.open(target_path.parent, flags)
+            try:
+                os.fsync(dir_fd)
+            finally:
+                os.close(dir_fd)
+    finally:
+        if temp_path and temp_path.exists():
+            with suppress(OSError):
+                temp_path.unlink()

{resforge-0.3.0 → resforge-0.4.0/src}/resforge/android/__init__.py

@@ -1,5 +1,5 @@
 from .compose import ComposeWriter
-from .types import Dimension, PluralValues, dp, inch, mm, pt, px, sp
+from .types import Dimension, PluralValues, dp, em, inch, mm, pt, px, sp
 from .values import ValuesWriter
 
 __all__ = [
@@ -8,6 +8,7 @@ __all__ = [
     "PluralValues",
     "ValuesWriter",
     "dp",
+    "em",
     "inch",
     "mm",
     "pt",