This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

ABOUT

This is a native Python client library for the Kyoto Tycoon server, supporting both Python 2 and 3. It includes significant performance improvements and bug fixes over the (now seemingly unmaintained) original library by Toru Maesaka and Stephen Hamer.

For more information on Kyoto Tycoon server, please refer to:

http://fallabs.com/kyototycoon/

Along with this library we’re also maintaining an updated and ready-to-go fork of Kyoto Tycoon here:

https://github.com/sapo/kyoto

FEATURES

The more efficient binary protocol is also supported along with the HTTP protocol. It provides a performance improvement of up to 6x, but only the following operations are available:

  • get() and get_bulk()
  • set() and set_bulk()
  • remove() and remove_bulk()
  • play_script()

Atomic operations aren’t supported with the binary protocol, the use of “atomic=False” is mandatory when using it. Operations besides these will raise a NotImplementedError exception.

It’s possible to have two KyotoTycoon objects open to the same server in the same application, one using HTTP and the other using the binary protocol, if necessary.

The library does automatic packing and unpacking (marshalling) of values coming from/to the database. The following data storage formats are available by default:

  • KT_PACKER_PICKLE - Python “pickle” format.
  • KT_PACKER_JSON - JSON format (compact representation).
  • KT_PACKER_STRING - Strings (UTF-8).
  • KT_PACKER_BYTES - Binary data.

There is also a KT_PACKER_CUSTOM format available where you can specify your own object to do the marshalling. This object needs to provide the following two methods:

  • .pack(self, data) - convert “data” to bytes()
  • .unpack(self, data) - convert “data” from bytes()

Marshalling is done for all methods except play_script(), because the server can return data in more than one format at once. The caller will most likely know the type of data that the called script returns and must do the marshalling itself.

REPLICATION SLAVE

Since version 0.7.0 this library also contains a replication slave class. This class provides a consume() generator function that receives and parses transaction log entries from a Kyoto Tycoon master server into dictionaries.

This can be used to build your own custom replication schemes, like key filtering, or react to server “set”, “remove” or “clear” database operations.

Do note that only explicit operations create transaction log events. Implicit operations like key removal upon expiration don’t.

Unlike the client library, the replication slave always handles the “key” and “value” attributes as opaque binary data.

MEMCACHE-ENABLED SERVERS

Kyoto Tycoon supports a subset of the memcached protocol. When a server has this enabled including item flags, these are stored as the last 4 bytes of the value. Since version 0.7.3 of this library, there’s a custom packer included that transparently handles this and also includes gzip compression/decompression for scenarios where, for example, a Python application is writing HTML pages to the Kyoto server and an HTTP server is reading from it using a memcached client library.

Example:

from kyototycoon import KyotoTycoon, KT_PACKER_CUSTOM
from kyototycoon.packers import MemcachePacker

mp = MemcachePacker(gzip_enabled=True, gzip_flag=1)
kt = KyotoTycoon(pack_type=KT_PACKER_CUSTOM, custom_packer=mp)

kt.open("127.0.0.1", 1978)

kt.set("key", "value")
value = kt.get("key")

kt.close()

To handle (value, flags) pairs without any additional processing, the SimpleMemcachePacker can be used:

from kyototycoon import KyotoTycoon, KT_PACKER_CUSTOM
from kyototycoon.packers import SimpleMemcachePacker

smp = SimpleMemcachePacker()
kt = KyotoTycoon(pack_type=KT_PACKER_CUSTOM, custom_packer=smp)

kt.open("127.0.0.1", 1978)

kt.set("key", ("value", 123))
value, flags = kt.get("key")

kt.close()

COMPATIBILITY

This library is still not at version 1.0, which means the API and behavior are not guaranteed to remain consistent between versions.

Support for using an error object has been removed. If you need the old behavior for compatibility reasons, use a version up to (and including) v0.5.9. Versions later than this raise exceptions on all Kyoto Tycoon errors.

INSTALLATION

You can install the latest version of this library from source:

python setup.py build
python setup.py install

Or, you can install the latest stable release from PyPI:

pip install python-kyototycoon-ng

AUTHORS

Binary protocol support was added based on Ulrich Mierendorff’s code. You can find the original library at the following URL:

http://www.ulrichmierendorff.com/software/kyoto_tycoon/python_library.html
Release History

Release History

0.7.3

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.7.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.7.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
python-kyototycoon-ng-0.7.3.zip (13.7 kB) Copy SHA256 Checksum SHA256 Source Jan 20, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting