~ntt-pf-lab/nova/monkey_patch_notification

« back to all changes in this revision

Viewing changes to vendor/lockfile/README

  • Committer: Jesse Andrews
  • Date: 2010-05-28 06:05:26 UTC
  • Revision ID: git-v1:bf6e6e718cdc7488e2da87b21e258ccc065fe499
initial commit

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
The lockfile package exports a LockFile class which provides a simple API for
 
2
locking files.  Unlike the Windows msvcrt.locking function, the fcntl.lockf
 
3
and flock functions, and the deprecated posixfile module, the API is
 
4
identical across both Unix (including Linux and Mac) and Windows platforms.
 
5
The lock mechanism relies on the atomic nature of the link (on Unix) and
 
6
mkdir (on Windows) system calls.  An implementation based on SQLite is also
 
7
provided, more as a demonstration of the possibilities it provides than as
 
8
production-quality code.
 
9
 
 
10
Note: In version 0.9 the API changed in two significant ways:
 
11
 
 
12
 * It changed from a module defining several classes to a package containing
 
13
   several modules, each defining a single class.
 
14
 
 
15
 * Where classes had been named SomethingFileLock before the last two words
 
16
   have been reversed, so that class is now SomethingLockFile.
 
17
 
 
18
The previous module-level definitions of LinkFileLock, MkdirFileLock and
 
19
SQLiteFileLock will be retained until the 1.0 release.
 
20
 
 
21
To install:
 
22
 
 
23
    python setup.py install