Python-UnicodeCSV 使用与配置教程

Python-UnicodeCSV 使用与配置教程

python-unicodecsv Python2's stdlib csv module is nice, but it doesn't support unicode. This module is a drop-in replacement which *does*. If you prefer python 3's semantics but need support in py2, you probably want https://github.com/ryanhiebert/backports.csv 项目地址: https://gitcode.com/gh_mirrors/py/python-unicodecsv

1. 项目目录结构及介绍

Python-UnicodeCSV 项目是一个用于处理带有 Unicode 字符的 CSV 文件的 Python 库。以下是项目的目录结构及其介绍：

python-unicodecsv/
├── .gitignore                # git 忽略文件列表
├── .travis.yml               # Travis CI 持续集成配置文件
├── LICENSE                   # 项目许可证文件
├── MANIFEST.in               # 打包时包含的文件列表
├── README.rst                # 项目说明文件
├── runtests.py               # 运行测试的脚本
├── setup.py                  # 项目打包配置文件
├── tox.ini                   # tox 测试配置文件
└── unicodecsv/               # 模块目录
    ├── __init__.py           # 初始化文件
    └── unicodecsv.py        # UnicodeCSV 的主要实现文件

• .gitignore：指定 Git 忽略跟踪的文件和目录。
• .travis.yml：配置项目在 Travis CI 上的持续集成流程。
• LICENSE：项目的许可证信息，本项目采用开源许可证。
• MANIFEST.in：在打包时，指定需要包含的非代码文件。
• README.rst：项目的详细说明文件，采用 reStructuredText 格式。
• runtests.py：运行项目测试的脚本。
• setup.py：用于构建和打包项目的脚本。
• tox.ini：配置 tox 进行自动化测试。
• unicodecsv/：包含项目的主要代码。
  • __init__.py：初始化模块，允许用户通过 import unicodecsv 来导入模块。
  • unicodecsv.py：实现 UnicodeCSV 功能的 Python 文件。

2. 项目的启动文件介绍

在 Python-UnicodeCSV 项目中，并没有一个特定的“启动文件”。用户通常通过导入 unicodecsv 模块来使用这个库。以下是一个简单的使用示例：

import unicodecsv as csv

with open('example.csv', 'wb') as f:
    writer = csv.writer(f, encoding='utf-8')
    writer.writerow([u'é', u'ñ'])

在这个示例中，我们首先导入 unicodecsv 模块，并使用它来创建一个 CSV 文件，其中包含 Unicode 字符。

3. 项目的配置文件介绍

Python-UnicodeCSV 项目中的配置主要涉及 setup.py 文件。此文件用于配置项目的打包和安装过程。以下是 setup.py 文件的主要内容：

from setuptools import setup

setup(
    name='unicodecsv',
    version='0.14.1',
    packages=['unicodecsv'],
    description='A Unicode CSV writer',
    long_description=open('README.rst').read(),
    license='MIT',
    author='James Dunck',
    author_email='j.dunck AT gmail.com',
    url='https://github.com/jdunck/python-unicodecsv',
    classifiers=[
        'Development Status :: 5 - Production/Stable',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Programming Language :: Python :: 2',
        'Programming Language :: Python :: 2.6',
        'Programming Language :: Python :: 2.7',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.3',
        'Programming Language :: Python :: 3.4',
        'Programming Language :: Python :: 3.5',
        'Programming Language :: Python :: Implementation :: CPython',
        'Programming Language :: Python :: Implementation :: PyPy',
        'Topic :: Text Processing :: CSV',
    ]
)

在这个文件中，我们定义了项目的名称、版本、包含的包、描述、许可证、作者和作者邮箱等信息。此外，我们还指定了项目支持的 Python 版本以及一些分类标签。这些信息对于用户在使用 pip 安装库时非常有用。

python-unicodecsv Python2's stdlib csv module is nice, but it doesn't support unicode. This module is a drop-in replacement which *does*. If you prefer python 3's semantics but need support in py2, you probably want https://github.com/ryanhiebert/backports.csv 项目地址: https://gitcode.com/gh_mirrors/py/python-unicodecsv