# cfg-guard: A lock and a witness for config files too many hands…

> Source: <https://dev.to/ameobius/cfg-guard-a-lock-and-a-witness-for-config-files-too-many-hands-48ma>
> Published: 2026-10-23 22:00:18+00:00

Most cfg-guard write-ups stop at the README: here is what the tool does, here is how you run it. This one covers what it refuses to do, and where it breaks.

A lock and a witness for config files too many hands edit: flock plus a content-hash compare-and-swap refuse a write whose base bytes moved, and inotify with /proc names whoever writes around the lock. Stdlib only.

In Russian: Замок и свидетель для конфигов, которые правят много рук: flock плюс compare-and-swap по хэшу содержимого не дают затереть чужую правку, а inotify и /proc называют того, кто пишет мимо замка. Только stdlib.

```
pip install cfg-guard
```

Python. MIT licensed. Standard library first: the tool reads the data you point it at and sends nothing anywhere.

Every rule in a checker like this can produce a false positive. Use it to find candidates for a rewrite, not to grade a writer, and not where the voice is the point.

Source, issue tracker and documentation: [https://gitlab.com/ameobius-ai/cfg-guard](https://gitlab.com/ameobius-ai/cfg-guard)

Other tools from the same author: [https://ameobius-ai.gitlab.io](https://ameobius-ai.gitlab.io)
