-
-
Notifications
You must be signed in to change notification settings - Fork 1.4k
Expand file tree
/
Copy pathresources.yml
More file actions
344 lines (323 loc) · 12.5 KB
/
Copy pathresources.yml
File metadata and controls
344 lines (323 loc) · 12.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
catalog:
reviewed_on: "2026-08-31"
status: active
paths:
- id: foundations
order: 1
title_en: "Python foundations"
title_zh: "Python 基础"
summary_en: "Learn the language, environments, dependencies, typing, and tests that reliable Python work depends on."
summary_zh: "掌握语言基础、环境、依赖、类型与测试，为可靠的 Python 项目打好根基。"
- id: web-apis
order: 2
title_en: "Web and APIs"
title_zh: "Web 与 API"
summary_en: "Build typed services and applications that connect Python logic to users and other systems."
summary_zh: "构建有类型约束的服务和应用，把 Python 逻辑连接到用户与其他系统。"
- id: automation
order: 3
title_en: "Automation"
title_zh: "自动化"
summary_en: "Turn repeatable work into maintainable scripts, browser workflows, and data pipelines."
summary_zh: "把重复工作变成可维护的脚本、浏览器工作流和数据管道。"
- id: ai-agents
order: 4
title_en: "AI agents"
title_zh: "AI Agent"
summary_en: "Learn tools, structured output, state, evaluation, and the safety boundaries of agent systems."
summary_zh: "理解工具调用、结构化输出、状态、评测以及 Agent 系统的安全边界。"
resources:
- id: python-tutorial
path: foundations
title: "The Python Tutorial"
url: "https://docs.python.org/3/tutorial/"
source_type: official-docs
level: beginner
language: en
why_en: "The primary introduction to Python syntax, data structures, modules, errors, classes, and the standard library."
why_zh: "Python 官方入门教程，覆盖语法、数据结构、模块、异常、类与标准库。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: true
- id: python-venv
path: foundations
title: "venv — Creation of virtual environments"
url: "https://docs.python.org/3/library/venv.html"
source_type: official-docs
level: beginner
language: en
why_en: "The standard-library reference for creating isolated Python environments and understanding their behavior."
why_zh: "Python 标准库的虚拟环境参考，说明如何创建隔离环境及其运行方式。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: python-packaging-guide
path: foundations
title: "Python Packaging User Guide"
url: "https://packaging.python.org/en/latest/tutorials/packaging-projects/"
source_type: official-docs
level: intermediate
language: en
why_en: "The PyPA tutorial for project layout, build metadata, distributions, and publishing Python packages."
why_zh: "PyPA 官方教程，覆盖项目结构、构建元数据、分发包与 Python 包发布。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: uv-docs
path: foundations
title: "uv documentation"
url: "https://docs.astral.sh/uv/"
source_type: official-project
level: all-levels
language: en
why_en: "A modern workflow for Python versions, virtual environments, dependencies, lockfiles, and project commands."
why_zh: "现代 Python 工作流，统一管理版本、虚拟环境、依赖、锁文件和项目命令。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: true
- id: pytest-docs
path: foundations
title: "pytest documentation"
url: "https://docs.pytest.org/en/stable/"
source_type: official-project
level: intermediate
language: en
why_en: "The official guide to test discovery, assertions, fixtures, parametrization, and maintainable test suites."
why_zh: "pytest 官方指南，覆盖测试发现、断言、fixture、参数化和可维护测试套件。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: typing-docs
path: foundations
title: "Python typing documentation"
url: "https://typing.python.org/en/latest/"
source_type: official-docs
level: intermediate
language: en
why_en: "The canonical home for Python's type-system specification, guides, and typing best practices."
why_zh: "Python 类型系统规范、指南与类型标注实践的权威入口。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: fastapi-docs
path: web-apis
title: "FastAPI documentation"
url: "https://fastapi.tiangolo.com/"
source_type: official-docs
level: intermediate
language: en
why_en: "A direct route from typed Python functions to tested APIs with validation and generated documentation."
why_zh: "从带类型的 Python 函数出发，构建具备验证、测试和自动文档的 API。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: true
- id: django-tutorial
path: web-apis
title: "Django documentation: First steps"
url: "https://docs.djangoproject.com/en/stable/intro/tutorial01/"
source_type: official-docs
level: beginner
language: en
why_en: "The official path through Django projects, models, views, templates, forms, tests, and reusable apps."
why_zh: "Django 官方入门路径，覆盖项目、模型、视图、模板、表单、测试和可复用应用。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: flask-docs
path: web-apis
title: "Flask documentation"
url: "https://flask.palletsprojects.com/en/stable/"
source_type: official-docs
level: beginner
language: en
why_en: "The maintained reference and tutorial for Flask applications, requests, templates, testing, and deployment."
why_zh: "Flask 官方参考与教程，覆盖应用、请求、模板、测试和部署。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: pydantic-docs
path: web-apis
title: "Pydantic documentation"
url: "https://pydantic.dev/docs/validation/latest/get-started/"
source_type: official-docs
level: intermediate
language: en
why_en: "The primary guide to validating untrusted data and expressing typed contracts at Python system boundaries."
why_zh: "在 Python 系统边界验证不可信数据、定义类型契约的官方指南。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: httpx-docs
path: web-apis
title: "HTTPX documentation"
url: "https://www.python-httpx.org/"
source_type: official-project
level: intermediate
language: en
why_en: "The official reference for synchronous and asynchronous HTTP clients, timeouts, streaming, and transport control."
why_zh: "同步与异步 HTTP 客户端、超时、流式响应和传输控制的官方参考。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: pathlib-docs
path: automation
title: "pathlib — Object-oriented filesystem paths"
url: "https://docs.python.org/3/library/pathlib.html"
source_type: official-docs
level: beginner
language: en
why_en: "The standard-library reference for readable, cross-platform file and directory automation."
why_zh: "使用可读、跨平台的对象式路径完成文件与目录自动化的标准库参考。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: subprocess-docs
path: automation
title: "subprocess — Subprocess management"
url: "https://docs.python.org/3/library/subprocess.html"
source_type: official-docs
level: intermediate
language: en
why_en: "The standard-library contract for launching processes, capturing output, handling failures, and avoiding unsafe shell usage."
why_zh: "启动进程、捕获输出、处理失败并避免不安全 shell 用法的标准库契约。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: medium
featured: false
- id: playwright-python
path: automation
title: "Playwright for Python"
url: "https://playwright.dev/python/docs/intro"
source_type: official-docs
level: intermediate
language: en
why_en: "The official Python guide to reliable browser automation, locators, assertions, traces, and isolated contexts."
why_zh: "可靠浏览器自动化、定位器、断言、追踪和隔离上下文的 Python 官方指南。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: medium
featured: false
- id: scrapy-tutorial
path: automation
title: "Scrapy tutorial"
url: "https://docs.scrapy.org/en/latest/intro/tutorial.html"
source_type: official-docs
level: intermediate
language: en
why_en: "The official introduction to crawl structure, extraction, item pipelines, persistence, and responsible operation."
why_zh: "爬虫结构、数据提取、item pipeline、持久化与负责任运行的官方入门。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: medium
featured: false
- id: pandas-getting-started
path: automation
title: "pandas getting started guides"
url: "https://pandas.pydata.org/docs/getting_started/index.html"
source_type: official-docs
level: beginner
language: en
why_en: "The primary entry point for tabular data loading, cleaning, transformation, analysis, and export."
why_zh: "表格数据读取、清洗、转换、分析和导出的官方入门入口。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: low
featured: false
- id: openai-agents-sdk
path: ai-agents
title: "OpenAI Agents SDK"
url: "https://openai.github.io/openai-agents-python/"
source_type: official-docs
level: intermediate
language: en
why_en: "The official Python toolkit for agents, tools, handoffs, guardrails, sessions, tracing, and orchestration."
why_zh: "面向 Agent、工具、handoff、guardrail、session、追踪与编排的官方 Python 工具包。"
reviewed_on: "2026-08-31"
status: active
requires_key: true
risk: medium
featured: true
- id: pydantic-ai
path: ai-agents
title: "Pydantic AI"
url: "https://pydantic.dev/docs/ai/overview/"
source_type: official-docs
level: intermediate
language: en
why_en: "Typed agent development built around validated inputs, structured output, tools, testing, and model portability."
why_zh: "以输入验证、结构化输出、工具、测试和模型可移植性为核心的类型安全 Agent 开发。"
reviewed_on: "2026-08-31"
status: active
requires_key: true
risk: medium
featured: true
- id: model-context-protocol
path: ai-agents
title: "Model Context Protocol"
url: "https://modelcontextprotocol.io/docs/getting-started/intro"
source_type: official-standard
level: intermediate
language: en
why_en: "The open protocol and reference documentation for connecting AI applications to tools, data, and reusable context."
why_zh: "连接 AI 应用、工具、数据与可复用上下文的开放协议和权威参考。"
reviewed_on: "2026-08-31"
status: active
requires_key: false
risk: medium
featured: true
- id: langgraph-python
path: ai-agents
title: "LangGraph overview"
url: "https://docs.langchain.com/oss/python/langgraph/overview"
source_type: official-docs
level: advanced
language: en
why_en: "The official Python guide to stateful graph workflows, durable execution, memory, interrupts, and human review."
why_zh: "有状态图工作流、持久执行、记忆、中断与人工审核的 Python 官方指南。"
reviewed_on: "2026-08-31"
status: active
requires_key: true
risk: medium
featured: false
- id: google-adk
path: ai-agents
title: "Google Agent Development Kit"
url: "https://adk.dev/"
source_type: official-docs
level: advanced
language: en
why_en: "Google's official documentation for developing, evaluating, and deploying modular agent systems."
why_zh: "Google 官方模块化 Agent 系统开发、评测与部署文档。"
reviewed_on: "2026-08-31"
status: active
requires_key: true
risk: medium
featured: false