NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #49 most downloaded on PyPI
A platform independent file lock.
Latest stable
4.3.0
Last release today
22 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
12 years old
147 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
- Fix README rendering on PyPI - by @adamchainz .
Fix README rendering on PyPI - by @adamchainz .
.. _release-3-0-8: *
- Fix a memory leak when acquiring locks on Python 2. issue #37 - by Benedikt Schmitt.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix a memory leak when acquiring locks on Python 2. issue #37 - by Benedikt Schmitt.
Fix a memory leak when acquiring locks on Python 2. 37 - by Benedikt Schmitt.
.. _release-3-0-4: *
.. _release-3-0-3: *
- Render the animated README example through a raw image URL on PyPI - by Benedikt Schmitt.
Render the animated README example through a raw image URL on PyPI - by Benedikt Schmitt.
Render the animated README example through a raw image URL on PyPI - by Benedikt Schmitt.
- Keep the Unix lock file after release to avoid a race between processes. issue #31 - by Benedikt Schmitt.
Keep the Unix lock file after release to avoid a race between processes. issue #31 - by Benedikt Schmitt.
Add navigation to the README - by Benedikt Schmitt.
Clarify when to use a separate lock file in the documentation. issue #22 - by Benedikt Schmitt.
Keep the Unix lock file after release to avoid a race between processes. 31 - by Benedikt Schmitt.
Add navigation to the README - by Benedikt Schmitt.
Clarify when to use a separate lock file in the documentation. 22 - by Benedikt Schmitt.
- Remove the Unix lock file after release() - by @spokorski .
Remove the Unix lock file after release() - by @spokorski .
Reraise lock errors correctly on Python 3 - by Benedikt Schmitt.
Remove the Unix lock file after ~filelock.BaseFileLock.release - by spokorski.
Reraise lock errors correctly on Python 3 - by Benedikt Schmitt.
- Acquire the logger only when first needed. issue #24 - by Benedikt Schmitt.
Acquire the logger only when first needed. issue #24 - by Benedikt Schmitt.
Acquire the logger only when first needed. 24 - by Benedikt Schmitt.
.. _release-2-0-11:
- Add official Python 2 support. issue #20 - by Benedikt Schmitt.
Add official Python 2 support. issue #20 - by Benedikt Schmitt.
.. _release-2-0-9: *
- Add example PR #16 - by @pypingou .
Add example PR #16 - by @pypingou .
Update change order of the examples ( PR #16 ) - by @pypingou .
Explain why the protected file needs a separate lock path. issue #19 - by Benedikt Schmitt.
Correct the Read the Docs URL - by Benedikt Schmitt.
Add example 16 - by pypingou.
Update change order of the examples (16) - by pypingou.
Explain why the protected file needs a separate lock path. 19 - by Benedikt Schmitt.
Correct the Read the Docs URL - by Benedikt Schmitt.
- Add logging for lock operations - by @expobrain .
Add logging for lock operations - by @expobrain .
- Keep the README and license out of the installed environment root while including them in the source archive. issue #14 - by Benedikt Schmitt.
Keep the README and license out of the installed environment root while including them in the source archive. issue #14 - by Benedikt Schmitt.
Keep the README and license out of the installed environment root while including them in the source archive. 14 - by Benedikt Schmitt.
- Clear the lock descriptor before unlocking on Unix and Windows, avoiding a repeated release. - by @cottsay .
Clear the lock descriptor before unlocking on Unix and Windows, avoiding a repeated release. - by @cottsay .
Clear the lock descriptor before unlocking on Unix and Windows, avoiding a repeated release. - by cottsay.
- Keep the lock file after release - by @kramarz .
Keep the lock file after release - by @kramarz .
Export BaseFileLock as a public class - by Benedikt Schmitt.
Show the complete public API in the reference page - by Benedikt Schmitt.
Keep the lock file after release - by kramarz.
Export ~filelock.BaseFileLock as a public class - by Benedikt Schmitt.
Show the complete public API in the reference page - by Benedikt Schmitt.
- Export the platform-specific lock classes consistently through __all__ - by Benedikt Schmitt.
Export the platform-specific lock classes consistently through all - by Benedikt Schmitt.
Export the platform-specific lock classes consistently through __all__ - by Benedikt Schmitt.
- Treat Windows lock contention as a timeout instead of raising IOError . issue #5 - by Benedikt Schmitt.
Treat Windows lock contention as a timeout instead of raising IOError . issue #5 - by Benedikt Schmitt.
Avoid an extra acquisition for with lock.acquire(timeout=...) , so one release frees the lock. issue #3 - by Benedikt Schmitt.
Add a documentation site with recursive locking examples and an API reference - by Benedikt Schmitt.
Treat Windows lock contention as a timeout instead of raising IOError. 5 - by Benedikt Schmitt.
Avoid an extra acquisition for with lock.acquire(timeout=...), so one release frees the lock. 3 - by Benedikt Schmitt.
Add a documentation site with recursive locking examples and an API reference - by Benedikt Schmitt.
- Allow a default timeout at lock construction. issue #2 - by Benedikt Schmitt.
Allow a default timeout at lock construction. issue #2 - by Benedikt Schmitt.
Allow a default timeout at lock construction. 2 - by Benedikt Schmitt.
- Handle an exception while acquiring a lock - by Benedikt Schmitt.
Handle an exception while acquiring a lock - by Benedikt Schmitt.
Handle an exception while acquiring a lock - by Benedikt Schmitt.
- Do not time out when the same lock object already holds the lock - by Benedikt Schmitt.
Do not time out when the same lock object already holds the lock - by Benedikt Schmitt.
Do not time out when the same lock object already holds the lock - by Benedikt Schmitt.
- Return immediately after a successful first acquire instead of waiting one poll interval. issue #1 - by Benedikt Schmitt.
Return immediately after a successful first acquire instead of waiting one poll interval. issue #1 - by Benedikt Schmitt.
Return immediately after a successful first acquire instead of waiting one poll interval. 1 - by Benedikt Schmitt.
- Add a lock counter so the same lock object can acquire recursively - by Benedikt Schmitt.
Add a lock counter so the same lock object can acquire recursively - by Benedikt Schmitt.
Add a lock counter so the same lock object can acquire recursively - by Benedikt Schmitt.
- Include the renamed README and license files in the source distribution - by Benedikt Schmitt.
Include the renamed README and license files in the source distribution - by Benedikt Schmitt.
Include the renamed README and license files in the source distribution - by Benedikt Schmitt.
- Publish the README and license as reStructuredText so package metadata can render them - by Benedikt Schmitt.
Publish the README and license as reStructuredText so package metadata can render them - by Benedikt Schmitt.
Publish the README and license as reStructuredText so package metadata can render them - by Benedikt Schmitt.
- Add file locks for Unix and Windows - by Benedikt Schmitt.
Add file locks for Unix and Windows - by Benedikt Schmitt.
On this page
Changelog
Unreleased (2026-11-22)
4.3.0 (2026-11-22)
Added
Fixed
Documentation
Security
Performance
4.2.12 (2026-11-18)
Fixed
4.2.11 (2026-11-17)
Fixed
4.2.10 (2026-11-09)
Fixed
Packaging
4.2.9 (2026-11-04)
Fixed
4.2.8 (2026-11-04)
Documentation
4.2.7 (2026-11-02)
Fixed
4.2.6 (2026-10-31)
Fixed
4.2.5 (2026-10-30)
Fixed
Documentation
Packaging
4.2.4 (2026-10-19)
4.2.3 (2026-10-19)
Fixed
4.2.2 (2026-10-18)
Fixed
4.2.1 (2026-10-17)
Fixed
4.2.0 (2026-10-14)
Fixed
Performance
4.1.2 (2026-10-14)
Fixed
4.1.1 (2026-10-11)
Fixed
4.1.0 (2026-10-09)
Added
Fixed
Documentation
4.0.12 (2026-10-05)
Fixed
4.0.11 (2026-10-05)
Fixed
4.0.10 (2026-10-03)
Fixed
4.0.9 (2026-10-01)
Fixed
Security
4.0.8 (2026-10-01)
Fixed
4.0.7 (2026-09-29)
Fixed
4.0.6 (2026-09-28)
Fixed
4.0.5 (2026-09-28)
Fixed
4.0.4 (2026-09-26)
Fixed
4.0.3 (2026-09-23)
Fixed
4.0.2 (2026-09-23)
Fixed
4.0.1 (2026-09-19)
Fixed
4.0.0 (2026-09-17)
Added
Fixed
3.32.7 (2026-09-16)
Fixed
3.32.6 (2026-09-08)
Added
Fixed
3.32.5 (2026-08-31)
Fixed
3.32.4 (2026-08-23)
Fixed
3.32.3 (2026-08-13)
Fixed
3.32.2 (2026-07-29)
Fixed
3.32.0 (2026-07-21)
Added
Fixed
3.31.2 (2026-07-21)
Fixed
3.31.1 (2026-07-20)
Fixed
3.31.0 (2026-07-18)
Added
Fixed
3.30.3 (2026-07-17)
Fixed
Documentation
3.30.2 (2026-07-16)
Fixed
Documentation
3.30.1 (2026-07-16)
Fixed
3.30.0 (2026-07-16)
Added
Changes
Fixed
Documentation
Security
3.29.7 (2026-07-07)
Fixed
3.29.6 (2026-07-06)
Fixed
3.29.5 (2026-07-02)
Changes
Fixed
3.29.4 (2026-06-13)
Fixed
3.29.3 (2026-06-10)
Fixed
3.29.2 (2026-06-10)
Fixed
Security
3.29.1 (2026-06-03)
Documentation
Security
3.29.0 (2026-04-19)
Added
Fixed
3.28.0 (2026-04-14)
Added
Fixed
3.25.2 (2026-03-11)
Fixed
3.25.1 (2026-03-09)
Fixed
Documentation
3.25.0 (2026-03-01)
Added
Fixed
3.24.3 (2026-02-19)
Fixed
3.24.2 (2026-02-16)
Fixed
Documentation
3.24.1 (2026-02-15)
Fixed
3.24.0 (2026-02-14)
Added
Fixed
3.23.0 (2026-02-14)
Changes
Documentation
3.22.0 (2026-02-14)
Added
Fixed
3.21.2 (2026-02-13)
Fixed
3.21.1 (2026-02-12)
Fixed
3.21.0 (2026-02-12)
v3.20.4 (2026-03-23)
Added
v3.20.3 (2026-01-09)
Security
v3.20.2 (2026-01-02)
Added
v3.20.1 (2025-12-15)
Security
v3.20.0 (2025-10-08)
Added
v3.19.1 (2025-08-14)
Added
v3.18.0 (2025-03-11)
Added
Fixed
v3.17.0 (2025-01-21)
Added
v3.16.1 (2024-09-17)
v3.16.0 (2024-09-07)
Added
v3.15.4 (2024-06-22)
Fixed
v3.15.3 (2024-06-19)
Fixed
v3.15.2 (2024-06-19)
Changes
v3.15.1 (2024-06-12)
Fixed
v3.15.0 (2024-06-11)
Added
Fixed
v3.14.0 (2024-04-27)
Added
v3.13.4 (2024-04-09)
Fixed
v3.13.3 (2024-03-25)
Changes
v3.13.2 (2024-03-25)
Fixed
v3.13.1 (2023-10-30)
Added
v3.13.0 (2023-10-27)
Added
v3.12.4 (2023-09-13)
Packaging
v3.12.3 (2023-08-28)
Added
v3.12.2 (2023-06-12)
Fixed
v3.12.1 (2023-06-10)
Added
v3.12.0 (2023-04-18)
Changes
Fixed
v3.11.0 (2023-04-06)
Changes
v3.10.7 (2023-03-27)
Fixed
v3.10.6 (2023-03-25)
Fixed
v3.10.5 (2023-03-25)
Added
v3.10.4 (2023-03-24)
Fixed
v3.10.3 (2023-03-23)
Fixed
v3.10.2 (2023-03-22)
Fixed
v3.10.1 (2023-03-22)
Fixed
v3.10.0 (2023-03-15)
Added
v3.9.1 (2023-03-14)
Changes
v3.9.0 (2022-12-28)
v3.8.2 (2022-12-05)
Packaging
v3.8.1 (2022-12-04)
Fixed
v3.8.0 (2022-12-04)
Added
Documentation
v3.7.1 (2022-05-31)
Documentation
v3.7.0 (2022-05-13)
Added
v3.6.0 (2022-02-17)
Fixed
v3.5.1 (2022-02-16)
Fixed
v3.5.0 (2022-02-15)
Added
v3.4.2 (2021-12-16)
Added
v3.4.1 (2021-12-16)
Fixed
v3.4.0 (2021-11-16)
Deprecated
v3.3.2 (2021-10-29)
Added
v3.3.1 (2021-10-15)
Fixed
Documentation
v3.3.0 (2021-10-03)
Added
Documentation
v3.2.1 (2021-10-02)
Fixed
Documentation
v3.2.0 (2021-09-30)
Changes
Fixed
v3.1.0 (2021-09-27)
Documentation
v3.0.12 (2019-05-18)
Fixed
Documentation
Packaging
v3.0.10 (2018-11-01)
Documentation
v3.0.9 (2018-10-02)
v3.0.8 (2018-09-09)
Fixed
v3.0.6 (2018-08-22)
v3.0.4 (2018-02-01)
v3.0.3 (2018-01-30)
Documentation
v3.0.2 (2018-01-30)
Fixed
Documentation
v3.0.0 (2018-01-05)
Changes
Fixed
v2.0.13 (2017-11-05)
Fixed
v2.0.12 (2017-09-02)
v2.0.11 (2017-07-19)
Added
v2.0.10 (2017-06-07)
v2.0.9 (2017-06-07)
Fixed
Documentation
v2.0.8 (2017-01-24)
Added
v2.0.7 (2016-11-05)
Packaging
v2.0.6 (2016-05-01)
Fixed
v2.0.5 (2015-11-11)
Fixed
Added
Documentation
v2.0.4 (2015-07-29)
Added
v2.0.1 (2015-06-13)
Fixed
Documentation
v2.0.0 (2015-05-25)
Added
v1.0.3 (2015-04-22)
Fixed
v1.0.2 (2015-04-22)
Fixed
v1.0.1 (2015-04-22)
Fixed
v1.0.0 (2015-04-07)
Added
v0.2.2 (2015-03-25)
Packaging
v0.2.1 (2015-03-25)
Packaging
v0.2.0 (2014-07-06)
Added
One column per quarter.