csv23 0.3.4

改进

csv23解决了stdlib csv模块中的以下错误

bpo-12178

如果你的数据包含字面转义字符，则使用escapechar时存在破坏性的往返操作（已在Python 3.10中修复）

bpo-31590

Python 2 下使用 escapechar 和嵌入换行符的循环返回问题（已在 Python 3.4 中修复，但没有回滚）：生成警告

链接

• GitHub: https://github.com/xflr6/csv23

• PyPI: https://pypi.ac.cn/project/csv23/

• 文档: https://csv23.readthedocs.io

• 变更日志: https://csv23.readthedocs.io/en/latest/changelog.html

• 问题追踪器: https://github.com/xflr6/csv23/issues

• 下载: https://pypi.ac.cn/project/csv23/#files

附加功能

该软件包还提供一些便利功能，例如 open_csv() 上下文管理器，用于以正确的模式打开 CSV 文件并返回一个 csv.reader 或 csv.writer

>>> import csv23

>>> with csv23.open_csv('spam.csv') as reader:  # doctest: +SKIP
...     for row in reader:
...         print(', '.join(row))
Spam!, Spam!, Spam!'
Spam!, Lovely Spam!, Lovely Spam!'

Python 3 附加功能

对于要在调用代码中打开类似文件的对象的情况，例如直接读写二进制流（如由调用者控制的 ZIP 文件），read_csv() 和 write_csv() 函数（仅在 Python 3 中可用）非常有用

>>> import io
>>> buf = io.BytesIO()

>>> import zipfile
>>> with zipfile.ZipFile(buf, 'w') as z, z.open('spam.csv', 'w') as f:
...     csv23.write_csv(f, [[1, None]], header=['spam', 'eggs'])
<zipfile...>

>>> buf.seek(0)
0

>>> with zipfile.ZipFile(buf) as z, z.open('spam.csv') as f:
...     csv23.read_csv(f, as_list=True)
[['spam', 'eggs'], ['1', '']]

csv23 在内部使用给定编码和 newline='' 的 io.TextIOWrapper 包装字节流（请参阅 csv 模块的 文档）。

write_csv()-函数还支持使用 .update(<bytes>) 方法更新对象，如 hashlib.new() 实例，这允许在将给定的行写入磁盘之前计算从生成的二进制 CSV 文件输出中产生的校验和（注意，返回的是对象）

>>> import hashlib

>>> csv23.write_csv(hashlib.new('sha256'), [[1, None]], header=['spam', 'eggs']).hexdigest()
'aed6871f9ca7c047eb55a569e8337af03fee508521b5ddfe7ad0ad1e1139980a'

这两个函数都有一个可选的 autocompress 参数：将其设置为 True，如果文件参数是以 '.bz2'、'.gz' 和 '.xz' 结尾的路径，则透明地压缩（或解压缩）。

安装

此软件包在 Python 2.7 和 3.7+ 下运行，使用 pip 进行安装

$ pip install csv23

另请参阅

• https://docs.pythonlang.cn/2/library/csv.html#examples（UnicodeReader，UnicodeWriter）

• https://agate.readthedocs.io/en/latest/api/csv.html

• https://pypi.ac.cn/project/backports.csv/

• https://pypi.ac.cn/project/csv342/

许可证

此软件包在 MIT 许可证 下分发。