init project.

Author: hhstore

.gitignore

@@ -87,3 +87,19 @@ ENV/
 
 # Rope project settings
 .ropeproject
+
+
+# add 2016
+.DS_Store
+*.pyc
+*.pyo
+env
+env*
+dist
+*.egg-info
+_mailinglist
+.tox
+.idea/
+
+
+

README.md

@@ -1,2 +1,22 @@
 # tinydb-annotated
-tinydb 是用 Python 实现的一个很精巧的 nosql 数据库. 源码值得注解.
+- tinydb 是用 Python 实现的一个很精巧的 nosql 数据库. 
+- 源码值得注解.
+- [tinydb - github](https://github.com/msiemens/tinydb)
+
+
+## 版本选择:
+
+- 当前最新版本: [v3.2.0](https://github.com/msiemens/tinydb/releases/tag/v3.2.0)
+- 代码统计行数: 921(含注释)
+- 测试代码行数: 821(含注释)
+    - 暂时保留.
+    - 考虑有些测试用例,值得一看.
+
+
+```bash
+
+-> % find . -name "*.py" | xargs grep -v "^$" | wc -l
+     921
+
+
+```

tinydb-3.2.0/tests/__init__.py

@@ -0,0 +1,19 @@
+import pytest
+
+from tinydb.middlewares import CachingMiddleware
+from tinydb.storages import MemoryStorage
+from tinydb import TinyDB
+
+
+@pytest.fixture
+def db():
+    db_ = TinyDB(storage=MemoryStorage)
+    db_.purge_tables()
+    db_.insert_multiple({'int': 1, 'char': c} for c in 'abc')
+    return db_
+
+
+@pytest.fixture
+def storage():
+    _storage = CachingMiddleware(MemoryStorage)
+    return _storage()  # Initialize MemoryStorage

tinydb-3.2.0/tests/conftest.py

@@ -0,0 +1,99 @@
+import os
+
+from tinydb import TinyDB
+from tinydb.middlewares import CachingMiddleware
+from tinydb.storages import MemoryStorage, JSONStorage
+
+if 'xrange' not in dir(__builtins__):
+    # noinspection PyShadowingBuiltins
+    xrange = range  # Python 3 support
+
+
+element = {'none': [None, None], 'int': 42, 'float': 3.1415899999999999,
+           'list': ['LITE', 'RES_ACID', 'SUS_DEXT'],
+           'dict': {'hp': 13, 'sp': 5},
+           'bool': [True, False, True, False]}
+
+
+def test_caching(storage):
+    # Write contents
+    storage.write(element)
+
+    # Verify contents
+    assert element == storage.read()
+
+
+def test_caching_read():
+    db = TinyDB(storage=CachingMiddleware(MemoryStorage))
+    assert db.all() == []
+
+
+def test_caching_write_many(storage):
+    storage.WRITE_CACHE_SIZE = 3
+
+    # Storage should be still empty
+    assert storage.memory is None
+
+    # Write contents
+    for x in xrange(2):
+        storage.write(element)
+        assert storage.memory is None  # Still cached
+
+    storage.write(element)
+
+    # Verify contents: Cache should be emptied and written to storage
+    assert storage.memory
+
+
+def test_caching_flush(storage):
+    # Write contents
+    storage.write(element)
+
+    storage.flush()
+
+    # Verify contents: Cache should be emptied and written to storage
+    assert storage.memory
+
+
+def test_caching_write(storage):
+    # Write contents
+    storage.write(element)
+
+    storage.close()
+
+    # Verify contents: Cache should be emptied and written to storage
+    assert storage.storage.memory
+
+
+def test_nested():
+    storage = CachingMiddleware(MemoryStorage)
+    storage()  # Initialization
+
+    # Write contents
+    storage.write(element)
+
+    # Verify contents
+    assert element == storage.read()
+
+
+def test_caching_json_write(tmpdir):
+    path = str(tmpdir.join('test.db'))
+
+    db = TinyDB(path, storage=CachingMiddleware(JSONStorage))
+
+    db.insert({'key': 'value'})
+
+    db.close()
+
+    # Verify database filesize
+    statinfo = os.stat(path)
+    assert statinfo.st_size != 0
+
+    # Assert JSON file has been closed
+    assert db._storage._handle.closed
+
+    del db
+
+    # Repoen database
+    db = TinyDB(path, storage=CachingMiddleware(JSONStorage))
+    assert db.all() == [{'key': 'value'}]

tinydb-3.2.0/tests/test_middlewares.py

@@ -0,0 +1,17 @@
+from tinydb import where
+from tinydb.operations import delete, increment, decrement
+
+
+def test_delete(db):
+    db.update(delete('int'), where('char') == 'a')
+    assert 'int' not in db.get(where('char') == 'a')
+
+
+def test_increment(db):
+    db.update(increment('int'), where('char') == 'a')
+    assert db.get(where('char') == 'a')['int'] == 2
+
+
+def test_decrement(db):
+    db.update(decrement('int'), where('char') == 'a')
+    assert db.get(where('char') == 'a')['int'] == 0