chore: move dirs

Author: Sun-ZhenXing

.vscode/extensions.json

@@ -1,7 +1,9 @@
 {
   "recommendations": [
-    "DavidAnson.vscode-markdownlint",
     "yzhang.markdown-all-in-one",
-    "bierner.markdown-mermaid"
+    "vstirbu.vscode-mermaid-preview",
+    "bpruitt-goddard.mermaid-markdown-syntax-highlighting",
+    "bierner.markdown-mermaid",
+    "DavidAnson.vscode-markdownlint"
   ]
 }

.vscode/settings.json

@@ -1,65 +1,4 @@
 {
   "python.analysis.typeCheckingMode": "basic",
-  // Enable the ESlint flat config support
-  "eslint.experimental.useFlatConfig": true,
-  // Disable the default formatter, use eslint instead
-  "prettier.enable": false,
-  "editor.formatOnSave": false,
-  // Auto fix
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": true,
-    "source.organizeImports": false
-  },
-  // Silent the stylistic rules in you IDE, but still auto fix them
-  "eslint.rules.customizations": [
-    {
-      "rule": "style/*",
-      "severity": "off"
-    },
-    {
-      "rule": "*-indent",
-      "severity": "off"
-    },
-    {
-      "rule": "*-spacing",
-      "severity": "off"
-    },
-    {
-      "rule": "*-spaces",
-      "severity": "off"
-    },
-    {
-      "rule": "*-order",
-      "severity": "off"
-    },
-    {
-      "rule": "*-dangle",
-      "severity": "off"
-    },
-    {
-      "rule": "*-newline",
-      "severity": "off"
-    },
-    {
-      "rule": "*quotes",
-      "severity": "off"
-    },
-    {
-      "rule": "*semi",
-      "severity": "off"
-    }
-  ],
-  // Enable eslint for all supported languages
-  "eslint.validate": [
-    "javascript",
-    "javascriptreact",
-    "typescript",
-    "typescriptreact",
-    "vue",
-    "html",
-    "markdown",
-    "json",
-    "jsonc",
-    "yaml"
-  ]
+  "python.analysis.autoImportCompletions": true
 }

docs/.vuepress/config.ts

@@ -73,7 +73,6 @@ export default defineUserConfig({
       container: true,
       vPre: true,
       tabs: true,
-      card: true,
       codetabs: true,
       include: {
         resolvePath: (file) => {

docs/python-core/debugging/index.md renamed to docs/advanced/debugging/index.md

@@ -1,5 +1,7 @@
 # Python 泛型编程
 
+<!-- markdownlint-disable MD033 -->
+
 Python 是多范式的编程语言，支持泛型编程。本文介绍使用 Python 泛型编程的一些细节和实现。
 
 [[TOC]]
@@ -15,6 +17,7 @@ Python 是多范式的编程语言，支持泛型编程。本文介绍使用 Pyt
 3. 减少不确定性的错误和预期外的结果
 
 Python 的泛型编程和 C++/Java 的泛型编程有什么区别和共同点？
+
 1. 共同点：都可以实现代码复用
 2. 不同点：Python 的泛型不是强制的，可以不遵循类型声明，可以使用任意的类型代替
 
@@ -25,7 +28,7 @@ Python 使用 `typing` 模块实现类型注解，相对来讲，Python 的类
 虽然 Python 是动态类型的语言，但写程序时养成良好的习惯，会大大提高你的编码效率，减少错误出现，正如 *Zen of Python* 所说
 
 > Explicit is better than implicit.（显式胜于隐式）
-> 
+>
 > <cite>——Tim Peters</cite>
 
 通俗一点来讲就是，如果你的函数返回类型是可知的，就不要把它藏起来，让别人猜测你的返回类型。
@@ -67,7 +70,7 @@ l0 = list[tuple[str]]()
 正如 *Zen of Python* 所说的：
 
 > Special cases aren't special enough to break the rules.（特殊情形不足以特殊到打破规则）
-> 
+>
 > <cite>——Tim Peters</cite>
 
 :::

docs/python-core/debugging/segment-fault.md renamed to docs/advanced/debugging/segment-fault.md

@@ -0,0 +1,3 @@
+# Python 进阶
+
+<AutoCatalog />

docs/python-core/generic-programming/index.md renamed to docs/advanced/generic-programming/index.md

@@ -61,17 +61,17 @@ pip install -U cython
 
 - `resources/`：项目用到的资源文件
 - `demo_server/`
-    - `models/`
-        - `__init__.py`
-        - `xxx.py`
-    - `services/`
-        - `__init__.py`
-        - `xxx.py`
-    - `utils/`
-        - `__init__.py`
-        - `xxx.py`
+  - `models/`
     - `__init__.py`
-    - `core.py`
+    - `xxx.py`
+  - `services/`
+    - `__init__.py`
+    - `xxx.py`
+  - `utils/`
+    - `__init__.py`
+    - `xxx.py`
+  - `__init__.py`
+  - `core.py`
 - `server.py`：主入口文件
 - `setup.py`：包配置文件
 - `requirements.txt`：依赖文件
@@ -206,7 +206,7 @@ pip-delete-this-directory.txt
 
 ## 3. 动态导入和路由发现
 
-以下内容需要对 Python 的 `importlib` 模块有一定的了解，如果你不了解如何动态导入模块，可以参考 [此文章](../python-core/collections/import-python-file-from-path.md)。
+以下内容需要对 Python 的 `importlib` 模块有一定的了解，如果你不了解如何动态导入模块，可以参考 [此文章](../basic/collections/import-python-file-from-path.md)。
 
 我们在构建网络服务时常常使用一些元编程技巧，这常常需要借助运行时反射来实现。如 SpringBoot 中的 `@ComponentScan` 能够自动扫描并加载所有的 `@Component` 注解的类，然后将它们注册到 IoC 容器中。
 

docs/advanced/index.md

@@ -0,0 +1,34 @@
+# Python 协程
+
+::: info 参考
+
+[官方文档术语对照表](https://docs.python.org/zh-cn/3/glossary.html#term-coroutine)
+
+:::
+
+## 1. 协程
+
+协程是子例程的更一般形式。
+
+子例程可以在某一点进入并在另一点退出。协程则可以在许多不同的点上进入、退出和恢复。它们可通过 [async def](https://docs.python.org/zh-cn/3/reference/compound_stmts.html#async-def) 语句来实现。参见 [PEP 492](https://www.python.org/dev/peps/pep-0492) 。
+
+- *@3.5+* **协程**（coroutine）可以在多个位置上挂起和恢复执行
+- `await` 表达式，`async for` 以及 `async with` 只能在协程函数体中使用
+- 使用 `async def` 语法定义的函数总是为协程函数，即使它们不包含 `await` 或 `async` 关键字
+- 在协程函数体中使用 `yield from` 表达式将引发 `SyntaxError`
+
+详细解释见 [官方文档语言参考手册](https://docs.python.org/zh-cn/3/reference/compound_stmts.html#coroutines)。
+
+## 2. 协程函数
+
+返回一个 [`Coroutine`](https://docs.python.org/zh-cn/3/glossary.html#term-coroutine) 对象的函数。
+
+协程函数可通过 [`async def`](https://docs.python.org/zh-cn/3/reference/compound_stmts.html#async-def) 语句来定义，并可能包含 [`await`](https://docs.python.org/zh-cn/3/reference/expressions.html#await)、[`async for`](https://docs.python.org/zh-cn/3/reference/compound_stmts.html#async-for) 和 [`async with`](https://docs.python.org/zh-cn/3/reference/compound_stmts.html#async-with) 关键字。这些特性是由 [PEP 492](https://www.python.org/dev/peps/pep-0492) 引入的。
+
+## 3. PEP 492
+
+PEP 是 Python 语言发展的提案。
+
+[PEP 492](https://www.python.org/dev/peps/pep-0492) 提出使用 `async` 和 `await` 语法实现协程，将协程作为 Python 中的一个正式的单独概念，并增加相应的支持语法。
+
+该提案在 Python 3.5 版本实现。

docs/mixed-programming/c-cpp-mixed/ctypes.md renamed to docs/advanced/mixed-programming/c-cpp-mixed/ctypes.md

@@ -0,0 +1,94 @@
+# Python 异步编程
+
+::: info 转载
+
+原文链接：[阮一峰的网络日志：Python 异步编程入门](https://www.ruanyifeng.com/blog/2019/11/python-asyncio.html)
+
+:::
+
+[[TOC]]
+
+Python 3.4 引入了 `asyncio` 模块，增加了异步编程，跟 JavaScript 的 `async/await` 极为类似，大大方便了异步任务的处理。
+
+## Python 的异步编程
+
+历史上，Python 并不支持专门的异步编程语法，因为不需要。
+
+有了多线程（`threading`）和多进程（`multiprocessing`），就没必要一定支持异步了。如果一个线程（或进程）阻塞，新建其他线程（或进程）就可以了，程序不会卡死。
+
+但是，多线程有 “线程竞争” 的问题，处理起来很复杂，还涉及加锁。对于简单的异步任务来说（比如与网页互动），写起来很麻烦。
+
+## asyncio 的设计
+
+`asyncio` 模块最大特点就是，只存在一个线程。
+
+由于只有一个线程，就不可能多个任务同时运行。`asyncio` 是 **多任务合作** 模式（cooperative multitasking），允许异步任务交出执行权给其他任务，等到其他任务完成，再收回执行权继续往下执行，这和 JavaScript 也是一样的。
+
+由于代码的执行权在多个任务之间交换，所以看上去好像多个任务同时运行，其实底层只有一个线程，多个任务分享运行时间。
+
+`asyncio` 模块在单线程上启动一个事件循环（event loop），时刻监听新进入循环的事件，加以处理，并不断重复这个过程，直到异步任务结束。
+
+## asyncio API
+
+下面介绍 `asyncio` 模块最主要的几个 API。注意，必须使用 Python 3.7 或更高版本，早期的语法已经改变了。
+
+第一步，`import` 导入 `asyncio` 模块。
+
+```python
+import asyncio
+```
+
+第二步，函数前面加上 `async` 关键字，就变成了 `async` 函数。这种函数最大特点是执行可以暂停，交出执行权。
+
+```python
+async def main():
+    pass
+```
+
+第三步，在 `async` 函数内部的异步任务前面，加上 `await` 命令。
+
+```python
+await asyncio.sleep(1)
+```
+
+上面代码中，`asyncio.sleep(1)` 方法可以生成一个异步任务，休眠 1 秒钟然后结束。
+
+执行引擎遇到 `await` 命令，就会在异步任务开始执行之后，暂停当前 `async` 函数的执行，把执行权交给其他任务。等到异步任务结束，再把执行权交回 `async` 函数，继续往下执行。
+
+第四步，`async.run()` 方法加载 `async` 函数，启动事件循环。
+
+```python
+asyncio.run(main())
+```
+
+上面代码中，`asyncio.run()` 在事件循环上监听 `async` 函数 `main()` 的执行。等到 `main()` 执行完了，事件循环才会终止。
+
+## async 函数示例
+
+```python
+import asyncio
+
+async def count():
+    print('One')
+    await asyncio.sleep(1)
+    print('Two')
+
+async def main():
+    await asyncio.gather(count(), count(), count())
+
+asyncio.run(main())
+```
+
+执行结果：
+
+```console
+$ python async.py
+One
+One
+One
+Two
+Two
+Two
+```
+
+脚本总的运行时间是 1 秒，而它们同步执行的时间是 3 秒。

docs/mixed-programming/c-cpp-mixed/index.md renamed to docs/advanced/mixed-programming/c-cpp-mixed/index.md

@@ -4,7 +4,7 @@
 
 ## 1. Python 语言定义
 
-我们在第三方库中介绍过一个 Python 语言解析器[`parso`](../../pypi-package/compiler/parso.md)，它的核心就是一个 Python 语言定义，它是一个 EBNF 语法定义，用于解析 Python 代码。[^1]
+我们在第三方库中介绍过一个 Python 语言解析器[`parso`](../../packages/compiler/parso.md)，它的核心就是一个 Python 语言定义，它是一个 EBNF 语法定义，用于解析 Python 代码。[^1]
 
 [^1]: 冷门话题，聊一聊 Python 的 EBNF，酷 Python，<http://www.coolpython.net/informal_essay/21-04/py-ebnf.html>
 
@@ -34,13 +34,13 @@ suite: simple_stmt | NEWLINE INDENT stmt+ DEDENT
 
 ## 2. EBNF 语法
 
-```card
+<!-- ```card
 title: AI 提示
 desc: 解释一下 Extended Backus Naur Form（EBNF）是什么？What is the Extended Backus Naur Form (EBNF)?
 link: https://chat.openai.com/
 logo: /vuepress-python-notes/chatgpt.svg
 color: rgba(226, 212, 255, 0.2)
-```
+``` -->
 
 **巴科斯-诺尔范式**（Extended Backus-Naur Form，EBNF）是一种用于描述计算机语言语法的元语言。它是 Backus-Naur Form（BNF）的扩展版本，提供了更多的元素和语法结构，以便更准确地描述一些复杂的语法规则。
 

docs/mixed-programming/c-cpp-mixed/intro.md renamed to docs/advanced/mixed-programming/c-cpp-mixed/intro.md

@@ -0,0 +1,3 @@
+# Python 并发编程
+
+<AutoCatalog />

docs/mixed-programming/c-cpp-mixed/src/sample.c renamed to docs/advanced/mixed-programming/c-cpp-mixed/src/sample.c

@@ -0,0 +1,3 @@
+# Python 多进程
+
+<AutoCatalog />

docs/mixed-programming/index.md renamed to docs/advanced/mixed-programming/index.md

@@ -0,0 +1,54 @@
+# Python 多进程
+
+[[TOC]]
+
+## 1. 进程
+
+多进程可以避免 Python 多线程的劣势，充分发挥多核优势。
+
+## 2. 创建进程
+
+创建过程与多线程一致：
+
+@[code python](./src/mp_1.py)
+
+## 3. 使用 `Queue` 进行进程间通信
+
+使用 `multiprocessing.Queue` 返回输出的值：
+
+@[code python](./src/mp_queue.py)
+
+## 4. 多线程与多进程对比
+
+性能对比
+
+@[code python](./src/mp_2.py)
+
+## 5. `Pool` 进程池
+
+@[code python](./src/mp_pool.py)
+
+`apply_async()` 函数一次使用一个值
+
+```python
+res = pool.apply_async(job, (2,))
+print(res.get())
+pool = mp.Pool(processes=2)
+```
+
+## 6. 共享内存
+
+定义共享内存变量：
+
+```python
+val = mp.Value('d', 1)
+array = mp.Array('i', [1, 2, 3])
+```
+
+变量的类型值可以参考[标准库文档](https://docs.python.org/zh-cn/3/library/array.html#module-array)。
+
+## 7. `Lock` 锁
+
+使用锁：
+
+@[code python](./src/mp_lock.py)

docs/quicknote/cython-build-image.md renamed to docs/awesome/cython-build-image.md

@@ -0,0 +1,11 @@
+import multiprocessing as mp
+
+
+def job(a: int, b: int) -> None:
+    print("a:", a, "b:", b)
+
+
+if __name__ == "__main__":
+    p1 = mp.Process(target=job, args=(1, 2))
+    p1.start()
+    p1.join()