forked from neithere/pyrant
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
51 lines (35 loc) · 1.64 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
Pyrant
======
Pyrant is a Python wrapper around Tokyo Tyrant. It provides:
* `pyrant.protocol` is a not-too-pythonic implementation of the Tyrant
protocol. It supports the table database and all Tyrant features but does not
attempt to do anything else;
* `pyrant.Tyrant` is a higher-level pythonic dict-like API;
* `pyrant.query` is a high-level API for complex queries (inspired by Django
ORM).
Usually you will only want to use the `Tyrant` class because it is built on top
of the `protocol` module and provides access to it and to the query API.
Documentation
-------------
See complete `HTML documentation <http://packages.python.org/pyrant/>`_
for details. Sometimes it may get slightly outdated. You can always have the
latest snapsnot by building it from the source (using Sphinx).
What is Tokyo Tyrant?
---------------------
`Tokyo Tyrant`_ is a network interface for Tokyo Cabinet.
`Tokyo Cabinet`_ is a lightweight database manager with several storages,
including a simple key/value storage and a document-oriented schemaless
database with powerful query machinery.
.. _Tokyo Cabinet: http://1978th.net/tokyocabinet/
.. _Tokyo Tyrant: http://1978th.net/tokyotyrant/
Models (schemata)
-----------------
Pyrant itself does not provide means for defining models, but our related project
`Docu`_ allows to do that easily.
.. _Docu: http://pypi.python.org/pypi/docu/
Community
---------
This application was originally created by Martin Conte Mac Donell with some
code from PyTyrant by Bob Ippolito. Pyrant was subsequently improved by other
developers. They are listed in the AUTHORS file.
Please feel free to file issues and/or submit patches.