update

Author: Guo-Zhang

cache/diskcache.md

@@ -0,0 +1,9 @@
+# DiskCache库
+
+## 用户文档
+
+- http://www.grantjenks.com/docs/diskcache/tutorial.html#tutorial-cache
+
+## API文档
+
+- http://www.grantjenks.com/docs/diskcache/api.html

markdown/gitbook.md

@@ -0,0 +1,24 @@
+# GitBook项目解析
+
+## GitBook项目结构
+
+详见：https://tonydeng.github.io/gitbook-zh/gitbook-howtouse/book/README.html
+
+## 参考资料
+
+### 官方实现
+
+[GitBook官方源码](https://github.com/GitbookIO/gitbook/tree/master/lib):
+
+- Models、Parsers等的建模可直接follow。
+
+### Python实现
+
+[`pybook`](https://github.com/bijanebrahimi/pybook):
+
+- 可以借鉴一些可以临时使用的Python实现方法。
+- 原本想fork，然后发现年久失修且架构不好，没有fork价值，不如重写。
+
+其他供参考的实现：
+
+- https://github.com/samuel-walker/gitbook-python-scripts

markdown/metadata.md

@@ -0,0 +1,6 @@
+# MetaData解析
+
+`markdown_meta_extension`:
+
+- PyPI: 
+- GitLab源码：https://gitlab.com/markdown-meta-extension/markdown-meta-extension/-/tree/master

markdown/parser.md

@@ -0,0 +1,6 @@
+# Markdown解析器
+
+可参考代码：
+
+- https://github.com/yhfyhf/Markdown-Parser-Python
+- https://github.com/phpusr/markdown-tree-parser

markdown/regex.md

@@ -0,0 +1,5 @@
+# 正则表达式实现
+
+一个[Markdown语法的正则教程](http://chubakbidpaa.com/interesting/2021/09/28/regex-for-md.html)。
+
+一个[Markdown正则匹配的测试工具](https://www.regextester.com/105361)。

string/examples.md

@@ -0,0 +1,3 @@
+# 字符串处理案例
+
+重复字符计数：https://pretagteam.com/question/counting-repeated-characters-in-a-string-in-python

unittest/env.md

@@ -0,0 +1,11 @@
+# 模拟环境变量
+
+使用`unittest`的装饰器`mock.patch.dict(os.environ, {'<key>': 'value'})`。
+
+方案来自：
+
+- https://adamj.eu/tech/2020/10/13/how-to-mock-environment-variables-with-pythons-unittest/
+
+在此基础上注意：
+
+类级别的装饰器，会在`setUp`方法之后运行。如果`setUp`方法内运行的代码先使用了环境变量，则类装饰器这样写实际上无效。这种情况下需要把装饰器加在`setUp`方法上。例如[`qtclass-admin-cli`的测试`test_tutorial_parsers_course.py`](https://quanttide.coding.net/p/qtclass-app/d/qtclass-admin-cli/git/tree/master/tests/test_tutorial_parsers_course.py)的15行。(PS: 尚未阅读源码或者API文档确认是否如此，请读者谨慎验证，如有问题欢迎PR。)

unittest/http.md

@@ -1,13 +1,10 @@
 # Mock HTTP API
 
-使用最易用的`responses`。
+使用最易用的[`responses`](https://pypi.org/project/responses/0.4.0/)。
 
-目前有几种方案可以选择：
+其他备选方案包括：
 
 - https://github.com/patrys/httmock
 - https://requests-mock.readthedocs.io/en/latest/matching.html#simple
-- https://github.com/getsentry/responses
-
-其他方法：
-
 - https://stackoverflow.com/questions/15753390/how-can-i-mock-requests-and-the-response
+- https://pythonrepo.com/repo/getsentry-responses-python-wsgi-compatible-web-servers