csvtomd 0.3.0

csvtomd：降价表变得容易
===================================

.. 图:: http://mplewis .com/files/csvtomd.png？
:alt: Excel —> Markdown

Excel —> Markdown
|CircleCI|

将您的 CSV 文件转换为 Markdown 表。

`Tables Generator <http://www.tablesgenerator.com/markdown_tables>`__ 是
一款出色的网络工具，用于将表格数据转换为各种表格
布局。我喜欢它如何让我导入 CSV 文件，但我需要能够
为我正在处理的文档集批量转换许多 CSV 文件。

我构建了``csvtomd`` 来将一个或多个 CSV 文件转换为填充精美的
Markdown 表。现在您可以在 Excel 中构建表格并进行转换
用于 GitHub、Bitbucket 或 `Mou <http://mouapp.com/>`__ Markdown
文件，无需手动构建。

安装
============

这是一个 Python 3 脚本，所以使用``pip3`` 来安装：

::

pip3 install csvtomd

之后，从你的终端运行``csvtomd --help``验证它是否
安装正确。

用法
=====

``csvtomd MY_SPREADSHEET.csv`` 从``MY_SPREADSHEET.csv`` 生成一个 Markdown 表
。

``csvtomd SHEET1.csv SHEET2.csv SHEET3.csv``
从输入文件生成三个 Markdown 表，并在输入
文件名旁边显示它们。

``csvtomd`` 或 ``csvtomd -`` 从标准生成一个 Markdown 表
输入。您可以键入 CSV 数据或通过管道输入文件。

示例输入
-------------

文件：``thrones.csv``

::

First Name,Last Name,Location,Allegiance
Mance,Rayder, North of the Wall,
Wildlings Margaery,Tyrell,The Reach,House Tyrell
Danerys,Targaryen,Meereen,House Targaryen
Tyrion,Lannister,King's Landing,House Lannister

Example Markdown Table
--------------- -------

命令：``csvtomd 王座.csv``

+--------------+-------------+--- ------------------+--------------------------------+
| 名字 | 姓氏 | 位置 | 忠诚 |
+==============+=============+==================== =+====================+
| 曼斯 | 雷德 | 墙北| 野人 |
+--------------+-------------+-------- -+--------------------+
| 玛格丽 | 泰瑞尔 | 到达 | 提利尔之家 |
+--------------+-------------+-------- -+--------------------+
| 丹妮莉丝 | 坦格利安 | 弥林 | 坦格利安家族 |
+--------------+-------------+-------- -+--------------------+
| 提利昂 | 兰尼斯特 | 君临 | 兰尼斯特家族 |
+--------------+-------------+-------- -+-----------------+

示例原始输出
------------------

命令：``csvtomd 王座。 csv``

::

名字 | 姓氏 | 位置 | 忠诚
------------|-------------|------------| ------------------
曼斯 | 雷德 | 墙北| 野人
玛格丽 | 泰瑞尔 | 到达 | 提利尔
·丹妮莉丝之家 | 坦格利安 | 弥林 | 家族坦格利安提
利昂 | 兰尼斯特 | 君临 | 兰尼斯特

家族命令：``csvtomd --padding 0 proses.csv``

::

名字|姓氏|位置|效忠
---------|---------|-- ---------------|----------------
曼斯 |雷德 |北墙|
Wildlings Margaery |提利尔|致远星|提利尔家族
Danerys |Targaryen|Meereen |House Targaryen
Tyrion |Lannister|King's Landing |House Lannister

要求
------------

Python 3。

在 Mac OS X 10.9.3 上使用 Python 3.4.1 测试。

不需要任何外部包，因此它应该与
平台无关。

帮助
----

命令：``csvtomd --help``

::

用法：csvtomd.py [-h] [-n] [-p PADDING] [-d DELIMITER] csv_file [csv_file ...]

读一或更多 CSV 文件，并以 Markdown 表格的形式输出其内容
。

位置参数：
csv_file 一个或多个要转换的 CSV 文件

可选参数：
-h, --help 显示此帮助信息并退出-n, --no-filenames 输出多个 Markdown 表
时不显示文件名。 -p PADDING, --padding PADDING 要在表格单元格和 列分隔符之间添加的空格数。默认为 2 个空格。 -d DELIMITER, --delimiter DELIMITER CSV 分隔符，预期值：',', ';'。默认为 ,贡献=============错误报告、修复或功能？随时打开问题或拉取请求。测试-------我只接受带有测试的功能的拉取请求。


















.. code:: sh

# 在项目根目录中运行测试
$ py.test
============================= 测试会话开始 = =============================
平台 darwin -- Python 3.5.0, pytest-3.0.5, py-1.4.31, pluggy-0.4.0
rootdir: /your/path/to/csvtomd, inifile:
收集 3 项

test/test_csvtomd.py ...

==================== ====== 3 在 0.04 秒内通过 ============================

释放
---------

.. code:: sh

# 在 setup.py 和 csvtomd.py 中添加版本号
# 删除旧版本
rm -rf dist
# 构建源代码和二进制轮分布
python setup_wrap.py sdist bdist_wheel
# 上传到 PyPI
pip install twine
twine upload dist/* `这是PyPI

的实际指南。
<https://packaging.python.org/distributing/>`__`还有一个
非常好的
。<https://hynek.me/articles/sharing-your-labor-of-love-pypi-quick-and-dirty/>`__

许可
=======

版权所有 (c) 2016 Matthew Lewis。根据 `MIT
许可证 <http://opensource.org/licenses/MIT>`__ 获得许可。

.. |圆CI| 图片：：https
://circleci.com/gh/mplewis/csvtomd.svg?style=svg：目标：https://circleci.com/gh/mplewis/csvtomd