yoga-layout-python 0.1.0__tar.gz

yoga_layout_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Facebook, Inc. and its affiliates.
+
+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.

yoga_layout_python-0.1.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: yoga-layout-python
+Version: 0.1.0
+Summary: Pure Python port of Meta Yoga layout engine
+Author: Meta Platforms, Inc. and affiliates.
+Maintainer: Quantmew Contributors
+License: MIT License
+        
+        Copyright (c) Facebook, Inc. and its affiliates.
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/quantmew/yoga-layout-python
+Project-URL: Repository, https://github.com/quantmew/yoga-layout-python
+Project-URL: Documentation, https://yogalayout.dev/
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0; extra == "test"
+Dynamic: license-file
+
+# yoga-layout-python
+
+`yoga-layout-python` is a pure Python port of Meta's Yoga layout engine.
+
+## Current Status
+
+- Public enums, value/config primitives, and the core layout algorithm are implemented in Python.
+- Internal module layout mirrors upstream `yoga/` so translation and parity work can stay file-for-file aligned.
+- Upstream test translations pass, and a Python-vs-C++ differential parity harness is available under `tools/`.
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+For development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## API Shape
+
+The Python package keeps Yoga's public naming style:
+
+```python
+from yoga import *
+
+config = YGConfigNew()
+node = YGNodeNewWithConfig(config)
+YGNodeStyleSetWidth(node, 100)
+YGNodeStyleSetHeight(node, 50)
+YGNodeCalculateLayout(node, YGUndefined, YGUndefined, YGDirectionLTR)
+
+width = YGNodeLayoutGetWidth(node)
+height = YGNodeLayoutGetHeight(node)
+```
+
+## Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=yoga --cov-report=term-missing
+
+# Run specific test file
+pytest tests/test_smoke.py -v
+```
+
+## Differential Parity
+
+The repository includes a differential parity runner that compares Python layout
+results against the vendored upstream C++ Yoga engine on the same captured tree.
+
+```bash
+# Run the default parity suite
+python tools/run_differential_ci.py
+
+# Rebuild the C++ runner first
+python tools/run_differential_ci.py --force-rebuild
+
+# Increase the random batch size
+python tools/run_differential_ci.py --random-count 1000 --seed 20260317
+```
+
+On failure, the script writes a repro capture to
+`build/differential_failure_capture.json`.
+
+The lower-level harness remains available if you want the raw output format:
+
+```bash
+python tools/differential_test.py
+```
+
+## Project Structure
+
+```
+src/yoga/
+├── algorithm/        # Core layout algorithms (CalculateLayout, FlexLine, etc.)
+├── config/           # Configuration handling
+├── debug/            # Debug utilities (logging, assertions)
+├── event/            # Event system
+├── node/             # Node class and layout results
+├── numeric/          # Numeric utilities (FloatOptional, Comparison)
+├── style/            # Style system (Style, StyleLength, etc.)
+└── *.py              # Public API modules
+
+tools/
+├── differential_cpp_runner.cpp  # C++ capture runner used for parity checks
+├── differential_test.py         # Python/C++ differential harness
+└── run_differential_ci.py       # Stable CLI entrypoint for parity checks
+```
+
+## License
+
+This project uses the same MIT license as upstream Yoga. See `LICENSE`.
+
+## Contributing
+
+Contributions are welcome! Please see the upstream [Yoga repository](https://github.com/facebook/yoga) for reference.

yoga_layout_python-0.1.0/README.md

@@ -0,0 +1,103 @@
+# yoga-layout-python
+
+`yoga-layout-python` is a pure Python port of Meta's Yoga layout engine.
+
+## Current Status
+
+- Public enums, value/config primitives, and the core layout algorithm are implemented in Python.
+- Internal module layout mirrors upstream `yoga/` so translation and parity work can stay file-for-file aligned.
+- Upstream test translations pass, and a Python-vs-C++ differential parity harness is available under `tools/`.
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+For development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## API Shape
+
+The Python package keeps Yoga's public naming style:
+
+```python
+from yoga import *
+
+config = YGConfigNew()
+node = YGNodeNewWithConfig(config)
+YGNodeStyleSetWidth(node, 100)
+YGNodeStyleSetHeight(node, 50)
+YGNodeCalculateLayout(node, YGUndefined, YGUndefined, YGDirectionLTR)
+
+width = YGNodeLayoutGetWidth(node)
+height = YGNodeLayoutGetHeight(node)
+```
+
+## Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=yoga --cov-report=term-missing
+
+# Run specific test file
+pytest tests/test_smoke.py -v
+```
+
+## Differential Parity
+
+The repository includes a differential parity runner that compares Python layout
+results against the vendored upstream C++ Yoga engine on the same captured tree.
+
+```bash
+# Run the default parity suite
+python tools/run_differential_ci.py
+
+# Rebuild the C++ runner first
+python tools/run_differential_ci.py --force-rebuild
+
+# Increase the random batch size
+python tools/run_differential_ci.py --random-count 1000 --seed 20260317
+```
+
+On failure, the script writes a repro capture to
+`build/differential_failure_capture.json`.
+
+The lower-level harness remains available if you want the raw output format:
+
+```bash
+python tools/differential_test.py
+```
+
+## Project Structure
+
+```
+src/yoga/
+├── algorithm/        # Core layout algorithms (CalculateLayout, FlexLine, etc.)
+├── config/           # Configuration handling
+├── debug/            # Debug utilities (logging, assertions)
+├── event/            # Event system
+├── node/             # Node class and layout results
+├── numeric/          # Numeric utilities (FloatOptional, Comparison)
+├── style/            # Style system (Style, StyleLength, etc.)
+└── *.py              # Public API modules
+
+tools/
+├── differential_cpp_runner.cpp  # C++ capture runner used for parity checks
+├── differential_test.py         # Python/C++ differential harness
+└── run_differential_ci.py       # Stable CLI entrypoint for parity checks
+```
+
+## License
+
+This project uses the same MIT license as upstream Yoga. See `LICENSE`.
+
+## Contributing
+
+Contributions are welcome! Please see the upstream [Yoga repository](https://github.com/facebook/yoga) for reference.

yoga_layout_python-0.1.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "yoga-layout-python"
+dynamic = ["version"]
+description = "Pure Python port of Meta Yoga layout engine"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {file = "LICENSE"}
+authors = [
+  {name = "Meta Platforms, Inc. and affiliates."}
+]
+maintainers = [
+  {name = "Quantmew Contributors"}
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=7.0",
+  "pytest-cov>=4.0",
+  "black>=23.0",
+  "ruff>=0.1.0",
+  "mypy>=1.0",
+]
+test = [
+  "pytest>=7.0",
+  "pytest-cov>=4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/quantmew/yoga-layout-python"
+Repository = "https://github.com/quantmew/yoga-layout-python"
+Documentation = "https://yogalayout.dev/"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.dynamic]
+version = {attr = "yoga.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_functions = "test_*"
+
+[tool.black]
+line-length = 100
+target-version = ["py39", "py310", "py311", "py312"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+select = ["E", "F", "W", "I", "N", "UP", "B", "C4", "SIM"]
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false

yoga_layout_python-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

yoga_layout_python-0.1.0/src/yoga/YGConfig.py

@@ -0,0 +1,92 @@
+"""
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+This source code is licensed under the MIT license found in the
+LICENSE file in the root directory of this source tree.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .YGEnums import YGErrata, YGExperimentalFeature
+from .config.Config import Config, _default_logger, getDefaultConfig, resolveRef
+
+
+YGConfigRef = Config
+YGConfigConstRef = Config
+YGNodeRef = Any
+YGNodeConstRef = Any
+YGLogger = Any
+YGCloneNodeFunc = Any
+
+
+def YGConfigNew() -> YGConfigRef:
+    return Config(logger_=_default_logger)
+
+
+def YGConfigFree(config: YGConfigRef) -> None:
+    del config
+
+
+def YGConfigGetDefault() -> YGConfigConstRef:
+    return getDefaultConfig()
+
+
+def YGConfigSetUseWebDefaults(config: YGConfigRef, enabled: bool) -> None:
+    resolveRef(config).setUseWebDefaults(enabled)
+
+
+def YGConfigGetUseWebDefaults(config: YGConfigConstRef) -> bool:
+    return resolveRef(config).useWebDefaults()
+
+
+def YGConfigSetPointScaleFactor(config: YGConfigRef, pixelsInPoint: float) -> None:
+    configRef = resolveRef(config)
+    if pixelsInPoint < 0.0:
+        raise ValueError("Scale factor should not be less than zero")
+    configRef.setPointScaleFactor(pixelsInPoint)
+
+
+def YGConfigGetPointScaleFactor(config: YGConfigConstRef) -> float:
+    return resolveRef(config).getPointScaleFactor()
+
+
+def YGConfigSetErrata(config: YGConfigRef, errata: YGErrata) -> None:
+    resolveRef(config).setErrata(errata)
+
+
+def YGConfigGetErrata(config: YGConfigConstRef) -> YGErrata:
+    return resolveRef(config).getErrata()
+
+
+def YGConfigSetLogger(config: YGConfigRef, logger: YGLogger) -> None:
+    configRef = resolveRef(config)
+    if logger is not None:
+        configRef.setLogger(logger)
+    else:
+        configRef.setLogger(_default_logger)
+
+
+def YGConfigSetContext(config: YGConfigRef, context: object) -> None:
+    resolveRef(config).setContext(context)
+
+
+def YGConfigGetContext(config: YGConfigConstRef) -> object:
+    return resolveRef(config).getContext()
+
+
+def YGConfigSetExperimentalFeatureEnabled(
+    config: YGConfigRef, feature: YGExperimentalFeature, enabled: bool
+) -> None:
+    resolveRef(config).setExperimentalFeatureEnabled(feature, enabled)
+
+
+def YGConfigIsExperimentalFeatureEnabled(
+    config: YGConfigConstRef, feature: YGExperimentalFeature
+) -> bool:
+    return resolveRef(config).isExperimentalFeatureEnabled(feature)
+
+
+def YGConfigSetCloneNodeFunc(config: YGConfigRef, callback: YGCloneNodeFunc) -> None:
+    resolveRef(config).setCloneNodeCallback(callback)