A flat file database for json objects.
Project description
# jsondb
[![Build Status][travis-image]][travis-build]
[![PyPI version](https://badge.fury.io/py/jsondatabase.svg)](https://badge.fury.io/py/jsondatabase)
This is a utility for managing content in a database which stores
content in JSON format.
## Installation
This package can be installed from [PyPi](https://pypi.python.org/pypi/jsondatabase) by running:
```bash
pip install jsondatabase
```
Note, the package name and the import name are different.
Import the package using `import jsondb`.
## Usage
```python
from jsondb.db import Database
db = Database("mydata.db")
```
The database has an attribute which works similar to
[jQuery's `data`][jquery-data] attribute.
```python
# Getting all data
db = Database("mydata.db")
print(db.data())
```
```python
# Getting a stored value
db = Database("mydata.db")
print(db.data(key="user_count"))
```
**It is important to note that a key will be created regardless of whether it
exists as long as a value is provided.** The database has the same functionality
as a dictionary.
```python
# Setting a value
db = Database("mydata.db")
db.data(key="user_count", value=241)
```
```python
# Passing in a dictionary value
db = Database("mydata.db")
data = {
"user_id": 234565,
"user_name": "AwesomeUserName",
"is_moderator": True,
}
db.data(dictionary=data)
```
```python
# Deleting a value
db = Database("mydata.db")
db.delete("my_key")
```
The database also supports a dictionary-like syntax for retrieving, setting, and
removing values.
```python
db = Database("mydata.db")
# Retrieving a value
value = db["key"]
# Setting a value
db["key"] = value
# Removing a key
del db["key"]
# Checking if a key exists
"key" in db
```
## Performance
If performance is an issue with large databases then the `python-cjson` module
can be installed. jsondb will automatically detect this and use cjson instead.
[jquery-data]: http://api.jquery.com/data/
[travis-build]: https://travis-ci.org/gunthercox/jsondb
[travis-image]: https://travis-ci.org/gunthercox/jsondb.svg
History
-------
`See release notes
<https://github.com/gunthercox/jsondb/releases>`_
[![Build Status][travis-image]][travis-build]
[![PyPI version](https://badge.fury.io/py/jsondatabase.svg)](https://badge.fury.io/py/jsondatabase)
This is a utility for managing content in a database which stores
content in JSON format.
## Installation
This package can be installed from [PyPi](https://pypi.python.org/pypi/jsondatabase) by running:
```bash
pip install jsondatabase
```
Note, the package name and the import name are different.
Import the package using `import jsondb`.
## Usage
```python
from jsondb.db import Database
db = Database("mydata.db")
```
The database has an attribute which works similar to
[jQuery's `data`][jquery-data] attribute.
```python
# Getting all data
db = Database("mydata.db")
print(db.data())
```
```python
# Getting a stored value
db = Database("mydata.db")
print(db.data(key="user_count"))
```
**It is important to note that a key will be created regardless of whether it
exists as long as a value is provided.** The database has the same functionality
as a dictionary.
```python
# Setting a value
db = Database("mydata.db")
db.data(key="user_count", value=241)
```
```python
# Passing in a dictionary value
db = Database("mydata.db")
data = {
"user_id": 234565,
"user_name": "AwesomeUserName",
"is_moderator": True,
}
db.data(dictionary=data)
```
```python
# Deleting a value
db = Database("mydata.db")
db.delete("my_key")
```
The database also supports a dictionary-like syntax for retrieving, setting, and
removing values.
```python
db = Database("mydata.db")
# Retrieving a value
value = db["key"]
# Setting a value
db["key"] = value
# Removing a key
del db["key"]
# Checking if a key exists
"key" in db
```
## Performance
If performance is an issue with large databases then the `python-cjson` module
can be installed. jsondb will automatically detect this and use cjson instead.
[jquery-data]: http://api.jquery.com/data/
[travis-build]: https://travis-ci.org/gunthercox/jsondb
[travis-image]: https://travis-ci.org/gunthercox/jsondb.svg
History
-------
`See release notes
<https://github.com/gunthercox/jsondb/releases>`_
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
jsondatabase-0.1.3.tar.gz
(6.1 kB
view hashes)
Built Distribution
Close
Hashes for jsondatabase-0.1.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5f6907d8ca3f1cdad98e4aa4c1da7780f09a353debe58b11466d65fdbbe3e9b9 |
|
MD5 | 6642012eea0f93588f086039ec1b9ffb |
|
BLAKE2b-256 | 99036429ba501da482b642dbd68748746949553d959bd113020522f2427b9eb2 |