公开记录中等
软件健康报告模式 0.27.0 · 指标 1.13.0 · 2026-07-28 10:16 UTC
Geocodio / geocodio-library-python
geocod.io Python library
Geocodio/geocodio-library-python 的健康指数为 100 分中的 57 分，处于「中等」区间。 其得分最高的类别是Vitality（72/100），最低的是Community & Adoption（39/100）。 最近一次更新在 11 天前。 近期的大部分工作由 1 位贡献者完成。
57
总分 / 100软件健康指数
指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 49（有风险）的上限。AI 就绪度不计入总体分。
57
优秀85-100堪称典范；基本满足所有检验标准
良好70-84健康；仅有轻微不足
中等50-69可接受，但存在明显不足；建议进行审查
存在风险30-49存在重大薄弱环节；采用时应保持审慎
危急1-29问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）
评分画像
每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。
所有权
软件包生态系统
| 注册表 | 软件包 | 版本 | 月下载量 | 版本数 | 最近发布 |
|---|---|---|---|---|---|
| PyPI | geocodio-library-python | 1.0.0 | 4,632 | 8 | 52 天前 |
按类别列示的指标
活力
项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？
72
开发活跃度
54中等
评分方式
| 28.8/36 | 推送新近度 — 最近一次推送于 11 天前 |
| 6.2/36 | 提交节奏 — 52 周中有 9 周有提交 |
| 14.9/18 | 提交量 — 最近一年 45 次提交 |
| 4/10 | OpenSSF Scorecard：Maintained — 5 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 4 |
所用输入
| commits_last_year | 45 |
| human_commit_share | 1 |
| days_since_last_push | 11 |
| active_weeks_last_year | 9 |
发布纪律
100优秀
评分方式
| 27/27 | 有发布版本 — 已发布 11 个发布版本 |
| 36/36 | 发布时效 — 最近一次发布版本于 11 天前 |
| 27/27 | 发布节奏 — 约每 38 天发布一次 |
| 0/10 | OpenSSF Scorecard：Signed-Releases — 无数据 |
所用输入
| releases_count | 11 |
| latest_release_tag | v1.2.0 |
| releases_from_tags | 否 |
| days_since_latest_release | 11 |
| mean_days_between_releases | 38 |
已排除计分（无数据或不适用）：OpenSSF Scorecard：Signed-Releases。 其余权重已重新归一化。
社区与采用
项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？
39
流行度与采用
15危急
评分方式
| 7.7/60 | 星标 — 4 个星标 |
| 5/25 | 复刻 — 5 个复刻 |
| 2.7/15 | 关注者 — 4 位关注者 |
所用输入
| forks | 5 |
| stars | 4 |
| watchers | 4 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
社区健康
50中等
评分方式
| 22.5/22.5 | README |
| 22.5/22.5 | 许可证 — 可识别的许可证（MIT） |
| 0/18 | CONTRIBUTING 指南 |
| 0/13.5 | 行为准则 |
| 0/7.2 | 议题模板 |
| 0/6.3 | PR 模板 |
所用输入
| has_readme | 是 |
| has_license | 是 |
| has_contributing | 否 |
| has_issue_template | 否 |
| has_code_of_conduct | 否 |
| has_pull_request_template | 否 |
生态采用（下载量）
61中等
评分方式
| 48.9/80 | 月度下载量 — pypi 合计每月 4,632 次下载 |
| 0/20 | 注册表被依赖数 — 该生态系统不报告此项 |
所用输入
| packages | geocodio-library-python |
| dependents | — |
| ecosystems | pypi |
| total_downloads | — |
| monthly_downloads | 4,632 |
已排除计分（无数据或不适用）：注册表被依赖数。 其余权重已重新归一化。
可持续性与治理
项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？
65
维护者韧性（巴士系数）
33存在风险
评分方式
| 9/54 | 巴士系数 — 1 位贡献者贡献了半数提交 |
| 8.9/22.5 | 提交分布 — 头号贡献者编写了 60% 的提交 |
| 5.4/13.5 | 贡献者广度 — 4 位贡献者 |
| 10/10 | OpenSSF Scorecard：Contributors — project has 5 contributing companies or organizations |
所用输入
| bus_factor | 1 |
| contributors_sampled | 4 |
| top_contributor_share | 0.605 |
议题与 PR 响应能力
78良好
评分方式
| 46.8/46.8 | 议题解决 — 100% 的议题已关闭 |
| 29.6/38.3 | PR 接受 — 已裁定的 PR 中 17/22 已合并 |
| 1.5/15 | OpenSSF Scorecard：Code-Review — Found 4/21 approved changesets -- score normalized to 1 |
所用输入
| merged_prs | 17 |
| open_issues | 0 |
| closed_issues | 7 |
| issue_closed_ratio | 1 |
| closed_unmerged_prs | 5 |
所有权与托管责任
61中等
评分方式
| 30/30 | 所有权背书 — 组织持有 |
| 0/20 | 已验证域名 |
| 7.5/25 | 所有者影响力 — Geocodio 有 10 位关注者 |
| 23.3/25 | 既往记录 — 35 个公开仓库，账户约 12 年 |
所用输入
| followers | 10 |
| owner_type | Organization |
| is_verified | — |
| owner_login | Geocodio |
| public_repos | 35 |
| account_age_days | 4,551 |
软件包维护
100优秀
评分方式
| 25/25 | 已发布且可解析 — pypi 上有 1 个软件包 |
| 35/35 | 发布时效 — 最近一次发布于 52 天前 |
| 20/20 | 版本历史 — 8 个已发布版本 |
| 20/20 | 未被弃用 — 活跃，未被弃用或撤回 |
所用输入
| packages | geocodio-library-python |
| ecosystems | pypi |
| any_deprecated | 否 |
| min_days_since_publish | 52 |
工程质量
基础的工程与文档实践是否到位？
54
工程实践
64中等
评分方式
| 24/24 | CI 工作流 — 2 个工作流 |
| 24/24 | 存在测试 |
| 0/16 | Linter 配置 |
| 0/9.6 | Pre-commit 钩子 |
| 0/6.4 | .editorconfig |
| 16/20 | OpenSSF Scorecard：CI-Tests — 7 out of 8 merged PRs checked by a CI test -- score normalized to 8 |
所用输入
| has_ci | 是 |
| has_tests | 是 |
| has_editorconfig | 否 |
| has_linter_config | 否 |
| has_precommit_config | 否 |
文档
40存在风险
评分方式
| 30/30 | README |
| 0/25 | 文档目录 |
| 0/15 | 文档 / 主页站点 |
| 10/10 | 仓库描述 |
| 0/10 | 主题标签 |
| 0/10 | Wiki |
所用输入
| topics | — |
| has_wiki | 否 |
| homepage | — |
| has_readme | 是 |
| has_docs_dir | 否 |
| has_description | 是 |
安全
可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？
46
安全态势
33存在风险
评分方式
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 0/7.5 | Branch-Protection — branch protection not enabled on development/release branches |
| 2/2.5 | CI-Tests — 7 out of 8 merged PRs checked by a CI test -- score normalized to 8 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0.8/7.5 | Code-Review — Found 4/21 approved changesets -- score normalized to 1 |
| 2.5/2.5 | Contributors — project has 5 contributing companies or organizations |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | 许可证 — license file detected |
| 3/7.5 | Maintained — 5 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 4 |
| 0/5 | Packaging — 无数据 |
| 0/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
| 0/5 | SAST — SAST tool is not run on all commits -- score normalized to 0 |
| 0/5 | Security-Policy — security policy file not detected |
| 0/7.5 | Signed-Releases — 无数据 |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 2.2/7.5 | Vulnerabilities — 7 existing vulnerabilities detected |
所用输入
| source | openssf_scorecard |
| checks_evaluated | 16 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 2 |
| scorecard_aggregate | 3.3 |
已排除计分（无数据或不适用）：packaging, signed_releases。 其余权重已重新归一化。
依赖安全公告
100优秀
评分方式
| 35/35 | 直接依赖不含已知公告 — 没有直接依赖携带已知公告 |
| 25/25 | 间接依赖不含已知公告 — 没有间接依赖携带已知公告 |
| 0/40 | 没有长期未处理的公告 — 没有公告带有发布日期 |
所用输入
| source | osv |
| advisories | 0 |
| affected_packages | 0 |
| assessed_packages | 6 |
| unassessed_packages | 0 |
| affected_by_severity | none |
| direct_affected_packages | 0 |
已排除计分（无数据或不适用）：没有长期未处理的公告。 其余权重已重新归一化。 比对的是 pypi:geocodio-library-python@1.0.0 的运行时依赖闭包——安装已发布的软件包时真正被拉取进来的内容——共 6 个软件包。 未对可达性进行分析。
AI 就绪度
该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？这是一枚独立的实验性徽章——权重为 0.0，因此单独呈现，不影响总体健康评分。
44
AI 代理上下文与指引
40存在风险
评分方式
| 0/45 | 代理指令 — 没有 CLAUDE.md / AGENTS.md / 编辑器规则 |
| 0/15 | 机器可读文档（llms.txt） |
| 40/40 | 可读的提交历史 — 100 次人类提交中有 87 次说明了意图（结构化标题或解释性正文） |
所用输入
| has_llms_txt | 否 |
| legible_history_share | 0.87 |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
验证循环（构建 / 测试 / 类型检查）
42存在风险
评分方式
| 0/18 | 一条命令的引导启动 |
| 22/22 | 自动化测试 |
| 0/11 | Lint / 格式化配置 |
| 0/11 | 静态类型检查 |
| 10/10 | 可复现环境 — lockfile |
| 10/10 | 已体现的代理实践 — 最近 100 次提交中有 6 次由代理编写或署名代理 |
| 0/8 | 自动化维护 — 未观察到自动依赖更新 |
| 0/10 | OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
所用输入
| has_nix | 否 |
| has_tests | 是 |
| lockfiles | uv.lock |
| has_dockerfile | 否 |
| typed_language | 否 |
| bootstrap_files | — |
| has_devcontainer | 否 |
| has_linter_config | 否 |
| typecheck_configs | — |
| agent_commit_share | 0.06 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
面向模型的代码可读性
55中等
评分方式
| 0/45 | 可类型检查的代码 — Python，未配置类型检查 |
| 55/55 | 可控的文件大小 — 采样的 26 个源文件中有 0 个超过 60KB |
所用输入
| primary_language | Python |
| largest_source_bytes | 54,413 |
| source_files_sampled | 26 |
| oversized_source_files | 0 |
关键数据
4GitHub 星标
4贡献者
45最近 12 个月提交数
11距最近推送天数
11发布版本数
1巴士系数（bus factor）
0开放议题
PyPI软件包生态系统数
数据采集警告
- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
更多细节
Star 与 Fork 历史 0 ★ / 5 ⇿
0Star
5Fork
8发布
每颗 star 和每个 fork 的添加时间，来自 GitHub 并按天汇总。累计增长位于其构成来源——每日新增——的正上方，二者可相互对照：稳定的自然增长与短暂的突增形态截然不同。当这一差别可被衡量时，它会作为增长真实性予以报告。
主版本 1次版本 6修订 1
OpenSSF Scorecard 3.3 / 10
3.3综合
来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身，而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用，并从安全评分中剔除（绝不按零分计）。
| 10 | Binary-Artifacts | no binaries found in the repo |
| 0 | Branch-Protection | branch protection not enabled on development/release branches |
| 8 | CI-Tests | 7 out of 8 merged PRs checked by a CI test -- score normalized to 8 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 1 | Code-Review | Found 4/21 approved changesets -- score normalized to 1 |
| 10 | Contributors | project has 5 contributing companies or organizations |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 4 | Maintained | 5 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 4 |
| 不适用 | Packaging | packaging workflow not detected |
| 0 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 0 |
| 0 | SAST | SAST tool is not run on all commits -- score normalized to 0 |
| 0 | Security-Policy | security policy file not detected |
| 不适用 | Signed-Releases | no releases found |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 3 | Vulnerabilities | 7 existing vulnerabilities detected |
直接依赖 1
| 注册表 | 软件包 | 版本约束 | 清单文件 |
|---|---|---|---|
| PyPI | httpx | >=0.24.0 | pyproject.toml |
全部依赖 未采集
本报告未能采集到解析后的依赖集合：GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
依赖安全公告 0
安装 pypi:geocodio-library-python@1.0.0 会引入 6 个包（直接与传递）：其中 0 个存在已知公告，0 个为直接依赖。
没有已知公告影响已评估的依赖。
公告表示依赖图中记录的版本落入某条公告的受影响范围。可达性未经分析，且依赖图包含开发与测试的版本固定——某项发现可能只涉及工具链而非交付的软件。
原始 JSON 报告 机器可读
{
"data": {
"repo": {
"topics": [],
"is_fork": false,
"size_kb": 500,
"has_wiki": false,
"homepage": null,
"languages": {
"Python": 259499
},
"pushed_at": "2026-07-16T10:43:29Z",
"created_at": "2025-04-14T08:37:53Z",
"owner_type": "Organization",
"updated_at": "2026-07-16T10:43:00Z",
"description": "geocod.io Python library",
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "main",
"license_spdx_raw": "MIT",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": "https://www.geocod.io",
"name": null,
"type": "Organization",
"login": "Geocodio",
"company": null,
"location": "Arlington, VA",
"followers": 10,
"avatar_url": "https://avatars.githubusercontent.com/u/6632163?v=4",
"created_at": "2014-02-09T17:38:46Z",
"is_verified": null,
"public_repos": 35,
"account_age_days": 4551
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v1.2.0",
"kind": "minor",
"published_at": "2026-07-16T10:43:29Z"
},
{
"tag": "v1.1.0",
"kind": "minor",
"published_at": "2026-07-14T14:28:19Z"
},
{
"tag": "v1.0.0",
"kind": "major",
"published_at": "2026-06-05T14:51:55Z"
},
{
"tag": "v0.7.0",
"kind": "minor",
"published_at": "2026-03-12T12:10:33Z"
},
{
"tag": "v0.6.0",
"kind": "minor",
"published_at": "2026-02-24T17:02:01Z"
},
{
"tag": "v0.5.1",
"kind": "patch",
"published_at": "2026-02-18T11:04:45Z"
},
{
"tag": "v0.5.0",
"kind": "minor",
"published_at": "2026-01-06T11:11:33Z"
},
{
"tag": "v0.4.0",
"kind": "minor",
"published_at": "2025-11-19T16:24:23Z"
},
{
"tag": "v0.3.0",
"kind": "minor",
"published_at": "2025-10-24T09:21:37Z"
},
{
"tag": "v0.2.0",
"kind": "minor",
"published_at": "2025-08-08T16:02:19Z"
},
{
"tag": "v0.1.0",
"kind": "minor",
"published_at": "2025-08-08T14:26:45Z"
}
],
"recent_commits": [
{
"oid": "6b4738f17888c690d64126c83f22683870fa0c81",
"body": "Expose stable address keys on geocoding results",
"is_bot": false,
"headline": "Merge pull request #29 from Geocodio/fix-25",
"author_name": "Liam Hammett",
"author_login": "imliam",
"committed_at": "2026-07-16T10:42:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6cf673e143d692f26d2af0d6ca4dbf41897a623f",
"body": null,
"is_bot": false,
"headline": "Expose stable address keys on geocoding results",
"author_name": "Liam Hammett",
"author_login": "imliam",
"committed_at": "2026-07-14T15:49:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bdb8dc3ea41a70b3566ecdb2b820a1aa707b8d59",
"body": "Keep unmatched addresses in batch geocoding responses",
"is_bot": false,
"headline": "Merge pull request #28 from Geocodio/fix-24",
"author_name": "Liam Hammett",
"author_login": "imliam",
"committed_at": "2026-07-14T14:25:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3ae19ff82632f27073cba94a8e23ad3efbaf87a6",
"body": null,
"is_bot": false,
"headline": "Keep unmatched addresses in batch geocoding responses",
"author_name": "Liam Hammett",
"author_login": "imliam",
"committed_at": "2026-07-14T13:56:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4f04d1578bb87db2a536e35cdd6bfaafbd0e089c",
"body": "* Migrate to Geocodio API v2\n\nBreaking change: migrate the client to the Geocodio v2 API.\n\n- Bump base URL version prefix from v1.x to v2 (BASE_PATH = \"/v2\").\n- Remove the top-level `input` object from /geocode and /reverse response\n parsing. GeocodingResponse.input has been removed; parsed address\n[…]\nr float\n\nAPI returns proportion as int (1) for whole-district representation;\ntest asserted float only. Accept (int, float). Same pre-existing\ntype-assertion class as district_number, unrelated to v2.",
"is_bot": false,
"headline": "Migrate to Geocodio API v2 (#23)",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2026-06-05T14:48:14Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ec82fa2f6f26b74793969f356474dcd579543b31",
"body": null,
"is_bot": false,
"headline": "Accept int or float for district proportion in e2e tests",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2026-03-12T12:08:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4db343f5b1428457b6d952341fe184196dfaf85d",
"body": null,
"is_bot": false,
"headline": "Use Any type for district_number to accept whatever the API returns",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2026-03-12T12:07:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0cfe58590ac8f89b0548dd32b7bf16667f022896",
"body": null,
"is_bot": false,
"headline": "Bump default API version to v1.11",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2026-03-12T11:57:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dcdf0bf438c684fcfac65f86796bae9fe3613992",
"body": "Update log messages in smoke_lists.py from v1.9 to v1.10.",
"is_bot": false,
"headline": "feat: [US-007] - Update documentation to reference API v1.10",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2026-02-24T17:02:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "155f4c1508c9863bbeab6b3c6c38810c1680e407",
"body": null,
"is_bot": false,
"headline": "feat: [US-006] Update geocodio-library-python to API v1.10",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2026-02-24T16:59:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "12c4823ef1b718b594fbe5724c41b7fe2f1aea7f",
"body": null,
"is_bot": false,
"headline": "chore: prepare release v0.5.1",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2026-02-18T11:04:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1e7d7ab7518a2b557bdccb3e849789243c48b566",
"body": "The API now returns state_legislative_districts as a dict with\nhouse/senate keys containing legislator info, but the parser only\nchecked for the \"stateleg\" key and expected a flat list. This caused\nall stateleg data to silently land in extras as None.\n\nAdd _parse_stateleg helper that handles both the new dict format\nand legacy flat list format, and check for both \"stateleg\" and\n\"state_legislative_districts\" response keys.",
"is_bot": false,
"headline": "fix(parser): handle new state legislative district response structure",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2026-02-18T10:59:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "94629c1a40b843fa6f41f0599f69e42e43f615ac",
"body": null,
"is_bot": false,
"headline": "fix: update version in pyproject.toml to 0.5.0",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2026-01-06T11:08:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3979c7f249c2254488b8129c8459e55488ebd36c",
"body": "* feat(distance): add Distance API support\n\nAdd full Distance API support matching the PHP SDK implementation:\n\n- Add Coordinate class for flexible coordinate input formats (string, tuple, dict)\n- Add distance() method for single origin to multiple destinations (GET)\n- Add distance_matrix() method f\n[…]\n): remove unused f-string prefixes\n\n* chore: prepare release v0.5.0\n\n- Bump version to 0.5.0\n- Update CHANGELOG with Distance API features\n\n---------\n\nCo-authored-by: Mathias Hansen <me@codemonkey.io>",
"is_bot": false,
"headline": "feat(distance): add Distance API support (#21)",
"author_name": "Sylvester Damgaard",
"author_login": "sylvesterdamgaard",
"committed_at": "2026-01-06T10:56:16Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "939c0beb662e3d4fb9592fc6f97a2ba9e4d35c7d",
"body": "fix(parser): support nested field structures with backward compatibility",
"is_bot": false,
"headline": "Merge pull request #18 from Geocodio/fix/nested-field-parsing",
"author_name": "Sylvester Damgaard",
"author_login": "sylvesterdamgaard",
"committed_at": "2025-11-19T16:23:41Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ee94771ce92095d40223b4792588ed27206c1d0c",
"body": "The test was checking for non-existent fields:\n- zip4.zip4 → zip4.plus4\n- zip4.delivery_point → zip4.city_delivery\n\nAlso added validation for zip9 and valid_delivery_area fields\nto match the actual API response structure.\n\nVerified with real API - test now passes.",
"is_bot": false,
"headline": "fix(tests): correct ZIP4Data field names in E2E test",
"author_name": "Sylvester Damgaard",
"author_login": "sylvesterdamgaard",
"committed_at": "2025-11-19T13:47:56Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "af65377750419f640ab5bed192d13ab9d2cad182",
"body": "API changed response format from flat to nested structure for several fields:\n- Census: census2010: {...} → census: {2010: {...}}\n- ACS: acs-demographics: {...} → acs: {demographics: {...}}\n- School districts: school: [...] → school_districts: {elementary: {...}}\n\nAdditionally, census field names ch\n[…]\n\n- census2031+ years work automatically without code changes\n- cd120+ congressional districts work automatically\n- Unknown API fields captured in extras dict\n\nFixes #15\nFixes #16\nCloses #14\nCloses #17",
"is_bot": false,
"headline": "fix(parser): support nested field structures with backward compatibility",
"author_name": "Sylvester Damgaard",
"author_login": "sylvesterdamgaard",
"committed_at": "2025-11-19T13:37:50Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "a71fbbb79b8965e274850a5c2f3831f2dccceb57",
"body": null,
"is_bot": false,
"headline": "chore: bump version to 0.3.0",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-10-24T09:04:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8b74f92e1c3456db15c775dfbb0e5ffd28ec3fdb",
"body": "Fix: Census field appends not included in response",
"is_bot": false,
"headline": "Merge pull request #13 from Geocodio/fix/census-field-appends-issue-12",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-10-24T08:59:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0eb5dcc064aa6a1f61339d689f5b82813a815995",
"body": "Replace hardcoded census year parsing (census2010, census2020, census2023)\nwith dynamic detection and parsing of any census field returned by the API.\n\nChanges:\n- Modified _parse_fields() to automatically detect and parse any field\n matching the pattern \"census\" + digits (e.g., census2024, census20\n[…]\nre-proof: new census years only require adding a field definition\n to GeocodioFields, no changes needed to parsing logic\n- Maintains backwards compatibility with all existing census fields\n\nFixes #12",
"is_bot": false,
"headline": "fix: dynamically parse all census field appends",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-10-23T13:51:21Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "0a06fca1700963e64d5ecde438477b709bfbcced",
"body": "Add test case to verify that all census year fields (census2010,\ncensus2020, census2023, census2024) are properly parsed and included\nin the response.\n\nThis test currently demonstrates the bug where census2024 and other\nyears beyond 2023 are not being parsed even though the API returns\nthem.\n\nRelates to #12",
"is_bot": false,
"headline": "test: add test for census field appends",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-10-23T13:50:53Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e33e911e9aca3fe9e89661c303bb73f42edda82e",
"body": "- Bump version to 0.2.0\n- Update CHANGELOG with breaking change notes\n- Document migration guide for GeocodioClient to Geocodio rename",
"is_bot": false,
"headline": "chore: prepare release v0.2.0",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T16:01:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e2a981f93f88e21a8171875b2f1e5b8db7504d30",
"body": "refactor!: Rename GeocodioClient to Geocodio",
"is_bot": false,
"headline": "Merge pull request #11 from Geocodio/refactor/rename-client-to-geocodio",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T15:59:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4ca2d4b09745b0d7c138bcbe1fd1c0d5baa8ec63",
"body": "Update all code examples and documentation in README to reflect the renamed class.",
"is_bot": false,
"headline": "docs: update README examples to use Geocodio class name",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T15:56:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0835d0b524bce75643c8cead0d8bdf48646b6420",
"body": "Update all test files and smoke tests to import and use the new Geocodio class name instead of GeocodioClient.",
"is_bot": false,
"headline": "test: update tests to use renamed Geocodio class",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T15:56:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "559a88c8369f2d2aafa23b9067c1fc8eb1c545f5",
"body": "BREAKING CHANGE: The main client class has been renamed from GeocodioClient to Geocodio for simplicity and consistency with other SDKs.\n\nMigration guide:\n- Change imports from `from geocodio import GeocodioClient` to `from geocodio import Geocodio`\n- Update instantiation from `client = GeocodioClient(...)` to `client = Geocodio(...)`",
"is_bot": false,
"headline": "refactor\\!: rename GeocodioClient to Geocodio",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T15:56:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4713a68ccae569086e42cc349733d67b6caf9a65",
"body": null,
"is_bot": false,
"headline": "docs: Moved development installation to the bottom of the README",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T14:34:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "534f12dee14447192e07e5d892ab705cd9d7fa94",
"body": "Resolved flake8 W292 warning by ensuring the file ends with a newline character.",
"is_bot": false,
"headline": "fix: add missing newline at end of _version.py file",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T14:32:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c563d04ad4cf0e034181ccdf9d3f2bf65b39ea8e",
"body": null,
"is_bot": false,
"headline": "chore: prepare release v0.1.0",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T14:25:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "81a0aed95c4d4879b7b8b2c3789d3073f58d042f",
"body": "feat: Add user-agent header to all API requests",
"is_bot": false,
"headline": "Merge pull request #10 from Geocodio/feat/add-user-agent-header",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T14:19:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bb185aed695f176fe6686765491a0cab75eab47e",
"body": "- Create centralized version management in _version.py\n- Add USER_AGENT constant with format 'geocodio-library-python/{version}'\n- Include User-Agent header in all HTTP requests via _request() method\n- Add comprehensive test coverage for user-agent header verification",
"is_bot": false,
"headline": "feat(client): add user-agent header to all API requests",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T14:11:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cb1433a524a23aec4c0c422b603440c9bf0a10be",
"body": "refactor: use Authorization header for API authentication",
"is_bot": false,
"headline": "Merge pull request #9 from Geocodio/refactor/auth-header-authentication",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T14:06:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4a1ca43ae2335908c26d18a276c99a3f153ab95c",
"body": "Update all test mocks to match the new authentication implementation\nusing Authorization headers instead of query parameters.\n\n- Update httpx_mock fixtures to use match_headers with Bearer token\n- Remove api_key from query parameter expectations in all test files\n- Ensure all error mapping and geocoding tests pass with new auth format",
"is_bot": false,
"headline": "test: update mocks to expect Authorization header",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T14:04:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c2f16d2b591affffb730bf3de30c7819d88f971f",
"body": "…API key\n\nMigrate API key authentication from query parameters to Authorization header\nfollowing security best practices and Geocodio API documentation recommendations.\nThis reduces code duplication by centralizing auth header injection in the\n_request method.\n\n- Add Authorization header with Bearer\n[…]\nemove redundant api_key parameter initialization from all API methods\n- Make params parameter optional in _request method (defaults to empty dict)\n- Remove TODO comment about repeated API key handling",
"is_bot": false,
"headline": "refactor(auth): use Authorization header instead of query params for …",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T14:03:54Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "57c4ae5678baa90da8f620a0ab1cccd85d27d068",
"body": "Add documentation showing how to use the library with Geocodio Enterprise\nby passing api.enterprise.geocod.io as the hostname parameter.",
"is_bot": false,
"headline": "docs: add Geocodio Enterprise usage section to README",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T14:01:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9fbbe6ced8ae0d5e5f9f8a309dca9b74757520b9",
"body": "feat: Update to Geocodio API v1.9",
"is_bot": false,
"headline": "Merge pull request #8 from Geocodio/feat/update-api-v1.9",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T13:56:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fffd2847ff6a2de23ef0562be7fab8144ccb9c96",
"body": "- Update API base path from v1.8 to v1.9 in client\n- Update all test URLs to use v1.9 endpoints\n- Update smoke test logging to reflect v1.9",
"is_bot": false,
"headline": "feat: update to Geocodio API v1.9",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T13:53:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3bf342e8c145769e4ff1cf58dcb6bc2f85c42a82",
"body": "feat(client): add configurable timeout support for all API operations",
"is_bot": false,
"headline": "Merge pull request #7 from Geocodio/feat/configurable-timeouts",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T13:41:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "60e0305e9e1b82e1ef239b1a8bd04baa75711b77",
"body": null,
"is_bot": false,
"headline": "Merge branch 'main' into feat/configurable-timeouts",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T13:41:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "74d7ee4da91671169e86bccc82ff816268cc0adf",
"body": "Fix batch reverse geocoding coordinate format",
"is_bot": false,
"headline": "Merge pull request #6 from Geocodio/fix/batch-reverse-geocoding",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T13:39:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b54a08b6fd7a1627edb46119fa8281bc63b3bcce",
"body": "- Add configurable timeouts for single, batch, and list API operations\n- Default timeouts: 5s (single), 30min (batch), 60s (list API)\n- Users can override defaults via GeocodioClient constructor\n- Pass appropriate timeout from each method to _request()",
"is_bot": false,
"headline": "feat(client): add configurable timeout support for all API operations",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T13:05:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "979fc6f10067e019daed424b18c96b3f72f9d774",
"body": "Increased the HTTP request timeout from 30 to 60 seconds to handle\nDELETE operations on the lists API that can take longer for large lists.\nThis resolves the ReadTimeout errors occurring in the GitHub Actions CI.",
"is_bot": false,
"headline": "fix(client): increase HTTP timeout to prevent test failures",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T12:53:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c05f6c5b87e6056181c804dad06b5c763f1db0d1",
"body": "The library was sending coordinates in incorrect format for batch reverse\ngeocoding operations, causing API errors. Coordinates are now properly\nconverted to strings before sending to the API.\n\n- Convert tuple coordinates to comma-separated strings\n- Send coordinates as plain array instead of wrapped object\n- Support mixed input formats (tuples and strings)",
"is_bot": false,
"headline": "fix(reverse): fix batch reverse geocoding coordinate format",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T12:19:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "31a3abc1fd8d2720864d93d0d16eecca6d4776c8",
"body": "Corrected the import statements for exception classes to properly\nimport from geocodio.exceptions module instead of the main geocodio\nmodule. This ensures the code examples work correctly.",
"is_bot": false,
"headline": "docs: fix error handling import statements in README",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T12:18:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1c6c6c2cfb88ff643c03c22d58269d10b213b4d5",
"body": null,
"is_bot": false,
"headline": "fix: Update license",
"author_name": "Mathias Hansen",
"author_login": "MiniCodeMonkey",
"committed_at": "2025-08-08T11:50:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7662863062283167eafc4169cff6d9033904079f",
"body": "Enhance GitHub Actions workflows for publishing",
"is_bot": false,
"headline": "Merge pull request #5 from Geocodio/hotfix/publish-workflow",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-07-01T21:13:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d616412a5b0507c10149d04f2470f839d291bd1d",
"body": "- Add push triggers for main, hotfix, and release branches in publish.yml\n- Introduce test-act-event-ci.json and test-act-event-publish.json for local workflow testing with act, enabling version and publish target inputs",
"is_bot": false,
"headline": "Enhance GitHub Actions workflows for publishing",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-07-01T21:12:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d8dbf4665d5a4ae09c6d8d2a6b20a9526ef5fbbf",
"body": "Feature/ci pipeline tasks",
"is_bot": false,
"headline": "Merge pull request #4 from Geocodio/feature/ci-pipeline-tasks",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-07-01T20:30:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "601d45639fbd680923bf7e7881253d0f18de09a5",
"body": "- Add tests/test_workflows.py with pytest-based workflow tests\n\n- Test CI and publish workflows using act\n\n- Skip tests in CI environments to avoid Docker-in-Docker conflicts\n\n- Use --container-architecture linux/amd64 for M-series chip compatibility\n\n- Support real TestPyPI tokens when available\n\n- Update README.md with workflow testing setup instructions\n\n- Document prerequisites: act, Docker, and optional TestPyPI token",
"is_bot": false,
"headline": "Add workflow testing with act for local development",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-07-01T20:23:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6ac47f00b843be0d1880a20bee7a1764a84d1cda",
"body": "Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>",
"is_bot": false,
"headline": "Update test_pypi_release.py",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-07-01T20:07:27Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "8923d48a66bd8baa94f6611ae4c694b64e77591a",
"body": "Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>",
"is_bot": false,
"headline": "Update .github/workflows/ci.yml",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-07-01T20:07:06Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "800bfabec8c73ded9b43545dc8ae102cec9bf9f2",
"body": null,
"is_bot": false,
"headline": "revert: remove CI test line",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-30T23:08:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6e59c3b998601fd9beb446f8a1528ab5e8d92ef6",
"body": null,
"is_bot": false,
"headline": "test: trigger CI with API key to verify e2e tests run",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-30T23:07:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "137cd96514d891ee0b5fef2e87808eda3b5e6893",
"body": "- Added section on CI processes, including unit tests and E2E test conditions.\n- Documented the PyPI publishing workflow and local packaging script usage.",
"is_bot": false,
"headline": "docs: update README with CI and publishing details",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-30T23:02:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e186344632908d17a09102a78fd85d5c45de23a4",
"body": "- Script to build, check, and (optionally) upload to TestPyPI for local verification\n\n- Useful for validating packaging and credentials before CI/CD release",
"is_bot": false,
"headline": "chore: add local PyPI release test script",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-30T22:57:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9b369d497d3e6f064ed48635edbeddaab34c1517",
"body": "- Create GitHub Actions workflow for automated PyPI publishing\n\n- Support both TestPyPI and PyPI publishing targets\n\n- Add manual workflow dispatch with version input\n\n- Configure automatic publishing on release creation\n\n- Use uv for dependency management and build tools\n\n- Include version update capability for manual releases",
"is_bot": false,
"headline": "feat: add PyPI publishing workflow",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-30T22:56:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c7496a79714d6b630b10aca3af4e5d1eee0fc5c9",
"body": "- Replace fictional addresses with real, valid addresses (White House, Apple HQ)\n\n- Fix List API examples to use correct .data attribute for paginated responses\n\n- Add working error handling examples with proper exception types\n\n- Update development installation instructions to use -e flag\n\n- Improve code examples to show actual output rather than raw objects\n\n- All examples tested and verified to work with live API",
"is_bot": false,
"headline": "docs: update README with verified examples and installation instructions",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-30T22:54:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "320eca4e43d84c5f4147564c2b03f73e3644139f",
"body": "- Split test execution into unit tests and e2e tests\n\n- Add conditional e2e test execution based on API key availability\n\n- Configure GEOCODIO_API_KEY secret for e2e test authentication\n\n- Add verbose output for e2e tests to aid debugging\n\n- Maintain existing linting step in workflow\n\n- Unit tests run always, e2e tests run only when API key is provided",
"is_bot": false,
"headline": "feat: enhance CI pipeline with e2e test support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-30T22:53:53Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "26c4d06d1e40ee3f5c66449765b17f92091dc595",
"body": "…cal reasons. if confusing, disponse of them",
"is_bot": false,
"headline": "docs: add informative docs to project_docs folder, mainly for histori…",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-30T21:48:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "19f1db54521d86e4375c60c555f6db3c5762fa42",
"body": "Fix/refactor class names extras",
"is_bot": false,
"headline": "Merge pull request #3 from Geocodio/fix/refactor-class-names-extras",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-21T23:50:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "acc84cb11c62d2ab2b276aad05431a269dc9f8a3",
"body": null,
"is_bot": false,
"headline": "Merge branch 'main' into fix/refactor-class-names-extras",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-21T23:49:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b1b0a84d66e4590b4f8507e4367db0708919d90a",
"body": null,
"is_bot": false,
"headline": "chore: remove example script for List API functionality",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-21T23:27:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2ba078dfc143aa50ab9f11981b4357c76fdecd3a",
"body": "- Updated ApiModelMixin to inherit from ExtrasMixin.\n- Cleaned up AddressComponents and other models to just inherit from ApiModelMixin.\n- removing unnecessary print statements.",
"is_bot": false,
"headline": "refactor: rename mixin classes for clarity",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-21T23:27:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a6f95ee173668f96131045fadabe495605bb1684",
"body": "chore: add GitHub actions for CI",
"is_bot": false,
"headline": "Merge pull request #2 from Geocodio/chore/ci-setup",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-21T23:23:50Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e4f069d73778cd588acbf0b5ddcbcd0946e1bf2b",
"body": "Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>",
"is_bot": false,
"headline": "Update README.md",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-21T23:23:20Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "475ef69a621ff54282893ab39fe6657aa8ac3e36",
"body": null,
"is_bot": false,
"headline": "chore: commit uv.lock file",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-09T19:51:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "18234841affdfe983d2781103ddb256e9817f14d",
"body": null,
"is_bot": false,
"headline": "chore: update CI linting command to target 'src/' and ignore E501",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-09T19:41:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9ad983ee4b0b412083b962a4c319f46eb18679f5",
"body": null,
"is_bot": false,
"headline": "linting: optimizing imports and linting to pass lint check",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-09T19:39:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "178795cf2ad64d1123e026432080fba55ec317aa",
"body": null,
"is_bot": false,
"headline": "chore: update CI commands to use 'uv run' for testing and linting",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-09T19:31:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dca4bde5cc35fe86707c3dc6b17308c9ccdee884",
"body": "- change how we use pip to install deps properly",
"is_bot": false,
"headline": "fix: update CI setup and installation instructions in README",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-09T19:29:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f0a098494e28405e0c68978bb27c09a0feb5b148",
"body": null,
"is_bot": false,
"headline": "chore: add CI configuration for testing and linting",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-09T19:17:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "56295e3f4699c4f982493e1f1ed07a5a2efb2c95",
"body": null,
"is_bot": false,
"headline": "fix: support `fields` param in create_list()",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-06T18:41:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "582682f382926a6fcbd602035f70e575038f603b",
"body": "- Add instructions for setting up development environment\\n- Document test running procedures\\n- Clarify Python version requirements",
"is_bot": false,
"headline": "docs: update README with development setup instructions",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-06T18:03:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2d3ae865b34ef80e4e7027d057272b3302e99ebc",
"body": "- Add ListProcessingState class in models.py to store processing state constants\\n- Update smoke_lists.py to use the new constants\\n- Update test_lists_api.py to use the new constants\\n- Remove TODO comments about using constants\\n- Add proper logging in test file to match smoke test style\\n\\nThis change improves maintainability by centralizing the state values\\nand reduces the chance of typos when checking list processing states.",
"is_bot": false,
"headline": "refactor: add ListProcessingState constants for list processing states",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-06T17:57:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e7069a01df89c01f9f43b428edcca5b3e61a7f20",
"body": "feat: implement List API methods for managing address lists",
"is_bot": false,
"headline": "Merge pull request #1 from Geocodio/feature/lists-api-support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-04T19:37:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1a6a801ef17c21a3920f66e16fbef0402edb1806",
"body": "Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>",
"is_bot": false,
"headline": "Update src/geocodio/client.py",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-04T19:34:13Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "060967b086a0b2485618d549ab7920d68a7878bc",
"body": "Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>",
"is_bot": false,
"headline": "Update src/geocodio/client.py",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-04T19:34:01Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "065059315dee01d90d2856f1e7fee87a051ee35d",
"body": "- Implemented `GeocodioClient.download()` to fetch a geocoded list as CSV, supporting both file saving and returning bytes.\n- Handles error responses, including \"list still processing\" and JSON parsing failures, raising `GeocodioServerError` as appropriate.\n- Added end-to-end tests in `tests/e2e/tes\n[…]\nt in tests.\n- Updated test fixtures and helpers for reliable E2E testing of list processing and download scenarios.\n- Improved error logging and file handling in the client for robust file operations.",
"is_bot": false,
"headline": "feat: add and test List API .download() method (E2E and unit)",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-06-04T19:30:09Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "d6276488ffd8da38dd8e382b0fe5a5ab7f83e1ce",
"body": null,
"is_bot": false,
"headline": "WIP -- commit before moving locations -- squash this!",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-05-29T22:17:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "07b36a42e43f076345b52958bf05211434c660b8",
"body": "Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>",
"is_bot": false,
"headline": "fix: add missing `raise`",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-05-28T21:20:51Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "cce93509a8744345c504b8a0ae4576005327a488",
"body": "- feat: add custom error classes for handling HTTP errors\n- added `_check_response` for standardized error handling.\n- Refactored client List methods to use correct file upload logic\n- restructured test cases for list-related features.\n- added dependencies for dev to pyproject.toml",
"is_bot": false,
"headline": "feat: Finish implementation of feature/lists-api-support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-05-27T19:22:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "abc6209fea594347d6a2e6317378db11bc1c429f",
"body": null,
"is_bot": false,
"headline": "docs: update repository links in README to Geocod.io urls and GH project",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-05-11T20:46:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "412ef4c0b4d9dd944e79254b8cb90d452271f637",
"body": null,
"is_bot": false,
"headline": "docs: update project documentation with new features and improvements",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T23:17:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b205c74b1a1237b380edbb600043f5a6ca1773a4",
"body": "- Replace CanadianRiding with FederalRiding model\n\n- Add complete test data for StatisticsCanadaData model\n\n- Fix test assertions to match model fields",
"is_bot": false,
"headline": "test: Update Canadian riding and Statistics Canada tests",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:58:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bba7fdfd56f3b52b0666f8a9007df533ff6f62e8",
"body": "- Remove unused format parameter from geocoding client\n\n- Add comprehensive test coverage for new data models (ZIP+4, Canadian riding, Statistics Canada, FFIEC)\n\n- Reorganize and clean up existing test cases",
"is_bot": false,
"headline": "feat: Add support for additional data fields and improve test coverage",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:48:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9378982f1c9833f6adaf2912ce1d6e39506e28ca",
"body": "…ralRiding and ProvincialRiding models, add complete StatisticsCanadaData model, update tests, fix dataclass field ordering",
"is_bot": false,
"headline": "feat: improve Canadian field support - Split CanadianRiding into Fede…",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:45:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "beca3c2292c124bad17e5a7ea8582950d8079882",
"body": "- Add Housing model for ACS housing data\n\n- Add housing to GeocodioFields\n\n- Add unit and integration tests for housing",
"is_bot": false,
"headline": "feat: add housing support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:10:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "25816de6d1c38455c23462e51c8476406d55cc68",
"body": "- Add Families model for ACS families data\n\n- Add families to GeocodioFields\n\n- Add unit and integration tests for families",
"is_bot": false,
"headline": "feat: add families support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:06:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e026e641d92d06321d7fdb28c854aa48c1777054",
"body": "- Add Economics model for ACS economics data\n\n- Add economics to GeocodioFields\n\n- Add unit and integration tests for economics",
"is_bot": false,
"headline": "feat: add economics support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:05:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4efdefded1ab0851f3410fb944d2f466b1cc971c",
"body": "- Add Demographics model for ACS demographics data\n\n- Add demographics to GeocodioFields\n\n- Add unit and integration tests for demographics",
"is_bot": false,
"headline": "feat: add demographics support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:04:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "efcd71faf56994e4df5e132536a74d8abe51961a",
"body": "- Add MSA and CSA codes to CensusData model\n\n- Add census2023 to GeocodioFields\n\n- Add unit and integration tests for census2023",
"is_bot": false,
"headline": "feat: add census2023 support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:04:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5fbdd1b8d6767fbb8f3b8c34ebab8b9d5cd44719",
"body": "- Add SchoolDistrict model\n\n- Add school_districts to GeocodioFields\n\n- Add unit and integration tests for school districts",
"is_bot": false,
"headline": "feat: add school districts support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:02:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "859a6d855f8e116a5cb27544edbc2c67b8e399f8",
"body": "- Add StateLegislativeDistrict model\n\n- Add state_legislative_districts and state_legislative_districts_next to GeocodioFields\n\n- Add unit and integration tests for state legislative districts",
"is_bot": false,
"headline": "feat: add state legislative districts support",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:00:53Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b826f8295cbd87c1f9256aac55ace07c0905260e",
"body": "- Create ApiModelMixin to centralize API response parsing\n\n- Add type hints for better type safety\n\n- Remove duplicate from_api methods from model classes",
"is_bot": false,
"headline": "refactor: add ApiModelMixin for common from_api functionality",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-26T22:00:50Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "961f7defefa480feefd71ff6811747a3921bffe1",
"body": "- Add ocd_id field to CongressionalDistrict model\n\n- Make CongressionalDistrict inherit from _HasExtras for future fields\n\n- Add from_api method for proper API response parsing\n\n- Update client to use from_api for congressional districts\n\n- Improve test coverage with specific field assertions",
"is_bot": false,
"headline": "feat: add ocd_id support to CongressionalDistrict",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-24T22:47:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1373a72af6b6d2237275ac73c68c0550bbae1f64",
"body": "- Update test examples to use Chicago and Denver addresses consistently\n\n- Fix batch request format to send addresses as a list\n\n- Update test assertions to match actual API responses\n\n- Add debug logging to help diagnose request/response issues",
"is_bot": false,
"headline": "test: update batch geocoding tests to match API behavior",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-24T22:41:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2992014d79ad283aaf6e18cf00f787da855ffc0a",
"body": "- Fixed batch geocoding response parsing to handle nested structure\n\n- Added debug logging to help diagnose response parsing issues\n\n- Added comprehensive batch geocoding integration test\n\n- Added smoke test for manual testing\n\n- Updated README with comprehensive documentation and examples\n\n- Added unit tests for geocoding functionality",
"is_bot": false,
"headline": "fix: batch geocoding response parsing and add tests",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-24T22:30:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0acc31722e1f544de368941c5b13f572e84dc6ef",
"body": "Required for loading .env files in tests",
"is_bot": false,
"headline": "chore: add python-dotenv to dev requirements",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-24T22:14:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7d6538149917772256d4d0c65026a8a4052abe79",
"body": "- Add debug logging to test configuration\n\n- Make no-key test more explicit\n\n- Fix test to properly check for AuthenticationError",
"is_bot": false,
"headline": "test: improve test configuration and no-key test",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-24T22:13:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "13a509d5b48ad767c16b2ab95e753ab888258303",
"body": "- Remove TODO comment\n\n- Maintain MIT License format\n\n- Keep current copyright holder",
"is_bot": false,
"headline": "chore: update license to match PHP library format",
"author_name": "Ed Finkler",
"author_login": "funkatron",
"committed_at": "2025-04-24T21:47:55Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 11,
"commits_last_year": 45,
"latest_release_at": "2026-07-16T10:43:29Z",
"latest_release_tag": "v1.2.0",
"releases_from_tags": false,
"days_since_last_push": 11,
"active_weeks_last_year": 9,
"days_since_latest_release": 11,
"mean_days_between_releases": 38
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": false,
"health_percentage": 37,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "geocodio-library-python",
"exists": true,
"license": "MIT",
"keywords": [
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Programming Language :: Python :: 3.14",
"Topic :: Internet :: WWW/HTTP :: Dynamic Content",
"Topic :: Scientific/Engineering :: GIS",
"Topic :: Software Development :: Libraries :: Python Modules"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/geocodio-library-python/",
"is_deprecated": false,
"latest_version": "1.0.0",
"repository_url": "https://github.com/geocodio/geocodio-library-python",
"versions_count": 8,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 4632,
"first_published_at": "2025-08-08T14:27:15.240739Z",
"latest_published_at": "2026-06-05T14:52:21.129669Z",
"latest_version_yanked": null,
"days_since_latest_publish": 52
}
]
},
"popularity": {
"forks": 5,
"stars": 4,
"watchers": 4,
"fork_history": {
"days": [
{
"date": "2025-10-27",
"count": 1
},
{
"date": "2025-11-13",
"count": 1
},
{
"date": "2026-06-18",
"count": 1
},
{
"date": "2026-06-26",
"count": 1
},
{
"date": "2026-07-22",
"count": 1
}
],
"complete": true,
"collected": 5,
"total_forks": 5
},
"star_history": null,
"open_issues_and_prs": 0
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [],
"toolchain_manifests": [],
"largest_source_bytes": 54413,
"source_files_sampled": 26,
"oversized_source_files": 0,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"pyproject.toml",
"requirements-dev.txt",
"setup.cfg"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [],
"collected": true,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 6,
"malicious_count": 0,
"assessed_package": "pypi:geocodio-library-python@1.0.0",
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "httpx",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.24.0"
}
],
"all_dependencies": {
"error": "GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"source": null,
"packages": [],
"collected": false,
"truncated": false,
"total_count": null,
"direct_count": null,
"indirect_count": null
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 17,
"open_issues": 0,
"closed_ratio": 1,
"closed_issues": 7,
"closed_unmerged_prs": 5
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "funkatron",
"commits": 69,
"avatar_url": "https://avatars.githubusercontent.com/u/1960?v=4"
},
{
"type": "User",
"login": "MiniCodeMonkey",
"commits": 37,
"avatar_url": "https://avatars.githubusercontent.com/u/220535?v=4"
},
{
"type": "User",
"login": "imliam",
"commits": 4,
"avatar_url": "https://avatars.githubusercontent.com/u/4326337?v=4"
},
{
"type": "User",
"login": "sylvesterdamgaard",
"commits": 4,
"avatar_url": "https://avatars.githubusercontent.com/u/2431914?v=4"
}
],
"contributors_sampled": 4,
"top_contributor_share": 0.605
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"ci.yml",
"publish.yml"
],
"has_docs_dir": false,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [
"uv.lock"
],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 0,
"reason": "branch protection not enabled on development/release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 8,
"reason": "7 out of 8 merged PRs checked by a CI test -- score normalized to 8",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 1,
"reason": "Found 4/21 approved changesets -- score normalized to 1",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 10,
"reason": "project has 5 contributing companies or organizations",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 4,
"reason": "5 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 4",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 3,
"reason": "7 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "6b4738f17888c690d64126c83f22683870fa0c81",
"ran_at": "2026-07-28T10:16:37Z",
"aggregate_score": 3.3,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-16T10:44:06Z",
"oldest_open_prs": [],
"last_merged_pr_at": "2026-07-16T10:42:50Z",
"ci_last_conclusion": "FAILURE",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/Geocodio/geocodio-library-python",
"host": "github.com",
"name": "geocodio-library-python",
"owner": "Geocodio"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 57,
"inputs": {
"security": 46,
"vitality": 72,
"community": 39,
"governance": 65,
"engineering": 54
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 72,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "moderate",
"name": "Development activity",
"note": null,
"notes": [],
"value": 54,
"inputs": {
"commits_last_year": 45,
"human_commit_share": 1,
"days_since_last_push": 11,
"active_weeks_last_year": 9
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 11 days ago",
"points": 28.8,
"status": "partial",
"details": [
{
"code": "push_recency",
"params": {
"days": 11
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "9/52 weeks with commits",
"points": 6.2,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 9
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "45 commits in the last year",
"points": 14.9,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 45
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "5 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 4",
"points": 4,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 100,
"inputs": {
"releases_count": 11,
"latest_release_tag": "v1.2.0",
"releases_from_tags": false,
"days_since_latest_release": 11,
"mean_days_between_releases": 38
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "11 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 11
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 11 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 11
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~38 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 38
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 11,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 11 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 11
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "at_risk",
"name": "Community & Adoption",
"value": 39,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "critical",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 15,
"inputs": {
"forks": 5,
"stars": 4,
"watchers": 4,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "4 stars",
"points": 7.7,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 4
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "5 forks",
"points": 5,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 5
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "4 watchers",
"points": 2.7,
"status": "partial",
"details": [
{
"code": "watchers",
"params": {
"count": 4
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "moderate",
"name": "Community health",
"note": null,
"notes": [],
"value": 50,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": false,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
},
{
"key": "ecosystem_adoption",
"band": "moderate",
"name": "Ecosystem adoption (downloads)",
"note": "Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"registry_dependents"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 61,
"inputs": {
"packages": [
"geocodio-library-python"
],
"dependents": null,
"ecosystems": "pypi",
"total_downloads": null,
"monthly_downloads": 4632
},
"components": [
{
"key": "monthly_downloads",
"name": "Monthly downloads",
"detail": "4,632 downloads/month across pypi",
"points": 48.9,
"status": "partial",
"details": [
{
"code": "downloads_monthly",
"params": {
"count": 4632,
"ecosystems": "pypi"
}
}
],
"max_points": 80
},
{
"key": "registry_dependents",
"name": "Registry dependents",
"detail": "not reported by this ecosystem",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_reported_by_this_ecosystem",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 65,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "at_risk",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 33,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 4,
"top_contributor_share": 0.605
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 60% of commits",
"points": 8.9,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 60
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "4 contributors",
"points": 5.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 4
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 5 contributing companies or organizations",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 78,
"inputs": {
"merged_prs": 17,
"open_issues": 0,
"closed_issues": 7,
"issue_closed_ratio": 1,
"closed_unmerged_prs": 5
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "100% of issues closed",
"points": 46.8,
"status": "met",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 100
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "17/22 decided PRs merged",
"points": 29.6,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 17,
"decided": 22
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 4/21 approved changesets -- score normalized to 1",
"points": 1.5,
"status": "partial",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": null,
"notes": [],
"value": 61,
"inputs": {
"followers": 10,
"owner_type": "Organization",
"is_verified": null,
"owner_login": "Geocodio",
"public_repos": 35,
"account_age_days": 4551
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "organization-owned",
"points": 30,
"status": "met",
"details": [
{
"code": "owner_organization",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "10 followers of Geocodio",
"points": 7.5,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 10,
"login": "Geocodio"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "35 public repos, account ~12 yr old",
"points": 23.3,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 35
}
},
{
"code": "account_age_years",
"params": {
"years": 12
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"geocodio-library-python"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 52
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 52 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 52
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "8 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 8
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "moderate",
"name": "Engineering Quality",
"value": 54,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "moderate",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 64,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "2 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 2
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "7 out of 8 merged PRs checked by a CI test -- score normalized to 8",
"points": 16,
"status": "partial",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "at_risk",
"name": "Documentation",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"topics": [],
"has_wiki": false,
"homepage": null,
"has_readme": true,
"has_docs_dir": false,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "at_risk",
"name": "Security",
"value": 46,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Packaging, Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"packaging",
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 33,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 16,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 2,
"scorecard_aggregate": 3.3
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection not enabled on development/release branches",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "7 out of 8 merged PRs checked by a CI test -- score normalized to 8",
"points": 2,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 4/21 approved changesets -- score normalized to 1",
"points": 0.8,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 5 contributing companies or organizations",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "5 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 4",
"points": 3,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "7 existing vulnerabilities detected",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "excellent",
"name": "Dependency advisories",
"note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:geocodio-library-python@1.0.0 runtime dependency closure — what installing the published package pulls in — 6 packages. Reachability is not analyzed.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"no_advisories_left_outstanding"
]
}
},
{
"code": "weights_renormalized",
"params": {}
},
{
"code": "advisories_scope_published",
"params": {
"package": "pypi:geocodio-library-python@1.0.0",
"assessed": 6
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 100,
"inputs": {
"source": "osv",
"advisories": 0,
"affected_packages": 0,
"assessed_packages": 6,
"unassessed_packages": 0,
"affected_by_severity": "none",
"direct_affected_packages": 0
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "no direct dependency carries a known advisory",
"points": 35,
"status": "met",
"details": [
{
"code": "no_direct_advisories",
"params": {}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "no indirect dependency carries a known advisory",
"points": 25,
"status": "met",
"details": [
{
"code": "no_indirect_advisories",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "no advisory carries a publication date",
"points": 0,
"status": "excluded",
"details": [
{
"code": "advisories_no_publication_date",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "excellent",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 6,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 8
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "at_risk",
"name": "AI Readiness",
"value": 44,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "at_risk",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.87,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "no CLAUDE.md / AGENTS.md / editor rules",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_instructions",
"params": {}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "87 of 100 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 87,
"sampled": 100
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "at_risk",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 42,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"uv.lock"
],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [],
"agent_commit_share": 0.06,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "6 of the last 100 commits agent-authored or agent-credited",
"points": 10,
"status": "met",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 6,
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "moderate",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 55,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 54413,
"source_files_sampled": 26,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python without a type-check config",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_typecheck_config_language",
"params": {
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/26 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 26,
"oversized": 0
}
}
],
"max_points": 55
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token",
"GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository"
],
"report_type": "repository",
"generated_at": "2026-07-28T10:16:50.404519Z",
"schema_version": "0.27.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/g/Geocodio/geocodio-library-python.svg",
"full_name": "Geocodio/geocodio-library-python",
"license_state": "standard",
"license_spdx": "MIT"
}