python / python/cpython

ambiguous _max_size parameter in SpooledTemporaryFile

未关闭
#78,627 4 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

3.7 (EOL) 3.8 (EOL) 3.9 (EOL) docs stdlib type-bug
主要语言
Python
星标
77.2k
派生
36k
平均合并
1 天 9 小时
30 天内合并 PR
558

描述

BPO 34446
Nosy @brettcannon, @lurch

Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2018-08-20.19:47:35.501>
labels = ['type-bug', '3.8', '3.9', '3.7', 'library', 'docs']
title = 'ambiguous _max_size parameter in SpooledTemporaryFile'
updated_at = <Date 2019-07-07.15:58:26.019>
user = 'https://bugs.python.org/jcc2220'

bugs.python.org fields:

activity = <Date 2019-07-07.15:58:26.019>
actor = 'lurchman'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation', 'Library (Lib)']
creation = <Date 2018-08-20.19:47:35.501>
creator = 'jcc2220'
dependencies = []
files = []
hgrepos = []
issue_num = 34446
keywords = []
message_count = 4.0
messages = ['323809', '323845', '323850', '347475']
nosy_count = 4.0
nosy_names = ['brett.cannon', 'docs@python', 'lurchman', 'jcc2220']
pr_nums = []
priority = 'normal'
resolution = None
stage = None
status = 'open'
superseder = None
type = 'behavior'
url = 'https://bugs.python.org/issue34446'
versions = ['Python 2.7', 'Python 3.5', 'Python 3.6', 'Python 3.7', 'Python 3.8', 'Python 3.9']

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

从 tempfile.SpooledTemporaryFile 的文档条目开始,检查其中如何描述 _max_size 参数。明确该参数的含义和行为,使读者能够区分其用途;完成的标准是文档不再含糊不清。检查现有的文档构建或相关的库文档测试(如果有)。

由索引模型根据 Issue 内容生成。

评估

技术栈
python
领域
documentation
Issue 类型
文档
难度
2/5
预计耗时
1-3 小时
活跃度
停滞
描述清晰度
需要澄清
新手友好度
25/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。