docs(python-core): add errors/segment-fault & tools/pip/command

Author: Sun-ZhenXing

.clang-format

@@ -0,0 +1,8 @@
+BasedOnStyle: Google
+UseTab: Never
+IndentWidth: 4
+TabWidth: 4
+PointerAlignment: Left
+DerivePointerAlignment: false
+ReflowComments: true
+AccessModifierOffset: -4

.eslintignore

@@ -0,0 +1 @@
+!docs/.vuepress/

.eslintrc

@@ -0,0 +1,7 @@
+{
+  "rules": {
+  },
+  "extends": [
+    "@antfu"
+  ]
+}

.gitignore

@@ -15,6 +15,7 @@ dist-ssr
 # Editor directories and files
 .vscode/*
 !.vscode/extensions.json
+!.vscode/settings.json
 .idea
 .DS_Store
 *.suo

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "python.analysis.typeCheckingMode": "basic"
+}

Dockerfile

@@ -1,5 +1,5 @@
 # Builder
-FROM node:18.16.0-bullseye-slim as builder
+FROM node:18.17.0-bullseye-slim as builder
 
 WORKDIR /app
 
@@ -16,7 +16,7 @@ RUN npm -v \
     && pnpm build
 
 # Nginx Server
-FROM nginx:1.24.0-alpine3.17-slim
+FROM nginx:nginx:1.25.2-alpine3.18-slim
 
 WORKDIR /usr/share/nginx/html/vuepress-python-notes/
 

docs/.vuepress/config.ts

@@ -1,6 +1,6 @@
 import process from 'node:process'
 import { getDirname, path } from '@vuepress/utils'
-import { defineUserConfig, defaultTheme } from 'vuepress'
+import { defaultTheme, defineUserConfig } from 'vuepress'
 import { mdEnhancePlugin } from 'vuepress-plugin-md-enhance'
 import { copyCodePlugin } from 'vuepress-plugin-copy-code2'
 import { searchProPlugin } from 'vuepress-plugin-search-pro'
@@ -19,12 +19,12 @@ export default defineUserConfig({
   title: 'Python 笔记',
   description: 'Python 笔记',
   head: [
-    ['link', { rel: 'icon', href: `${BASE_PATH}favicon.svg` }]
+    ['link', { rel: 'icon', href: `${BASE_PATH}favicon.svg` }],
   ],
   base: BASE_PATH,
   markdown: {
     code: {
-      lineNumbers: 10
+      lineNumbers: 10,
     },
     importCode: {
       handleImportPath: str => str
@@ -71,7 +71,7 @@ export default defineUserConfig({
       card: true,
       codetabs: true,
       include: {
-        resolvePath: file => {
+        resolvePath: (file) => {
           if (file.startsWith('@'))
             return file.replace('@', CURRENT_PATH)
           if (file.startsWith('/'))
@@ -96,45 +96,54 @@ export default defineUserConfig({
         {
           matcher: '@def',
           replacer: ({ tag }) => {
-            if (tag === 'em') return {
-              tag: 'Badge',
-              attrs: { type: 'tip' },
-              content: '定义'
+            if (tag === 'em') {
+              return {
+                tag: 'Badge',
+                attrs: { type: 'tip' },
+                content: '定义',
+              }
             }
-          }
+          },
         },
         {
           matcher: /@3.[0-9]+\+/,
           replacer: ({ tag, content }) => {
-            if (tag === 'em') return {
-              tag: 'Badge',
-              attrs: { type: 'tip' },
-              content: content.replace('@', '')
+            if (tag === 'em') {
+              return {
+                tag: 'Badge',
+                attrs: { type: 'tip' },
+                content: content.replace('@', ''),
+              }
             }
-          }
+          },
         },
         {
           matcher: '@TODO',
           replacer: ({ tag }) => {
-            if (tag === 'em') return {
-              tag: 'Badge',
-              attrs: { type: 'danger' },
-              content: 'TODO'
+            if (tag === 'em') {
+              return {
+                tag: 'Badge',
+                attrs: { type: 'danger' },
+                content: 'TODO',
+              }
             }
-          }
-        }
-      ]
+          },
+        },
+      ],
     }, false),
     searchProPlugin({}),
     autoCatalogPlugin({
       orderGetter: ({ title, routeMeta }) => {
-        if (routeMeta.order) return routeMeta.order as number
+        if (routeMeta.order)
+          return routeMeta.order as number
         const prefix = title.match(/^\d+. /)
-        if (prefix) return parseInt(prefix[0])
+        if (prefix)
+          return Number.parseInt(prefix[0])
         const suffix = title.match(/\d+$/)
-        if (suffix) return parseInt(suffix[0])
+        if (suffix)
+          return Number.parseInt(suffix[0])
         return 0
-      }
+      },
     }),
     copyCodePlugin({
       showInMobile: true,

docs/README.md

@@ -14,3 +14,14 @@ footer: Python 笔记合集，由 @Sun-ZhenXing 创建
 # Python 笔记合集
 
 <AutoCatalog />
+
+::: warning TODO
+
+- [ ] 使用 `TypedDict` 构造类型字典
+- [ ] 如何构建像 SymPy 一样的代数系统
+- [ ] 从零构建 JS 逆向工具，通过网站验签
+- [ ] PySide6: 添加笔记：Tree/Table 扩展最后一行/列
+- [ ] Celery：Python 异步任务调度
+- [ ] Rocketry：Python 下的轻量调度框架
+
+:::

docs/mixed-programming/c-cpp-mixed/src/sample.c

@@ -20,8 +20,7 @@ int in_mandel(double x0, double y0, int n) {
         y = 2 * x * y + y0;
         x = xtemp;
         n -= 1;
-        if (x * x + y * y > 4)
-            return 0;
+        if (x * x + y * y > 4) return 0;
     }
     return 1;
 }

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

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