Upgrading to Newer Releases¶

Version 3.0¶

Breaking API Changes¶

Querying (see Issue #62):
- where('...').contains('...') has been renamed to where('...').search('...').
- where('foo').has('bar') is replaced by either where('foo').bar or Query().foo.bar.
  - In case the key is not a valid Python identifier, array notation can be used: where('a.b.c') is now Query()['a.b.c'].

Checking for the existence of a key has to be done explicitely: where('foo').exists().

SmartCacheTable has been moved to msiemens/tinydb-smartcache.
Serialization has been moved to msiemens/tinydb-serialization.
Empty storages are now expected to return None instead of raising ValueError (see Issue #67).

Version 2.0¶

Breaking API Changes¶

The syntax query in db is not supported any more. Use db.contains(...) instead.
The ConcurrencyMiddleware has been removed due to a insecure implementation (see Issue #18). Consider tinyrecord instead.

Apart from that the API remains compatible to v1.4 and prior.

For migration from v1 to v2, check out the v2.0 documentation