Raw JSON report machine-readable
{
"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"
}