Contributing docs: local test runs silently skip SpatiaLite and ext.c tests, and the setup steps assume SSH and uv
维护者通常 3 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 84/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- python, sqlite
- 领域
- documentation, testing
调研方向
阅读 docs/contributing.rst 和 .github/workflows/test.yml，使贡献者的环境设置与 CI 环境保持一致。更新通过 HTTPS 克隆 fork 的说明，添加 uv 安装说明的链接，并使用 issue 中的命令记录 SpatiaLite 和 ext.c 测试的本地设置方法。完成标准是页面解释了这些前置条件，并且贡献者能够判断为什么这些测试在本地可能会被跳过。
由索引模型根据 Issue 内容生成。
描述
Following docs/contributing.rst on a fresh macOS machine, I hit three gaps:
-
The clone command uses SSH (
git clone [email protected]:simonw/sqlite-utils). It worked for me because I already have an SSH key on GitHub, but it fails withPermission denied (publickey)for anyone without one, and contributors usually need to clone their fork rather than the main repository. -
Every command uses
uv run, but the page does not say uv must be installed or link to its install instructions. -
uv run pytestpasses locally while skipping tests that CI runs. On my machine: 1,494 passed, 19 skipped.pytest -rsshows 12 skips intests/test_gis.py("Could not find SpatiaLite extension") and 3 intests/test_cli.py("Requires compiled ext.c"). CI installslibsqlite3-mod-spatialiteand compilesext.cin.github/workflows/test.yml, but the contributing page mentions neither, so a contributor changing GIS code can get a green local run and a red CI run.
Environment: macOS 26.2, Python 3.11.5, uv 0.13.7, sqlite-utils main at 9c66baf.
Proposed fix, in docs/contributing.rst: clone your fork over HTTPS, link https://docs.astral.sh/uv/getting-started/installation/, and add a "Tests that skip locally" section with brew install spatialite-tools (macOS) or apt-get install libsqlite3-mod-spatialite (Ubuntu) and cd tests && gcc ext.c -fPIC -shared -o ext.so.
Related: #900 (docs build command) and #872 (CI legs that never run a pandas test). Happy to open a PR for this.
- 主要语言
- Python
- 星标
- 2.2k
- 派生
- 215
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
simonw/sqlite-utils 的其他 Issue
-
Tests use CliRunner.isolated_filesystem(), which is deprecated and will be removed in Click 9.0可能已有人在做 @devpryan7792 于 11 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 78/100
simonw/sqlite-utils#916 ·
维护者通常 3 天内回复
-
rows_from_file() splits a single-column CSV file on a letter, or raises csv.Error可能已有人在做 @L4XB 于 19 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 84/100
simonw/sqlite-utils#907 ·
维护者通常 3 天内回复
-
enable_fts() exhausts iterator columns before populating the index可能已有人在做 @syahra712 于 25 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 83/100
simonw/sqlite-utils#902 ·
维护者通常 3 天内回复
-
rows_from_file() ignores ignore_extras= and extras_key= for anything that isn't Format.CSV可能已有人在做 @feiiiiii5 于 36 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 88/100
simonw/sqlite-utils#892 ·
维护者通常 3 天内回复
-
Raw numpy scalar values get silently stored as corrupted BLOBs instead of being converted可能已有人在做 @TanbirRamim 于 43 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 75/100
simonw/sqlite-utils#876 ·
维护者通常 3 天内回复
查看 simonw/sqlite-utils 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 78/100
fritzprix/libr-agent#2612 ·
维护者通常 1 天内回复
-
needs-triage presubmit-gate
难度 2/5 1-3 小时 新手友好度 76/100
gke-labs/kube-agents#5001 ·
维护者通常 1 天内回复
-
colorado
难度 2/5 1-3 小时 新手友好度 72/100
freelawproject/juriscraper#2405 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 66/100
cline/mcp-marketplace#3576 ·
-
难度 1/5 1 小时以内 新手友好度 90/100
griptape-ai/griptape-nodes-library-elevenlabs#30 ·
维护者通常 1 天内回复