{
    "info": {
        "author": "Ron Serruya",
        "author_email": "ron.serruya@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: MIT License",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3"
        ],
        "description": "# tbl - `cat` for csv files\n\n`tbl` lets you print out csv files to your terminal, formatted and \"prettified\".  \n\nA lot of the hard work is done with the [rapidtables](https://github.com/alttch/rapidtables) package, check it out!\n\ncat             |  tbl\n-------------------------|-------------------------\n![](docs_content/cat.png)  |  ![](docs_content/rstgrid.png)\n\nCheck out this recorded example:\n[![asciicast](https://asciinema.org/a/268740.png)](https://asciinema.org/a/268740)\n## Requirements\n* Python 3.4+\n\n## Installation\n```shell\npip install --user clitbl\n```\n\n## Usage options\nUse ```tbl -h / tbl --help``` to see help.\n\n* The most common use it to just print the table\n```shell\ntbl file.csv\n```\n* `--headers`  \nThe headers options lets you explicitly specify the headers for the table. Use this option when you csv files does \nnot include headers, (e.g [exampleFile](example_csv/no_headers.csv)\n```shell\ntbl file.csv --headers '#Index#Item#Cost#Tax#Total'\n```\n* `--select`  \nThe select options lets you select what columns to print (similar to SQL SELECT)\n```shell\ntbl file.csv --select '#Item#Tax'\n```  \n:exclamation: Both `headers` and `select` use the first charcter as a separator, \nit can be any character (kinda like a `sed` expressions)  \n:exclamation: The headers specified with this option are case-sensitive  \n:star2: The `headers` and `select` headers can be used together\n\n* `--format` (defualt: rstgrid)  \nThe format options lets you specify the format used when printing the table.  \nThe available formats are:\n\n| rstgrid | rst | md | simple |\n|-------|-------|-----------|-------|\n|![](docs_content/rstgrid.png)|![](docs_content/rst.png)|![](docs_content/md.png)|![](docs_content/simple.png)|\n\n## Restrictions\nThere are several cases `tbl` does not support:\n* Duplicated headers, all headers must be distinct\n* Very long headers, while tbl can wrap long paragraph of text in a cell, \nit cannot wrap text in the headers, which may lead to disfigured output\n\n:exclamation: This is not the use case for tbl anyway, but dont try to print huge tables (several GBs), \nas tbl (and rapidtable) read the entire table to memory before printing\n\n\\* Example csv were downloaded from [here](https://people.sc.fsu.edu/~jburkardt/data/csv/csv.html)\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/ronserruya/tbl",
        "keywords": "",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "clitbl",
        "package_url": "https://pypi.org/project/clitbl/",
        "platform": "",
        "project_url": "https://pypi.org/project/clitbl/",
        "project_urls": {
            "Homepage": "https://github.com/ronserruya/tbl"
        },
        "release_url": "https://pypi.org/project/clitbl/0.0.1/",
        "requires_dist": [
            "rapidtables (==0.1.7)",
            "click (==7)"
        ],
        "requires_python": ">=3.4",
        "summary": "csv files printer",
        "version": "0.0.1"
    },
    "last_serial": 5835523,
    "releases": {
        "0.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ee634fa87bc9d0f359f29e5a551aa6f6",
                    "sha256": "88b4a89cbd858abfbfe8af3841fb60d1d29f6f953d12b755622e2f8e1d9df788"
                },
                "downloads": -1,
                "filename": "clitbl-0.0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "ee634fa87bc9d0f359f29e5a551aa6f6",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.4",
                "size": 5195,
                "upload_time": "2019-09-16T10:42:52",
                "url": "https://files.pythonhosted.org/packages/86/f0/32e194a2e791cda0294cc0396fb8f2a9462905dea933efb03cb489972128/clitbl-0.0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "1396579e229f4cffd307f38edb60831f",
                    "sha256": "ca40e0501dc4b9af5a79994a14008bd42adb33d9794a5589fdc40b4358ec0a24"
                },
                "downloads": -1,
                "filename": "clitbl-0.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "1396579e229f4cffd307f38edb60831f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.4",
                "size": 3753,
                "upload_time": "2019-09-16T10:42:54",
                "url": "https://files.pythonhosted.org/packages/b4/33/df49001cb5bca5f1867b0feffa000c9a0fff1281cd27277e2a0be6da7a08/clitbl-0.0.1.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "ee634fa87bc9d0f359f29e5a551aa6f6",
                "sha256": "88b4a89cbd858abfbfe8af3841fb60d1d29f6f953d12b755622e2f8e1d9df788"
            },
            "downloads": -1,
            "filename": "clitbl-0.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ee634fa87bc9d0f359f29e5a551aa6f6",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.4",
            "size": 5195,
            "upload_time": "2019-09-16T10:42:52",
            "url": "https://files.pythonhosted.org/packages/86/f0/32e194a2e791cda0294cc0396fb8f2a9462905dea933efb03cb489972128/clitbl-0.0.1-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "1396579e229f4cffd307f38edb60831f",
                "sha256": "ca40e0501dc4b9af5a79994a14008bd42adb33d9794a5589fdc40b4358ec0a24"
            },
            "downloads": -1,
            "filename": "clitbl-0.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "1396579e229f4cffd307f38edb60831f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.4",
            "size": 3753,
            "upload_time": "2019-09-16T10:42:54",
            "url": "https://files.pythonhosted.org/packages/b4/33/df49001cb5bca5f1867b0feffa000c9a0fff1281cd27277e2a0be6da7a08/clitbl-0.0.1.tar.gz"
        }
    ]
}