Skip to content

v0.0.3

Choose a tag to compare

@github-actions github-actions released this 19 Oct 18:22
· 2 commits to main since this release
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