Edit docs

Author: gottadiveintopython

roadmap.md

@@ -6,3 +6,9 @@
 - Remove `anim_with_ratio`
 - `modal` サブモジュールでは `out_duration` と `in_duration` を個別に指定するのに対し `transition` サブモジュールでは両者を足した `duration` を指定する。
   この仕様のばらつきを統一する。
+
+
+# 0.12.0
+
+- `sync_attr` `sync_attrs` `smooth_attr` を通常のコンテキストマネージャのように `__enter__()` の実行によって効力を発揮するように変更する。
+- Remove `sleep_free`

sphinx/notes-ja.rst

@@ -27,7 +27,7 @@ asyncioも同じです。
 (追記)
 Python3.14にて :func:`asyncio.create_task` と :meth:`asyncio.TaskGroup.create_task` に ``eager_start`` 引数が加わりました。
 また `直ちに再開する機能`_ も議題になっているようです。
-なのでasynckivyができる事が全てasyncioでもできるようになる未来はあるかもしれません、
+なので将来asynckivyができる事が全てasyncioでもできるようになるかもしれません、
 
 .. _直ちに再開する機能: https://discuss.python.org/t/an-eager-way-to-set-result-on-asyncio-future/106161
 .. _車輪の再発明: https://ja.wikipedia.org/wiki/%E8%BB%8A%E8%BC%AA%E3%81%AE%E5%86%8D%E7%99%BA%E6%98%8E

sphinx/notes.rst

@@ -58,7 +58,7 @@ I/O without blocking the main thread.
     def thread_blocking_operation():
         '''
         This function is called from outside the main thread so you should not
-        perform any graphics-related operations here.
+        interact with Kivy except through ``Clock``.
         '''
 
 

sphinx/submod-modal.rst

@@ -45,14 +45,3 @@ API Reference
     :members:
     :undoc-members:
     :exclude-members:
-
-
-Notes
------
-
-You might wonder why this module has its own transitions when there's already a ``transition`` submodule.
-The reason is that modal dialogs require transitions in which the dialog moves in first and then moves out,
-whereas the transitions in the ``transition`` submodule move a widget out first and then back in.
-
-Perhaps I should rename the ``transition`` submodule to ``outin_transition`` and move the modal dialog transitions
-into a separate ``inout_transition`` submodule.

src/asynckivy/_event.py

@@ -266,7 +266,8 @@ async def original_rest_of_touch_events(widget, touch, *, stop_dispatching=False
                       widget, touch, stop_dispatching=stop_dispatching, grab=grab
                   ) as on_touch_move:
                       while True:
-                          yield await on_touch_move()
+                          await on_touch_move()
+                          yield
 
           However, be aware of :ref:`the-problem-with-async-generators`.
 

src/asynckivy/_threading.py

@@ -26,7 +26,8 @@ async def run_in_thread(func, *, daemon=None):
     See :ref:`io-in-asynckivy` for details.
 
     .. warning::
-        When the caller Task is cancelled, the ``func`` will be left running, which violates "structured concurrency".
+        When the caller Task is cancelled, the ``func`` will be left running, which violates structured concurrency.
+        Also, do not call this function from outside the main thread unless you know what you're doing.
     '''
     ev = asyncgui.ExclusiveEvent()
     Thread(
@@ -52,11 +53,10 @@ async def run_in_executor(executor: Executor, func, *args):
 
     :param args: Arguments to pass to the ``executor.submit`` method.
 
-    See :ref:`io-in-asynckivy` for details.
-
     .. warning::
         When the caller Task is cancelled, the ``func`` will be left running if it has already started,
-        which violates "structured concurrency".
+        which violates structured concurrency.
+        Also, do not call this function from outside the main thread unless you know what you're doing.
 
     .. versionchanged:: 0.11.1
         Added support for passing arguments to the ``executor.submit`` method.