OilpriceAPI/python-sdk має індекс здоров’я 65 зі 100, що відповідає смузі «Помірний». Найвищий показник — Vitality (81/100), найнижчий — Community & Adoption (42/100). Останнє оновлення було 4 дні тому. Більшість нещодавньої роботи виконує один учасник.
65
загалом / 100
Помірний
Індекс здоров'я програмного забезпечення
Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє середнє; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 49 («Під ризиком»). Готовність до ШІ не входить до індексу.
65
Відмінний85-100Зразковий; відповідає практично всім перевіреним критеріям
Добрий70-84Здоровий; незначні прогалини
Помірний50-69Прийнятний, але з помітними прогалинами; рекомендовано перевірку
У зоні ризику30-49Суттєві слабкі місця; впровадження потребує обережності
Критичний1-29Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)
Профіль оцінок
Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.
Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
25/25
Непрямі залежності без відомих сповіщень — жодна непряма залежність не має відомих сповіщень
0/40
Немає задавнених сповіщень — жодне сповіщення не має дати публікації
Використані вхідні дані
source
osv
advisories
0
affected_packages
0
assessed_packages
13
unassessed_packages
0
affected_by_severity
none
direct_affected_packages
0
Виключено з оцінювання (немає даних або не застосовно): Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено з runtime-замиканням залежностей pypi:oilpriceapi@1.11.0 — тим, що тягне за собою встановлення опублікованого пакета, — 13 пакетів. Досяжність не аналізується.
Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Незалежний, експериментальний бейдж — вага 0.0, тож він подається окремо і не впливає на загальний індекс здоров'я.
Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
Докладніше
Історія зірок і форків 0 ★ / 2 ⇿
0Зірки
2Форки
Коли додано кожну зірку й форк — зібрано з GitHub і згруповано за днями. Кумулятивне зростання розміщено просто над денними додаваннями, з яких воно складається, тож їх видно одне проти одного: рівномірне органічне накопичення виглядає зовсім інакше, ніж різкий короткочасний сплеск. Там, де цю різницю можна виміряти, її подано як автентичність росту.
OpenSSF Scorecard 5.6 / 10
5.6сукупно
Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).Scorecard v5.5.0 · 2026-07-29 23:53 UTC
Повний розв'язаний набір залежностей із графа залежностей GitHub: 3 прямих і 17 непрямих (транзитивних) пакетів. Транзитивне замикання є повним, коли в репозиторії закомічено lockfile.
Реєстр
Пакет
Версія
Зв'язок
PyPI
httpx
—
пряма
PyPI
pydantic
—
пряма
PyPI
python-dateutil
—
пряма
PyPI
black
—
непряма
PyPI
cachetools
—
непряма
PyPI
click
—
непряма
PyPI
jsonschema
—
непряма
PyPI
mypy
—
непряма
PyPI
numpy
—
непряма
PyPI
pandas
—
непряма
PyPI
pre-commit
—
непряма
PyPI
pytest
—
непряма
PyPI
pytest-asyncio
—
непряма
PyPI
pytest-cov
—
непряма
PyPI
pytest-timeout
—
непряма
PyPI
redis
—
непряма
PyPI
rich
—
непряма
PyPI
ruff
—
непряма
PyPI
setuptools
—
непряма
PyPI
websockets
—
непряма
Сповіщення про залежності 0
Встановлення pypi:oilpriceapi@1.11.0 тягне 13 пакетів, прямих і транзитивних: 0 мають відомі сповіщення, з них 0 — прямі залежності.
Жодне відоме сповіщення не стосується оцінених залежностей.
Сповіщення означає, що версія, записана в графі залежностей, потрапляє в уражений діапазон. Досяжність не аналізується, а граф містить піниї розробки й тестування — знахідка може стосуватися інструментів, а не поставленого коду.
Звіт у форматі JSON машиночитний
{
"data": {
"repo": {
"topics": [
"api-client",
"async",
"energy",
"oil-prices",
"pydantic",
"python",
"sdk",
"trading",
"commodity-prices",
"commodities",
"financial-data",
"wti",
"brent-crude",
"commodity-data",
"energy-api",
"natural-gas",
"oil-price",
"openbb",
"pypi"
],
"is_fork": false,
"size_kb": 14120,
"has_wiki": false,
"homepage": "https://pypi.org/project/oilpriceapi/",
"languages": {
"Shell": 3169,
"Python": 745054,
"PowerShell": 9033
},
"pushed_at": "2026-07-25T18:29:06Z",
"created_at": "2025-09-29T20:05:12Z",
"owner_type": "Organization",
"updated_at": "2026-07-25T18:29:10Z",
"description": "Official Python SDK for source-timestamped OilPriceAPI energy data with typed recovery and executable capability metadata",
"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.oilpriceapi.com",
"name": "OilPriceAPI",
"type": "Organization",
"login": "OilpriceAPI",
"company": null,
"location": "United States of America",
"followers": 7,
"avatar_url": "https://avatars.githubusercontent.com/u/152923419?v=4",
"created_at": "2023-12-04T20:40:00Z",
"is_verified": null,
"public_repos": 18,
"account_age_days": 968
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v1.11.0",
"kind": "minor",
"published_at": "2026-07-19T16:37:47Z"
},
{
"tag": "v1.10.2",
"kind": "patch",
"published_at": "2026-07-16T13:16:43Z"
},
{
"tag": "v1.10.1",
"kind": "patch",
"published_at": "2026-07-03T14:13:33Z"
},
{
"tag": "v1.10.0",
"kind": "minor",
"published_at": "2026-07-03T11:02:09Z"
},
{
"tag": "v1.9.0",
"kind": "minor",
"published_at": "2026-06-21T21:14:37Z"
},
{
"tag": "v1.8.1",
"kind": "patch",
"published_at": "2026-06-21T17:13:21Z"
},
{
"tag": "v1.8.0",
"kind": "minor",
"published_at": "2026-06-21T16:42:38Z"
},
{
"tag": "v1.7.1",
"kind": "patch",
"published_at": "2026-06-21T09:47:47Z"
},
{
"tag": "v1.7.0",
"kind": "minor",
"published_at": "2026-03-29T18:10:37Z"
},
{
"tag": "v1.6.0",
"kind": "minor",
"published_at": "2026-03-18T11:18:13Z"
},
{
"tag": "v1.0.0",
"kind": "major",
"published_at": "2025-09-29T20:52:10Z"
}
],
"recent_commits": [
{
"oid": "f7b92634173dd9c86cdc5e078cba2019bca6cd38",
"body": null,
"is_bot": false,
"headline": "feat: validate dates and guide commodity codes (#76)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T18:29:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "205078857734a1b510379cd2258ffb3e208517b2",
"body": null,
"is_bot": false,
"headline": "docs: replace speculative canary process with release gate (#75)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T18:16:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c2f6a882b1aa483815b9191e8c83a1a25a7c224f",
"body": null,
"is_bot": false,
"headline": "fix: replace flaky SDK health job with bounded synthetic (#74)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T18:12:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8a061ef2b544d729dddb0b8be27956ef21c9fedf",
"body": null,
"is_bot": false,
"headline": "fix: preserve dataframe context across pages (#73)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T17:36:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fa86d807bccce739717c3409cf040a557efd342f",
"body": "* feat: normalize API error contracts\n\n* fix: address error contract review",
"is_bot": false,
"headline": "feat: normalize API error contracts (#72)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T17:27:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2592030d6f6339e9a305042ac4bb3bd39cd3d076",
"body": "Updates the requirements on [jsonschema](https://github.com/python-jsonschema/jsonschema) to permit the latest version.\n- [Release notes](https://github.com/python-jsonschema/jsonschema/releases)\n- [Changelog](https://github.com/python-jsonschema/jsonschema/blob/main/CHANGELOG.rst)\n- [Commits](https\n[…]\ndency-version: 4.26.0\n dependency-type: direct:development\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps-dev): update jsonschema requirement (#69)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-25T17:06:23Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "9edbb85854fed2780f57dff4c894d8038abe4eb9",
"body": "Bumps [actions/setup-python](https://github.com/actions/setup-python) from 6 to 7.\n- [Release notes](https://github.com/actions/setup-python/releases)\n- [Commits](https://github.com/actions/setup-python/compare/v6...v7)\n\n---\nupdated-dependencies:\n- dependency-name: actions/setup-python\n dependency-\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): bump actions/setup-python from 6 to 7 (#68)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-25T17:06:20Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "fdc4bde8589be43ce17b4a98515bbe11d599f9f1",
"body": "Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 4 to 7.\n- [Release notes](https://github.com/actions/upload-artifact/releases)\n- [Commits](https://github.com/actions/upload-artifact/compare/v4...v7)\n\n---\nupdated-dependencies:\n- dependency-name: actions/upload-artifac\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): bump actions/upload-artifact from 4 to 7 (#67)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-25T17:06:17Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "32791c08ad735cb642a3766e22e53f436ef1c8d0",
"body": "Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 7.\n- [Release notes](https://github.com/actions/checkout/releases)\n- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)\n- [Commits](https://github.com/actions/checkout/compare/v4...v7)\n\n---\nupdated-dependenc\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): bump actions/checkout from 4 to 7 (#59)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:46Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "770ecdf9615d705b90c60abd57997096c2549231",
"body": "Bumps [actions/configure-pages](https://github.com/actions/configure-pages) from 4 to 6.\n- [Release notes](https://github.com/actions/configure-pages/releases)\n- [Commits](https://github.com/actions/configure-pages/compare/v4...v6)\n\n---\nupdated-dependencies:\n- dependency-name: actions/configure-page\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): Bump actions/configure-pages from 4 to 6 (#58)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:43Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "b33414f052cf7e1c9f56973615dad3210e26249f",
"body": "Bumps [actions/upload-pages-artifact](https://github.com/actions/upload-pages-artifact) from 3 to 5.\n- [Release notes](https://github.com/actions/upload-pages-artifact/releases)\n- [Commits](https://github.com/actions/upload-pages-artifact/compare/v3...v5)\n\n---\nupdated-dependencies:\n- dependency-name\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): Bump actions/upload-pages-artifact from 3 to 5 (#57)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:40Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7f44d08c265ad6dc18fe23ce9acc471b1d35a1b1",
"body": "Bumps [actions/setup-python](https://github.com/actions/setup-python) from 5 to 6.\n- [Release notes](https://github.com/actions/setup-python/releases)\n- [Commits](https://github.com/actions/setup-python/compare/v5...v6)\n\n---\nupdated-dependencies:\n- dependency-name: actions/setup-python\n dependency-\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): Bump actions/setup-python from 5 to 6 (#56)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:36Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "183412826c71204271ec9871104d1091c0f246cb",
"body": "Bumps [actions/deploy-pages](https://github.com/actions/deploy-pages) from 4 to 5.\n- [Release notes](https://github.com/actions/deploy-pages/releases)\n- [Commits](https://github.com/actions/deploy-pages/compare/v4...v5)\n\n---\nupdated-dependencies:\n- dependency-name: actions/deploy-pages\n dependency-\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): Bump actions/deploy-pages from 4 to 5 (#55)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:33Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "028ecccc908338fb5a0952afe5d49f916ec8da61",
"body": null,
"is_bot": false,
"headline": "docs: correct PyPI source accuracy (#66)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-19T16:36:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c872371ac85e1a19f3f63247291574fa2d1d793c",
"body": null,
"is_bot": false,
"headline": "fix: make exported snippets standalone (#64)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-19T11:25:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fd826218450d5a346b5d2c789e20cbe64c603914",
"body": null,
"is_bot": false,
"headline": "feat: publish executable snippet manifest (#63)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-19T11:12:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fc2cc0b2ead792d4bb10bebb27fe76758c660d4e",
"body": "The repo had no dependabot.yml. Runtime deps are floor-pinned ranges so\nusers already get current releases; this keeps the CI actions and dev\ntoolchain from drifting silently.\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: add dependabot config (pip + github-actions, weekly) (#54)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-16T13:16:17Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "b30c213d694a4f8e9e161a49107981df60c8525c",
"body": "… (#48) (#53)\n\n- live-tests.yml: split into (1) an always-run keyless demo smoke against\n /v1/demo/* with no secret and no gate, and (2) the keyed live suite,\n which now warns loudly (::warning::) instead of silently exiting when\n the secret is unavailable.\n- weekly-health.yml: export the secret \n[…]\nct.py: unknown commodity codes now return HTTP 400\n invalid_code (was 404) — update the two stale contract tests to the\n current API contract.\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "ci: tier live smokes so keyless demo coverage can never silently skip…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-16T13:16:07Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "1973bd74f8a4d5378e142af6846746f71698e10c",
"body": "Includes the well production resource work, removes exposed API tokens, and adds CI coverage to block hardcoded OilPriceAPI-shaped tokens.",
"is_bot": false,
"headline": "Add well production resource and secret guard",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-16T01:06:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6cfa2d8a2fd96bb77019e002d2d5bb1a82cb1f74",
"body": "…ing (#4175) (#51)\n\nSource fields are already free-string typed (no venue enum to loosen); this\naligns example/fixture source values with the API switch to market_reporting\nmasked labels (government labels like EIA/opec.org unchanged). Version bumped\n(patch, unpublished).\n\nCo-authored-by: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: drop venue-typed source enums; align examples with market_report…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-10T14:20:55Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "1c932974357d6565af6a4df34d8702a9c779f219",
"body": "* docs: registry storefront README + v1.10.1\n\nApply the shared registry-storefront formula from the PHP SDK:\n- hero line (oil/gas/LNG/carbon/fuels in under 60 seconds) + audience line + 2M+ requests/month\n- shields.io pypi/v badge, nav line with utm_source=python-sdk and quick-start jump link\n- \"Wha\n[…]\nr explorer and raw\nOpenAPI spec from the README (they existed, unadvertised).\n\nCo-Authored-By: Claude Fable 5 <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: registry storefront README + v1.10.1 (#49)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-03T14:12:20Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "06d9d49a5c3a07ae8996583a7bfaa53de05568da",
"body": "… (#47)\n\nREADME: add 'Beyond Oil — Gas, LNG, Carbon & Fuels' right after the first\nquick-start example — EU_CARBON_EUR spot, ttf-gas futures curve, RTM bunker\nport prices — naming the maritime-compliance (EU ETS/FuelEU), fleet/logistics,\nLNG/European-gas and CBAM audiences. All calls verified agains\n[…]\nhout it)\n\nVerified locally: unit suite 303 passed / 10 skipped; both exact CI commands\nexit 0 with no key (18/22 skipped); workflow YAML parses.\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: embedder-segment quick start + fix weekly-health workflow (#44)…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-03T11:15:34Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "53969a17e43f218127d906d4c1c4fa4ace03f576",
"body": "…e promised (#43) (#46)\n\n- version 1.9.0 → 1.10.0 (analysis module landed after the 1.9.0 tag;\n README advertised it but PyPI 1.9.0 doesn't contain it)\n- README: indicators claim now says v1.10.0; fixed 3 dead\n docs.oilpriceapi.com/sdk/python links (404) → docs root\n- CHANGELOG: [Unreleased] → [1.\n[…]\n - 2026-07-03\n- test_demo_contract: un-pin exact catalog count (442 → floor of 400;\n live catalog is 436 today — curation shouldn't fail tests)\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "release: v1.10.0 — ship the technical-indicators module pip users wer…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-03T11:02:07Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "e3b1020dc0720c225e94b8eaa67803df7d182129",
"body": "…#45)\n\n37 files: customer email lists (PII), outreach drafts, Reddit/marketing\nplans, QA session artifacts, internal strategy docs, and a customer-named\ntest file. All are session artifacts, not SDK documentation. Archived\ninternally before removal. History scrub tracked separately in #42.\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: remove internal docs and customer PII from public repo (#42) (…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-03T11:01:16Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "b9ddeb856b5ae55421ab749e49ef74edea1ff013",
"body": "Add `client.analysis` (AnalysisResource) with SMA, EMA, RSI, MACD,\nBollinger Bands, and ATR. Supports both the DataFrame helper\n(`with_indicators(df, indicators=[...])`, non-mutating) and direct\nper-Series calculation. Pure pandas/numpy implementation with no new\nhard dependencies; pandas remains th\n[…]\nll unit coverage (12 tests, analysis.py at ~87%), README\ndocumentation with examples for both usage styles, and a CHANGELOG entry.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(analysis): add technical indicators module (Closes #3) (#41)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-22T11:46:29Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "242c450bca4341fb47ae8fca4de2a52987abb5e9",
"body": "… doc contract tests (#39)\n\nCloses #26.\n\nThe SDK Performance Guide content already existed at docs/PERFORMANCE_GUIDE.md\nbut was undiscoverable: the README did not link to it and it was absent from\nthe mkdocs site navigation. This makes the guide reachable and locks all five\nissue acceptance criteria\n[…]\nnd nav\n discoverability.\n\nTDD: tests written first; 2 of 7 failed (README link + mkdocs nav) before the\nfix and all 7 pass after.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(performance): wire performance guide into README + docs nav, add…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-22T11:26:43Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8e67190eaa17483f2b64405152c17f0d7a269b30",
"body": "Every SDK request must identify itself to the API for adoption tracking.\nThe sync and async clients already sent X-SDK-Name and X-SDK-Version but\nomitted X-SDK-Language and X-Client-Type, so 0/166 recent requests could be\nattributed to the Python SDK vs raw python-httpx/python-requests calls.\n\nAdd t\n[…]\nPI clients:\n\n X-SDK-Language: python\n X-Client-Type: sdk\n\nChange is additive (4 lines) and does not alter existing behavior.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(telemetry): send X-SDK-Language and X-Client-Type headers (#4) (#40)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-22T11:26:39Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8c9a0c9ae47fb17551bfbbba581d221bb2158119",
"body": "The integration/live tests hit the real API with a single 1-request/second\nkey that is shared across SDK repos in CI. Cross-repo contention produces\nHTTP 429 (RateLimitError) responses that fail otherwise-green code.\n\nAdd a `live_call` fixture in tests/integration/conftest.py that:\n- spaces live cal\n[…]\n\ntest_historical_endpoints.py through this helper. The existing\nskip-if-no-OILPRICEAPI_KEY behavior is preserved. No version bump.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "ci: skip live tests on 429 (shared-key rate-limit resilience) (#38)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-22T09:15:37Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "f0ceb5b191c29cd8eba99687d1f8ad5c0cc823e6",
"body": "…(#37)\n\nAdd SDK support for the now-live #3245 endpoints on both the sync and\nasync clients:\n\n- client.market_brief(codes, narrative=False) -> MarketBrief\n- client.subscriptions.list() / .create() / .delete() / .events()\n with friendly interval mapping (\"5m\"/\"1h\"/\"daily\" -> interval_seconds)\n and \n[…]\nILPRICEAPI_TEST_KEY, no prod writes).\n\nVersion bumped 1.8.1 -> 1.9.0.\n\nGates: mypy clean, ruff clean, pytest 311 passed (cov 59%).\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: market-brief + agent-subscription methods (sync+async, v1.9.0) …",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T21:14:32Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "95e47b136362d96833b1a1b9b4debff564a3dfe3",
"body": "* docs: normalize legacy plan names to current tiers\n\nReplace legacy tier names (Exploration / Production Boost / Reservoir\nMastery) in customer-facing docs and the QA issue-generator script with\nthe current billing tiers: Developer ($19/10K), Starter ($49/50K,\nwebhooks), Professional ($99/100K, web\n[…]\no the existing streaming unit test still matches.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: normalize legacy plan names to current tiers (#36)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T17:27:52Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "a4c110e5d1a11add0ba56881fbca495f61c53fc9",
"body": "* fix: futures slug normalization + live CI tests (v1.8.1)\n\nFutures endpoints are keyed by slug (ice-brent, ice-wti, ...), not raw\nexchange contract code. The old docstrings advertised \"CL.1\" which would\nhit /v1/futures/CL.1 and 404. Add contract-code -> slug normalization so\ncallers can pass either\n[…]\nutil import passes mypy in both local and CI envs\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: futures slug normalization + live CI tests (v1.8.1) (#35)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T17:09:37Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9c107d44e47fca0870b3a68c458d8dd26d1e3f03",
"body": "…n) (#34)\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: release 1.8.0 (WebSocket streaming + param fixes + typing-clea…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T16:42:33Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "0c121a7fa1cf4160e8d0bf4defeca31ef33d37fb",
"body": "…ests (#33)\n\nTask 1 — typing-debt paid down: fixed the real type errors in client,\nasync_client, cli, telemetry, prices, alerts, analytics, data_sources,\nwebhooks and the package __init__ with proper annotations (not type: ignore),\nthen removed all 10 TODO(typing-debt) per-module mypy overrides. The\n[…]\nsts cover the accessor.\n\nGates: mypy clean, ruff clean (oilpriceapi/), 249 unit tests pass, cov 57.38%\n(>=50). Version not bumped.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: pay down mypy typing-debt + param audit + live demo contract t…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T16:01:05Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "f2b1b35b9c2fc5da3548f4a1ed65e8a39973e4a4",
"body": "Add a real-time streaming client for the OilPriceAPI Rails ActionCable\nendpoint (/cable, EnergyPricesChannel), exposed via the async SDK as\n`client.stream`.\n\n- Implements the ActionCable JSON subprotocol: welcome -> subscribe ->\n confirm_subscription -> message; pings/control frames filtered.\n- Tok\n[…]\ns (39 files), pytest 240 passed /\n9 skipped, coverage 55.9% (>= 50% threshold). New streaming modules:\nclient 92.6%, models 95.4%.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: async WebSocket streaming client (#32)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T15:23:04Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "742cc029d072127fb444dca025f32c0a448dba9e",
"body": "…ions (#31)\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: green CI — mypy python_version + sync forecasts/drilling annotat…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T14:52:08Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3b83e8095533ac49d0b49103ae4341f5413c86f8",
"body": "Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: bump version to 1.7.1 for PyPI release (#30)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T09:47:35Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "9f68a1b595edb239017c7acda07d6313d2a0d1a6",
"body": "… (#29)\n\nThe \"Publish to PyPI\" workflow was blocked: its pytest gate had 11\nfailures and coverage sat below the 50% threshold, so the package was\nstuck at 1.6.2 while pyproject was at 1.7.0.\n\nRoot causes and fixes:\n\n1. Schema drift on `currency` (models.py)\n - Price.currency and HistoricalPrice.cu\n[…]\ne result: 227 passed, 9 skipped, coverage 52.90% (exit 0).\nruff check oilpriceapi/ passes. `pytest --timeout=60` no longer errors.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: green publish gate + add pytest-timeout so PyPI publish can ship…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T09:45:40Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9c6c1f3d75b53e3cf6b61c2cd3d79e1c3c963a68",
"body": "…sync telemetry\n\n- Fix 656 ruff lint errors (auto-fix + config updates for pre-existing style issues)\n- Add 429 auto-retry to request_with_headers() (was missing)\n- Add enable_telemetry param + tracking to AsyncOilPriceAPI\n- Extract shared validators to resource_validators.py\n- Update pyproject.toml ruff config to ignore pre-existing style debt\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: Pass ruff lint checks, fix request_with_headers 429 retry, add a…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-29T18:13:59Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "362b118d4b13ff7c8b92337cb720b9a17343e7da",
"body": "Major improvements:\n\n- Full async client: all 16 resources now available on AsyncOilPriceAPI (was 2)\n- Add 429 auto-retry with Retry-After header support (capped at 60s)\n- Add webhook signature verification (verify_signature + standalone export)\n- Add oilprice CLI tool (price, historical, commoditie\n[…]\nync duplication)\n- Make lint/mypy blocking in CI (removed continue-on-error)\n- Add coverage enforcement gate (--cov-fail-under=50)\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: v1.7.0 — World-class SDK upgrade",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-29T18:08:45Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "97c49d3457dce37143441b38a182e315acd6b26a",
"body": "… in historical\n\n1. get_all(): Handle nested dict response from /v1/prices/all\n (data.data.prices is a dict keyed by commodity, not a list)\n2. historical: Use request_with_headers() + X-Total-Pages header\n for reliable pagination detection (was using per_page comparison)\n3. historical: Pass curr\n[…]\nrequesting 1000)\n\nVerified: EU_CARBON_EUR returns 1,603 rows (EUR), NATURAL_GAS_GBP\nreturns 2,974 rows (GBP) with auto-pagination.\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: get_all() response parsing, historical auto-pagination, currency…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-18T11:28:38Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "35a6b57a4fa12478f022a76ec05831b3e38053ac",
"body": "1. get_all() now correctly maps API response currency field to Price\n model (was always defaulting to USD regardless of actual currency)\n2. get_all() auto-paginates using X-Has-Next response header\n3. to_dataframe() accepts per_page parameter, forwarded to get_all()\n\nFixes: customers getting USD f\n[…]\n EUR/GBP commodities in to_dataframe(),\nand pagination capping results at 500 rows.\n\nReported by Jens Baetens (Entras BV) — twice.\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: currency preservation + auto-pagination in to_dataframe()",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-18T11:17:49Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "5b0bfa54f5f72b4ee37e245dc3664e5f34e97ba8",
"body": "Updated README with UTM attribution links and cross-channel promotion\nnow live on PyPI.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: bump version to 1.5.1 for PyPI README update",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-08T11:21:52Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "506226e4f9072e0fc6260a6e58c37473efb3f022",
"body": "Enable attribution tracking for PyPI/Python SDK channel by adding\nutm_source=pypi&utm_medium=sdk&utm_campaign=readme to all signup\nand pricing links. Added \"Also Available As\" cross-promotion section.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add UTM tracking parameters to all signup and pricing links",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-08T10:37:25Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "4205358539fa736f15f081fbc68ced15685ab073",
"body": "conftest.py in those dirs imports python-dotenv (not in dev deps).\npytest collects conftest even with -m exclusion. Use --ignore instead.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(ci): Ignore integration/contract test dirs in CI",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-14T14:06:45Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "87d7602e4ca015cb3c54a21762f622aa80321be2",
"body": "336 pre-existing lint errors in source. Lint is advisory until codebase\nis cleaned up. Tests remain the blocking gate for releases.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(ci): Make lint non-blocking (pre-existing errors)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-14T14:04:11Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "36d7154afd514086458982065a6b0ea9f9bfc15d",
"body": "Pre-existing lint issues in test files (613 errors) were causing CI\nfailure. Scope lint to oilpriceapi/ package only.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(ci): Scope ruff lint to source code only",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-14T14:02:11Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "ba293de856cd8c52530b84c2e45ea0b7fc52c42c",
"body": "Add CI test workflow (Python 3.9-3.12 matrix), weekly integration health\ncheck, and require tests pass before PyPI publish.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "ci: Add test pipeline and publish gate",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-14T13:59:56Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "6558a00af44918b63896e3c90061570909fdf5fa",
"body": "Align pyproject.toml version with __init__.py (1.4.3 → 1.5.0).\nDocument all 13 new resource modules, diesel fix, and test improvements.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: Update version to 1.5.0 and add CHANGELOG entry",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T13:13:55Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3197c18a6dcd80c22f23396590a58a4740c81232",
"body": "Fix diesel validation (empty string handling) and alerts test method\nrename. Add unit tests for commodities, futures, storage, rig counts,\nbunker fuels, analytics, forecasts, data quality, drilling, webhooks,\nand data sources. 222 pass, 0 fail, 60% coverage.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "test: Fix 18 failing tests and add 84 new tests for all resources",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T12:59:18Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "40c30c2b7f5c1ad721eb37cde7784e24e3d7b363",
"body": "Document commodities, futures, storage, rig counts, bunker fuels,\nanalytics, drilling intelligence, energy intelligence, webhooks,\nforecasts, data quality, and data sources resources. Version 1.5.0.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: Update README with all 13 resource modules and usage examples",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T12:30:49Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "9629d1cbc739171255ca3e4a1e71223a4274156d",
"body": "…sources resources and enhance alerts\n\nPhase 3 of SDK gap analysis: adds 11 new resource files covering drilling intelligence (10 methods),\nenergy intelligence sub-package with 7 modules (rig counts, oil inventories, OPEC production,\ndrilling productivity, forecasts, well permits, frac focus), webhooks CRUD (7 methods),\ndata sources CRUD (9 methods), and enhances alerts with test/triggers/analytics_history methods.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add drilling intelligence, energy intelligence, webhooks, data …",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T11:40:39Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "5cf3bd8f7cff426387ae71ca972e542598108a2d",
"body": "…ig counts, bunker fuels, analytics, forecasts, and data quality\n\nPhase 2 of SDK gap analysis - expands Python SDK from 4 resources to 12, adding full coverage\nfor commodities, futures (7 methods), storage (5), rig counts (5), bunker fuels (6),\nanalytics (6), forecasts (4), and data quality (3).\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add 8 new resource modules for commodities, futures, storage, r…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T11:24:07Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3eb76a44e9814bdfbb9de5e628c552dd23d36766",
"body": "Add get_data_connector_prices() method and DataConnectorPrice model\nfor fetching prices from connected data sources (BYOS).\n\nNew model DataConnectorPrice with 8 fields:\n- price, currency, fuel_type, port, region, unit, source, timestamp\n\nSupports filtering by fuel_type, port, region, and since timestamp.\nRequires Data Connector feature enabled on organization.\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add Data Connector support for BYOS prices",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-01-25T11:58:58Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "268109e468233e002dfa427174231111f762bc00",
"body": "- Add app_url and app_name config options for SDK telemetry\n- Send X-SDK-Name, X-SDK-Version headers on every request\n- Send X-App-URL, X-App-Name headers when configured (10% bonus!)\n- Rename headers from X-Api-Client to X-SDK-Name for consistency\n- Bump version to 1.5.0\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add telemetry headers for app tracking (v1.5.0)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-27T18:52:59Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "aa35e8922fbc9d32d465a98c81ee1f305ee73901",
"body": "These test fixes address pagination-related assertion failures:\n- Relax record count assertions (API returns paginated results, 100/page)\n- Add timezone-aware datetime handling for date comparisons\n- Add conftest.py with .env loading for live API tests\n- Update comments explaining pagination behavio\n[…]\navior while still validating core functionality.\n\nTest results: 21/21 contract tests pass, 9/10 integration tests pass\nNo production code changes - tests only\n\nRelated to v1.4.3 historical timeout fix",
"is_bot": false,
"headline": "test: Fix contract/integration tests for API pagination behavior",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-17T10:19:02Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "a7f7c399dbc8365429f6c5153a01b4960b01e882",
"body": "Q1 (Prevention - Urgent & Important):\n- #20: Integration tests with real API calls\n- #21: Performance baseline tests\n- #22: Pre-release validation automation\n- #23: Monitoring & alerting documentation\n\nQ2 (Long-term Quality - Important, Not Urgent):\n- #24: Opt-in SDK telemetry module\n- #25: API cont\n[…]\ntatus:\n- Tests: Ready to use immediately\n- Monitoring: Infrastructure ready (deployment optional)\n- Telemetry: Module ready (integration pending)\n\nResolves: #20, #21, #22, #23, #24, #25, #26, #27, #28",
"is_bot": false,
"headline": "feat: Complete Q1 & Q2 QA improvements (#20-28)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-17T09:49:06Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "31c0a9f88c1c80fa5e208804c3ea924a5e73945f",
"body": "BREAKING BUG FIX - ALL historical queries were returning wrong data:\n- Changed 'commodity' parameter to 'by_code' to match API expectation\n- Fixes issue where ALL historical queries returned BRENT_CRUDE_USD data\n- Impact: All v1.4.0-1.4.2 users were getting wrong commodity data\n\nThis parameter misma\n[…]\n.\nDate ranges and validation fixed in API separately.\n\nVersion: 1.4.2 → 1.4.3\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "Critical Fix: Historical API parameter name (v1.4.3)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-17T08:46:11Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "b421d50f0b31cb2750623f2b6af63c377d01b5a3",
"body": "Fixes 100% timeout rate on historical queries by implementing intelligent\nendpoint selection and dynamic timeout management.\n\nRoot Cause:\n- SDK hardcoded /v1/prices/past_year for all date ranges\n- 30s default timeout insufficient for year-long aggregations (actual: 67-85s)\n\nSolution:\n- Endpoint sele\n[…]\nmpatible)\n\nResolves: Customer issue from idan@comity.ai\nPublished: PyPI v1.4.2\n\n🤖 Generated with Claude Code (https://claude.com/claude-code)\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Fix historical data timeout issue (SDK v1.4.2)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T23:11:25Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "ed5bfca8ed1339889050955a6c74f05065e558b8",
"body": "- Remove non-existent analysis module examples\n- Remove non-existent CLI tool section\n- Replace MockClient with working pytest examples\n- Replace broken example links with inline code\n- Update features list (remove vaporware, add actual features)\n- Add documentation status disclaimer\n- Fix all broke\n[…]\numentation accuracy improved from 65% to ~95%, matching Node.js SDK standard.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: Remove vaporware features, improve accuracy to 95%",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T16:11:38Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "3c2f4ba98ea990709093875055904e8c0118428a",
"body": "- Add X-Api-Client header: 'oilpriceapi-python'\n- Add X-Client-Version header: '1.4.1'\n- Update User-Agent to include Python version\n- Remove deprecated X-SDK-Language, X-SDK-Version, X-Client-Type headers\n\nResolves: #8\nDocumentation: /home/kwaldman/code/sdks/EISENHOWER_MATRIX_PLAN.md",
"is_bot": false,
"headline": "Add SDK telemetry headers (v1.4.1)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T15:06:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "80d87242c72eb9f1ffa21b57d57adb11a7d77c1d",
"body": "Updated Available Commodities section:\n- Added new Coal section with all 8 endpoints\n- Organized into US Spot (3), International Futures (3), Historical (2)\n- Updated commodity count from \"all commodities\" to \"all 79 commodities\"\n- Grouped oil & gas commodities separately from coal for clarity\n\nCoal\n[…]\nternational: NEWCASTLE_COAL_USD, COKING_COAL_USD, CME_COAL_USD\n- Historical: NYMEX_APPALACHIAN_USD, NYMEX_WESTERN_RAIL_USD\n\nMakes Python SDK documentation consistent with complete coal API deployment.",
"is_bot": false,
"headline": "docs: Add 8 coal endpoints to Python SDK README",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T14:41:09Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "77fce4ed1f01c2c237e9d0eb0ac44763c1b0521a",
"body": "Critical fixes based on QA assessment and backend API verification:\n\nAPI Contract Fixes:\n- Fix list() to handle unwrapped array responses from API\n- Fix get() to handle direct object responses (not wrapped)\n- Fix create() to handle direct object responses\n- Fix update() to handle direct object respo\n[…]\nesponses (PriceAlertSerializer)\n- Confirmed API returns unwrapped responses\n- Verified routes.rb shows no test_webhook endpoint\n\nImpact: Prevents 100% failure rate on list/get/create/update operations",
"is_bot": false,
"headline": "fix: Update API response handling and disable test_webhook",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T09:54:29Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "86bd6b493d2dd6b679f07446fc0e552194434c66",
"body": "Add comprehensive price alerts functionality to Python SDK:\n\n- New AlertsResource with full CRUD operations\n- 5 comparison operators for flexible conditions\n- Webhook notifications with HTTPS support\n- Alert cooldown periods (0-1440 minutes)\n- Webhook endpoint testing\n- DataFrame conversion support\n\n[…]\nlerts.test_webhook(url) - Test webhook endpoint\n- alerts.to_dataframe() - Convert to pandas DataFrame\n\nSupports 12 API endpoints (up from 7).\n\nCo-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add price alerts support (v1.4.0)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T02:30:13Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "473fb076a6733f0d0ef33d30d34f97bac5ce0015",
"body": "Sprint 1 - Python Diesel Implementation Complete\n\nChanges:\n1. Created DieselResource class with get_price(), get_stations(), and to_dataframe() methods\n2. Added 7 comprehensive Pydantic models (DieselPrice, DieselStation, DieselStationsResponse, etc.)\n3. Implemented input validation for coordinates,\n[…]\nrices/stations - Nearby station prices (paid)\n- Pandas DataFrame integration for diesel data\n\nResolves: https://github.com/OilpriceAPI/python-sdk/issues/6\nDocumentation: SDK_SPRINT_PLAN_DEC_15_2025.md",
"is_bot": false,
"headline": "feat: Add diesel prices support to Python SDK (v1.3.0)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-15T22:10:56Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "6c3ab3ed0da1c7bf8ed98191fbe279be3cef024f",
"body": null,
"is_bot": false,
"headline": "Remove pricing section from GitHub Pages landing page",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-29T20:20:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b31da482f6b8935332d057b4bbdfd046968d49df",
"body": null,
"is_bot": false,
"headline": "Add GitHub Pages deployment for Python SDK docs",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-29T13:57:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9346d4f7ec8eb81ec8722f75dfb807028f010272",
"body": "Show both sync and async usage examples to demonstrate async/await support.\n\nAsync example:\n- Uses AsyncOilPriceAPI with context manager\n- Shows asyncio.gather() for concurrent requests\n- Fetches multiple commodities in parallel\n\nThis addresses feedback about proving async functionality exists and works.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add async example code block to Reddit post",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T21:07:18Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "9cb4ec609783f6c406285e6b8530b6a0b5b9f216",
"body": "Query production database to get actual Python SDK usage statistics:\n- 113 API requests from Python SDK (User-Agent: OilPriceAPI-Python/1.0.0)\n- 4 unique active users\n- Most popular: /v1/prices/past_year (77 requests)\n\nUpdated Reddit post (line 66):\n- Before: \"20+ downloads in the past month\"\n- Afte\n[…]\nion rate suggests onboarding friction\n- Historical data (/past_year) is primary use case\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Update Reddit post with real usage data from production DB",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T20:25:40Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "0e979d1ecfe13993d9382354c4dac2ee1cb073d8",
"body": "- Added Quick Start one-liner at top\n- Removed defensive language (\"not a toy project\")\n- Changed \"proper\" to \"comprehensive\" (less subjective)\n- Asked for feedback: \"What should I prioritize?\"\n- Added real usage stats: 20+ downloads/month\n- Prepared answers for common questions\n- Posting strategy and timing guidance\n\nReady to post Tuesday-Thursday 9-11am EST\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Final Reddit post with Sr. QA Engineer improvements",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T20:13:17Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "feb0d95020f183f89cef71d28bb6b440ca7b7583",
"body": "- Credible claims backed by real code\n- Transparent about roadmap items\n- Technical depth (jitter, connection pooling, error handling)\n- Invites community contribution\n- Ready to post Tuesday-Thursday morning\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add honest Reddit post for current SDK state",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T20:07:32Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "6528e3dab3b4ce02067a9d93376206e64b15885e",
"body": "- Add jitter to exponential backoff (prevents thundering herd)\n- Configure connection pool limits (max 100 concurrent, 20 keepalive)\n- Comprehensive test suite for retry strategy\n- Improves production resilience under high load\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Phase 1: Add retry jitter and connection pool limits",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T20:03:27Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "5c3983054623c8b7de55934dd43715da1eb6fb98",
"body": "Marketing Materials:\n- REDDIT_POST_TEMPLATE.md: Ready-to-use Reddit post with engagement strategy\n- SESSION_SUMMARY_SDK.md: Complete session summary and next steps\n\nReddit Post Ready:\n- 3 title options (value-focused recommended)\n- Full post body with code examples\n- Engagement strategy and sample r\n[…]\nsignup\n2. Post to r/Python\n3. Engage actively for 2-3 hours\n4. Track metrics daily\n5. Update baseline after 24 hours\n\nExpected Impact: 50-100 upvotes, 2-3x download spike\n\n🤖 Generated with Claude Code",
"is_bot": false,
"headline": "Add Reddit post template and session summary",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T19:59:27Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8893fa96c25d0ea1c4b7d35715494843e2f44ebd",
"body": "Documentation Added:\n- GITHUB_ISSUES_SDK.md: 12 prioritized growth issues (P1-P3)\n- PERFORMANCE_BASELINE.md: Baseline metrics before Reddit campaign\n- README.md: Enhanced with download badge and quick start\n\nCurrent Metrics (Baseline 2025-11-25):\n- PyPI Downloads: 1,019 total, 7/day average\n- Last 3\n[…]\narget: 2x downloads (15/day)\n- 90-day target: 7x downloads (50/day)\n- First Reddit post: 20-50 download spike expected\n\nNext: Reddit post to r/Python, track metrics daily\n\n🤖 Generated with Claude Code",
"is_bot": false,
"headline": "Prepare Python SDK for Reddit marketing launch",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T19:55:26Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8a7359c614c907238ff7d841e45c060297a1126d",
"body": "- Both emails sent via Postmark with tracking enabled\n- Python Weekly: dc8a303c-b14f-442a-9921-8de7f2a1d3c1\n- PyCoder's Weekly: 2f85f78b-4072-4fda-a1e9-8328164eee2d\n- Added Postmark dashboard link for tracking\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Mark Python Weekly and PyCoder's Weekly emails as sent",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T19:28:12Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "2d0807c6c1e2c3962a57941ee6453f3c79b22d33",
"body": "- Web form at pythonweekly.com/submit returns 404\n- Updated instructions to email rahul@pythonweekly.com instead\n- Updated checklist to reflect PR #2809 completion\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Update Python Weekly submission method to email",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T18:59:54Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "572cdbe5726c43c1d4a9d73ca9098f4d247583e5",
"body": "awesome-python PR successfully created and submitted.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Update READY_TO_SUBMIT with PR #2809 link",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T15:47:05Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "a3d0edf9eb7bf1c71365dc6ae90f899f06c1be1c",
"body": "- Add downloads/month badge to README for transparency\n- Add Contributor Covenant Code of Conduct v2.1\n- Create comprehensive marketing action plan\n- Create Awesome Lists submission tracker\n- Improve community documentation\n\nThis addresses issue #528: PyPI Package Optimization and Marketing\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add PyPI marketing improvements and action plan",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T11:32:55Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3b213ec807f6014bc3fd2f259d25a395c5b0ea2f",
"body": "…ility\n\nFixes #2\n\nReplace relative markdown links with absolute GitHub URLs to ensure\nlinks work correctly on both GitHub and PyPI package page.\n\nChanges:\n- README.md: Fix examples/, EXAMPLES.md, LICENSE, CONTRIBUTING.md links\n- docs/index.md: Fix CONTRIBUTING.md and LICENSE links\n\nBefore: [EXAMPLES\n[…]\nverywhere\n\nThis resolves the 404 error at https://pypi.org/project/oilpriceapi/examples/\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: Convert relative links to absolute GitHub URLs for PyPI compatib…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-10-07T20:56:55Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "d07bfef69b6fee530be6d807bfb6a153c3233e68",
"body": "….com\n\n- Add 3 promotional badges to README (Website, Docs, Sign Up)\n- Add promotional footer section with value proposition and CTAs\n- Create docs/index.md with 25+ backlinks and complete SDK documentation\n- Create EXAMPLES.md with 12 real-world use cases and 30+ backlinks\n- Create GITHUB_TOPICS_SE\n[…]\n website sections\nExpected impact: 50-100% increase in SDK installations over 3-6 months\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add comprehensive SEO enhancements and backlinks to oilpriceapi…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-10-07T20:46:15Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "d6f6755a01fb8c2629b755cb46dc8c3688095d21",
"body": "Automated publishing using trusted publisher (OIDC).\nTriggers on GitHub releases.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "ci: Add GitHub Actions workflow for PyPI publishing",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-09-29T20:46:38Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "5ee9e9d9dfef414fb4436076b8103ae75be79ccf",
"body": "Removed internal development scripts, test utilities, and planning docs\nthat were used during SDK development but don't belong in the production\nrepository. This cleanup prepares the repo for PyPI publication.\n\nRemoved files:\n- Development scripts: CREATE_GITHUB_ISSUES.sh, generate_*.py utilities\n- \n[…]\ntegration/ is canonical location)\n\nRepository is now clean and ready for v1.0.0 release.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: Remove development artifacts from production repo",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-09-29T20:13:14Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "80f17b9bf42f48f774d9523a481111e908c493f2",
"body": "- Synchronous and asynchronous clients\n- Comprehensive error handling and logging\n- Type-safe Pydantic models\n- 94 unit tests + 6 integration tests\n- Full documentation and examples\n- Production-ready with 64% test coverage\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Initial commit: OilPriceAPI Python SDK v1.0.0",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-09-29T20:05:22Z",
"body_truncated": false,
"is_coding_agent": true
}
],
"releases_count": 11,
"commits_last_year": 82,
"latest_release_at": "2026-07-19T16:37:47Z",
"latest_release_tag": "v1.11.0",
"releases_from_tags": false,
"days_since_last_push": 4,
"active_weeks_last_year": 17,
"days_since_latest_release": 10,
"mean_days_between_releases": 13.7
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": true,
"health_percentage": 87,
"has_issue_template": false,
"has_code_of_conduct": true,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "oilpriceapi",
"exists": true,
"license": null,
"keywords": [
"oil",
"prices",
"api",
"commodities",
"energy",
"brent",
"wti",
"natural gas",
"source timestamps",
"finance",
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"Intended Audience :: Financial and Insurance Industry",
"Intended Audience :: Science/Research",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9",
"Topic :: Office/Business :: Financial",
"Topic :: Scientific/Engineering :: Information Analysis",
"Topic :: Software Development :: Libraries :: Python Modules",
"Typing :: Typed"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/oilpriceapi/",
"is_deprecated": false,
"latest_version": "1.11.0",
"repository_url": "https://github.com/oilpriceapi/python-sdk",
"versions_count": 20,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 728,
"first_published_at": "2025-09-29T21:05:54.900617Z",
"latest_published_at": "2026-07-19T16:38:55.842344Z",
"latest_version_yanked": null,
"days_since_latest_publish": 10
}
]
},
"popularity": {
"forks": 2,
"stars": 2,
"watchers": 0,
"fork_history": {
"days": [
{
"date": "2026-03-20",
"count": 1
},
{
"date": "2026-03-26",
"count": 1
}
],
"complete": true,
"collected": 2,
"total_forks": 2
},
"star_history": null,
"open_issues_and_prs": 0
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [
"examples"
],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"oilpriceapi/py.typed"
],
"toolchain_manifests": [],
"largest_source_bytes": 61566,
"source_files_sampled": 112,
"oversized_source_files": 1,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"pyproject.toml"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [],
"collected": true,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 13,
"malicious_count": 0,
"assessed_package": "pypi:oilpriceapi@1.11.0",
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "httpx",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.24.0"
},
{
"name": "pydantic",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.0.0"
},
{
"name": "python-dateutil",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.8.0"
},
{
"name": "typing-extensions",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=4.5.0"
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "httpx",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pydantic",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "python-dateutil",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "black",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "cachetools",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "click",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "jsonschema",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mypy",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "numpy",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pandas",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pre-commit",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-asyncio",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-cov",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-timeout",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "redis",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "rich",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "ruff",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "setuptools",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "websockets",
"direct": false,
"version": null,
"ecosystem": "pypi"
}
],
"collected": true,
"truncated": false,
"total_count": 20,
"direct_count": 3,
"indirect_count": 17
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 37,
"open_issues": 0,
"closed_ratio": 1,
"closed_issues": 39,
"closed_unmerged_prs": 0
},
"bus_factor": 1,
"bot_contributors": 1,
"top_contributors": [
{
"type": "User",
"login": "karlwaldman",
"commits": 74,
"avatar_url": "https://avatars.githubusercontent.com/u/12957260?v=4"
}
],
"contributors_sampled": 1,
"top_contributor_share": 1
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"github-pages.yml",
"live-tests.yml",
"publish.yml",
"test.yml",
"weekly-health.yml"
],
"has_docs_dir": true,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 9,
"reason": "binaries present in source code",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": null,
"reason": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 10,
"reason": "21 out of 21 merged PRs checked by a CI test -- score normalized to 10",
"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": 0,
"reason": "Found 0/22 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 3,
"reason": "project has 1 contributing companies or organizations -- score normalized to 3",
"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": 10,
"reason": "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": 10,
"reason": "30 commit(s) and 25 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": 10,
"reason": "packaging workflow 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": 10,
"reason": "security policy file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": 0,
"reason": "Project has not signed or included provenance with any releases.",
"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": 10,
"reason": "0 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "f7b92634173dd9c86cdc5e078cba2019bca6cd38",
"ran_at": "2026-07-29T23:53:08Z",
"aggregate_score": 5.6,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": true,
"has_dependabot_config": true
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-29T23:39:29Z",
"oldest_open_prs": [],
"last_merged_pr_at": "2026-07-25T18:29:05Z",
"ci_last_conclusion": "FAILURE",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/OilpriceAPI/python-sdk",
"host": "github.com",
"name": "python-sdk",
"owner": "OilpriceAPI"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 65,
"inputs": {
"security": 66,
"vitality": 81,
"community": 42,
"governance": 58,
"engineering": 77
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 81,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "good",
"name": "Development activity",
"note": null,
"notes": [],
"value": 75,
"inputs": {
"commits_last_year": 82,
"human_commit_share": 0.902,
"days_since_last_push": 4,
"active_weeks_last_year": 17
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 4 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 4
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "17/52 weeks with commits",
"points": 11.8,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 17
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "82 commits in the last year",
"points": 17.2,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 82
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 25 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"releases_count": 11,
"latest_release_tag": "v1.11.0",
"releases_from_tags": false,
"days_since_latest_release": 10,
"mean_days_between_releases": 13.7
},
"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 10 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 10
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~13.7 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 13.7
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"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": 4,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 4 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 4
}
}
],
"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": 42,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "critical",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 1,
"inputs": {
"forks": 2,
"stars": 2,
"watchers": 0,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "2 stars",
"points": 0,
"status": "missed",
"details": [
{
"code": "stars",
"params": {
"count": 2
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "2 forks",
"points": 0,
"status": "missed",
"details": [
{
"code": "forks",
"params": {
"count": 2
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "0 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 0
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "excellent",
"name": "Community health",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": true,
"has_issue_template": false,
"has_code_of_conduct": true,
"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": 18,
"status": "met",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 13.5,
"status": "met",
"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": "at_risk",
"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": 48,
"inputs": {
"packages": [
"oilpriceapi"
],
"dependents": null,
"ecosystems": "pypi",
"total_downloads": null,
"monthly_downloads": 728
},
"components": [
{
"key": "monthly_downloads",
"name": "Monthly downloads",
"detail": "728 downloads/month across pypi",
"points": 38.2,
"status": "partial",
"details": [
{
"code": "downloads_monthly",
"params": {
"count": 728,
"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": 58,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 13,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 1,
"top_contributor_share": 1
},
"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 100% of commits",
"points": 0,
"status": "missed",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 100
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "1 contributors",
"points": 1.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 1
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "excellent",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"merged_prs": 37,
"open_issues": 0,
"closed_issues": 39,
"issue_closed_ratio": 1,
"closed_unmerged_prs": 0
},
"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": "37/37 decided PRs merged",
"points": 38.2,
"status": "met",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 37,
"decided": 37
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 0/22 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": null,
"notes": [],
"value": 51,
"inputs": {
"followers": 7,
"owner_type": "Organization",
"is_verified": null,
"owner_login": "OilpriceAPI",
"public_repos": 18,
"account_age_days": 968
},
"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": "7 followers of OilpriceAPI",
"points": 6.5,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 7,
"login": "OilpriceAPI"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "18 public repos, account ~2 yr old",
"points": 14.6,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 18
}
},
{
"code": "account_age_years",
"params": {
"years": 2
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"oilpriceapi"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 10
},
"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 10 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 10
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "20 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 20
}
}
],
"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": "good",
"name": "Engineering Quality",
"value": 77,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "moderate",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 68,
"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": "5 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 5
}
}
],
"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": "21 out of 21 merged PRs checked by a CI test -- score normalized to 10",
"points": 20,
"status": "met",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "excellent",
"name": "Documentation",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"topics": [
"api-client",
"async",
"energy",
"oil-prices",
"pydantic",
"python",
"sdk",
"trading",
"commodity-prices",
"commodities",
"financial-data",
"wti",
"brent-crude",
"commodity-data",
"energy-api",
"natural-gas",
"oil-price",
"openbb",
"pypi"
],
"has_wiki": false,
"homepage": "https://pypi.org/project/oilpriceapi/",
"has_readme": true,
"has_docs_dir": true,
"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": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://pypi.org/project/oilpriceapi/",
"points": 15,
"status": "met",
"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": "19 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 19
}
}
],
"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": "moderate",
"name": "Security",
"value": 66,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "moderate",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Branch-Protection. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"branch_protection"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 57,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 17,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 1,
"scorecard_aggregate": 5.6
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "binaries present in source code",
"points": 6.8,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "21 out of 21 merged PRs checked by a CI test -- score normalized to 10",
"points": 2.5,
"status": "met",
"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 0/22 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 0.8,
"status": "partial",
"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": "update tool detected",
"points": 7.5,
"status": "met",
"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": "30 commit(s) and 25 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow detected",
"points": 5,
"status": "met",
"details": [],
"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 detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"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": "0 existing vulnerabilities detected",
"points": 7.5,
"status": "met",
"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:oilpriceapi@1.11.0 runtime dependency closure — what installing the published package pulls in — 13 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:oilpriceapi@1.11.0",
"assessed": 13
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 100,
"inputs": {
"source": "osv",
"advisories": 0,
"affected_packages": 0,
"assessed_packages": 13,
"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": 13,
"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": 2
},
"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": "moderate",
"name": "AI Readiness",
"value": 51,
"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.973,
"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": "72 of 74 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 72,
"sampled": 74
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "moderate",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 51,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [
"oilpriceapi/py.typed"
],
"agent_commit_share": 0.695,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0.098
},
"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": "oilpriceapi/py.typed",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "oilpriceapi/py.typed"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "57 of the last 82 commits agent-authored or agent-credited",
"points": 10,
"status": "met",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 57,
"sampled": 82
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "8 of the last 82 commits are automated dependency updates",
"points": 8,
"status": "met",
"details": [
{
"code": "dependency_bot_commits",
"params": {
"count": 8,
"sampled": 82
}
}
],
"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": "good",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 82,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 61566,
"source_files_sampled": 112,
"oversized_source_files": 1
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python with type-check config (oilpriceapi/py.typed)",
"points": 27,
"status": "partial",
"details": [
{
"code": "typecheck_config_language",
"params": {
"files": "oilpriceapi/py.typed",
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "1/112 source files over 60KB",
"points": 54.5,
"status": "partial",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 112,
"oversized": 1
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "at_risk",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"example_dirs": [
"examples"
],
"has_mcp_signal": false,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": "examples",
"points": 40,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "examples"
}
}
],
"max_points": 40
}
]
}
],
"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"
],
"report_type": "repository",
"generated_at": "2026-07-29T23:53:22.941455Z",
"schema_version": "0.27.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/o/OilpriceAPI/python-sdk.svg",
"full_name": "OilpriceAPI/python-sdk",
"license_state": "standard",
"license_spdx": "MIT"
}
Пов’язані записи
Перевірені репозиторії, що мають спільні каталожні теги або екосистеми з OilpriceAPI/python-sdk. Читати поруч →
Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.
Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v1.13.0, схема v0.27.0 — повна методологія · вікі метрик.
