A Pythonic interface for Amazon’s DynamoDB that supports Python 2 and 3.
DynamoDB is a great NoSQL service provided by Amazon, but the API is verbose. PynamoDB presents you with a simple, elegant API.
Useful links:
See the full documentation at http://pynamodb.readthedocs.org/
Ask questions at Google group
See release notes at http://pynamodb.readthedocs.org/en/latest/release_notes.html
Installation
From PyPi:
$ pip install pynamodb
From GitHub:
$ pip install git+https://github.com/jlafon/PynamoDB#egg=pynamodb
Basic Usage
Create a model that describes your DynamoDB table.
from pynamodb.models import Model
from pynamodb.attributes import UnicodeAttribute
class UserModel(Model):
"""
A DynamoDB User
"""
class Meta:
table_name = "dynamodb-user"
email = UnicodeAttribute(null=True)
first_name = UnicodeAttribute(range_key=True)
last_name = UnicodeAttribute(hash_key=True)Now, search your table for all users with a last name of ‘Smith’ and whose first name begins with ‘J’:
for user in UserModel.query("Smith", first_name__begins_with="J"):
print(user.first_name)Create a new user:
user = UserModel("John", "Denver")
user.save()Retrieve an existing user:
try:
user = UserModel.get("John", "Denver")
print(user)
except UserModel.DoesNotExist:
print("User does not exist")Advanced Usage
Want to use indexes? No problem:
from pynamodb.models import Model
from pynamodb.indexes import GlobalSecondaryIndex, AllProjection
from pynamodb.attributes import NumberAttribute, UnicodeAttribute
class ViewIndex(GlobalSecondaryIndex):
class Meta:
read_capacity_units = 2
write_capacity_units = 1
projection = AllProjection()
view = NumberAttribute(default=0, hash_key=True)
class TestModel(Model):
class Meta:
table_name = "TestModel"
forum = UnicodeAttribute(hash_key=True)
thread = UnicodeAttribute(range_key=True)
view = NumberAttribute(default=0)
view_index = ViewIndex()Now query the index for all items with 0 views:
for item in TestModel.view_index.query(0):
print("Item queried from index: {0}".format(item))It’s really that simple.
Want to use DynamoDB local? Just add a host name attribute and specify your local server.
from pynamodb.models import Model
from pynamodb.attributes import UnicodeAttribute
class UserModel(Model):
"""
A DynamoDB User
"""
class Meta:
table_name = "dynamodb-user"
host = "http://localhost:8000"
email = UnicodeAttribute(null=True)
first_name = UnicodeAttribute(range_key=True)
last_name = UnicodeAttribute(hash_key=True)Features
Python 3 support
Python 2 support
An ORM-like interface with query and scan filters
Compatible with DynamoDB Local
Includes the entire DynamoDB API
Supports both unicode and binary DynamoDB attributes
Support for global secondary indexes, local secondary indexes, and batch operations
Provides iterators for working with queries, scans, that are automatically paginated
Automatic pagination for bulk operations
Complex queries
6 maintainers
Metadata
6 maintainers
Release files for pynamodb 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pynamodb-1.0.0.tar.gz | 35.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pynamodb-1.0.0-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 77.2 kB
Release files / pynamodb-1.0.0.tar.gz
| Download URL | pynamodb-1.0.0.tar.gz |
|---|---|
| Size | 35.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cb49601a2719f7e369c8458c4f22cdb5a222ea9d46d29dc604e4097126540d2e
|
|
BLAKE2b-256 checksum How to use checksums |
f0b2c19521ddbfd36bafffb323efb1341c997369c9a64d1dc706ac71a617e95b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / pynamodb-1.0.0-py2.py3-none-any.whl
| Download URL | pynamodb-1.0.0-py2.py3-none-any.whl |
|---|---|
| Size | 41.8 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
8f36f316df5b6d6b311611e785df5f1a4e9adde3a0cc71f53ca96472890a6b32
|
|
BLAKE2b-256 checksum How to use checksums |
f0442094469d7be8e4ce3e3981d0459774c07ce8b62a5d5b5ac6650cfed20a61
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
