README.rst 1.5 KB

12345678910111213141516171819202122232425262728293031323334
  1. Note: This package is **deprecated**. It is highly preferred that instead of
  2. using this code base that instead `fasteners`_ or `oslo.concurrency`_ is
  3. used instead. For any questions or comments or further help needed
  4. please email `openstack-dev`_ and prefix your email subject
  5. with ``[oslo][pylockfile]`` (for a faster response).
  6. The lockfile package exports a LockFile class which provides a simple API for
  7. locking files. Unlike the Windows msvcrt.locking function, the fcntl.lockf
  8. and flock functions, and the deprecated posixfile module, the API is
  9. identical across both Unix (including Linux and Mac) and Windows platforms.
  10. The lock mechanism relies on the atomic nature of the link (on Unix) and
  11. mkdir (on Windows) system calls. An implementation based on SQLite is also
  12. provided, more as a demonstration of the possibilities it provides than as
  13. production-quality code.
  14. Note: In version 0.9 the API changed in two significant ways:
  15. * It changed from a module defining several classes to a package containing
  16. several modules, each defining a single class.
  17. * Where classes had been named SomethingFileLock before the last two words
  18. have been reversed, so that class is now SomethingLockFile.
  19. The previous module-level definitions of LinkFileLock, MkdirFileLock and
  20. SQLiteFileLock will be retained until the 1.0 release.
  21. To install:
  22. python setup.py install
  23. * Documentation: http://docs.openstack.org/developer/pylockfile
  24. * Source: http://git.openstack.org/cgit/openstack/pylockfile
  25. * Bugs: http://bugs.launchpad.net/pylockfile