Metadata-Version: 2.0
Name: RelStorage
Version: 2.1a2
Summary: A backend for ZODB that stores pickles in a relational database.
Home-page: http://relstorage.readthedocs.io/
Author: Shane Hathaway
Author-email: shane@willowrise.com
License: ZPL 2.1
Keywords: ZODB SQL RDBMS MySQL PostgreSQL Oracle
Platform: any
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Unix
Requires-Dist: cffi
Requires-Dist: perfmetrics
Requires-Dist: zc.lockfile
Requires-Dist: zope.interface
Requires-Dist: ZEO (>=4.3.1,<5.0); python_full_version < '2.7.9'
Requires-Dist: ZODB (>=4.4.3,<5.0); python_full_version < '2.7.9'
Requires-Dist: ZEO (>=4.3.1); python_full_version == '3.6.0rc1'
Requires-Dist: ZODB (>=4.4.3); python_full_version == '3.6.0rc1'
Requires-Dist: ZEO (>=4.3.1); python_full_version >= '2.7.9'
Requires-Dist: ZODB (>=4.4.3); python_full_version >= '2.7.9'
Provides-Extra: mysql
Requires-Dist: mysqlclient (>=1.3.7); platform_python_implementation=="CPython" and python_version == "2.7" and extra == 'mysql'
Provides-Extra: mysql
Requires-Dist: mysqlclient (>=1.3.7); platform_python_implementation=="CPython" and python_version >= "3.3" and extra == 'mysql'
Provides-Extra: mysql
Requires-Dist: PyMySQL (>=0.6.6); platform_python_implementation=="PyPy" and extra == 'mysql'
Provides-Extra: oracle
Requires-Dist: cx-Oracle (>=5.0.0); extra == 'oracle'
Provides-Extra: postgresql
Requires-Dist: psycopg2 (>=2.6.1);  platform_python_implementation == "CPython" and extra == 'postgresql'
Provides-Extra: postgresql
Requires-Dist: psycopg2cffi (>=2.7.4);  platform_python_implementation == "PyPy" and extra == 'postgresql'
Provides-Extra: test
Requires-Dist: ZODB[test]; extra == 'test'
Requires-Dist: mock; extra == 'test'
Requires-Dist: random2; extra == 'test'
Requires-Dist: zc.zlibstorage; extra == 'test'
Requires-Dist: zope.testing; extra == 'test'

RelStorage is a storage implementation for ZODB that stores pickles in
a relational database. PostgreSQL 9.0 and above (performance is best
with 9.5 and above), MySQL 5.0.32+ / 5.1.34+, and Oracle 10g and 11g
are currently supported. RelStorage replaced the PGStorage project.


==========
 Features
==========

* It is a drop-in replacement for FileStorage and ZEO.
* There is a simple way to convert FileStorage to RelStorage and back again.
  You can also convert a RelStorage instance to a different relational database.
* Designed for high volume sites: multiple ZODB instances can share the same
  database. This is similar to ZEO, but RelStorage does not require ZEO.
* According to some tests, RelStorage handles high concurrency better than
  the standard combination of ZEO and FileStorage.
* Whereas FileStorage takes longer to start as the database grows due to an
  in-memory index of all objects, RelStorage starts quickly regardless of
  database size.
* Supports undo, packing, and filesystem-based ZODB blobs.
* Both history-preserving and history-free storage are available.
* Capable of failover to replicated SQL databases.
* ``zodbconvert`` utility to copy databases.
* Free, open source (ZPL 2.1)


===============
 Documentation
===============

Documentation including `installation instructions`_ is hosted on `readthedocs`_.

The complete `changelog`_ is also there.

.. image:: https://readthedocs.org/projects/relstorage/badge/?version=latest
     :target: http://relstorage.readthedocs.io/en/latest/?badge=latest


.. _`installation instructions`: http://relstorage.readthedocs.io/en/latest/install.html
.. _`readthedocs`: http://relstorage.readthedocs.io/en/latest/
.. _`changelog`: http://relstorage.readthedocs.io/en/latest/changelog.html


=============
 Development
=============

RelStorage is hosted at GitHub:

    https://github.com/zodb/relstorage

Continuous integration
----------------------

A test suite is run for every push and pull request submitted. Travis
CI is used to test on Linux, and AppVeyor runs the builds on
Windows.

.. image:: https://travis-ci.org/zodb/relstorage.svg?branch=master
    :target: https://travis-ci.org/zodb/relstorage

.. image:: https://ci.appveyor.com/api/projects/status/pccddlgujdoqvl83?svg=true
   :target: https://ci.appveyor.com/project/jamadden/relstorage/branch/master

Builds on Travis CI automatically submit updates to `coveralls.io`_ to
monitor test coverage.

.. image:: https://coveralls.io/repos/zodb/relstorage/badge.svg?branch=master&service=github
   :target: https://coveralls.io/github/zodb/relstorage?branch=master

Likewise, builds on Travis CI will automatically submit updates to
`landscape.io`_ to monitor code health (adherence to PEP8, absence of
common code smells, etc).

.. image:: https://landscape.io/github/zodb/relstorage/master/landscape.svg?style=flat
   :target: https://landscape.io/github/zodb/relstorage/master
   :alt: Code Health

.. _coveralls.io: https://coveralls.io/github/zodb/relstorage
.. _landscape.io: https://landscape.io/github/zodb/relstorage


