docs: update Database.find()

Author: joonas-yoon

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Supports to find by key and value with `Condition` that is generated from `Key`.
+
 Thanks for getting this release out! please stay tuned :)
 
 ## [0.2.3] - 2023-01-18

docs/source/examples/database/basic.rst

@@ -111,13 +111,30 @@ Multiple items
 Find
 ^^^^
 
+You can find objects with passing lambda function to handle each items. For example:
+
 .. code-block:: python
 
     >>> db.find(lambda x: x['type'].endswith('e'))
     ['2g4kaFAiDBPchz66HNPsZa', 'dpKsCc7evmV7Mxq8ikgY89', 'fewugXnJHosmaXeqbXrLtD']
     >>> db.get(['2g4kaFAiDBPchz66HNPsZa', 'dpKsCc7evmV7Mxq8ikgY89', 'fewugXnJHosmaXeqbXrLtD'])
     [{'id': 1001, 'type': 'Chocolate'}, {'id': 1002, 'type': 'Orange'}, {'id': 1003, 'type': 'Apple'}]
 
+Also we provide flexible wrappers for `==`, `!=`, `<`, `<=`, `>`, `>=` to comparison operators.
+
+.. code-block:: python
+
+    >>> from json_as_db import Key
+    >>> db = Database()
+    >>> db.add([{'product': 'Chocolate', 'amount': 10}, {'product': 'Orange', 'amount': 1}, {'product': 'Apple', 'amount': 3}])
+    ['oTTno3xwizirjM6skVrZsi', 'Gw9pwyeV6cXJbHkT3sSUaW', 'LVw4smsL9WRgtRo5bTSnuX']
+    >>> db.find(Key('type') == 'Chocolate')
+    ['oTTno3xwizirjM6skVrZsi']
+    >>> db.find(Key('product') > 'Apple')
+    ['oTTno3xwizirjM6skVrZsi', 'Gw9pwyeV6cXJbHkT3sSUaW']
+    >>> db.find(Key('amount') <= 3)
+    ['Gw9pwyeV6cXJbHkT3sSUaW', 'LVw4smsL9WRgtRo5bTSnuX']
+
 
 Commit & Rollback
 ^^^^^^^^^^^^^^^^^