ren-ui-python 0.1.0__tar.gz → 0.2.0__tar.gz

{ren_ui_python-0.1.0 → ren_ui_python-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ren-ui-python
-Version: 0.1.0
+Version: 0.2.0
 Summary: Native RenkuOS/HaikuOS desktop apps in Python, packaged as HPKG
 Author-email: Lee JunHaeng aka rainygirl <rainygirl@gmail.com>
 License-Expression: MIT

{ren_ui_python-0.1.0 → ren_ui_python-0.2.0}/README.md

@@ -3,7 +3,7 @@
 Python 코드로 **RenkuOS 네이티브 UI와 앱을 작성하고 `.hpkg`로 패키징**하는 프레임워크입니다.
 웹뷰나 다른 OS의 위젯을 흉내 내지 않고, C++ 브리지를 통해 Haiku의 `libbe`를 호출합니다.
 
-현재 버전은 **0.1.0 초기 구현**입니다. 아래에 명시한 API를 지원하며, Haiku API 전체에 대한 바인딩은 아닙니다.
+현재 버전은 **0.2.0 초기 구현**입니다. 아래에 명시한 API를 지원하며, Haiku API 전체에 대한 바인딩은 아닙니다.
 Python 3.11 이상이 필요합니다. macOS/Linux에서는 프로젝트 생성·검사·소스 스테이징·단위 테스트가 가능하고,
 네이티브 UI 실행과 실제 HPKG 빌드는 Haiku에서 수행합니다.
 
@@ -12,10 +12,10 @@ Python 3.11 이상이 필요합니다. macOS/Linux에서는 프로젝트 생성
 
 ## 빠른 시작
 
-저장소 루트에서 설치합니다.
+[PyPI](https://pypi.org/project/ren-ui-python/)에서 설치합니다.
 
 ```sh
-python3 -m pip install .
+python3 -m pip install ren-ui-python
 ren init hello_haiku
 ren check hello_haiku
 ```
@@ -52,8 +52,8 @@ python3 -m ren_ui build examples/hello
 ## 샘플 앱
 
 각 디렉터리에 앱 코드, `ren.toml`, `LICENSE`가 들어 있습니다.
-저장소 루트에서 `python3 -m pip install .`로 현재 프레임워크를 설치한 뒤 Haiku에서 실행하세요.
-이전에 설치한 경우에도 다시 설치해야 새 `TextArea`와 `confirm` API를 사용할 수 있습니다.
+`python3 -m pip install ren-ui-python`으로 프레임워크를 설치한 뒤 Haiku에서 실행하세요.
+이전에 설치했다면 `python3 -m pip install --upgrade ren-ui-python`으로 최신 버전으로 올립니다.
 
 | 샘플 | 코드 | 배우는 내용 |
 | --- | --- | --- |
@@ -142,7 +142,7 @@ class DialogDemo:
             ),
             width=560, height=240,
             # 메인 창을 닫으면 열려 있는 입력 창도 함께 종료합니다.
-            on_close=self.quit,
+            onclosed=self.quit,
         )
 
     def quit(self, event: Event):
@@ -195,7 +195,7 @@ class DialogDemo:
                 hint, name,
                 Row(apply_button, Button("취소", cancel), padding=0),
             ),
-            width=400, height=180, resizable=False, on_close=closed,
+            width=400, height=180, resizable=False, onclosed=closed,
         )
         self.input_window = dialog.show()
 
@@ -375,7 +375,7 @@ class EditorDemo:
         self.draft_text: str | None = None
         self.draft_error: str | None = None
         self.path = TextInput(label="파일 경로:")
-        self.editor = TextArea(on_change=self.remember_change)
+        self.editor = TextArea(onchange=self.remember_change)
         self.status = Label("파일의 전체 경로를 입력하고 열기 또는 저장을 누르세요.")
         self.window = Window(
             app, "Ren · 텍스트 에디터",
@@ -612,12 +612,12 @@ with Application("application/x-vnd.example-hello") as app:
 | `system.settings_directory` | `find_directory` | 사용자 설정 디렉터리 |
 
 버튼은 `@button.onclick` 데코레이터로 클릭 함수를 등록합니다. 생성자의 `onclick` 인자로 전달해도 됩니다.
-입력·체크박스·슬라이더는 `on_change`에 함수를 전달합니다.
+입력·체크박스·슬라이더는 `onchange`에 함수를 전달합니다.
 콜백 인자는 `Event(source, kind, text, value)`입니다. `text`와 `value`는 이벤트 발생 시점의 스냅샷입니다.
 `TextInput`은 편집 및 Enter 입력 시, 슬라이더는 드래그 및 확정 시 알림을 보내므로 같은 값의 이벤트가 반복될 수 있습니다.
 `TextArea`는 편집 시와 표시된 위젯의 `.text`에 대입할 때 변경 이벤트를 보냅니다.
 `@window.onclose`는 닫기 전 확인 함수이며 `True`를 반환해야 닫힙니다.
-기존 `Window.on_close`는 창이 이미 닫힌 후 호출되는 별도의 알림입니다.
+기존 `Window.onclosed`는 창이 이미 닫힌 후 호출되는 별도의 알림입니다.
 마지막 창을 닫으면 앱도 종료됩니다.
 
 ## 문법과 API 사용법
@@ -729,7 +729,7 @@ app.call_soon(started)
 ### Window: 창 구성
 
 ```text
-Window(app, title, content, *, width=480, height=280, resizable=True, onclose=None, on_close=None)
+Window(app, title, content, *, width=480, height=280, resizable=True, onclose=None, onclosed=None)
 ```
 
 `content`에는 위젯 또는 레이아웃 하나를 전달합니다. 여러 위젯을 넣으려면 `Column`이나 `Row`로 묶습니다.
@@ -750,7 +750,7 @@ window = Window(
     width=520,
     height=320,
     resizable=False,
-    on_close=closed,
+    onclosed=closed,
 )
 window.show()
 ```
@@ -784,13 +784,13 @@ def before_close(event: Event) -> bool:
 창 테두리의 닫기 버튼과 표시된 창의 `window.close()` 모두 이 확인을 거칩니다.
 확인 중 중복 요청은 합치며, 핸들러는 네이티브 창 잠금을 해제한 Python 이벤트 처리 스레드에서 실행됩니다.
 핸들러 안에서는 `window.close()`를 다시 호출할 필요 없이 결과만 반환하세요.
-`window.close()`는 실제 닫힘을 기다리지 않습니다. 완료 처리는 `on_close`에서 수행합니다.
+`window.close()`는 실제 닫힘을 기다리지 않습니다. 완료 처리는 `onclosed`에서 수행합니다.
 `app.quit()`도 각 창의 확인을 거칩니다. 허용한 창은 닫히고 취소한 창은 남으며, 모든 창이 닫힌 뒤 앱이 종료됩니다.
 종료 버튼에서 특정 창만 닫으려면 `event: Event`를 받는 핸들러 안에서 `window.close()`를 호출하세요.
 실행 전·종료 후 자원 정리인 `app.close()`는 확인 없이 자원을 해제합니다.
 아직 `show()`하지 않은 창의 `close()`는 네이티브 창이 없으므로 핸들러 없이 객체를 닫습니다.
 
-`on_close`는 닫기 완료 알림이므로 콜백에서 그 창의 컨트롤을 수정하지 않습니다.
+`onclosed`는 닫기 완료 알림이므로 콜백에서 그 창의 컨트롤을 수정하지 않습니다.
 콜백의 반환값으로 닫기를 취소할 수 없습니다.
 `width`, `height`, `resizable`, `content`는 표시 전 구성에 사용하며,
 창 표시 후 해당 필드에 대입하는 방식으로 창 크기나 내용을 변경하는 API는 제공하지 않습니다.
@@ -847,10 +847,10 @@ content = Column(*labels)
 ```text
 Label(text="")
 Button(text, onclick=None, *, enabled=True, icon=None, icon_size=24)
-TextInput(text="", *, label="", on_change=None, enabled=True)
-TextArea(text="", *, on_change=None, editable=True, wrap=True)
-CheckBox(text, *, checked=False, on_change=None, enabled=True)
-Slider(text="", *, minimum=0, maximum=100, value=0, on_change=None)
+TextInput(text="", *, label="", onchange=None, enabled=True)
+TextArea(text="", *, onchange=None, editable=True, wrap=True)
+CheckBox(text, *, checked=False, onchange=None, enabled=True)
+Slider(text="", *, minimum=0, maximum=100, value=0, onchange=None)
 ```
 
 | 위젯 | 인자의 의미 | 생성 예 |
@@ -878,7 +878,7 @@ from ren_ui import Event, TextArea
 def document_changed(event: Event):
     print("변경된 내용:", event.text)
 
-editor = TextArea("첫 줄\n둘째 줄", on_change=document_changed)
+editor = TextArea("첫 줄\n둘째 줄", onchange=document_changed)
 preview = TextArea("선택·복사 가능한 읽기 전용 텍스트", editable=False)
 ```
 
@@ -944,9 +944,9 @@ def checked_changed(event: Event):
 def volume_changed(event: Event):
     print("음량:", event.value)
 
-name = TextInput(label="이름:", on_change=text_changed)
-enabled = CheckBox("사용", on_change=checked_changed)
-volume = Slider("음량", on_change=volume_changed)
+name = TextInput(label="이름:", onchange=text_changed)
+enabled = CheckBox("사용", onchange=checked_changed)
+volume = Slider("음량", onchange=volume_changed)
 ```
 
 `Event`는 읽기 전용 객체입니다. 처리 함수의 반환값은 사용하지 않습니다.
@@ -1051,7 +1051,7 @@ def main():
 
         content = Column(
             result,
-            CheckBox("증가 버튼 사용", checked=True, on_change=toggle),
+            CheckBox("증가 버튼 사용", checked=True, onchange=toggle),
             Row(increment_button, Button("초기화", reset), padding=0),
             Button("종료", quit_app),
         )
@@ -1360,7 +1360,7 @@ PNG를 앱 아이콘과 버튼 아이콘으로 사용한 설치 앱입니다.
 
 Python으로 Haiku 네이티브 앱을 만들고 HPKG로 배포하는 방법을 설명합니다. 설치와 첫 앱 작성부터 이벤트 처리, 샘플의 조작법, 패키징까지 순서대로 따라 할 수 있습니다.
 
-**대상 버전:** 0.1.0 / 네이티브 브리지 ABI v5  
+**대상 버전:** 0.2.0 / 네이티브 브리지 ABI v5  
 **문서 기준:** 2026-10-05 / Python 3.11 이상
 
 ![Python으로 만든 Haiku 캘린더 앱](docs/verification/arm64-2026-10-05/calendar.png)
@@ -1394,10 +1394,10 @@ Python으로 Haiku 네이티브 앱을 만들고 HPKG로 배포하는 방법을
 | package, rc, xres, resattr, mimeset | HPKG와 앱 리소스 생성 |
 | 실행 중인 Haiku 데스크톱 | 실제 창과 위젯 표시 |
 
-저장소 루트에서 다음 명령을 실행합니다. 필요한 도구는 사용 중인 Haiku 환경에 맞춰 먼저 설치합니다.
+다음 명령을 실행합니다. 필요한 도구는 사용 중인 Haiku 환경에 맞춰 먼저 설치합니다.
 
 ```sh
-python3 -m pip install .
+python3 -m pip install ren-ui-python
 ren doctor
 ren init manual_demo
 ren check manual_demo
@@ -1550,7 +1550,7 @@ def save(event: Event):
 
 #### 텍스트와 값 변경
 
-입력창·텍스트 영역·체크박스·슬라이더는 생성자의 `on_change`에 함수를 전달합니다. 이 위젯들에는 `onclick` 데코레이터를 사용하지 않습니다.
+입력창·텍스트 영역·체크박스·슬라이더는 생성자의 `onchange`에 함수를 전달합니다. 이 위젯들에는 `onclick` 데코레이터를 사용하지 않습니다.
 
 ```python
 from ren_ui import Event, TextInput, CheckBox
@@ -1558,11 +1558,11 @@ from ren_ui import Event, TextInput, CheckBox
 def name_changed(event: Event):
     print("입력:", event.text)
 
-def option_changed(event: Event):
+def optionchanged(event: Event):
     print("체크:", bool(event.value))
 
-name = TextInput(label="이름:", on_change=name_changed)
-option = CheckBox("알림", on_change=option_changed)
+name = TextInput(label="이름:", onchange=name_changed)
+option = CheckBox("알림", onchange=optionchanged)
 ```
 
 입력 확정이나 드래그 때문에 같은 값의 이벤트가 반복될 수 있습니다. `TextArea.text`에 대입해도 변경 이벤트가 발생하므로, 자신의 변경 핸들러에서 같은 값을 계속 대입하지 않도록 합니다.
@@ -1615,14 +1615,14 @@ def before_close(event: Event) -> bool:
 - 확인 중 중복 닫기 요청은 합칩니다. 핸들러 안에서 다시 `window.close()`를 호출하지 말고 결과를 반환합니다.
 - `window.close()`는 비동기 요청입니다. 호출 직후에 창이 이미 닫혔다고 가정하지 않습니다.
 
-#### onclose와 on_close의 차이
+#### onclose와 onclosed의 차이
 
 | 이름 | 호출 시점 | 반환값 |
 | --- | --- | --- |
 | onclose | 창이 닫히기 전 | True만 닫기 허용 |
-| on_close | 실제로 닫힌 뒤 | 닫힘을 취소할 수 없음 |
+| onclosed | 실제로 닫힌 뒤 | 닫힘을 취소할 수 없음 |
 
-닫힌 후의 정리가 필요하면 생성자의 `on_close=handler`를 사용합니다. 이 알림에서는 이미 닫힌 창의 컨트롤을 수정하지 않습니다.
+닫힌 후의 정리가 필요하면 생성자의 `onclosed=handler`를 사용합니다. 이 알림에서는 이미 닫힌 창의 컨트롤을 수정하지 않습니다.
 
 아직 `show()`하지 않은 창의 `close()`와 실행 전·종료 후 자원 정리인 `app.close()`는 확인 없이 정리합니다. 실행 중 종료를 요청할 때는 `window.close()` 또는 `app.quit()`를 사용합니다.
 

{ren_ui_python-0.1.0 → ren_ui_python-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ren-ui-python"
-version = "0.1.0"
+version = "0.2.0"
 description = "Native RenkuOS/HaikuOS desktop apps in Python, packaged as HPKG"
 readme = "PYPI.md"
 requires-python = ">=3.11"

{ren_ui_python-0.1.0 → ren_ui_python-0.2.0}/src/ren_ui/__init__.py

@@ -4,7 +4,7 @@ from .app import Application, Event
 from .resources import asset_path
 from .widgets import Button, CheckBox, Column, Image, Label, Row, Slider, TextArea, TextInput, Window
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __all__ = [
     "Application", "Event", "Image", "asset_path", "Window", "Column", "Row", "Label", "Button",
     "TextInput", "TextArea", "CheckBox", "Slider",

{ren_ui_python-0.1.0 → ren_ui_python-0.2.0}/src/ren_ui/app.py

@@ -84,8 +84,8 @@ class Application:
                     if window._closed:
                         continue
                     window._closed = True
-                    if window.on_close:
-                        window.on_close(Event(window, kind))
+                    if window.onclosed:
+                        window.onclosed(Event(window, kind))
                     continue
                 if window._closed or window._closing:
                     continue
@@ -93,8 +93,8 @@ class Application:
                     window._decide_close(Event(window, kind))
                     continue
                 widget = window._widgets.get(view_id)
-                if widget is not None and widget.on_change:
-                    widget.on_change(Event(widget, kind, text, value))
+                if widget is not None and widget.onchange:
+                    widget.onchange(Event(widget, kind, text, value))
             except Exception:
                 # A failing handler must not kill the dispatcher or the app.
                 traceback.print_exc()

{ren_ui_python-0.1.0 → ren_ui_python-0.2.0}/src/ren_ui/widgets.py

@@ -19,14 +19,14 @@ def _dimension(value, name, *, positive=False):
 class Widget:
     kind = ""
 
-    def __init__(self, text="", *, on_change=None, enabled=True):
+    def __init__(self, text="", *, onchange=None, enabled=True):
         utf8(text)
-        if on_change is not None and not callable(on_change):
-            raise TypeError("on_change must be callable")
+        if onchange is not None and not callable(onchange):
+            raise TypeError("onchange must be callable")
         self._text = text
         self._value = 0
         self._enabled = bool(enabled)
-        self.on_change = on_change
+        self.onchange = onchange
         self._window = None
         self._id = None
 
@@ -114,7 +114,7 @@ class Button(Widget):
 
     def __init__(self, text, onclick=None, *, enabled=True,
                  icon: str | Path | None = None, icon_size: int = 24):
-        super().__init__(text, on_change=onclick, enabled=enabled)
+        super().__init__(text, onchange=onclick, enabled=enabled)
         if type(icon_size) is not int or not 1 <= icon_size <= 256:
             raise ValueError("icon_size must be an integer from 1 to 256")
         self._icon_size = icon_size
@@ -143,7 +143,7 @@ class Button(Widget):
         """
         if not callable(callback):
             raise TypeError("onclick must be callable")
-        self.on_change = callback
+        self.onchange = callback
         return callback
 
     def click(self):
@@ -198,8 +198,8 @@ class Image(Widget):
 class TextInput(Widget):
     kind = "text"
 
-    def __init__(self, text="", *, label="", on_change=None, enabled=True):
-        super().__init__(text, on_change=on_change, enabled=enabled)
+    def __init__(self, text="", *, label="", onchange=None, enabled=True):
+        super().__init__(text, onchange=onchange, enabled=enabled)
         utf8(label)
         self.label = label
 
@@ -207,15 +207,15 @@ class TextInput(Widget):
 class TextArea(Widget):
     """Scrollable UTF-8 text, up to 1 MiB, with native editing and undo.
 
-    Changes, including assignments to text after mounting, emit on_change.
+    Changes, including assignments to text after mounting, emit onchange.
     wrap is a construction option; editable can be changed at runtime.
     """
     kind = "textarea"
     MAX_BYTES = 1024 * 1024
 
-    def __init__(self, text="", *, on_change=None, editable=True, wrap=True):
+    def __init__(self, text="", *, onchange=None, editable=True, wrap=True):
         self._validate_text(text)
-        super().__init__(text, on_change=on_change, enabled=editable)
+        super().__init__(text, onchange=onchange, enabled=editable)
         self.wrap = bool(wrap)
 
     @staticmethod
@@ -240,8 +240,8 @@ class TextArea(Widget):
 class CheckBox(Widget):
     kind = "checkbox"
 
-    def __init__(self, text, *, checked=False, on_change=None, enabled=True):
-        super().__init__(text, on_change=on_change, enabled=enabled)
+    def __init__(self, text, *, checked=False, onchange=None, enabled=True):
+        super().__init__(text, onchange=onchange, enabled=enabled)
         self._value = int(bool(checked))
 
     @property
@@ -256,8 +256,8 @@ class CheckBox(Widget):
 class Slider(Widget):
     kind = "slider"
 
-    def __init__(self, text="", *, minimum=0, maximum=100, value=0, on_change=None):
-        super().__init__(text, on_change=on_change)
+    def __init__(self, text="", *, minimum=0, maximum=100, value=0, onchange=None):
+        super().__init__(text, onchange=onchange)
         # The ABI carries layout/range values as floats; keep integers exact.
         if not all(isinstance(v, int) and abs(v) <= 2**24 for v in (minimum, maximum, value)):
             raise ValueError("slider bounds and value must be integers within +/- 2**24")
@@ -284,13 +284,13 @@ class Row(Column):
 
 
 class Window:
-    def __init__(self, app, title, content, *, width=480, height=280, resizable=True, onclose=None, on_close=None):
+    def __init__(self, app, title, content, *, width=480, height=280, resizable=True, onclose=None, onclosed=None):
         utf8(title)
         if not isinstance(content, Widget):
             raise TypeError("content must be a widget or layout")
-        if on_close is not None and not callable(on_close):
-            raise TypeError("on_close must be callable")
-        self.app, self.content, self.on_close = app, content, on_close
+        if onclosed is not None and not callable(onclosed):
+            raise TypeError("onclosed must be callable")
+        self.app, self.content, self.onclosed = app, content, onclosed
         self._title = title
         self.width = _dimension(width, "width", positive=True)
         self.height = _dimension(height, "height", positive=True)

{ren_ui_python-0.1.0 → ren_ui_python-0.2.0}/src/ren_ui_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ren-ui-python
-Version: 0.1.0
+Version: 0.2.0
 Summary: Native RenkuOS/HaikuOS desktop apps in Python, packaged as HPKG
 Author-email: Lee JunHaeng aka rainygirl <rainygirl@gmail.com>
 License-Expression: MIT

{ren_ui_python-0.1.0 → ren_ui_python-0.2.0}/tests/test_samples.py

@@ -84,14 +84,14 @@ class DialogTests(unittest.TestCase):
             dialog = demo.input_window
             hint, name, buttons = dialog.content.children
             name.text = "  "
-            buttons.children[0].on_change(None)
+            buttons.children[0].onchange(None)
             self.assertIn("한 글자", hint.text)
             self.assertEqual(demo.name, "Haiku")
             name.text = "  한글 이름  "
-            buttons.children[0].on_change(None)
+            buttons.children[0].onchange(None)
             self.assertEqual(demo.name, "한글 이름")
             self.assertTrue(dialog._closed)
-            dialog.on_close(Event(dialog, "closed"))
+            dialog.onclosed(Event(dialog, "closed"))
             self.assertIsNone(demo.input_window)
 
 

{ren_ui_python-0.1.0 → ren_ui_python-0.2.0}/tests/test_widgets.py

@@ -31,7 +31,7 @@ class WidgetTests(unittest.TestCase):
                 app = Application("application/x-vnd.ren-test")
                 app._native = Mock()
                 events, closed = [], []
-                window = Window(app, "Close", Label("x"), on_close=closed.append)
+                window = Window(app, "Close", Label("x"), onclosed=closed.append)
                 window._id = 1
                 app._windows[1] = window
 
@@ -119,7 +119,7 @@ class WidgetTests(unittest.TestCase):
         for invalid in (None, 42):
             with self.assertRaises(TypeError):
                 button.onclick(invalid)
-        self.assertIs(button.on_change, callback)
+        self.assertIs(button.onchange, callback)
 
     def test_composition_does_not_load_native_library(self):
         with patch("ren_ui.app.Native", side_effect=AssertionError("must stay lazy")):
@@ -273,8 +273,8 @@ class WidgetTests(unittest.TestCase):
     def test_event_snapshot_and_close_delivery(self):
         app = Application("application/x-vnd.ren-test")
         events = []
-        widget = TextInput(on_change=events.append)
-        window = Window(app, "Title", widget, on_close=events.append)
+        widget = TextInput(onchange=events.append)
+        window = Window(app, "Title", widget, onclosed=events.append)
         app._windows[1] = window
         window._widgets[2] = widget
         app._enqueue(1, 2, b"change", "한글".encode(), 7)