zeo_connector 0.4.6

Documentation

This module defines three classes:

• ZEOWrapperPrototype

• ZEOConfWrapper

• ZEOWrapper

<zeoclient>
  server localhost:60985
</zeoclient>

from zeo_connector import ZEOConfWrapper

db_obj = ZEOConfWrapper(
    conf_path="/tests/data/zeo_client.conf",
    project_key="Some project key",
)

import transaction

with transaction.manager:
    db_obj["data"] = "some data"

from zeo_connector import ZEOWrapper

different_db_obj = ZEOWrapper(
    server="localhost",
    port=60985,
    project_key="Some project key",
)

import transaction

with transaction.manager:
    print different_db_obj["data"]

Running the ZEO server

The examples expects, that the ZEO server is running. To run the ZEO, look at the help page of the runzeo script which is part of the ZEO bundle. This script requires commandline or XML configuration.

You can generate the configuration files using provided zeo_connector_gen_defaults.py script, which is part of the zeo_connector_defaults <https://github.com/Bystroushaak/zeo_connector_defaults> package:

$ zeo_connector_gen_defaults.py --help
usage: zeo_connector_gen_defaults.py [-h] [-s SERVER] [-p PORT] [-C] [-S]
                                     [PATH]

This program will create the default ZEO XML configuration files.

positional arguments:
  PATH                  Path to the database on the server (used in server
                        configuration only.

optional arguments:
  -h, --help            show this help message and exit
  -s SERVER, --server SERVER
                        Server url. Default: localhost
  -p PORT, --port PORT  Port of the server. Default: 60985
  -C, --only-client     Create only CLIENT configuration.
  -S, --only-server     Create only SERVER configuration

For example:

$ zeo_connector_gen_defaults.py /tmp

will create zeo.conf file with following content:

<zeo>
  address localhost:60985
</zeo>

<filestorage>
  path /tmp/storage.fs
</filestorage>

<eventlog>
  level INFO
  <logfile>
    path /tmp/zeo.log
    format %(asctime)s %(message)s
  </logfile>
</eventlog>

and zeo_client.conf containing:

<zeoclient>
  server localhost:60985
</zeoclient>

You can change the ports and address of the server using --server or --port arguments.

To run the ZEO with the server configuration file, run the following command:

runzeo -C zeo.conf

To run the client, you may use ZEOConfWrapper, as was show above:

from zeo_connector import ZEOConfWrapper

db_obj = ZEOConfWrapper(
    conf_path="./zeo_client.conf",
    project_key="Some project key",
)

Installation

Module is hosted at PYPI, and can be easily installed using PIP:

sudo pip install zeo_connector

Source code

Project is released under the MIT license. Source code can be found at GitHub:

• https://github.com/Bystroushaak/zeo_connector

Unittests

You can run the tests using provided run_tests.sh script, which can be found in the root of the project.

If you have any trouble, just add --pdb switch at the end of your run_tests.sh command like this: ./run_tests.sh --pdb. This will drop you to PDB shell.

pip install --user pytest

sudo pip install pytest

$ ./run_tests.sh
============================= test session starts ==============================
platform linux2 -- Python 2.7.6 -- py-1.4.30 -- pytest-2.7.2
rootdir: /home/bystrousak/Plocha/Dropbox/c0d3z/python/libs/zeo_connector, inifile:
plugins: cov
collected 7 items

tests/test_zeo_connector.py .......

=========================== 7 passed in 7.08 seconds ===========================

0.4.6

• Cleanup of metadata files.

0.4.0 - 0.4.5

• Added @retry_and_reset decorator for all internal dict-methods calls.

• Project key is now optional, so this object may be used to access the root of the database.

• Property ASYNCORE_RUNNING renamed to _ASYNCORE_RUNNING.

• Implemented .pack().

• Added @transaction_manager.

• Added examples/database_handler.py and tests.

• Added @wraps(fn) to decorators.

• Added requirement for zope.interface.

• Attempt to solve https://github.com/WebArchivCZ/WA-KAT/issues/86

0.3.0

• Environment generator and other shared parts moved to https://github.com/Bystroushaak/zeo_connector_defaults

• README.rst improved, added more documentation and additional sections.

0.2.0

• Added standard dict methods, like .__contains__(), .__delitem__(), .__iter__() and so on.

0.1.0

• Project created.