Welcome to TinyDB!

Welcome to TinyDB, your tiny, document oriented database optimized for your happiness :)

>>> from tinydb import TinyDB, Query
>>> db = TinyDB('path/to/db.json')
>>> User = Query()
>>> db.insert({'name': 'John', 'age': 22})
>>> db.search(User.name == 'John')
[{'name': 'John', 'age': 22}]

User’s Guide

• Introduction
  • Why Use TinyDB?
  • Why Not Use TinyDB?
• Getting Started
  • Installing TinyDB
  • Basic Usage
• Advanced Usage
  • Remarks on Storages
  • Queries
  • Handling Data
  • Using Element IDs
  • Tables
  • Storages & Middlewares
  • What’s next

Extending TinyDB

• Extending TinyDB
  • Write a Custom Storage
  • Write a Custom Middleware
  • Creating a Custom Table Classes
• TinyDB Extensions
  • tinyindex
  • tinymongo
  • tinyrecord
  • tinydb-serialization
  • tinydb-smartcache

API Reference

• API Documentation
  • tinydb.database
  • tinydb.queries
  • tinydb.storage
  • tinydb.middlewares

Additional Notes

• Contribution Guidelines
  • Philosophy of TinyDB
  • Code Conventions
  • Version Numbers
• Changelog
  • Version Numbering
  • v3.2.0 (2016-04-25)
  • v3.1.3 (2016-02-14)
  • v3.1.2 (2016-01-30)
  • v3.1.1 (2016-01-23)
  • v3.1.0 (2015-12-31)
  • v3.0.0 (2015-11-13)
  • v2.4.0 (2015-08-14)
  • v2.3.2 (2015-05-20)
  • v2.3.1 (2015-04-30)
  • v2.3.0 (2015-04-08)
  • v2.2.2 (2015-02-12)
  • v2.2.1 (2015-01-09)
  • v2.2.0 (2014-11-10)
  • v2.1.0 (2014-10-14)
  • v2.0.1 (2014-09-22)
  • v2.0.0 (2014-09-05)
  • v1.4.0 (2014-07-22)
  • v1.3.0 (2014-07-02)
  • v1.2.0 (2014-06-19)
  • v1.1.1 (2014-06-14)
  • v1.1.0 (2014-05-06)
  • v1.0.1 (2014-04-26)
  • v1.0.0 (2013-07-20)
• Upgrade Notes
  • Version 3.0
  • Version 2.0