========
PynamoDB
========
.. image:: https://img.shields.io/pypi/v/pynamodb.svg
:target: https://pypi.python.org/pypi/pynamodb/
.. image:: https://img.shields.io/conda/vn/conda-forge/pynamodb.svg
:target: https://anaconda.org/conda-forge/pynamodb
.. image:: https://github.com/pynamodb/PynamoDB/workflows/Tests/badge.svg
:target: https://github.com/pynamodb/PynamoDB/actions
.. image:: https://img.shields.io/coveralls/pynamodb/PynamoDB/master.svg
:target: https://coveralls.io/github/pynamodb/PynamoDB
A Pythonic interface for Amazon's `DynamoDB <https://aws.amazon.com/dynamodb/>`_.
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 https://pynamodb.readthedocs.io/
* Ask questions in the `GitHub issues <https://github.com/pynamodb/PynamoDB/issues>`_
* See release notes at https://pynamodb.readthedocs.io/en/latest/release_notes.html
Installation
============
From PyPi::
$ pip install pynamodb
From GitHub::
$ pip install git+https://github.com/pynamodb/PynamoDB#egg=pynamodb
From conda-forge::
$ conda install -c conda-forge pynamodb
Basic Usage
===========
Create a model that describes your DynamoDB table.
.. code-block:: python
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)
PynamoDB allows you to create the table if needed (it must exist before you can use it!):
.. code-block:: python
UserModel.create_table(read_capacity_units=1, write_capacity_units=1)
Create a new user:
.. code-block:: python
user = UserModel("John", "Denver")
user.email = "djohn@company.org"
user.save()
Now, search your table for all users with a last name of 'Denver' and whose
first name begins with 'J':
.. code-block:: python
for user in UserModel.query("Denver", UserModel.first_name.startswith("J")):
print(user.first_name)
Examples of ways to query your table with filter conditions:
.. code-block:: python
for user in UserModel.query("Denver", UserModel.email=="djohn@company.org"):
print(user.first_name)
Retrieve an existing user:
.. code-block:: python
try:
user = UserModel.get("John", "Denver")
print(user)
except UserModel.DoesNotExist:
print("User does not exist")
Upgrade Warning
===============
The behavior of 'UnicodeSetAttribute' has changed in backwards-incompatible ways
as of the 1.6.0 and 3.0.1 releases of PynamoDB.
See `UnicodeSetAttribute upgrade docs <https://pynamodb.readthedocs.io/en/latest/release_notes.html>`_
for detailed instructions on how to safely perform the upgrade.
Advanced Usage
==============
Dax usage
.. code-block:: python
from pynamodb.models import Model
from pynamodb.indexes import GlobalSecondaryIndex, AllProjection
from pynamodb.attributes import NumberAttribute, UnicodeAttribute
class UserModel(Model):
"""
A DynamoDB User
"""
class Meta:
table_name = "dynamodb-user"
dax_read_endpoints = ['xxxx:8111']
dax_write_endpoints = ['xxxx:8111']
email = UnicodeAttribute(null=True)
first_name = UnicodeAttribute(range_key=True)
last_name = UnicodeAttribute(hash_key=True)
Want to use indexes? No problem:
.. code-block:: python
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:
.. code-block:: python
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.
.. code-block:: python
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)
Want to enable streams on a table? Just add a ``stream_view_type`` name attribute and specify
the type of data you'd like to stream.
.. code-block:: python
from pynamodb.models import Model
from pynamodb.attributes import UnicodeAttribute
from pynamodb.constants import STREAM_NEW_AND_OLD_IMAGE
class AnimalModel(Model):
"""
A DynamoDB Animal
"""
class Meta:
table_name = "dynamodb-user"
host = "http://localhost:8000"
stream_view_type = STREAM_NEW_AND_OLD_IMAGE
type = UnicodeAttribute(null=True)
name = UnicodeAttribute(range_key=True)
id = UnicodeAttribute(hash_key=True)
Features
========
* Python >= 3.7 support
* An ORM-like interface with query and scan filters
* Compatible with DynamoDB Local
* Supports the entire DynamoDB API
* Support for Unicode, Binary, JSON, Number, Set, and UTC Datetime attributes
* Support for Global and Local Secondary Indexes
* Provides iterators for working with queries, scans, that are automatically paginated
* Automatic pagination for bulk operations
* Complex queries
* Batch operations with automatic pagination
* Iterators for working with Query and Scan operations
Raw data
{
"_id": null,
"home_page": "https://github.com/thanakijwanavit/PynamoDB",
"name": "pynamodb-dax",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python dynamodb amazon dax",
"author": "Nic Wanavit (fork)",
"author_email": "nwanavit@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/07/ea/7f6ebc1fabeb9a4dc8e03a74cad5926ec10ce08f3f58660199154cebf521/pynamodb-dax-0.0.6.tar.gz",
"platform": null,
"description": "========\nPynamoDB\n========\n\n.. image:: https://img.shields.io/pypi/v/pynamodb.svg\n :target: https://pypi.python.org/pypi/pynamodb/\n.. image:: https://img.shields.io/conda/vn/conda-forge/pynamodb.svg\n :target: https://anaconda.org/conda-forge/pynamodb\n.. image:: https://github.com/pynamodb/PynamoDB/workflows/Tests/badge.svg\n :target: https://github.com/pynamodb/PynamoDB/actions\n.. image:: https://img.shields.io/coveralls/pynamodb/PynamoDB/master.svg\n :target: https://coveralls.io/github/pynamodb/PynamoDB\n\nA Pythonic interface for Amazon's `DynamoDB <https://aws.amazon.com/dynamodb/>`_.\n\nDynamoDB is a great NoSQL service provided by Amazon, but the API is verbose.\nPynamoDB presents you with a simple, elegant API.\n\nUseful links:\n\n* See the full documentation at https://pynamodb.readthedocs.io/\n* Ask questions in the `GitHub issues <https://github.com/pynamodb/PynamoDB/issues>`_\n* See release notes at https://pynamodb.readthedocs.io/en/latest/release_notes.html\n\nInstallation\n============\nFrom PyPi::\n\n $ pip install pynamodb\n\nFrom GitHub::\n\n $ pip install git+https://github.com/pynamodb/PynamoDB#egg=pynamodb\n\nFrom conda-forge::\n\n $ conda install -c conda-forge pynamodb\n\n\nBasic Usage\n===========\n\nCreate a model that describes your DynamoDB table.\n\n.. code-block:: python\n\n from pynamodb.models import Model\n from pynamodb.attributes import UnicodeAttribute\n\n class UserModel(Model):\n \"\"\"\n A DynamoDB User\n \"\"\"\n class Meta:\n table_name = \"dynamodb-user\"\n email = UnicodeAttribute(null=True)\n first_name = UnicodeAttribute(range_key=True)\n last_name = UnicodeAttribute(hash_key=True)\n\nPynamoDB allows you to create the table if needed (it must exist before you can use it!):\n\n.. code-block:: python\n\n UserModel.create_table(read_capacity_units=1, write_capacity_units=1)\n\nCreate a new user:\n\n.. code-block:: python\n\n user = UserModel(\"John\", \"Denver\")\n user.email = \"djohn@company.org\"\n user.save()\n\nNow, search your table for all users with a last name of 'Denver' and whose\nfirst name begins with 'J':\n\n.. code-block:: python\n\n for user in UserModel.query(\"Denver\", UserModel.first_name.startswith(\"J\")):\n print(user.first_name)\n\nExamples of ways to query your table with filter conditions:\n\n.. code-block:: python\n\n for user in UserModel.query(\"Denver\", UserModel.email==\"djohn@company.org\"):\n print(user.first_name)\n\nRetrieve an existing user:\n\n.. code-block:: python\n\n try:\n user = UserModel.get(\"John\", \"Denver\")\n print(user)\n except UserModel.DoesNotExist:\n print(\"User does not exist\")\n\nUpgrade Warning\n===============\n\nThe behavior of 'UnicodeSetAttribute' has changed in backwards-incompatible ways\nas of the 1.6.0 and 3.0.1 releases of PynamoDB.\n\nSee `UnicodeSetAttribute upgrade docs <https://pynamodb.readthedocs.io/en/latest/release_notes.html>`_\nfor detailed instructions on how to safely perform the upgrade.\n\nAdvanced Usage\n==============\nDax usage\n\n\n.. code-block:: python\n\n from pynamodb.models import Model\n from pynamodb.indexes import GlobalSecondaryIndex, AllProjection\n from pynamodb.attributes import NumberAttribute, UnicodeAttribute\n\n class UserModel(Model):\n \"\"\"\n A DynamoDB User\n \"\"\"\n class Meta:\n table_name = \"dynamodb-user\"\n dax_read_endpoints = ['xxxx:8111']\n dax_write_endpoints = ['xxxx:8111']\n email = UnicodeAttribute(null=True)\n first_name = UnicodeAttribute(range_key=True)\n last_name = UnicodeAttribute(hash_key=True)\n\nWant to use indexes? No problem:\n\n.. code-block:: python\n\n from pynamodb.models import Model\n from pynamodb.indexes import GlobalSecondaryIndex, AllProjection\n from pynamodb.attributes import NumberAttribute, UnicodeAttribute\n\n class ViewIndex(GlobalSecondaryIndex):\n class Meta:\n read_capacity_units = 2\n write_capacity_units = 1\n projection = AllProjection()\n view = NumberAttribute(default=0, hash_key=True)\n\n class TestModel(Model):\n class Meta:\n table_name = \"TestModel\"\n forum = UnicodeAttribute(hash_key=True)\n thread = UnicodeAttribute(range_key=True)\n view = NumberAttribute(default=0)\n view_index = ViewIndex()\n\nNow query the index for all items with 0 views:\n\n.. code-block:: python\n\n for item in TestModel.view_index.query(0):\n print(\"Item queried from index: {0}\".format(item))\n\nIt's really that simple.\n\n\nWant to use DynamoDB local? Just add a ``host`` name attribute and specify your local server.\n\n.. code-block:: python\n\n from pynamodb.models import Model\n from pynamodb.attributes import UnicodeAttribute\n\n class UserModel(Model):\n \"\"\"\n A DynamoDB User\n \"\"\"\n class Meta:\n table_name = \"dynamodb-user\"\n host = \"http://localhost:8000\"\n email = UnicodeAttribute(null=True)\n first_name = UnicodeAttribute(range_key=True)\n last_name = UnicodeAttribute(hash_key=True)\n\nWant to enable streams on a table? Just add a ``stream_view_type`` name attribute and specify\nthe type of data you'd like to stream.\n\n.. code-block:: python\n\n from pynamodb.models import Model\n from pynamodb.attributes import UnicodeAttribute\n from pynamodb.constants import STREAM_NEW_AND_OLD_IMAGE\n\n class AnimalModel(Model):\n \"\"\"\n A DynamoDB Animal\n \"\"\"\n class Meta:\n table_name = \"dynamodb-user\"\n host = \"http://localhost:8000\"\n stream_view_type = STREAM_NEW_AND_OLD_IMAGE\n type = UnicodeAttribute(null=True)\n name = UnicodeAttribute(range_key=True)\n id = UnicodeAttribute(hash_key=True)\n\nFeatures\n========\n\n* Python >= 3.7 support\n* An ORM-like interface with query and scan filters\n* Compatible with DynamoDB Local\n* Supports the entire DynamoDB API\n* Support for Unicode, Binary, JSON, Number, Set, and UTC Datetime attributes\n* Support for Global and Local Secondary Indexes\n* Provides iterators for working with queries, scans, that are automatically paginated\n* Automatic pagination for bulk operations\n* Complex queries\n* Batch operations with automatic pagination\n* Iterators for working with Query and Scan operations\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "fork to pynamodb for supporting dax",
"version": "0.0.6",
"project_urls": {
"Homepage": "https://github.com/thanakijwanavit/PynamoDB"
},
"split_keywords": [
"python",
"dynamodb",
"amazon",
"dax"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f3af362f44816aa9ed2d9ae55ff6fdee54db565e7759843c4e4dbce11d89585f",
"md5": "e99593e43714a243fe82e1ad85aa1c47",
"sha256": "06f294ed6a8f0cf1bf1098c307492db0588c4a64686be9ddf07e95977cde199e"
},
"downloads": -1,
"filename": "pynamodb_dax-0.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e99593e43714a243fe82e1ad85aa1c47",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 128528,
"upload_time": "2023-05-11T19:23:57",
"upload_time_iso_8601": "2023-05-11T19:23:57.236062Z",
"url": "https://files.pythonhosted.org/packages/f3/af/362f44816aa9ed2d9ae55ff6fdee54db565e7759843c4e4dbce11d89585f/pynamodb_dax-0.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "07ea7f6ebc1fabeb9a4dc8e03a74cad5926ec10ce08f3f58660199154cebf521",
"md5": "3800949f19d47331547340bc1ff53710",
"sha256": "fe699d609bc876ff757d1e332381cf40bc69e70336205665b68f76c69d3d4986"
},
"downloads": -1,
"filename": "pynamodb-dax-0.0.6.tar.gz",
"has_sig": false,
"md5_digest": "3800949f19d47331547340bc1ff53710",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 114787,
"upload_time": "2023-05-11T19:23:59",
"upload_time_iso_8601": "2023-05-11T19:23:59.326159Z",
"url": "https://files.pythonhosted.org/packages/07/ea/7f6ebc1fabeb9a4dc8e03a74cad5926ec10ce08f3f58660199154cebf521/pynamodb-dax-0.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-11 19:23:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "thanakijwanavit",
"github_project": "PynamoDB",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "pynamodb-dax"
}
JSON
