安全的文件写入者：`safer`

📝 安全的文件写入者：safer

去发现同类优质开源项目:https://gitcode.com/

在编程中，避免部分写入或数据损坏是至关重要的。safer 是一个小型但强大的库，它为Python的open()函数提供了一个安全的替代品，确保你的文件操作要么全部完成，要么什么都不做。

简介

想象一下，你正在尝试写入一个文件，但是在写入过程中发生了异常。传统的文件流可能会导致部分写入，甚至破坏文件。safer 来解决这个问题了。它通过将文件流包装在一个临时容器中，在所有数据成功写入后才将其移至目标文件，如果发生错误，则不会改变原有文件。

技术剖析

safer 提供了一系列方便的工具：

• safer.writer() 包装已存在的写入器，如socket或流，保证数据完整写出或不写。
• safer.open() 直接替换内置的open()，同样保证文件的完整性。
• safer.closer() 返回一个可关闭的流，当其关闭时会关闭底层的流或可调用对象。
• safer.dump() 类似于json.dump()，适用于任何序列化协议，支持YAML和TOML等，并能写入文件流或其他可调用对象。
• safer.printer() 和safer.open()类似，但它返回一个打印到流的函数。

默认情况下，safer 在内存中缓冲写入的数据。对于大文件，可以使用temp_file参数，先将数据写入临时文件，然后在成功后使用os.rename进行原子移动。请注意，这种方法在Windows上可能无法正常工作。

应用场景

无论是在网络服务中处理socket写入，还是在日常的文件操作中，safer 都能在异常发生时保护你的数据安全。例如，当你需要写入JSON文件时，safer.open() 可以确保即使中间步骤出错，也不会留下一个半完整的JSON文件。

with safer.open('data.json', 'w') as fp:
    json.dump(data, fp)

如果你需要批量打印数据，而不想在出现异常时破坏现有文件，safer.printer() 是理想的选择。

with safer.printer('output.txt') as print:
    for item in items:
        print(item)

项目特点

• 安全性：无论何时，你都能确保文件要么完整写入，要么保持原状。
• 便捷性：无需复杂的错误处理代码，直接使用with语句即可轻松实现。
• 灵活性：支持内存缓存和磁盘临时文件，适用于不同大小的文件。
• 兼容性：支持Python 3.4 到 3.11版本。

现在就通过pip安装safer并开始享受更安全的文件写入吧！

pip install safer

阅读更多关于safer的信息和详细API文档，请访问项目GitHub页面 和 Medium上的文章。

立即加入我们，让文件写入变得无后顾之忧！

去发现同类优质开源项目:https://gitcode.com/