{ "info": { "author": "Matthew Lewis", "author_email": "matt@mplewis.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Topic :: Text Processing :: Markup" ], "description": "csvtomd: markdown tables made easy\n==================================\n\n.. figure:: http://mplewis.com/files/csvtomd.png?\n :alt: Excel \u2014> Markdown\n\n Excel \u2014> Markdown\n|CircleCI|\n\nConvert your CSV files into Markdown tables.\n\n`Tables Generator `__ is\na fantastic web tool for converting tabular data into all sorts of table\nlayouts. I like how it lets me import CSV files, but I need the ability\nto convert many CSV files in batch for a docset on which I'm working.\n\nI built ``csvtomd`` to convert one or more CSV files into nicely-padded\nMarkdown tables. Now you can build your tables in Excel and convert them\nfor use in GitHub, Bitbucket, or `Mou `__ Markdown\nfiles without having to construct them by hand.\n\nInstallation\n============\n\nThis is a Python 3 script, so use ``pip3`` to install:\n\n::\n\n pip3 install csvtomd\n\nAfter this, run ``csvtomd --help`` from your terminal to verify it's\ninstalled properly.\n\nUsage\n=====\n\n``csvtomd MY_SPREADSHEET.csv`` generates a Markdown table from\n``MY_SPREADSHEET.csv``.\n\n``csvtomd SHEET1.csv SHEET2.csv SHEET3.csv`` generates three Markdown\ntables from the input files and displays them alongside the input\nfilename.\n\n``csvtomd`` or ``csvtomd -`` generates a Markdown table from standard\ninput. You can type CSV data or pipe a file in.\n\nExample Input\n-------------\n\nFile: ``thrones.csv``\n\n::\n\n First Name,Last Name,Location,Allegiance\n Mance,Rayder,North of the Wall,Wildlings\n Margaery,Tyrell,The Reach,House Tyrell\n Danerys,Targaryen,Meereen,House Targaryen\n Tyrion,Lannister,King's Landing,House Lannister\n\nExample Markdown Table\n----------------------\n\nCommand: ``csvtomd thrones.csv``\n\n+--------------+-------------+---------------------+-------------------+\n| First Name | Last Name | Location | Allegiance |\n+==============+=============+=====================+===================+\n| Mance | Rayder | North of the Wall | Wildlings |\n+--------------+-------------+---------------------+-------------------+\n| Margaery | Tyrell | The Reach | House Tyrell |\n+--------------+-------------+---------------------+-------------------+\n| Danerys | Targaryen | Meereen | House Targaryen |\n+--------------+-------------+---------------------+-------------------+\n| Tyrion | Lannister | King's Landing | House Lannister |\n+--------------+-------------+---------------------+-------------------+\n\nExample Raw Output\n------------------\n\nCommand: ``csvtomd thrones.csv``\n\n::\n\n First Name | Last Name | Location | Allegiance\n ------------|-------------|---------------------|-----------------\n Mance | Rayder | North of the Wall | Wildlings\n Margaery | Tyrell | The Reach | House Tyrell\n Danerys | Targaryen | Meereen | House Targaryen\n Tyrion | Lannister | King's Landing | House Lannister\n\nCommand: ``csvtomd --padding 0 thrones.csv``\n\n::\n\n First Name|Last Name|Location |Allegiance\n ----------|---------|-----------------|---------------\n Mance |Rayder |North of the Wall|Wildlings\n Margaery |Tyrell |The Reach |House Tyrell\n Danerys |Targaryen|Meereen |House Targaryen\n Tyrion |Lannister|King's Landing |House Lannister\n\nRequirements\n------------\n\nPython 3.\n\nTested with Python 3.4.1 on Mac OS X 10.9.3.\n\nDoesn't require any external packages, so it should be\nplatform-agnostic.\n\nHelp\n----\n\nCommand: ``csvtomd --help``\n\n::\n\n usage: csvtomd.py [-h] [-n] [-p PADDING] [-d DELIMITER] csv_file [csv_file ...]\n\n Read one or more CSV files and output their contents in the form of Markdown\n tables.\n\n positional arguments:\n csv_file One or more CSV files to be converted\n\n optional arguments:\n -h, --help show this help message and exit\n -n, --no-filenames Don't display filenames when outputting multiple\n Markdown tables.\n -p PADDING, --padding PADDING\n The number of spaces to add between table cells and\n column dividers. Default is 2 spaces.\n -d DELIMITER, --delimiter DELIMITER\n CSV delimiter, expected values: ',', ';'. Default is ,\n\nContributions\n=============\n\nBug reports, fixes, or features? Feel free to open an issue or pull\nrequest any time.\n\nTesting\n-------\n\nI only accept pull requests for features with tests.\n\n.. code:: sh\n\n # Run tests in the project root\n $ py.test\n ============================= test session starts ==============================\n platform darwin -- Python 3.5.0, pytest-3.0.5, py-1.4.31, pluggy-0.4.0\n rootdir: /your/path/to/csvtomd, inifile:\n collected 3 items\n\n test/test_csvtomd.py ...\n\n =========================== 3 passed in 0.04 seconds ===========================\n\nReleasing\n---------\n\n.. code:: sh\n\n # Bump version number in setup.py and csvtomd.py\n # Delete old builds\n rm -rf dist\n # Build source and binary wheel distribution\n python setup_wrap.py sdist bdist_wheel\n # Upload to PyPI\n pip install twine\n twine upload dist/*\n\n`Here's an actual guide to\nPyPI. `__ `And another\nreally good\none. `__\n\nLicense\n=======\n\nCopyright (c) 2016 Matthew Lewis. Licensed under `the MIT\nLicense `__.\n\n.. |CircleCI| image:: https://circleci.com/gh/mplewis/csvtomd.svg?style=svg\n :target: https://circleci.com/gh/mplewis/csvtomd", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mplewis/csvtomd", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "csvtomd", "package_url": "https://pypi.org/project/csvtomd/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/csvtomd/", "project_urls": { "Homepage": "https://github.com/mplewis/csvtomd" }, "release_url": "https://pypi.org/project/csvtomd/0.3.0/", "requires_dist": null, "requires_python": "", "summary": "Convert your CSV files into Markdown tables.", "version": "0.3.0" }, "last_serial": 2941276, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "b721e0598253abd09798569904f5895e", "sha256": "171f69abb1342f779546f5174bc1b9142e254262f6d98a9e22e9c823066c656a" }, "downloads": -1, "filename": "csvtomd-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "b721e0598253abd09798569904f5895e", "packagetype": "bdist_wheel", "python_version": "3.4", "requires_python": null, "size": 6562, "upload_time": "2014-07-13T23:54:08", "url": "https://files.pythonhosted.org/packages/67/14/3d62272a08628a13cd90fa273810fc81791ce4f372025bc368a172392243/csvtomd-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f30b47ef8045f0b817f36df64d817858", "sha256": "55c61f6735ce050d931fd7f911d6cadd13bf9c5fc2cf7f82bad90f32157e871f" }, "downloads": -1, "filename": "csvtomd-0.1.0.tar.gz", "has_sig": false, "md5_digest": "f30b47ef8045f0b817f36df64d817858", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4105, "upload_time": "2014-07-13T23:53:55", "url": "https://files.pythonhosted.org/packages/e7/9e/d8247d19a1281c4c8f211c0f95a96451ac600b7f58fd37d04456a37e4909/csvtomd-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "af9432b2d9bd4b4d9da616ee06090d35", "sha256": "76bdc09a6ef6879483fc6f8e9f2e86ada25c20e398a28fab96aa2b7a499f4414" }, "downloads": -1, "filename": "csvtomd-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "af9432b2d9bd4b4d9da616ee06090d35", "packagetype": "bdist_wheel", "python_version": "3.4", "requires_python": null, "size": 7058, "upload_time": "2014-07-14T00:14:32", "url": "https://files.pythonhosted.org/packages/b2/b3/2a91f356d540bef014eedb33860c9812523f74cfe52c1a0f0483d5cc3789/csvtomd-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9025c82ba793435ee52773ec6a8bba9f", "sha256": "f2cd1da71ca8ed823d1f02167039e07e58d15a73d672069dfddcda8639576490" }, "downloads": -1, "filename": "csvtomd-0.1.1.tar.gz", "has_sig": false, "md5_digest": "9025c82ba793435ee52773ec6a8bba9f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4461, "upload_time": "2014-07-14T00:14:21", "url": "https://files.pythonhosted.org/packages/5a/d8/9dbce820243bb6db670cd1ddea80ea1890c6bfd5d122910fdd157d51d71f/csvtomd-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "e71db936cb918a6f17b44a52449be7de", "sha256": "b722b02246bc4a536734de91d4376c7f5168b71fe8f50eed539b2b8661ff0cb6" }, "downloads": -1, "filename": "csvtomd-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "e71db936cb918a6f17b44a52449be7de", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10144, "upload_time": "2016-12-14T04:16:43", "url": "https://files.pythonhosted.org/packages/d7/34/6d055eb9e0b75343d5d71f8fe2529ae907b4518b166c7a22c5003e0f78fa/csvtomd-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7d81424faa9853b5694615abcd780b85", "sha256": "256c364bf1053eff47f68e426a54a8d29b830e70d09bc68b974d38aa391c66f3" }, "downloads": -1, "filename": "csvtomd-0.2.0.tar.gz", "has_sig": false, "md5_digest": "7d81424faa9853b5694615abcd780b85", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6106, "upload_time": "2016-12-14T04:16:45", "url": "https://files.pythonhosted.org/packages/8b/72/f2177d762edd4fd3f4b536e4bcc9fe216ce6a70b4c4e37fc164863ca3b68/csvtomd-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "48017e9d995007406739e67ccea29d48", "sha256": "c73b39162b7bd113a92da90b967976d8888d9018e6a8e6284cdda4d61ba6b2b7" }, "downloads": -1, "filename": "csvtomd-0.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "48017e9d995007406739e67ccea29d48", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10148, "upload_time": "2016-12-18T21:39:38", "url": "https://files.pythonhosted.org/packages/c6/cf/769c38df1fe0921a76d3867a55ba9c59ff107dc2d1da7ce31b4bf71803a5/csvtomd-0.2.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0ba33a877acfdba1e2cf909005876c0e", "sha256": "d9fdf166c3c299ad5800b3cb1661f223b98237f38f22e9d253d45d321f70ec72" }, "downloads": -1, "filename": "csvtomd-0.2.1.tar.gz", "has_sig": false, "md5_digest": "0ba33a877acfdba1e2cf909005876c0e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6116, "upload_time": "2016-12-18T21:39:40", "url": "https://files.pythonhosted.org/packages/2f/41/289bedde7fb32d817d5802eff68b99546842cb34df840665ec39b363f258/csvtomd-0.2.1.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "efb14e1a8dba25f171cee32c283dd57a", "sha256": "3ef90b54404dbe21c2b6e7b498f14664ef2360356ea9d7d644d32aff80bcd076" }, "downloads": -1, "filename": "csvtomd-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "efb14e1a8dba25f171cee32c283dd57a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10358, "upload_time": "2017-06-11T02:26:21", "url": "https://files.pythonhosted.org/packages/f9/5c/3fe97f0507909529120c2d521f50fe64ccf8b0c11b4e7dc487c326c08a9b/csvtomd-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7c0106e53488d026f66cfd8388288f8c", "sha256": "a1fbf1db86d4b7b62a75dc259807719b2301ed01db5d1d7d9bb49c4a8858778b" }, "downloads": -1, "filename": "csvtomd-0.3.0.tar.gz", "has_sig": false, "md5_digest": "7c0106e53488d026f66cfd8388288f8c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6273, "upload_time": "2017-06-11T02:26:23", "url": "https://files.pythonhosted.org/packages/9d/59/ea3c8b102f9c72e5d276a169f7f343432213441c39a6eac7a8f444c66681/csvtomd-0.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "efb14e1a8dba25f171cee32c283dd57a", "sha256": "3ef90b54404dbe21c2b6e7b498f14664ef2360356ea9d7d644d32aff80bcd076" }, "downloads": -1, "filename": "csvtomd-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "efb14e1a8dba25f171cee32c283dd57a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10358, "upload_time": "2017-06-11T02:26:21", "url": "https://files.pythonhosted.org/packages/f9/5c/3fe97f0507909529120c2d521f50fe64ccf8b0c11b4e7dc487c326c08a9b/csvtomd-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7c0106e53488d026f66cfd8388288f8c", "sha256": "a1fbf1db86d4b7b62a75dc259807719b2301ed01db5d1d7d9bb49c4a8858778b" }, "downloads": -1, "filename": "csvtomd-0.3.0.tar.gz", "has_sig": false, "md5_digest": "7c0106e53488d026f66cfd8388288f8c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6273, "upload_time": "2017-06-11T02:26:23", "url": "https://files.pythonhosted.org/packages/9d/59/ea3c8b102f9c72e5d276a169f7f343432213441c39a6eac7a8f444c66681/csvtomd-0.3.0.tar.gz" } ] }