Spaces:
Running
Running
Metadata-Version: 2.1 | |
Name: cassandra-driver | |
Version: 3.29.1 | |
Summary: DataStax Driver for Apache Cassandra | |
Home-page: http://github.com/datastax/python-driver | |
Author: DataStax | |
Project-URL: Documentation, https://docs.datastax.com/en/developer/python-driver/latest/ | |
Project-URL: Source, https://github.com/datastax/python-driver/ | |
Project-URL: Issues, https://datastax-oss.atlassian.net/browse/PYTHON | |
Keywords: cassandra,cql,orm,dse,graph | |
Classifier: Development Status :: 5 - Production/Stable | |
Classifier: Intended Audience :: Developers | |
Classifier: License :: OSI Approved :: Apache Software License | |
Classifier: Natural Language :: English | |
Classifier: Operating System :: OS Independent | |
Classifier: Programming Language :: Python | |
Classifier: Programming Language :: Python :: 3.8 | |
Classifier: Programming Language :: Python :: 3.9 | |
Classifier: Programming Language :: Python :: 3.10 | |
Classifier: Programming Language :: Python :: 3.11 | |
Classifier: Programming Language :: Python :: 3.12 | |
Classifier: Programming Language :: Python :: Implementation :: CPython | |
Classifier: Programming Language :: Python :: Implementation :: PyPy | |
Classifier: Topic :: Software Development :: Libraries :: Python Modules | |
Description-Content-Type: text/x-rst | |
License-File: LICENSE | |
Requires-Dist: geomet <0.3,>=0.1 | |
Provides-Extra: cle | |
Requires-Dist: cryptography >=35.0 ; extra == 'cle' | |
Provides-Extra: graph | |
Requires-Dist: gremlinpython ==3.4.6 ; extra == 'graph' | |
DataStax Driver for Apache Cassandra | |
==================================== | |
.. image:: https://travis-ci.com/datastax/python-driver.png?branch=master | |
:target: https://travis-ci.com/github/datastax/python-driver | |
A modern, `feature-rich <https://github.com/datastax/python-driver#features>`_ and highly-tunable Python client library for Apache Cassandra (2.1+) and | |
DataStax Enterprise (4.7+) using exclusively Cassandra's binary protocol and Cassandra Query Language v3. | |
The driver supports Python 3.8 through 3.12. | |
**Note:** DataStax products do not support big-endian systems. | |
Features | |
-------- | |
* `Synchronous <http://datastax.github.io/python-driver/api/cassandra/cluster.html#cassandra.cluster.Session.execute>`_ and `Asynchronous <http://datastax.github.io/python-driver/api/cassandra/cluster.html#cassandra.cluster.Session.execute_async>`_ APIs | |
* `Simple, Prepared, and Batch statements <http://datastax.github.io/python-driver/api/cassandra/query.html#cassandra.query.Statement>`_ | |
* Asynchronous IO, parallel execution, request pipelining | |
* `Connection pooling <http://datastax.github.io/python-driver/api/cassandra/cluster.html#cassandra.cluster.Cluster.get_core_connections_per_host>`_ | |
* Automatic node discovery | |
* `Automatic reconnection <http://datastax.github.io/python-driver/api/cassandra/policies.html#reconnecting-to-dead-hosts>`_ | |
* Configurable `load balancing <http://datastax.github.io/python-driver/api/cassandra/policies.html#load-balancing>`_ and `retry policies <http://datastax.github.io/python-driver/api/cassandra/policies.html#retrying-failed-operations>`_ | |
* `Concurrent execution utilities <http://datastax.github.io/python-driver/api/cassandra/concurrent.html>`_ | |
* `Object mapper <http://datastax.github.io/python-driver/object_mapper.html>`_ | |
* `Connecting to DataStax Astra database (cloud) <https://docs.datastax.com/en/developer/python-driver/latest/cloud/>`_ | |
* DSE Graph execution API | |
* DSE Geometric type serialization | |
* DSE PlainText and GSSAPI authentication | |
Installation | |
------------ | |
Installation through pip is recommended:: | |
$ pip install cassandra-driver | |
For more complete installation instructions, see the | |
`installation guide <http://datastax.github.io/python-driver/installation.html>`_. | |
Documentation | |
------------- | |
The documentation can be found online `here <http://datastax.github.io/python-driver/index.html>`_. | |
A couple of links for getting up to speed: | |
* `Installation <http://datastax.github.io/python-driver/installation.html>`_ | |
* `Getting started guide <http://datastax.github.io/python-driver/getting_started.html>`_ | |
* `API docs <http://datastax.github.io/python-driver/api/index.html>`_ | |
* `Performance tips <http://datastax.github.io/python-driver/performance.html>`_ | |
Object Mapper | |
------------- | |
cqlengine (originally developed by Blake Eggleston and Jon Haddad, with contributions from the | |
community) is now maintained as an integral part of this package. Refer to | |
`documentation here <http://datastax.github.io/python-driver/object_mapper.html>`_. | |
Contributing | |
------------ | |
See `CONTRIBUTING.md <https://github.com/datastax/python-driver/blob/master/CONTRIBUTING.rst>`_. | |
Error Handling | |
-------------- | |
While originally written for the Java driver, users may reference the `Cassandra error handling done right blog <https://www.datastax.com/blog/cassandra-error-handling-done-right>`_ for resolving error handling scenarios with Apache Cassandra. | |
Reporting Problems | |
------------------ | |
Please report any bugs and make any feature requests on the | |
`JIRA <https://datastax-oss.atlassian.net/browse/PYTHON>`_ issue tracker. | |
If you would like to contribute, please feel free to open a pull request. | |
Getting Help | |
------------ | |
Your best options for getting help with the driver are the | |
`mailing list <https://groups.google.com/a/lists.datastax.com/forum/#!forum/python-driver-user>`_ | |
and the `DataStax Community <https://community.datastax.com>`_. | |
License | |
------- | |
Copyright DataStax, Inc. | |
Licensed under the Apache License, Version 2.0 (the "License"); | |
you may not use this file except in compliance with the License. | |
You may obtain a copy of the License at | |
http://www.apache.org/licenses/LICENSE-2.0 | |
Unless required by applicable law or agreed to in writing, software | |
distributed under the License is distributed on an "AS IS" BASIS, | |
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
See the License for the specific language governing permissions and | |
limitations under the License. | |