| Name | pyqldb JSON |
| Version |
3.2.4
JSON |
| download |
| home_page | None |
| Summary | Python driver for Amazon QLDB |
| upload_time | 2024-04-23 18:43:31 |
| maintainer | None |
| docs_url | None |
| author | Amazon Web Services |
| requires_python | None |
| license | Apache License 2.0 |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Amazon QLDB Python Driver
[](https://pypi.python.org/pypi/pyqldb)
[](https://amazon-qldb-driver-python.readthedocs.io/en/latest/?badge=latest)
[](https://github.com/awslabs/amazon-qldb-driver-python/actions?query=workflow%3A%22Python+application%22)
[](https://github.com/awslabs/amazon-qldb-driver-python/blob/master/LICENSE)
[](https://aws.amazon.com/qldb/)
This is the Python driver for [Amazon Quantum Ledger Database (QLDB)](https://aws.amazon.com/qldb/), which allows Python developers
to write software that makes use of Amazon QLDB.
For getting started with the driver, see [Python and Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started.python.html).
## Requirements
### Basic Configuration
See [Accessing Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/accessing.html) for information on connecting to AWS.
### Required Python versions
Pyqldb 2.x requires Python 3.4 or later.
Pyqldb 3.x requires Python 3.6 or later.
Please see the link below for more detail to install Python:
* [Python Installation](https://www.python.org/downloads/)
## Getting Started
Please see the [Quickstart guide for the Amazon QLDB Driver for Python](https://docs.aws.amazon.com/qldb/latest/developerguide/driver-quickstart-python.html).
First, install the driver using pip:
```pip install pyqldb```
Then from a Python interpreter, call the driver and specify the ledger name:
```python
from pyqldb.driver.qldb_driver import QldbDriver
qldb_driver = QldbDriver(ledger_name='test-ledger')
for table in qldb_driver.list_tables():
print(table)
```
### See Also
1. [Getting Started with Amazon QLDB Python Driver](https://amazon-qldb-driver-python.readthedocs.io/en/stable/guide/getting_started.html) A guide that gets you started with executing transactions with the QLDB Python driver.
2. [QLDB Python Driver Cookbook](https://amazon-qldb-driver-python.readthedocs.io/en/stable/guide/cookbook.html) The cookbook provides code samples for some simple QLDB Python driver use cases.
3. [Amazon QLDB Python Driver Tutorial](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started.python.tutorial.html): In this tutorial, you use the QLDB Driver for Python to create an Amazon QLDB ledger and populate it with tables and sample data.
4. [Amazon QLDB Python Driver Samples](https://github.com/aws-samples/amazon-qldb-dmv-sample-python): A DMV based example application which demonstrates how to use QLDB with the QLDB Driver for Python.
5. QLDB Python driver accepts and returns [Amazon ION](http://amzn.github.io/ion-docs/) Documents. Amazon Ion is a richly-typed, self-describing, hierarchical data serialization format offering interchangeable binary and text representations. For more information read the [ION docs](https://readthedocs.org/projects/ion-python/).
6. Amazon QLDB supports the [PartiQL](https://partiql.org/) query language. PartiQL provides SQL-compatible query access across multiple data stores containing structured data, semistructured data, and nested data. For more information read the [PartiQL docs](https://partiql.org/docs.html).
7. Refer the section [Common Errors while using the Amazon QLDB Drivers](https://docs.aws.amazon.com/qldb/latest/developerguide/driver-errors.html) which describes runtime errors that can be thrown by the Amazon QLDB Driver when calling the qldb-session APIs.
## Development
### Setup
Assuming that you have Python and `virtualenv` installed, set up your environment and installed the dependencies
like this instead of the `pip install pyqldb` defined above:
```
$ git clone https://github.com/awslabs/amazon-qldb-driver-python
$ cd amazon-qldb-driver-python
$ virtualenv venv
...
$ . venv/bin/activate
$ pip install -r requirements.txt
$ pip install -e .
```
### Running Tests
You can run the unit tests with this command:
```
$ pytest --cov-report term-missing --cov=pyqldb tests/unit
```
You can run the integration tests with this command:
```
$ pytest tests/integration
```
### Documentation
Sphinx is used for documentation. You can generate HTML locally with the following:
```
$ pip install -r requirements-docs.txt
$ pip install -e .
$ cd docs
$ make html
```
## Getting Help
Please use these community resources for getting help.
* Ask a question on StackOverflow and tag it with the [amazon-qldb](https://stackoverflow.com/questions/tagged/amazon-qldb) tag.
* Open a support ticket with [AWS Support](http://docs.aws.amazon.com/awssupport/latest/user/getting-started.html).
* Make a new thread at [AWS QLDB Forum](https://forums.aws.amazon.com/forum.jspa?forumID=353&start=0).
* If you think you may have found a bug, please open an [issue](https://github.com/awslabs/amazon-qldb-driver-python/issues/new).
## Opening Issues
If you encounter a bug with the Amazon QLDB Python Driver, we would like to hear about it. Please search the [existing issues](https://github.com/awslabs/amazon-qldb-driver-python/issues) and see if others are also experiencing the issue before opening a new issue. When opening a new issue, we will need the version of Amazon QLDB Python Driver, Python language version, and OS you're using. Please also include reproduction case for the issue when appropriate.
The GitHub issues are intended for bug reports and feature requests. For help and questions with using Amazon QLDB Python Driver, please make use of the resources listed in the [Getting Help](https://github.com/awslabs/amazon-qldb-driver-python#getting-help) section. Keeping the list of open issues lean will help us respond in a timely manner.
## License
This library is licensed under the Apache 2.0 License.
Raw data
{
"_id": null,
"home_page": null,
"name": "pyqldb",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Amazon Web Services",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/69/b5/311f8772027aedf977a53d7f2029d1f3f382c8f63edfc629358d1e4427c0/pyqldb-3.2.4.tar.gz",
"platform": null,
"description": "# Amazon QLDB Python Driver\n\n[](https://pypi.python.org/pypi/pyqldb)\n[](https://amazon-qldb-driver-python.readthedocs.io/en/latest/?badge=latest)\n[](https://github.com/awslabs/amazon-qldb-driver-python/actions?query=workflow%3A%22Python+application%22)\n[](https://github.com/awslabs/amazon-qldb-driver-python/blob/master/LICENSE)\n[](https://aws.amazon.com/qldb/)\n\nThis is the Python driver for [Amazon Quantum Ledger Database (QLDB)](https://aws.amazon.com/qldb/), which allows Python developers\nto write software that makes use of Amazon QLDB.\n\nFor getting started with the driver, see [Python and Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started.python.html).\n## Requirements\n\n### Basic Configuration\n\nSee [Accessing Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/accessing.html) for information on connecting to AWS.\n\n### Required Python versions\n\nPyqldb 2.x requires Python 3.4 or later.\n\nPyqldb 3.x requires Python 3.6 or later. \n\nPlease see the link below for more detail to install Python:\n\n* [Python Installation](https://www.python.org/downloads/)\n\n## Getting Started\n\nPlease see the [Quickstart guide for the Amazon QLDB Driver for Python](https://docs.aws.amazon.com/qldb/latest/developerguide/driver-quickstart-python.html).\n\nFirst, install the driver using pip:\n\n```pip install pyqldb```\n\n\nThen from a Python interpreter, call the driver and specify the ledger name:\n\n```python\nfrom pyqldb.driver.qldb_driver import QldbDriver\n\nqldb_driver = QldbDriver(ledger_name='test-ledger')\n\nfor table in qldb_driver.list_tables():\n print(table)\n```\n\n### See Also\n\n1. [Getting Started with Amazon QLDB Python Driver](https://amazon-qldb-driver-python.readthedocs.io/en/stable/guide/getting_started.html) A guide that gets you started with executing transactions with the QLDB Python driver.\n2. [QLDB Python Driver Cookbook](https://amazon-qldb-driver-python.readthedocs.io/en/stable/guide/cookbook.html) The cookbook provides code samples for some simple QLDB Python driver use cases. \n3. [Amazon QLDB Python Driver Tutorial](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started.python.tutorial.html): In this tutorial, you use the QLDB Driver for Python to create an Amazon QLDB ledger and populate it with tables and sample data.\n4. [Amazon QLDB Python Driver Samples](https://github.com/aws-samples/amazon-qldb-dmv-sample-python): A DMV based example application which demonstrates how to use QLDB with the QLDB Driver for Python.\n5. QLDB Python driver accepts and returns [Amazon ION](http://amzn.github.io/ion-docs/) Documents. Amazon Ion is a richly-typed, self-describing, hierarchical data serialization format offering interchangeable binary and text representations. For more information read the [ION docs](https://readthedocs.org/projects/ion-python/).\n6. Amazon QLDB supports the [PartiQL](https://partiql.org/) query language. PartiQL provides SQL-compatible query access across multiple data stores containing structured data, semistructured data, and nested data. For more information read the [PartiQL docs](https://partiql.org/docs.html).\n7. Refer the section [Common Errors while using the Amazon QLDB Drivers](https://docs.aws.amazon.com/qldb/latest/developerguide/driver-errors.html) which describes runtime errors that can be thrown by the Amazon QLDB Driver when calling the qldb-session APIs.\n\n## Development\n\n### Setup\n\nAssuming that you have Python and `virtualenv` installed, set up your environment and installed the dependencies\nlike this instead of the `pip install pyqldb` defined above:\n\n```\n$ git clone https://github.com/awslabs/amazon-qldb-driver-python\n$ cd amazon-qldb-driver-python\n$ virtualenv venv\n...\n$ . venv/bin/activate\n$ pip install -r requirements.txt\n$ pip install -e .\n```\n\n### Running Tests\n\nYou can run the unit tests with this command:\n\n```\n$ pytest --cov-report term-missing --cov=pyqldb tests/unit\n```\n\nYou can run the integration tests with this command:\n```\n$ pytest tests/integration\n```\n\n### Documentation \n\nSphinx is used for documentation. You can generate HTML locally with the following:\n\n```\n$ pip install -r requirements-docs.txt\n$ pip install -e .\n$ cd docs\n$ make html\n```\n\n## Getting Help\n\nPlease use these community resources for getting help.\n* Ask a question on StackOverflow and tag it with the [amazon-qldb](https://stackoverflow.com/questions/tagged/amazon-qldb) tag.\n* Open a support ticket with [AWS Support](http://docs.aws.amazon.com/awssupport/latest/user/getting-started.html).\n* Make a new thread at [AWS QLDB Forum](https://forums.aws.amazon.com/forum.jspa?forumID=353&start=0).\n* If you think you may have found a bug, please open an [issue](https://github.com/awslabs/amazon-qldb-driver-python/issues/new).\n\n## Opening Issues\n\nIf you encounter a bug with the Amazon QLDB Python Driver, we would like to hear about it. Please search the [existing issues](https://github.com/awslabs/amazon-qldb-driver-python/issues) and see if others are also experiencing the issue before opening a new issue. When opening a new issue, we will need the version of Amazon QLDB Python Driver, Python language version, and OS you're using. Please also include reproduction case for the issue when appropriate.\n\nThe GitHub issues are intended for bug reports and feature requests. For help and questions with using Amazon QLDB Python Driver, please make use of the resources listed in the [Getting Help](https://github.com/awslabs/amazon-qldb-driver-python#getting-help) section. Keeping the list of open issues lean will help us respond in a timely manner.\n\n## License\n\nThis library is licensed under the Apache 2.0 License.\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Python driver for Amazon QLDB",
"version": "3.2.4",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "69b5311f8772027aedf977a53d7f2029d1f3f382c8f63edfc629358d1e4427c0",
"md5": "da46324d59a1d5f2d0edd46d1a6472a0",
"sha256": "c98e3c605e7d02356a5c2fa92770ba4a8ef98265d672b67ec56487878fa206fc"
},
"downloads": -1,
"filename": "pyqldb-3.2.4.tar.gz",
"has_sig": false,
"md5_digest": "da46324d59a1d5f2d0edd46d1a6472a0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 23383,
"upload_time": "2024-04-23T18:43:31",
"upload_time_iso_8601": "2024-04-23T18:43:31.908658Z",
"url": "https://files.pythonhosted.org/packages/69/b5/311f8772027aedf977a53d7f2029d1f3f382c8f63edfc629358d1e4427c0/pyqldb-3.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-23 18:43:31",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyqldb"
}
