flockcontext 0.4.0

Improves fcntl.flock usage

Improves fcntl.flock usage.

flock is a Unix command for file locking, the mecanism that controls access restrictions of files.

Usage

Exclusive blocking lock:

from flockcontext import FlockOpen

with FlockOpen('/tmp/my.lock', 'w') as lock:
    lock.fd.write('Locked\n')

Exclusive blocking lock with 1 second timeout:

from flockcontext import FlockOpen

with FlockOpen('/tmp/my.lock', 'w', timeout=1) as lock:
    lock.fd.write('Locked\n')

Exclusive non-blocking lock:

from flockcontext import FlockOpen

try:
    with FlockOpen('/tmp/my.lock', 'w', blocking=False) as lock:
        lock.fd.write('Locked\n')
except IOError as e:
    print('Can not acquire lock')

Shared blocking lock:

from flockcontext import Flock

with FlockOpen('/tmp/my.lock', 'w', exclusive=False) as lock:
    lock.fd.write('Locked\n')

Acquire and release within context:

from flockcontext import FlockOpen

with FlockOpen('/tmp/my.lock', 'w') as lock:
    print('Lock acquired')
    lock.fd.write('Locked\n')

    lock.release()
    print('Lock released')

    lock.acquire()
    print('Lock acquired')
    lock.fd.write('Locked\n')

Locking already opened file:

from flockcontext import Flock

with open('/tmp/my.lock', 'w') as fd:
    with Flock(fd):
        fd.write('Locked\n')

License

• Free software: BSD license

History

0.4.0 (2019-07-03)

• Use docker for mutiple Python version testing from 2.7 to 3.7

• Add proper BSD licence file

• Add timeout for blocking lock

• Upgrade development status to Production/Stable

0.3.1 (2015-08-24)

• Add syntax highlighting for code exemples

• Add Flock manager exemple in README

0.3.0 (2015-08-21)

• Add FlockOpen context manager.

0.2.0 (2015-08-20)

• Add Flock relase and acquire capability withing context.

0.1.0 (2015-08-19)

• Add Flock context manager.