mypystubs: document uos.stat

docs/api/uos.rst

+``uos`` module
+===============
+
+.. automodule:: uos
+   :members:
+   :undoc-members:
+   :member-order: bysource

docs/index.rst

@@ -30,6 +30,7 @@ Welcome to flow3r's documentation!
    api/captouch.rst
    api/ctx.rst
    api/leds.rst
+   api/uos.rst
    api/sys_buttons.rst
    api/sys_display.rst
    api/sys_kernel.rst

python_payload/mypystubs/uos.pyi

+from typing import NewType
+
+StatStruct = NewType(
+    "StatStruct", tuple[int, int, int, int, int, int, int, int, int, int]
+)
+
+def stat(path: str) -> StatStruct:
+    """
+    Get the status of a file or directory.
+
+    Returns a tuple with 10 elements:
+
+    - st_mode
+
+    - st_ino
+
+    - st_dev
+
+    - st_nlink
+
+    - sb.st_uid
+
+    - sb.st_gid
+
+    - sb.st_size
+
+    - sb.st_atime
+
+    - sb.st_mtime
+
+    - sb.st_ctime
+    """