docs(python-core): add asyncio/ & debugging/

Author: Sun-ZhenXing

docs/python-core/asyncio/index.md

@@ -0,0 +1,3 @@
+# 异步编程
+
+<AutoCatalog />

docs/python-core/asyncio/pool.md

@@ -0,0 +1,43 @@
+# 池化异步执行任务
+
+[[TOC]]
+
+## 1. 异步线程池
+
+```python
+import asyncio
+import time
+from concurrent.futures import ThreadPoolExecutor
+
+async def main():
+    start = time.perf_counter()
+    loop = asyncio.get_event_loop()
+    with ThreadPoolExecutor(max_workers=4) as executor:
+        tasks_list = [loop.run_in_executor(executor, time.sleep, 2) for _ in range(16)]
+        await asyncio.gather(*tasks_list)
+        end = time.perf_counter()
+        print(f"Time elapsed: {end - start}")
+
+asyncio.run(main())
+```
+
+## 2. 异步进程池
+
+```python
+from multiprocessing import Pool
+import time
+
+def say_hello(name) -> str:
+    time.sleep(1)
+    return f"hello, {name}"
+
+if __name__ == "__main__":
+    time_start = time.perf_counter()
+    with Pool() as pool:
+        hi1_async = pool.apply_async(say_hello, args=("satori",))
+        hi2_async = pool.apply_async(say_hello, args=("koishi",))
+        print(hi1_async.get())
+        print(hi2_async.get())
+    time_end = time.perf_counter()
+    print(f"Time elapsed: {time_end - time_start:.2f}s")
+```

docs/python-core/asyncio/subprocess.md

@@ -0,0 +1,29 @@
+# 创建异步子进程
+
+[[TOC]]
+
+## 1. 发起异步进程
+
+```python
+import asyncio
+
+async def run(cmd: str | bytes):
+    proc = await asyncio.create_subprocess_shell(
+        cmd,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.PIPE,
+    )
+    stdout, stderr = await proc.communicate()
+
+    print(f"{cmd!r} exited with {proc.returncode}")
+    if stdout:
+        print(f"[stdout]\n{stdout.decode()}")
+    if stderr:
+        print(f"[stderr]\n{stderr.decode()}")
+
+asyncio.run(run("ls /"))
+```
+
+## 2. Windows 下的限制
+
+*@TODO* Windows 只有 `ProactorEventLoop` 支持异步子进程，但是许多库都不支持 `ProactorEventLoop`，所以 Windows 下的异步子进程支持不好。

docs/python-core/debugging/index.md

@@ -0,0 +1,3 @@
+# 🐛 Python 调试技巧
+
+<AutoCatalog />

docs/python-core/debugging/segment-fault.md

@@ -0,0 +1,15 @@
+# Python 如何查找段错误（Segment Fault）
+
+[[TOC]]
+
+## 1. Python 调试选项
+
+问题背景：在开发 PySide6 程序时出现了闪退错误，Windows 上不显示任何内容崩溃，Mac OS 上出现段错误（内容已转储）。常规调试方法无法得出错误出现的位置，因为出错的位置不是在 Python 解释器执行时出现的，而是在执行外部扩展时出现的。
+
+通过下面的方法成功定位到问题：发现是 `QThread` 线程中调用了 UI 功能导致的。PySide6 要求线程想修改或读取 UI 控件的内容必须借助信号通信。
+
+总结：调试方法是，在执行 Python 时加上 `-X faulthandler` 选项，可以在程序出现 Segment Fault 时打印出调用栈。
+
+```bash
+python -X faulthandler test.py
+```

docs/python-core/errors/segment-fault.md

@@ -83,6 +83,7 @@ SQLAlchemy 会报错：
 ## 2. 解决方案
 
 我们先学习一下 SQLAlchemy 的连接池参数。
+
 - `pool_size`：设置连接池中，保持的连接数。初始化时并不产生连接。
 - `max_overflow`：当连接池里的连接数已达到 `pool_size` 时，且都被使用时。又要求从连接池里获取连接时，`max_overflow` 就是允许再新建的连接数。
 - `pool_timeout`：从连接池里获取连接，如果此时无空闲的连接。且连接数已经到达了 `pool_size+max_overflow`。此时获取连接的进程会等待 `pool_timeout` 秒。如果超过这个时间，还没有获得将会抛出异常，默认为 30 秒。