resforge 0.4.2__tar.gz → 0.4.3__tar.gz

{resforge-0.4.2 → resforge-0.4.3}/.gitignore

@@ -27,8 +27,8 @@ share/python-wheels/
 MANIFEST
 
 # PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
 *.manifest
 *.spec
 
@@ -92,34 +92,34 @@ ipython_config.py
 #   However, in case of collaboration, if having platform-specific dependencies or dependencies
 #   having no cross-platform support, pipenv may install dependencies that don't work, or not
 #   install all needed dependencies.
-#Pipfile.lock
+# Pipfile.lock
 
 # UV
 #   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
 #   commonly ignored for libraries.
-#uv.lock
+# uv.lock
 
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
 #   commonly ignored for libraries.
 #   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
-#poetry.lock
-#poetry.toml
+# poetry.lock
+# poetry.toml
 
 # pdm
 #   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
 #   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
 #   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
-#pdm.lock
-#pdm.toml
+# pdm.lock
+# pdm.toml
 .pdm-python
 .pdm-build/
 
 # pixi
 #   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
-#pixi.lock
+# pixi.lock
 #   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
 #   in the .venv directory. It is recommended not to include this directory in version control.
 .pixi
@@ -131,6 +131,19 @@ __pypackages__/
 celerybeat-schedule
 celerybeat.pid
 
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
 # SageMath parsed files
 *.sage.py
 
@@ -169,24 +182,26 @@ dmypy.json
 cython_debug/
 
 # PyCharm
-#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
-#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
-#  and can be added to the global gitignore or merged into this file.  For a more nuclear
-#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
 
 # Abstra
-# Abstra is an AI-powered process automation framework.
-# Ignore directories containing user credentials, local state, and settings.
-# Learn more at https://abstra.io/docs
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
 .abstra/
 
 # Visual Studio Code
-#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
-#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
-#  you could uncomment the following to ignore the entire vscode folder
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
 # .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
 
 # Ruff stuff:
 .ruff_cache/
@@ -194,17 +209,16 @@ cython_debug/
 # PyPI configuration file
 .pypirc
 
-# Cursor
-#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
-#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
-#  refer to https://docs.cursor.com/context/ignore-files
-.cursorignore
-.cursorindexingignore
-
 # Marimo
 marimo/_static/
 marimo/_lsp/
 __marimo__/
 
-pyrightconfig.json
+# Streamlit
+.streamlit/secrets.toml
+
+# Forje build files
+*.forje
+
+# macOS
 .DS_Store

{resforge-0.4.2 → resforge-0.4.3}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: resforge
-Version: 0.4.2
+Version: 0.4.3
 Summary: A type-safe Python DSL for cross-platform mobile resource generation
 Project-URL: Homepage, https://kipila.dev
-Project-URL: Repository, https://github.com/kipila-dev/resforge
+Project-URL: Repository, https://github.com/kipila-dev/forje
 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
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -35,7 +34,7 @@ design tokens.
 
 ## Installation
 
-```bash
+```sh
 pip install resforge
 ```
 
@@ -79,12 +78,10 @@ with ValuesWriter("res/values/resources.xml") as res:
     res.string(
         app_name="My App",
         welcome_message="Welcome!",
-    )
-    res.color(
+    ).color(
         primary="#6200EE",
         secondary="#03DAC5",
-    )
-    res.dimension(
+    ).dimension(
         padding_small=dp(8),
         text_body=sp(16),
     )

{resforge-0.4.2 → resforge-0.4.3}/README.md

@@ -14,7 +14,7 @@ design tokens.
 
 ## Installation
 
-```bash
+```sh
 pip install resforge
 ```
 
@@ -58,12 +58,10 @@ with ValuesWriter("res/values/resources.xml") as res:
     res.string(
         app_name="My App",
         welcome_message="Welcome!",
-    )
-    res.color(
+    ).color(
         primary="#6200EE",
         secondary="#03DAC5",
-    )
-    res.dimension(
+    ).dimension(
         padding_small=dp(8),
         text_body=sp(16),
     )

{resforge-0.4.2 → resforge-0.4.3}/pyproject.toml

@@ -34,38 +34,10 @@ dependencies = ["coloraide"]
 
 [project.urls]
 Homepage = "https://kipila.dev"
-Repository = "https://github.com/kipila-dev/resforge"
+Repository = "https://github.com/kipila-dev/forje"
+
+[dependency-groups]
+dev = ["defusedxml"]
 
 [tool.hatch.version]
 path = "src/resforge/__init__.py"
-
-[tool.hatch.envs.default]
-dependencies = ["basedpyright", "defusedxml", "pytest", "ruff"]
-
-[tool.ruff]
-target-version = "py312"
-
-[tool.ruff.lint]
-select = ["ALL"]
-ignore = ["D100", "D104", "D105", "D107", "ANN401", "PLR2004", "E741"]
-
-[tool.ruff.lint.extend-per-file-ignores]
-"tests/**/*.py" = [
-  "ANN001",
-  "ANN201",
-  "D101",
-  "D102",
-  "D103",
-  "EM101",
-  "S101",
-  "TRY301",
-]
-
-[tool.ruff.lint.pydocstyle]
-convention = "google"
-
-[tool.basedpyright]
-include = ["src"]
-typeCheckingMode = "recommended"
-pythonVersion = "3.12"
-reportUnusedCallResult = "none"

{resforge-0.4.2 → resforge-0.4.3}/src/resforge/__init__.py

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

{resforge-0.4.2 → resforge-0.4.3}/src/resforge/android/compose.py

@@ -40,7 +40,7 @@ class _BaseComposeScope:
 
     def _to_compose_color_literal(self, color: Color) -> str:
         if color.in_srgb_gamut():
-            return f"Color({color.to_srgb_argb_hex(prefix="0x")})"
+            return f"Color({color.to_srgb_argb_hex(prefix='0x')})"
 
         self._ctx.add_imports("androidx.compose.ui.graphics.colorspace.ColorSpaces")
         r, g, b, a = color.to_p3_components()
@@ -100,16 +100,16 @@ class _ObjectScope(_BaseComposeScope):
 
 @final
 class ComposeWriter(_BaseComposeScope):
-    """A fluent context manager for generating Jetpack Compose color definitions.
+    """A context manager for generating Jetpack Compose color definitions.
 
     Writes a Kotlin file containing typed Color or Dimension properties.
 
     Example:
         >>> with ComposeWriter(
-                "ui/theme/Color.kt",
-                package="com.example.theme",
-                object_name="AppColors"
-            ) as compose:
+        ...     "ui/theme/Color.kt",
+        ...     package="com.example.theme",
+        ...     object_name="AppColors",
+        ... ) as compose:
         ...     compose.color(primary="#6200EE", background="#FFFFFF")
     """
 
@@ -117,6 +117,7 @@ class ComposeWriter(_BaseComposeScope):
         self,
         path: str | Path,
         package: str,
+        *,
         sink: WriteSink | None = None,
     ) -> None:
         """Initializes the ComposeWriter.

{resforge-0.4.2 → resforge-0.4.3}/src/resforge/android/values.py

@@ -19,7 +19,7 @@ _STYLE_NAME_PATTERN = re.compile(r"^[a-zA-Z_][a-zA-Z0-9_\.]*$")
 
 @final
 class ValuesWriter:
-    """A fluent context manager for generating Android XML resource files.
+    """A context manager for generating Android XML resource files.
 
     Provides a type-safe interface for creating strings, dimensions, colors,
     and arrays. Validates resource names and color formats at runtime.
@@ -30,7 +30,7 @@ class ValuesWriter:
 
     """
 
-    def __init__(self, path: str | Path, sink: WriteSink | None = None) -> None:
+    def __init__(self, path: str | Path, *, sink: WriteSink | None = None) -> None:
         """Initializes the ValuesWriter.
 
         Args:
@@ -153,8 +153,8 @@ class ValuesWriter:
 
         """
         for name, color in values.items():
-            resolved = Color.parse(color)
-            self._append("color", name, resolved.to_srgb_argb_hex())
+            parsed_color = Color.parse(color)
+            self._append("color", name, parsed_color.to_srgb_argb_hex())
         return self
 
     @require_context

{resforge-0.4.2 → resforge-0.4.3}/src/resforge/apple/catalog.py

@@ -15,7 +15,7 @@ __all__ = ["AssetCatalog"]
 
 @final
 class AssetCatalog:
-    """A fluent context manager for generating Apple Asset Catalogs (.xcassets).
+    """A context manager for generating Apple Asset Catalogs (.xcassets).
 
     To ensure atomic writes, it works in a temporary directory and only swaps
     to the final destination upon successful completion of the context.
@@ -29,6 +29,7 @@ class AssetCatalog:
         self,
         path: str | Path,
         name: str,
+        *,
         sink: WriteSink | None = None,
     ) -> None:
         """Initializes the AssetCatalog.

{resforge-0.4.2 → resforge-0.4.3}/src/resforge/color.py

@@ -110,6 +110,20 @@ class Color:
             round(self.alpha, 3) + 0.0,
         )
 
+    def to_oklch_components(self) -> tuple[float, float, float, float]:
+        """Convert the color to Oklch components (L, C, H, A).
+
+        Colors outside Oklch gamut are automatically clipped to the nearest
+        valid boundary.
+        """
+        oklch = self._to_coloraide().convert("oklch").clip()
+        return (
+            round(oklch["lightness"], 3) + 0.0,
+            round(oklch["chroma"], 3) + 0.0,
+            round(oklch["hue"], 3) + 0.0,
+            round(self.alpha, 3) + 0.0,
+        )
+
     def to_srgb_argb_hex(self, prefix: str = "#") -> str:
         """Convert the color to an ARGB hexadecimal string.
 

{resforge-0.4.2 → resforge-0.4.3}/src/resforge/io.py

@@ -13,7 +13,7 @@ __all__ = ["FileSystemSink", "MemorySink", "WriteSink", "atomic_write"]
 def atomic_write(target_path: str | 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.
+    Preserves file permissions if `target_path` already exists.
     """
     target_path = Path(target_path)
     target_path.parent.mkdir(parents=True, exist_ok=True)

{resforge-0.4.2 → resforge-0.4.3}/tests/test_android_compose.py

@@ -1,9 +1,10 @@
-import pytest
+from pathlib import Path
 
+import pytest
 from resforge.android import ComposeWriter, Dimension, dp, sp
 
 
-def test_object_colors(tmp_path):
+def test_object_colors(tmp_path: Path):
     output = tmp_path / "AppColors.kt"
     with (
         ComposeWriter(output, package="com.example.theme") as compose,
@@ -23,7 +24,7 @@ def test_object_colors(tmp_path):
     )
 
 
-def test_top_level_dimension(tmp_path):
+def test_top_level_dimension(tmp_path: Path):
     output = tmp_path / "Dimens.kt"
     with ComposeWriter(output, package="com.example.theme") as compose:
         compose.dimension(paddingSmall=dp(8), textBody=sp(16))
@@ -41,7 +42,7 @@ def test_top_level_dimension(tmp_path):
     )
 
 
-def test_mixed_top_level_and_object(tmp_path):
+def test_mixed_top_level_and_object(tmp_path: Path):
     output = tmp_path / "Theme.kt"
     with ComposeWriter(output, package="com.example.theme") as compose:
         compose.dimension(border=dp(8))
@@ -64,7 +65,7 @@ def test_mixed_top_level_and_object(tmp_path):
     )
 
 
-def test_multiple_objects(tmp_path):
+def test_multiple_objects(tmp_path: Path):
     output = tmp_path / "Theme.kt"
     with ComposeWriter(output, package="com.example.theme") as compose:
         with compose.object_("AppColors") as colors:
@@ -78,7 +79,7 @@ def test_multiple_objects(tmp_path):
     assert rendered.index("AppColors") < rendered.index("AppDimens")
 
 
-def test_object_require_context_raises(tmp_path):
+def test_object_require_context_raises(tmp_path: Path):
     output = tmp_path / "Color.kt"
     with ComposeWriter(output, package="com.example.theme") as compose:
         scope = compose.object_("AppColors")
@@ -87,7 +88,7 @@ def test_object_require_context_raises(tmp_path):
         scope.color(primary="#6200EE")
 
 
-def test_no_write_on_exception(tmp_path):
+def test_no_write_on_exception(tmp_path: Path):
     output = tmp_path / "Color.kt"
     with (
         pytest.raises(RuntimeError),
@@ -104,7 +105,7 @@ def test_require_context_raises():
         compose.color(primary="#6200EE")
 
 
-def test_creates_parent_directories(tmp_path):
+def test_creates_parent_directories(tmp_path: Path):
     output = tmp_path / "ui" / "theme" / "Color.kt"
     with ComposeWriter(output, package="com.example.theme") as compose:
         compose.color(primary="#6200EE")
@@ -112,7 +113,7 @@ def test_creates_parent_directories(tmp_path):
     assert output.exists()
 
 
-def test_package_is_configurable(tmp_path):
+def test_package_is_configurable(tmp_path: Path):
     output = tmp_path / "Color.kt"
     with ComposeWriter(output, package="dev.kipila.example") as compose:
         compose.color(primary="#6200EE")
@@ -120,7 +121,7 @@ def test_package_is_configurable(tmp_path):
     assert "package dev.kipila.example" in output.read_text()
 
 
-def test_unsupported_dimension_unit_raises(tmp_path):
+def test_unsupported_dimension_unit_raises(tmp_path: Path):
     output = tmp_path / "Color.kt"
 
     with (

{resforge-0.4.2 → resforge-0.4.3}/tests/test_android_values.py

@@ -2,7 +2,6 @@ from pathlib import Path
 
 import pytest
 from defusedxml.ElementTree import parse
-
 from resforge import Color
 from resforge.android import PluralValues, ValuesWriter, dp, em, inch, mm, pt, px, sp
 
@@ -46,7 +45,7 @@ class TestDimensionType:
 
 
 @pytest.fixture
-def xml_path(tmp_path) -> Path:
+def xml_path(tmp_path: Path) -> Path:
     return tmp_path / "res" / "values" / "test.xml"
 
 

{resforge-0.4.2 → resforge-0.4.3}/tests/test_apple_catalog.py

@@ -1,12 +1,12 @@
 import json
+from pathlib import Path
 
 import pytest
-
 from resforge.apple.catalog import AssetCatalog
 from resforge.apple.types import AppleColor
 
 
-def test_asset_catalog_lifecycle(tmp_path):
+def test_asset_catalog_lifecycle(tmp_path: Path):
     catalog_name = "Assets"
     output_dir = tmp_path / "App"
     final_path = output_dir / f"{catalog_name}.xcassets"
@@ -21,12 +21,14 @@ def test_asset_catalog_lifecycle(tmp_path):
     assert (final_path / "Contents.json").exists()
     contents_file = final_path / "Primary.colorset" / "Contents.json"
     assert (contents_file).exists()
-    data = json.loads(contents_file.read_text())
-    assert data["colors"][0]["color"]["components"]["red"] == "1.000"
+    assert (
+        json.loads(contents_file.read_text())["colors"][0]["color"]["components"]["red"]
+        == "1.000"
+    )
     assert not temp_path.exists()
 
 
-def test_asset_catalog_atomic_failure(tmp_path):
+def test_asset_catalog_atomic_failure(tmp_path: Path):
     catalog_name = "Assets"
     output_dir = tmp_path / "App"
     final_path = output_dir / f"{catalog_name}.xcassets"
@@ -44,7 +46,7 @@ def test_asset_catalog_atomic_failure(tmp_path):
     assert not temp_path.exists()
 
 
-def test_asset_catalog_overwrites_existing(tmp_path):
+def test_asset_catalog_overwrites_existing(tmp_path: Path):
     catalog_name = "Assets"
     output_dir = tmp_path / "App"
     final_path = output_dir / f"{catalog_name}.xcassets"
@@ -60,7 +62,7 @@ def test_asset_catalog_overwrites_existing(tmp_path):
     assert (final_path / "Contents.json").exists()
 
 
-def test_require_context_enforcement(tmp_path):
+def test_require_context_enforcement(tmp_path: Path):
     catalog = AssetCatalog(tmp_path / "App", "Assets")
 
     with pytest.raises(RuntimeError):

{resforge-0.4.2 → resforge-0.4.3}/tests/test_atomic_write.py

@@ -1,9 +1,10 @@
-import pytest
+from pathlib import Path
 
+import pytest
 from resforge.io import atomic_write
 
 
-def test_atomic_replace_existing(tmp_path):
+def test_atomic_replace_existing(tmp_path: Path):
     target = tmp_path / "output.bin"
     target.write_bytes(b"old")
     with atomic_write(target) as f:
@@ -12,14 +13,14 @@ def test_atomic_replace_existing(tmp_path):
     assert not any(tmp_path.glob("*.tmp"))
 
 
-def test_creates_parent_dirs(tmp_path):
+def test_creates_parent_dirs(tmp_path: Path):
     target = tmp_path / "a" / "b" / "c" / "output.bin"
     with atomic_write(target) as f:
         f.write(b"hello")
     assert target.exists()
 
 
-def test_no_corruption_on_exception(tmp_path):
+def test_no_corruption_on_exception(tmp_path: Path):
     target = tmp_path / "output.bin"
     target.write_bytes(b"original")
 

{resforge-0.4.2 → resforge-0.4.3}/tests/test_color.py

@@ -1,5 +1,4 @@
 import pytest
-
 from resforge.color import Color
 
 

resforge-0.4.2/.github/workflows/ci.yml

@@ -1,48 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.12", "3.13", "3.14"]
-
-    steps:
-      - uses: actions/checkout@v5
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install Hatch
-        run: pip install hatch
-
-      - name: Run tests
-        run: hatch run pytest
-
-  lint-and-check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-
-      - name: Install Hatch
-        run: pip install hatch
-
-      - name: Lint
-        run: hatch run ruff check .
-
-      - name: Type check
-        run: hatch run basedpyright
-
-      - name: Verify Build Metadata
-        run: hatch build

resforge-0.4.2/.github/workflows/publish.yml

@@ -1,29 +0,0 @@
-name: Publish
-
-on:
-  release:
-    types: [published]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-
-    environment: pypi
-    permissions:
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@v5
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Build
-        run: |
-          pip install build
-          python -m build
-
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1

resforge-0.4.2/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-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
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.