Setup docs still say `python setup.py install`, but `setup.py` was removed

未关闭 适合新手
#718 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

@GreedyC 已经在做这个了。

开始于 2026年10月22日。

  • #719 来自 @GreedyC —— 未关闭

评估

难度
1/5
预计耗时
1-3 小时
新手友好度
93/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
python
领域
documentation

调研方向

更新 README.md、docs/index.md、docs/guide.md 和 docs/installation.md 中的安装命令,然后使用 pyproject.toml 中定义的 test extra 修正 CONTRIBUTING.md 中关于测试依赖项的说明。先对照 pyproject.toml 检查这些文件;当文档中的安装和测试命令与项目当前配置一致时,即为完成。

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

描述

Description

The instructions for installing Python Fire from source tell users to run python setup.py install (or python setup.py develop). setup.py was removed when the project moved to pyproject.toml, so following these instructions fails right away. CONTRIBUTING.md also says the test dependencies are "listed in setup.py" and names mock, which is no longer a dependency (the tests use unittest.mock from the standard library).

Files needing change

File Line Current text
README.md 25 python setup.py install
docs/index.md 25 python setup.py install
docs/guide.md 19 python setup.py install
docs/installation.md 8 python setup.py install ... python setup.py develop
CONTRIBUTING.md 51 "install the test dependencies listed in setup.py (e.g. pytest, mock, termcolor, and hypothesis)"

Suggested fix

Replace the old commands with their pip equivalents, which I verified locally in a fresh virtual environment:

  • Install from source: pip install .
  • Install for development: pip install -e .
  • Install with test dependencies: pip install -e ".[test]" (the test extra in pyproject.toml), then run pytest

Suggested wording for CONTRIBUTING.md line 51:

To do this, first install the test dependencies with pip install -e ".[test]" (they are listed under [project.optional-dependencies] in pyproject.toml). Then run the tests by running pytest in the root directory of the repository.

Following these instructions, pip install -e ".[test]" followed by python -m pytest installs and runs the full test suite (273 tests collected).

主要语言
Python
星标
28.2k
派生
1.5k
PR 合并指标
30 天内没有已合并 PR

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

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

google/python-fire 的其他 Issue

查看 google/python-fire 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

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