Overview: The first release
@jorenham 已经在做这个了。
开始于 2025年2月4日。
评估
这个 Issue 还没有评估数据。
描述
Once the first NumType version is ready, it will support numpy==2.2.* release (probably 2.2.3), and will be compatible with at least Python 3.10.
This is what needs to happen before that:
Initial project layout
- stubs (based on
numpy/**/*.pyi) - static rejection tests (based on
numpy/typing/tests/data/fail/*.pyi) - static acceptance tests (based on
numpy/typing/tests/data/{misc,reveal}/*.pyi) - runtime acceptance tests (based on
numpy/typing/tests/data/pass/*.py) - fancy logo
- github labels
- github issue template
-
CONTRIBUTING.md -
README.md(badges, installing, motivation, (non-)goals, roadmap, type-checker support, differences with numpy)
Tooling setup
-
uv+hatch - dependabot
- CI workflow (enable everything, but allow errors where needed)
- release workflow
- enable trusted publishing on PyPI
-
ruff(minimal ignores, maximal selected rules, and hierarchically extend when needed) -
libcst(for bulk codemodding, can probably be removed later) -
basedpyright(at leastmode="strict") -
basedmypy-
mypy-compatible config - figure out why it's ignoring
numpy-stubswhen running it locally, and/or work around it (it works whennumtypeis installed from github) - https://github.com/numpy/numtype/pull/18
-
-
pytest(for runtime acceptance tests) -
typos -
markdownlint -
pre-commit -
tox
Static analysis
-
ruff- fix the >2000 errors, by writing codemods or by hand
-
ruff format(everything) -
ruff check(everything) - enforce in CI
-
basedpyright- valid
/src/numpy-stubs/ - valid
/test/static/ - valid
/test/runtime/ - valid
/tool/
- valid
-
basedmypy- valid
/src/numpy-stubs/ - valid
/test/static/ - valid
/test/runtime/ - valid
/tool/
- valid
-
stubtest- generate the allowlist (requires
mypyto pass) - fix
the low-hanging fruiteverything (exceptdistutils)
- generate the allowlist (requires
-
pytestpasses
- 主要语言
- Python
- 星标
- 79
- 派生
- 8
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
numpy/numtype 的其他 Issue
-
topic: documentation
难度 2/5 1-3 小时 新手友好度 68/100
-
topic: documentation
难度 4/5 3-5 天 新手友好度 35/100
-
long pyright analysis times可能重新可做 @jorenham 于 415 天前认领,目前没有进行中的 PR。 未关闭blame: Pyright tool: basedpyright
-
numpy.generic stubs: Incomplete
难度 3/5 1-2 天 新手友好度 35/100
-
_numtype stubs: Refactor
难度 3/5 1-2 天 新手友好度 45/100
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 76/100
PedestrianDynamics/pyFDS-Evac#199 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 65/100
521xueweihan/HelloGitHub#3790 ·
-
难度 2/5 1-3 小时 新手友好度 78/100
sandialabs/atlas-ui-3#978 ·
维护者通常 1 天内回复
-
area: tests perceived difficulty: 2
难度 2/5 1-3 小时 新手友好度 72/100
Nitjsefnie-Harness-Commons/daedalus#1255 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 86/100
EleutherAI/lm-evaluation-harness#4256 ·
维护者通常 1 天内回复