Releases

Release notes for aerospike-py. See all releases on GitHub.

v0.0.5​

Released: 2026-03-29

What's Changed​

Features​

• ping() health check: Lightweight cluster liveness check via info("build") to a random node. Returns True/False without raising. Useful for K8s readiness probes and load-balancer health checks (#248)
• Consolidated improvements: Exception handler, backpressure retry, observability endpoints (#232)
• Unified BatchRecords API: All batch operations return BatchRecords NamedTuple with per-record result codes, numpy key digest fix (#239)

Bug Fixes​

• Test cluster_name: Make test cluster_name configurable via env var (#230)
• CI Node.js memory: Increase Node.js memory for docs build

CI/CD​

• claude-code-action workflows: Replace gh-aw with claude-code-action for issue planning, implementation, and PR review
• Agentic workflow improvements: opus-4-6 model, high effort, max-turns 300, auto-fix MEDIUM severity issues

Dependencies​

• bump actions/deploy-pages from 4 to 5
• bump typescript from 5.9.3 to 6.0.2 in /docs
• bump recharts from 3.8.0 to 3.8.1 in /docs
• bump actions/download-artifact from 6.0.0 to 8.0.1
• bump actions/upload-artifact from 6.0.0 to 7.0.0
• bump github/gh-aw from 0.43.4 to 0.61.2

Full Changelog: https://github.com/aerospike-ce-ecosystem/aerospike-py/compare/v0.0.4...v0.0.5

v0.0.4​

Released: 2026-03-22

What's Changed​

• feat(skills): unify 6 api-* skills into single aerospike-py skill by @KimSoungRyoul in https://github.com/aerospike-ce-ecosystem/aerospike-py/pull/204
• fix(#203): BatchRecord/BatchRecords NamedTuple + 문서 예제 수정 + 테스트 개편 by @KimSoungRyoul in https://github.com/aerospike-ce-ecosystem/aerospike-py/pull/205
• fix: address post-#205 review issues by @KimSoungRyoul in https://github.com/aerospike-ce-ecosystem/aerospike-py/pull/206
• feat(ci): add gh-aw IssueOps + CommentOps workflows by @KimSoungRyoul in https://github.com/aerospike-ce-ecosystem/aerospike-py/pull/208
• feat: add operation-level backpressure via Semaphore by @KimSoungRyoul in https://github.com/aerospike-ce-ecosystem/aerospike-py/pull/213
• refactor(ci): redesign IssueOps/CommentOps with plan-first workflow by @KimSoungRyoul in https://github.com/aerospike-ce-ecosystem/aerospike-py/pull/216
• chore: upgrade aerospike-core alpha.9 → alpha.10 + sync node lookup refactor by @KimSoungRyoul in https://github.com/aerospike-ce-ecosystem/aerospike-py/pull/218
• test+docs: add get_node_names integration tests and fix async docs by @github-actions[bot] in https://github.com/aerospike-ce-ecosystem/aerospike-py/pull/219

New Contributors​

• @github-actions[bot] made their first contribution in https://github.com/aerospike-ce-ecosystem/aerospike-py/pull/219

Full Changelog: https://github.com/aerospike-ce-ecosystem/aerospike-py/compare/v0.0.3...v0.0.4

v0.0.3​

Released: 2026-03-09

What's Changed​

• ci: trigger docs rebuild on GitHub Release publish by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/179
• refactor: improve project structure, type safety, testing, and docs by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/180
• fix(sample-fastapi): Podman 지원 및 테스트 불일치 수정 by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/181
• ci(docs): GitHub Release 시 docs:version 자동 freeze by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/182
• refactor(tests): 테스트 코드 정리 (하드코딩 제거, 중복 삭제, 어설션 강화) by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/183
• ci: add security audit job and dependabot configuration by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/184
• ci: add docs build verification job by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/185
• chore: add GitHub issue templates by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/186
• refactor: extract client_ops.rs, OtelContext, unsafe lint (~1,200줄 중복 제거) by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/187
• docs: add architecture overview and troubleshooting guide by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/188
• docs: add FAQ and API comparison guide by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/192
• test: expand concurrency tests (23 → 45 tests) by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/189
• test: expand property-based tests (17 → 36 tests) by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/190
• feat: expose conn_pools_per_node config and expand error handling docs by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/193
• feat: add HyperLogLog CDT operation helpers by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/194
• feat: add Bitwise CDT operation helpers by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/195
• ci: add benchmark workflow for performance regression tracking by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/199
• ci: remove benchmark workflow from GitHub Actions by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/200
• chore(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/196
• chore(deps): bump recharts from 3.7.0 to 3.8.0 in /docs by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/197
• chore(deps): bump actions/setup-node from 4 to 6 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/198
• fix: correct bit_operations test op codes and Rust formatting by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/201
• chore: update .tokeignore and README code stats by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/202

Full Changelog: https://github.com/KimSoungRyoul/aerospike-py/compare/v0.0.2...v0.0.3

v0.0.2​

Released: 2026-03-07

What's Changed​

• improve: security, error handling, packaging, and dev tooling improvements by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/155
• improve: CI hardening, NumPy safety, async_client factory, and project infrastructure by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/156
• chore(deps): bump astral-sh/setup-uv from 5 to 7 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/158
• chore(deps): bump actions/setup-python from 5 to 6 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/159
• chore(deps): bump actions/upload-artifact from 4 to 6 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/160
• chore(deps): bump actions/setup-node from 4 to 6 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/162
• chore(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/163
• chore(deps-dev): bump typescript from 5.6.3 to 5.9.3 in /docs by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/161
• chore(deps): bump the rust-deps group in /rust with 4 updates by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/164
• chore(deps): bump recharts from 2.15.4 to 3.7.0 in /docs by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/157
• perf: eliminate double GIL acquisition and add metrics toggle API by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/165
• docs: refactor benchmark dashboard and update performance visualizations by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/166
• docs(i18n): complete Korean translations and make English the default by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/167
• docs: redesign site with Aerospike brand theme and improve homepage by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/168
• docs: restructure benchmark dashboard to 3-category layout by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/169
• refactor: deduplicate tests with parametrize and sync/async invoke helper by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/171
• fix: bytes key digest compatibility with official client by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/170
• chore(deps): bump actions/upload-pages-artifact from 3 to 4 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/174
• chore(deps): bump actions/upload-artifact from 6 to 7 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/175
• chore(deps): bump actions/download-artifact from 4 to 8 by @dependabot[bot] in https://github.com/KimSoungRyoul/aerospike-py/pull/176
• fix: harden input validation for policy/query/numpy conversion paths by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/177
• fix: harden numpy batch write conversion by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/178

New Contributors​

• @dependabot[bot] made their first contribution in https://github.com/KimSoungRyoul/aerospike-py/pull/158

Full Changelog: https://github.com/KimSoungRyoul/aerospike-py/compare/v0.0.1...v0.0.2

v0.0.1​

Released: 2026-02-26

What's Changed​

• perf: reduce PyO3 binding CPU overhead by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/146
• bench: enhance benchmark with percentage format and batch_write_numpy by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/147
• perf: reduce PyO3 binding CPU overhead with OTel fast-path and runtime tuning by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/148
• fix: resolve potential panics and improve code quality by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/149
• bench: add process-level CPU measurement and ops/CPU-sec metric by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/150
• bench: add process-level CPU efficiency metrics and docs dashboard by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/151
• Add Claude Code GitHub Workflow by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/152
• improve: project-wide safety, DRY, config, and docs improvements by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/153
• improve: project quality improvements (code, tests, docs, CI) by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/154

Full Changelog: https://github.com/KimSoungRyoul/aerospike-py/compare/v0.0.1.beta2...v0.0.1

v0.0.1.beta2​

Released: 2026-02-22

What's Changed​

• feat: add bug report logging for unexpected internal errors by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/144
• docs: add versioning infrastructure and tab-separate CDT operations by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/145

Full Changelog: https://github.com/KimSoungRyoul/aerospike-py/compare/v0.0.1.beta1...v0.0.1.beta2

v0.0.1.beta1​

Released: 2026-02-22

What's Changed​

• feat: add docstrings to .pyi stubs and auto-generate Docusaurus API docs by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/120
• test: add compatibility bug-hunting tests against official aerospike client by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/124
• docs: improve CLAUDE.md with dev workflow and tooling info by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/126
• docs: add Types reference and reorganize guides into 4 categories by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/128
• feat: introduce NamedTuple/TypedDict type system for all API returns by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/127
• chore: add Claude Code automations and consolidate compose files by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/129
• chore: add run-tests skill and change default port to 18710 by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/130
• fix: pass AEROSPIKE env vars through tox and fix broken doc links by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/131
• refactor: remove deprecated Scan API and restructure CLAUDE.md by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/132
• feat: add project-goals skill for planning context by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/133
• refactor: comprehensive codebase improvements across all layers by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/134
• docs: restructure and condense documentation for readability by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/137
• docs(rust): add doc comments to all public items and document unsafe Safety by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/138
• docs: enhance all 7 SKILL.md files with accurate references and guides by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/136
• feat: add batch_write_numpy API and improve NumpyBatchRecords by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/139
• Split monolithic SKILL.md into 6 domain-specific skill files by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/140
• docs: restructure sidebar with sub-categories and fix broken links by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/142
• docs: split CRUD into Read/Write, merge CDT into Operations by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/143

Full Changelog: https://github.com/KimSoungRyoul/aerospike-py/compare/v0.0.1.alpha6...v0.0.1.beta1

v0.0.1.alpha4​

Released: 2026-02-15

Changes​

• fix: correct PEP 440 to Cargo semver version conversion in publish workflow
• feat: add info_all() and info_random_node() to Client & AsyncClient
• feat: add server.address, server.port, db.aerospike.cluster_name tracing attributes

v0.0.1.alpha3​

Released: 2026-02-09

What's Changed​

• fix: add missing AerospikeTimeoutError and AerospikeIndexError to type stubs by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/85
• fix: improve type precision in exp.pyi and predicates.pyi stubs by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/89
• docs: translate Korean docstrings to English in numpy_batch.py by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/86
• refactor: add all exports to all public Python submodules by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/87
• docs: translate benchmark/RESULTS.md from Korean to English by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/90
• docs: update CONTRIBUTING.md to recommend uv workflow by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/88
• perf: add Cargo release profile with LTO and single codegen unit by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/92
• perf: use cached DEFAULT_READ_POLICY in select() and exists() by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/93
• test: add unit tests for predicates module by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/95
• chore: add PyPI classifiers, keywords, and project URLs by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/94
• chore: add explicit ruff lint configuration to pyproject.toml by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/91
• chore: add lint, fmt, and additional test targets to Makefile by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/96

Full Changelog: https://github.com/KimSoungRyoul/aerospike-py/compare/v0.0.1.alpha...v0.0.1.alpha3

v0.0.1.alpha​

Released: 2026-02-09

What's Changed​

• fix: add timeout to bad-host tests and remove unused config by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/49
• docs: Docusaurus로 문서 시스템 마이그레이션 및 가독성 개선 by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/51
• chore: relicense to Apache-2.0, expand tests, add FastAPI example by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/52
• perf: cache default policies for put/get hot path by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/53
• feat: benchmark report JSON + React Tabs UI by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/54
• fix: benchmark report side effects and timing inconsistencies by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/55
• fix: redesign homepage and translate benchmark reports to English by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/56
• refactor: improve type safety, explicit exports, rank key clarity by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/57
• refactor: migrate benchmark charts from matplotlib to Recharts by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/58
• docs: add FastAPI integration guide by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/59
• feat: add numpy batch_read support with dedicated benchmark by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/61
• Comprehensive code quality improvements (Rust, Python, Docs, Benchmark) by @KimSoungRyoul in https://github.com/KimSoungRyoul/aerospike-py/pull/62

Full Changelog: https://github.com/KimSoungRyoul/aerospike-py/compare/v0.0.1.dev2...v0.0.1.alpha

v0.0.1.dev2​

Released: 2026-02-07

v0.0.1.dev2​

Initial development release of aerospike-py.

• Aerospike Python Client powered by PyO3 + Rust
• License: AGPL-3.0-only