zeo_connector 0.1.0

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:

Start the ZEO storage server.

Usage: /usr/local/bin/runzeo [-C URL] [-a ADDRESS] [-f FILENAME] [-h]

Options:
-C/--configuration URL -- configuration file or URL
-a/--address ADDRESS -- server address of the form PORT, HOST:PORT, or PATH
                        (a PATH must contain at least one "/")
-f/--filename FILENAME -- filename for FileStorage
-t/--timeout TIMEOUT -- transaction timeout in seconds (default no timeout)
-h/--help -- print this usage message and exit
-m/--monitor ADDRESS -- address of monitor server ([HOST:]PORT or PATH)
--pid-file PATH -- relative path to output file containing this process's pid;
                   default $(INSTANCE_HOME)/var/ZEO.pid but only if envar
                   INSTANCE_HOME is defined

Unless -C is specified, -a and -f are required.

Example of the server configuration file zeo_server.conf:

<zeo>
  address localhost:60985
</zeo>

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

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

You should change the path properties.

Command to run the ZEO with the server configuration file:

runzeo -C zeo_server.conf