Skip to content

Releases

v0.0.4

Choose a tag to compare

@github-actions github-actions released this 29 Oct 15:12
715ddaf

🔄 Changed

  • Python 3.15 is supported (requires-python >=3.11,<3.16).

Full Changelog: v0.0.3...v0.0.4

v0.0.3

Choose a tag to compare

@github-actions github-actions released this 19 Oct 18:22
3cc46a0

🔄 Changed

  • Requires ddutils >= 0.4.0, < 0.5.0. The README wires the client registry with process_loop_scope from ddutils 0.4.0 instead of a scope function of its own, since the client completes its futures on the loop it was created in.

📝 Docs

  • Records: simple and composite bins, RootModel for typed lists and maps, a bin set to None is removed by the write and a record with no bins left is deleted by the server, filter_bins to leave a bin untouched, an empty map or list is a value so an optional composite needs a default, factory / to_entity / from_entity. The bare-datetime check covers the model's own fields only: a nested BaseModel with a bare datetime stores an ISO string that no filter matches, so AerospikeTimestamp goes inside composite models too. AerospikeDataWithPK.pk is None for a record written without send_key.
  • Manager: the checks at class definition, a table of the methods with their return values (get_map leaves out a key the batch could not answer, find_one picks an arbitrary match, put merges the model's bins and if_absent is create-only), what limit means: max_records is split across the nodes and treated as an upper bound, so a query may return fewer than limit records although more match, in no order and without a cursor. A *_policy_fields override replaces the whole dict, so extend DEFAULT_WRITE_POLICY and the others, or send_key=True is gone and queries stop returning pk; the defaults are tabulated. TTL semantics, Expiration.DONT_UPDATE without a TTL and the refusal of a namespace with nsup-period 0.
  • Filters: why the collection is bound to the record model (the server compares typed values, a value of another type matches nothing, silently), the scalar of every bin annotation, the operator table, IS_NULL as "the bin is missing" and NOT_EQUAL being false on a missing bin, one index filter per query and the pairs an index answers, the public building blocks.
  • Feature flag storage: get reads a malformed record as the defaults while get_map raises FeatureFlagStorageError on one, LIST_LIMIT of 1000 with an ERROR log, pk requires send_key=True, rename is put-then-delete.
  • AerospikeDsn requires the namespace and seeds is a string, unlike KafkaDsn.bootstrap_servers; the server versions the library was exercised on, the error hierarchy, the uvloop policy installed on import and AEROSPIKE_NO_UVLOOP. The layout follows dd-lib-stub, with a Compatibility section.

Full Changelog: v0.0.2...v0.0.3

v0.0.2

Choose a tag to compare

@github-actions github-actions released this 18 Oct 18:54
ab51b80

🔄 Changed

  • AerospikeManager.get_list / find_one pass limit to the server as QueryPolicy.max_records: the nodes stop once that many records are out instead of streaming the whole set to a client that reads one. The exact limit is still applied on the client, so the result is the same with far less work on the cluster.
  • client_factory is typed ConnectionManagerFactory[Any, Client, Any]: a project's factory with its own connection manager type passes the type checker.
  • get_map keeps returning only what the batch read: a key the batch could not answer (a timeout, a node away) is left out like a missing one; this is now documented.

Full Changelog: v0.0.1...v0.0.2

v0.0.1

Choose a tag to compare

@github-actions github-actions released this 18 Oct 17:31
9abac55

🚀 Added

  • dsn.AerospikeDsn: a settings field for a cluster, aerospike://host[:port][,host[:port]]/<namespace>, validated as a URL like pydantic's PostgresDsn; seeds is what new_client takes, namespace is required.
  • data.AerospikeData[Entity]: a record of a set, every field a bin. Scalars and plain containers are simple bins, a BaseModel / RootModel field is a composite bin stored as a map or list. Datetimes are declared as AerospikeTimestamp (integer microseconds, UTC); a bare datetime field or a bin name over 15 characters is rejected at class definition. Subclasses map to and from the domain through to_entity / from_entity.
  • filters.AerospikeFilterCollection(Model): the conditions of one query, bound to the record model: at most one secondary-index filter (equality on int / str, a range on int) and any number of filter expressions, ANDed. add_filter checks the bin and matches the value against the bin's scalar; values are normalized the way the server compares them (enums, UUIDs, datetimes, Decimal). Composite bins take is_null / is_not_null only.
  • manager.AerospikeManager[Data]: ORM-like access to one set: get, get_map, get_list, find_one, put (optionally create-only), delete, with a TTL set by every write and typed policy overrides. The client is obtained for every call from client_factory, a ConnectionManagerFactory from ddutils called with alias, which owns the client's scope and its close on shutdown.
  • feature_flags.AerospikeFeatureFlagStorage: the Aerospike backend of ddutils feature flags, one set, a flag per record, through an AerospikeManager[FeatureFlagData].

Supports Python 3.11–3.14 on aerospike-native 1.x.

Full Changelog: https://github.com/davyddd/ddaerospike/commits/v0.0.1