Metadata-Version: 1.1
Name: pylock
Version: 0.4
Summary: Python Distributed Lock
Home-page: http://github.com/waveaccounting/pylock
Author: Nathan Duthoit
Author-email: nathan@waveapps.com
License: BSD
Description: Usage
        -----
        
        ::
        
            from pylock import Lock
        
            with Lock('a_key', expires=60, timeout=10):
                # do something that should only be done one at a time
        
        Configuration
        -------------
        
        Backends
        ~~~~~~~~
        
        There are three available backends:
        
        Open (non-locking) backend
        ^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        ::
        
            DEFAULT_BACKEND = {
                'class': 'pylock.backends.open_lock.OpenLock',
                'connection': 'open://'
            }
        
        **Warning** This backend is not a real lock since it can always be
        acquired even if another instance has acquired it already. It is meant
        to be used for testing when you don't want to depend on a running redis
        or memcache instance and don't care about the lock working.
        
        Redis backend
        ^^^^^^^^^^^^^
        
        ::
        
            DEFAULT_BACKEND = {
                'class': 'pylock.backends.redis_lock.RedisLock',
                'connection': 'redis://'
            }
        
        Note: all fields after the scheme are optional, and will default to
        localhost on port 6379, using database 0.
        
        Memcache backend (coming soon)
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        ``DEFAULT_TIMEOUT`` (default: 60)
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        If another client has already obtained the lock, sleep for a maximum of
        this many seconds before giving up. A value of 0 means no wait (give up
        right away).
        
        The default timeout can be overridden when instantiating the lock.
        
        ``DEFAULT_EXPIRES`` (default: 10)
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        We consider any existing lock older than this many seconds to be invalid
        in order to detect crashed clients. This value must be higher than it
        takes the critical section to execute.
        
        The default expires can be overridden when instantiating the lock.
        
        ``KEY_PREFIX`` (default ``'pylock:'``)
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        This is used to prefix the key for the generated lock.
        
        For ``Lock('somekey')``, the generated key will be ``'pylock:somekey'``
        
        Inspired by
        -----------
        
        Redis backend
        ~~~~~~~~~~~~~
        
        The redis backend is almost an exact copy of Ben Bangert's
        ```retools.lock`` <https://github.com/bbangert/retools/blob/master/retools/lock.py>`_
        which is based on `Chris Lamb's
        example <https://chris-lamb.co.uk/posts/distributing-locking-python-and-redis>`_
        
        Memcache backend (coming soon)
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        The memcache backend is inspired by the following: -
        https://github.com/snbuback/DistributedLock -
        http://jbq.caraldi.com/2010/08/simple-distributed-lock-with-memcached.html
        -
        http://www.regexprn.com/2010/05/using-memcached-as-distributed-locking.html
        
        
        
        Notes related to the 0.4 release
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        Added a poetry lock file, but did not setup circleci builds
        To build and publish a release:
        poetry publish -r gemfury -u $GEMFURY_PUSH_TOKEN -p NOPASS --build 
        
        For testing I would suggest that you build and publish patch releases till it works in your app THEN publish a minor or major version
        because if you republish multiple builds at the same version it is very difficult to get your app to install the new ones.
        
        Poetry builds do not include test code the way that setup.py builds did.
        
Keywords: lock redis
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.7
