pythonx-compose 0.1.0a1__tar.gz

pythonx_compose-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023-2024 BREW (b-re-w), Jong-uk Lee (rnoro5122)
+
+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.

pythonx_compose-0.1.0a1/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: pythonx-compose
+Version: 0.1.0a1
+Summary: Pythonic Compose UI for Python on Kotlin Multiplatform, through python-multiplatform
+Author: BREW (b-re-w), Jong-uk Lee (rnoro5122)
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/thisisthepy/pythonx-compose
+Project-URL: Source, https://github.com/thisisthepy/pythonx-compose
+Project-URL: Issues, https://github.com/thisisthepy/pythonx-compose/issues
+Project-URL: Documentation, https://thisisthepy.github.io/pythonx-compose/
+Keywords: compose,jetpack-compose,compose-multiplatform,kotlin-multiplatform,ui,python-multiplatform
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+English | [한국어](https://github.com/thisisthepy/pythonx-compose/blob/main/docs/locale/README_ko.md)
+
+<div align="center">
+
+# pythonx-compose
+
+**Write Compose user interfaces in Python — with Compose's own widgets, spelled the Python way.**
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-7c4dff.svg)](https://github.com/thisisthepy/pythonx-compose/blob/main/LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-7c4dff.svg)](https://github.com/thisisthepy/pythonx-compose/blob/main/pyproject.toml)
+[![pip](https://img.shields.io/badge/pip-pythonx--compose-7c4dff.svg)](https://github.com/thisisthepy/pythonx-compose/blob/main/pyproject.toml)
+[![Status](https://img.shields.io/badge/status-pre--alpha-lightgrey.svg)](#-status)
+
+[Guide](https://thisisthepy.github.io/pythonx-compose/) · [Getting started](https://thisisthepy.github.io/pythonx-compose/getting-started.html) · [Concepts](https://thisisthepy.github.io/pythonx-compose/concepts.html) · [Status](https://thisisthepy.github.io/pythonx-compose/status.html)
+
+</div>
+
+---
+
+## Why
+
+Jetpack Compose and Compose Multiplatform are a superb way to build UI — if you write Kotlin.
+`pythonx-compose` is for people who write Python. It does not reimplement Compose and it does not
+invent a new widget set: it takes the real `androidx.compose.*` API, which
+[python-multiplatform](https://github.com/thisisthepy/python-multiplatform) exposes to Python under
+its Kotlin names, and restructures it into a Pythonic package, `pythonx.compose`.
+
+```python
+from pythonx.compose.runtime import Composable
+from pythonx.compose.material3 import Text, Button
+
+@Composable
+def Greeting():
+    Button(on_click=lambda: print("hi"), content=lambda: Text("Hello from Python"))
+```
+
+<sub>These names resolve today, by one rule, inside an app that embeds the binder; per-widget render
+proofs are still pending. See [Status](#-status).</sub>
+
+## ✨ Principles
+
+- **The original API, Pythonic names.** Every parameter is Compose's own parameter, in
+  `snake_case`: `onClick` → `on_click`, `horizontalAlignment` → `horizontal_alignment`. Upper-case
+  names (types, objects, composables) keep their Kotlin spelling; every other name is `snake_case`
+  only (`fillMaxWidth` → `fill_max_width`, `toURLString` → `to_url_string`), and an explicit
+  overload keeps its suffix (`padding__Dp`).
+- **Extension functions are methods.** `Modifier.padding(16).size(24).fill_max_width()` chains
+  exactly as it does in Kotlin. Keyword arguments to such a method are `snake_case`
+  too (`m.padding(padding_values=...)`), as they are on the module function
+  `padding(m, padding_values=...)`; Kotlin's own spelling still works at run time, and the type
+  stubs offer only the Pythonic one.
+- **Kotlin objects are namespaces.** `Alignment.Center` and `Arrangement.End` are read without
+  parentheses; functions inside them are `snake_case`: `Arrangement.spaced_by(8)`. Constants can
+  also be reached grouped by their declared type, as the notebook writes them:
+  `Alignment.Horizontal.End` is `Alignment.End`.
+- **`@Composable` stays.** Screens are decorated Python functions.
+- **A real package.** `pythonx/` is ordinary Python source that imports `androidx.compose.*` and
+  reshapes it. The binder never renames anything — renaming is this package's job.
+- **One manifest.** [`pythonx-map.toml`](https://github.com/thisisthepy/pythonx-compose/blob/main/pythonx/compose/pythonx-map.toml) says which `pythonx.compose.*` module
+  stands for which Kotlin package. It lives inside the package and ships in the wheel. The runtime
+  and the `.pyi` generator read the same file, so what your editor completes is what the interpreter
+  resolves.
+
+## 🧩 Architecture at a glance
+
+```mermaid
+flowchart LR
+    app["Your Python UI<br/>@Composable def Screen()"] --> px["pythonx.compose<br/>(this package, real Python)"]
+    px --> ax["androidx.compose.*<br/>Kotlin names, exposed by python-multiplatform"]
+    ax --> compose["Jetpack / Compose Multiplatform"]
+    map["pythonx-map.toml"] -.-> px
+    map -.-> pyi[".pyi stubs<br/>(in the wheel)"]
+```
+
+| Python module | Kotlin package |
+|---|---|
+| `pythonx.compose.runtime` | `androidx.compose.runtime` |
+| `pythonx.compose.ui` | `androidx.compose.ui` |
+| `pythonx.compose.layout` | `androidx.compose.foundation.layout` |
+| `pythonx.compose.material3` | `androidx.compose.material3` |
+
+Each module is a real file whose `__init__.py` calls one re-export rule; names resolve on first use.
+`Column`, `Row` and `Spacer` are importable from `pythonx.compose.material3` as well as
+`pythonx.compose.layout`, as the notebook writes them (the manifest's `[aliases]`).
+
+## 🚀 Quick start
+
+> [!NOTE]
+> `pythonx-compose` is **pre-alpha**. The first alpha, `0.1.0a1`, is released to PyPI when the
+> maintainer tags it; a pre-release needs `pip install --pre pythonx-compose`.
+
+From a clone, to run the tests:
+
+```bash
+git clone https://github.com/thisisthepy/pythonx-compose
+cd pythonx-compose
+python3 -m pip install pytest      # inside a virtual environment
+python3 -m pytest tests -q
+```
+
+What runs today, from the repository root:
+
+```python
+from pythonx.compose.runtime import Composable
+
+@Composable                      # an identity decorator: the function stays a plain function
+def Screen():
+    """A screen."""
+    return "drawn"
+
+assert Screen() == "drawn" and Screen.__name__ == "Screen"
+```
+
+```python
+import tomllib                   # the manifest: the one place the mapping is written down
+
+with open("pythonx/compose/pythonx-map.toml", "rb") as f:
+    manifest = tomllib.load(f)
+
+manifest["modules"]["pythonx.compose.layout"]
+# 'androidx.compose.foundation.layout'
+manifest["value-classes"]["raw-primitive-allowed"]
+# ['androidx.compose.ui.unit.Dp']   ->  padding(16) means padding(16.dp)
+```
+
+```python
+from pythonx.compose._reexport import python_name   # the naming rule, no binder needed
+
+python_name("fillMaxWidth")   # 'fill_max_width'
+python_name("toURLString")    # 'to_url_string'
+python_name("Modifier")       # 'Modifier'
+```
+
+Reading a Compose name such as `pythonx.compose.material3.Text` needs the binder, which the Kotlin
+host installs; outside an app it raises a `RuntimeError` saying so.
+
+The tests that drive a `Modifier` chain and overload dispatch read the binder's adaptation layer
+from a sibling [python-multiplatform](https://github.com/thisisthepy/python-multiplatform) checkout
+(or `PYTHONMULTIPLATFORM_HOME`); without one they are skipped.
+
+## 📦 Installation
+
+Distributed as the pip package **`pythonx-compose`** (Python 3.11 or later), providing the import
+package `pythonx.compose`, with the manifest inside the wheel, and typed: `.pyi` stubs generated from
+real Compose 1.11.1 and `py.typed` ship with it. It runs inside an app that embeds CPython
+through [python-multiplatform](https://github.com/thisisthepy/python-multiplatform); it is not a
+standalone desktop toolkit.
+
+## 🧪 Status
+
+| Area | State |
+|---|---|
+| Mapping manifest `pythonx-map.toml` | ✅ implemented and tested |
+| `@Composable` decorator | ✅ implemented and tested |
+| `pythonx` as a real on-disk package re-exporting `androidx.compose.*` by one rule | ✅ implemented and tested |
+| `Modifier` chains with snake_case methods, overload dispatch, `Dp` as a number | ✅ implemented and tested against the binder's layer |
+| `Column`, `Row`, `Spacer` from `material3` as well as `layout` | ✅ implemented and tested |
+| Method keyword arguments in `snake_case` | ✅ implemented and tested — module functions and methods (methods need python-multiplatform's `describe_member`) |
+| The empty `Modifier` | 🟡 partial — `Modifier.padding(16)` from the class needs an app-supplied factory against real Compose |
+| `Alignment` / `Arrangement` | ✅ implemented and tested — `Alignment.Center`, `Arrangement.spaced_by(8)`, and grouped `Alignment.Horizontal.End` beside `Alignment.End` |
+| Material 3 widgets (`Text`, `Button`, `Card`, `TextField`, …) | 🟡 partial — re-exported by rule; render proofs per widget pending (#9) |
+| Type stubs (`.pyi`) from real Compose 1.11.1, `py.typed` | ✅ implemented and checked with mypy; many types are still `Any` (#12) |
+| Distribution (`pythonx-compose`) | 🟡 partial — the wheel carries the manifest, the re-export rule, the stubs and `py.typed` |
+| Declared app root (`@app`) and Pythonic state (`state`), no update call | 🟡 partial — binder path tested against a fake host shaped after python-multiplatform #38; real Compose is the E2E module (#11, #19); numbers and strings round-trip through `state` |
+| `TextField(state=...)` with `TextFieldState` (`pythonx.compose.foundation.text.input`) | 🟡 partial — tested against a fake host shaped after python-multiplatform #73; the input-method (IME) composing proof is python-multiplatform E2E #26 (#10) |
+| `DefaultIcons` (`Icons.Default`), written `DefaultIcons.Add` | 🟡 partial — tested against a fake host shaped after python-multiplatform #37/#38; `Icon(DefaultIcons.Add, …)` is drawn in python-multiplatform's render test |
+| Colour schemes | ⏳ planned |
+| `remember_saveable`, coroutine scopes | ⏳ planned |
+
+The full list is on the guide's [Status page](https://thisisthepy.github.io/pythonx-compose/status.html).
+
+## 📖 Documentation
+
+- **Guide** — [`docs/guide/`](https://thisisthepy.github.io/pythonx-compose/), bilingual (English / 한국어)
+- **Korean README** — [`docs/locale/README_ko.md`](https://github.com/thisisthepy/pythonx-compose/blob/main/docs/locale/README_ko.md)
+
+## 🔌 Ecosystem
+
+| Repository | Role |
+|---|---|
+| [python-multiplatform](https://github.com/thisisthepy/python-multiplatform) | The binder: CPython embedded in Kotlin Multiplatform, exposing Kotlin to Python under Kotlin names |
+| **pythonx-compose** | Compose, restructured for Python — this repository |
+| [toolchain](https://github.com/thisisthepy/toolchain) | Gradle build plugin for Python Multiplatform apps |
+| [pypackpack](https://github.com/thisisthepy/pypackpack) | Distributing Python projects across platforms |
+| [torchnative](https://github.com/thisisthepy/torchnative) | Run the real PyTorch ecosystem on device |
+| [Gemstone](https://github.com/LogitAI/Gemstone) | A Kotlin Multiplatform AI app built alongside the stack |
+
+## 🤝 Contributing
+
+Development is intent-first and test-first: a change starts as a specification change, then a
+failing test, then code. The [guide](https://thisisthepy.github.io/pythonx-compose/status.html) lists what is open and where help is
+useful. Please open an issue before large changes.
+
+## Maintainers
+
+| Name | Area | Since |
+|---|---|---|
+| [@b-re-w](https://github.com/b-re-w) | Composable runtime | 2023 |
+| [@rnoro5122](https://github.com/rnoro5122) | Material 3 | 2024 |
+
+## License
+
+[MIT](https://github.com/thisisthepy/pythonx-compose/blob/main/LICENSE) © 2023–2024 BREW (b-re-w), Jong-uk Lee (rnoro5122)

pythonx_compose-0.1.0a1/README.md

@@ -0,0 +1,203 @@
+English | [한국어](https://github.com/thisisthepy/pythonx-compose/blob/main/docs/locale/README_ko.md)
+
+<div align="center">
+
+# pythonx-compose
+
+**Write Compose user interfaces in Python — with Compose's own widgets, spelled the Python way.**
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-7c4dff.svg)](https://github.com/thisisthepy/pythonx-compose/blob/main/LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-7c4dff.svg)](https://github.com/thisisthepy/pythonx-compose/blob/main/pyproject.toml)
+[![pip](https://img.shields.io/badge/pip-pythonx--compose-7c4dff.svg)](https://github.com/thisisthepy/pythonx-compose/blob/main/pyproject.toml)
+[![Status](https://img.shields.io/badge/status-pre--alpha-lightgrey.svg)](#-status)
+
+[Guide](https://thisisthepy.github.io/pythonx-compose/) · [Getting started](https://thisisthepy.github.io/pythonx-compose/getting-started.html) · [Concepts](https://thisisthepy.github.io/pythonx-compose/concepts.html) · [Status](https://thisisthepy.github.io/pythonx-compose/status.html)
+
+</div>
+
+---
+
+## Why
+
+Jetpack Compose and Compose Multiplatform are a superb way to build UI — if you write Kotlin.
+`pythonx-compose` is for people who write Python. It does not reimplement Compose and it does not
+invent a new widget set: it takes the real `androidx.compose.*` API, which
+[python-multiplatform](https://github.com/thisisthepy/python-multiplatform) exposes to Python under
+its Kotlin names, and restructures it into a Pythonic package, `pythonx.compose`.
+
+```python
+from pythonx.compose.runtime import Composable
+from pythonx.compose.material3 import Text, Button
+
+@Composable
+def Greeting():
+    Button(on_click=lambda: print("hi"), content=lambda: Text("Hello from Python"))
+```
+
+<sub>These names resolve today, by one rule, inside an app that embeds the binder; per-widget render
+proofs are still pending. See [Status](#-status).</sub>
+
+## ✨ Principles
+
+- **The original API, Pythonic names.** Every parameter is Compose's own parameter, in
+  `snake_case`: `onClick` → `on_click`, `horizontalAlignment` → `horizontal_alignment`. Upper-case
+  names (types, objects, composables) keep their Kotlin spelling; every other name is `snake_case`
+  only (`fillMaxWidth` → `fill_max_width`, `toURLString` → `to_url_string`), and an explicit
+  overload keeps its suffix (`padding__Dp`).
+- **Extension functions are methods.** `Modifier.padding(16).size(24).fill_max_width()` chains
+  exactly as it does in Kotlin. Keyword arguments to such a method are `snake_case`
+  too (`m.padding(padding_values=...)`), as they are on the module function
+  `padding(m, padding_values=...)`; Kotlin's own spelling still works at run time, and the type
+  stubs offer only the Pythonic one.
+- **Kotlin objects are namespaces.** `Alignment.Center` and `Arrangement.End` are read without
+  parentheses; functions inside them are `snake_case`: `Arrangement.spaced_by(8)`. Constants can
+  also be reached grouped by their declared type, as the notebook writes them:
+  `Alignment.Horizontal.End` is `Alignment.End`.
+- **`@Composable` stays.** Screens are decorated Python functions.
+- **A real package.** `pythonx/` is ordinary Python source that imports `androidx.compose.*` and
+  reshapes it. The binder never renames anything — renaming is this package's job.
+- **One manifest.** [`pythonx-map.toml`](https://github.com/thisisthepy/pythonx-compose/blob/main/pythonx/compose/pythonx-map.toml) says which `pythonx.compose.*` module
+  stands for which Kotlin package. It lives inside the package and ships in the wheel. The runtime
+  and the `.pyi` generator read the same file, so what your editor completes is what the interpreter
+  resolves.
+
+## 🧩 Architecture at a glance
+
+```mermaid
+flowchart LR
+    app["Your Python UI<br/>@Composable def Screen()"] --> px["pythonx.compose<br/>(this package, real Python)"]
+    px --> ax["androidx.compose.*<br/>Kotlin names, exposed by python-multiplatform"]
+    ax --> compose["Jetpack / Compose Multiplatform"]
+    map["pythonx-map.toml"] -.-> px
+    map -.-> pyi[".pyi stubs<br/>(in the wheel)"]
+```
+
+| Python module | Kotlin package |
+|---|---|
+| `pythonx.compose.runtime` | `androidx.compose.runtime` |
+| `pythonx.compose.ui` | `androidx.compose.ui` |
+| `pythonx.compose.layout` | `androidx.compose.foundation.layout` |
+| `pythonx.compose.material3` | `androidx.compose.material3` |
+
+Each module is a real file whose `__init__.py` calls one re-export rule; names resolve on first use.
+`Column`, `Row` and `Spacer` are importable from `pythonx.compose.material3` as well as
+`pythonx.compose.layout`, as the notebook writes them (the manifest's `[aliases]`).
+
+## 🚀 Quick start
+
+> [!NOTE]
+> `pythonx-compose` is **pre-alpha**. The first alpha, `0.1.0a1`, is released to PyPI when the
+> maintainer tags it; a pre-release needs `pip install --pre pythonx-compose`.
+
+From a clone, to run the tests:
+
+```bash
+git clone https://github.com/thisisthepy/pythonx-compose
+cd pythonx-compose
+python3 -m pip install pytest      # inside a virtual environment
+python3 -m pytest tests -q
+```
+
+What runs today, from the repository root:
+
+```python
+from pythonx.compose.runtime import Composable
+
+@Composable                      # an identity decorator: the function stays a plain function
+def Screen():
+    """A screen."""
+    return "drawn"
+
+assert Screen() == "drawn" and Screen.__name__ == "Screen"
+```
+
+```python
+import tomllib                   # the manifest: the one place the mapping is written down
+
+with open("pythonx/compose/pythonx-map.toml", "rb") as f:
+    manifest = tomllib.load(f)
+
+manifest["modules"]["pythonx.compose.layout"]
+# 'androidx.compose.foundation.layout'
+manifest["value-classes"]["raw-primitive-allowed"]
+# ['androidx.compose.ui.unit.Dp']   ->  padding(16) means padding(16.dp)
+```
+
+```python
+from pythonx.compose._reexport import python_name   # the naming rule, no binder needed
+
+python_name("fillMaxWidth")   # 'fill_max_width'
+python_name("toURLString")    # 'to_url_string'
+python_name("Modifier")       # 'Modifier'
+```
+
+Reading a Compose name such as `pythonx.compose.material3.Text` needs the binder, which the Kotlin
+host installs; outside an app it raises a `RuntimeError` saying so.
+
+The tests that drive a `Modifier` chain and overload dispatch read the binder's adaptation layer
+from a sibling [python-multiplatform](https://github.com/thisisthepy/python-multiplatform) checkout
+(or `PYTHONMULTIPLATFORM_HOME`); without one they are skipped.
+
+## 📦 Installation
+
+Distributed as the pip package **`pythonx-compose`** (Python 3.11 or later), providing the import
+package `pythonx.compose`, with the manifest inside the wheel, and typed: `.pyi` stubs generated from
+real Compose 1.11.1 and `py.typed` ship with it. It runs inside an app that embeds CPython
+through [python-multiplatform](https://github.com/thisisthepy/python-multiplatform); it is not a
+standalone desktop toolkit.
+
+## 🧪 Status
+
+| Area | State |
+|---|---|
+| Mapping manifest `pythonx-map.toml` | ✅ implemented and tested |
+| `@Composable` decorator | ✅ implemented and tested |
+| `pythonx` as a real on-disk package re-exporting `androidx.compose.*` by one rule | ✅ implemented and tested |
+| `Modifier` chains with snake_case methods, overload dispatch, `Dp` as a number | ✅ implemented and tested against the binder's layer |
+| `Column`, `Row`, `Spacer` from `material3` as well as `layout` | ✅ implemented and tested |
+| Method keyword arguments in `snake_case` | ✅ implemented and tested — module functions and methods (methods need python-multiplatform's `describe_member`) |
+| The empty `Modifier` | 🟡 partial — `Modifier.padding(16)` from the class needs an app-supplied factory against real Compose |
+| `Alignment` / `Arrangement` | ✅ implemented and tested — `Alignment.Center`, `Arrangement.spaced_by(8)`, and grouped `Alignment.Horizontal.End` beside `Alignment.End` |
+| Material 3 widgets (`Text`, `Button`, `Card`, `TextField`, …) | 🟡 partial — re-exported by rule; render proofs per widget pending (#9) |
+| Type stubs (`.pyi`) from real Compose 1.11.1, `py.typed` | ✅ implemented and checked with mypy; many types are still `Any` (#12) |
+| Distribution (`pythonx-compose`) | 🟡 partial — the wheel carries the manifest, the re-export rule, the stubs and `py.typed` |
+| Declared app root (`@app`) and Pythonic state (`state`), no update call | 🟡 partial — binder path tested against a fake host shaped after python-multiplatform #38; real Compose is the E2E module (#11, #19); numbers and strings round-trip through `state` |
+| `TextField(state=...)` with `TextFieldState` (`pythonx.compose.foundation.text.input`) | 🟡 partial — tested against a fake host shaped after python-multiplatform #73; the input-method (IME) composing proof is python-multiplatform E2E #26 (#10) |
+| `DefaultIcons` (`Icons.Default`), written `DefaultIcons.Add` | 🟡 partial — tested against a fake host shaped after python-multiplatform #37/#38; `Icon(DefaultIcons.Add, …)` is drawn in python-multiplatform's render test |
+| Colour schemes | ⏳ planned |
+| `remember_saveable`, coroutine scopes | ⏳ planned |
+
+The full list is on the guide's [Status page](https://thisisthepy.github.io/pythonx-compose/status.html).
+
+## 📖 Documentation
+
+- **Guide** — [`docs/guide/`](https://thisisthepy.github.io/pythonx-compose/), bilingual (English / 한국어)
+- **Korean README** — [`docs/locale/README_ko.md`](https://github.com/thisisthepy/pythonx-compose/blob/main/docs/locale/README_ko.md)
+
+## 🔌 Ecosystem
+
+| Repository | Role |
+|---|---|
+| [python-multiplatform](https://github.com/thisisthepy/python-multiplatform) | The binder: CPython embedded in Kotlin Multiplatform, exposing Kotlin to Python under Kotlin names |
+| **pythonx-compose** | Compose, restructured for Python — this repository |
+| [toolchain](https://github.com/thisisthepy/toolchain) | Gradle build plugin for Python Multiplatform apps |
+| [pypackpack](https://github.com/thisisthepy/pypackpack) | Distributing Python projects across platforms |
+| [torchnative](https://github.com/thisisthepy/torchnative) | Run the real PyTorch ecosystem on device |
+| [Gemstone](https://github.com/LogitAI/Gemstone) | A Kotlin Multiplatform AI app built alongside the stack |
+
+## 🤝 Contributing
+
+Development is intent-first and test-first: a change starts as a specification change, then a
+failing test, then code. The [guide](https://thisisthepy.github.io/pythonx-compose/status.html) lists what is open and where help is
+useful. Please open an issue before large changes.
+
+## Maintainers
+
+| Name | Area | Since |
+|---|---|---|
+| [@b-re-w](https://github.com/b-re-w) | Composable runtime | 2023 |
+| [@rnoro5122](https://github.com/rnoro5122) | Material 3 | 2024 |
+
+## License
+
+[MIT](https://github.com/thisisthepy/pythonx-compose/blob/main/LICENSE) © 2023–2024 BREW (b-re-w), Jong-uk Lee (rnoro5122)

pythonx_compose-0.1.0a1/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pythonx-compose"
+version = "0.1.0a1"
+description = "Pythonic Compose UI for Python on Kotlin Multiplatform, through python-multiplatform"
+readme = {file = "README.md", content-type = "text/markdown"}
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    {name = "BREW (b-re-w)"},
+    {name = "Jong-uk Lee (rnoro5122)"},
+]
+keywords = ["compose", "jetpack-compose", "compose-multiplatform", "kotlin-multiplatform", "ui", "python-multiplatform"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: User Interfaces",
+    "Typing :: Typed",
+]
+dependencies = [
+]
+#dependencies-kotlin = [
+#    "org.jetbrains.compose:compose-ui:0.4.0",
+#]
+requires-python = ">= 3.11"  # tomllib, which reads the manifest at run time
+#requires-kotlin = ">= 1.4.32"
+
+[project.urls]
+Homepage = "https://github.com/thisisthepy/pythonx-compose"
+Source = "https://github.com/thisisthepy/pythonx-compose"
+Issues = "https://github.com/thisisthepy/pythonx-compose/issues"
+Documentation = "https://thisisthepy.github.io/pythonx-compose/"
+
+[tool.setuptools.packages.find]
+include = ["pythonx.compose*"]
+
+[tool.setuptools.package-data]
+# Every package, not just `pythonx.compose` itself: a package-data key names one package and does
+# not descend, so `"pythonx.compose"` alone would ship `pythonx/compose/*.pyi` and drop
+# `pythonx/compose/ui/*.pyi` -- which is where most of the generated stubs land.
+"*" = ["*.pyi", "py.typed", "pythonx-map.toml"]

pythonx_compose-0.1.0a1/pythonx/compose/__init__.py

@@ -0,0 +1,4 @@
+
+from pythonx.compose._reexport import reexport
+
+__getattr__, __dir__ = reexport(__name__)

pythonx_compose-0.1.0a1/pythonx/compose/__init__.pyi

@@ -0,0 +1 @@
+# GENERATED by scripts/gen_stubs.py from python-multiplatform's Kotlin-named stubs (artifact kotlin-stubs, workflow run 37103737430, commit a5028618, Compose 1.11.1). Do not edit.