{"id":30600390,"url":"https://github.com/clamytoe/mdtable","last_synced_at":"2025-08-29T23:15:13.993Z","repository":{"id":311793675,"uuid":"1045073193","full_name":"clamytoe/mdtable","owner":"clamytoe","description":"An easy way to creating markdown tables from csv files.","archived":false,"fork":false,"pushed_at":"2025-08-26T18:52:25.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-26T22:31:03.972Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clamytoe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-26T16:02:56.000Z","updated_at":"2025-08-26T18:52:28.000Z","dependencies_parsed_at":"2025-08-26T22:34:26.267Z","dependency_job_id":"fed1b1d5-aa0a-4310-93f0-e3c7b722afeb","html_url":"https://github.com/clamytoe/mdtable","commit_stats":null,"previous_names":["clamytoe/mdtable"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/clamytoe/mdtable","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clamytoe%2Fmdtable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clamytoe%2Fmdtable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clamytoe%2Fmdtable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clamytoe%2Fmdtable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clamytoe","download_url":"https://codeload.github.com/clamytoe/mdtable/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clamytoe%2Fmdtable/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272779027,"owners_count":24991509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-29T02:00:10.610Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-29T23:15:12.902Z","updated_at":"2025-08-29T23:15:13.984Z","avatar_url":"https://github.com/clamytoe.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Markdown Table Generator (*mdtable*)\r\n\r\n\u003e *An easy way to creating markdown tables from csv files.*\r\n\r\n![Python version][python-version]\r\n![Latest version][latest-version]\r\n[![GitHub issues][issues-image]][issues-url]\r\n[![GitHub forks][fork-image]][fork-url]\r\n[![GitHub Stars][stars-image]][stars-url]\r\n[![License][license-image]][license-url]\r\n\r\nNOTE: This project was generated with [Cookiecutter](https://github.com/audreyr/cookiecutter) along with [@clamytoe's](https://github.com/clamytoe) [toepack](https://github.com/clamytoe/toepack) project template.\r\n\r\n## Initial setup\r\n\r\n```zsh\r\ncd Projects\r\ngit clone https://github.com/clamytoe/mdtable.git\r\ncd mdtable\r\n```\r\n\r\n### Anaconda setup\r\n\r\nIf you are an Anaconda user, this command will get you up to speed with the base installation.\r\n\r\n```zsh\r\nconda env create\r\nconda activate mdtable\r\n```\r\n\r\n### Regular Python setup\r\n\r\nIf you are just using normal Python, this will get you ready, but I highly recommend that you do this in a virtual environment.\r\nThere are many ways to do this, the simplest using *venv*.\r\n\r\n```zsh\r\npython3 -m venv venv\r\nsource venv/bin/activate\r\npip install -r requirements.txt\r\n```\r\n\r\n### Final setup\r\n\r\n```zsh\r\npip install -e .\r\n```\r\n\r\n## Usage\r\n\r\n```text\r\nusage: mdtable [-h] --input INPUT [--output OUTPUT] [--align ALIGN] [--preview]\r\n\r\nGenerate Markdown tables from CSV\r\n\r\noptions:\r\n  -h, --help       show this help message and exit\r\n  --input INPUT    Path to CSV file\r\n  --output OUTPUT  Path to save Markdown output\r\n  --align ALIGN    Comma-separated alignment (e.g. left,center,right)\r\n  --preview        Preview table in terminal\r\n```\r\n\r\n## Examples\r\n\r\nFor the following examples, I will be using the following data:\r\n\r\n*xrp-rich.csv*\r\n\r\n```csv\r\nPercentage, # Accounts, Balance equals (or greater than)\r\n0.01 %, 691, 6_692_587.586946 XRP\r\n0.1 %, 6_910, 350_491.824569 XRP\r\n0.2 %, 13_820, 197_695.303092 XRP\r\n0.5 %, 34_549, 96_445.903096 XRP\r\n1 %, 69_098, 50_025.789126 XRP\r\n2 %, 138_197, 25_003.992913 XRP\r\n3 %, 207_295, 15_642.899993 XRP\r\n4 %, 276_394, 10_686.116118 XRP\r\n5 %, 345_492, 8_370.264763 XRP\r\n10 %, 690_984, 2_396.754360 XRP\r\n```\r\n\r\n### Example 1\r\n\r\n```zsh\r\nmdtable --input xrp-rich.csv --output output.md --align right,center,right\r\n```\r\n\r\nThis will generate a markdown table from the data in `xrp-rich.csv` and save it to `output.md`. The alignments will be right,center, and right.\r\n\r\n*output.md*\r\n\r\n| Percentage |  # Accounts |  Balance equals (or greater than) |\r\n| ---: | :---: | ---: |\r\n| 0.01 % |  691 |  6,692,587.586946 XRP |\r\n| 0.1 % |  6,910 |  350,491.824569 XRP |\r\n| 0.2 % |  13,820 |  197,695.303092 XRP |\r\n| 0.5 % |  34,549 |  96,445.903096 XRP |\r\n| 1 % |  69,098 |  50,025.789126 XRP |\r\n| 2 % |  138,197 |  25,003.992913 XRP |\r\n| 3 % |  207,295 |  15,642.899993 XRP |\r\n| 4 % |  276,394 |  10,686.116118 XRP |\r\n| 5 % |  345,492 |  8,370.264763 XRP |\r\n| 10 % |  690,984 |  2,396.754360 XRP |\r\n\r\n### Example 2\r\n\r\n```zsh\r\nmdtable --input xrp-rich.csv --preview\r\n```\r\n\r\nThis will generate a markdown table from the data in `xrp-rich.csv` and preview it in the terminal.\r\n\r\n```text\r\n+------------+-------------+-----------------------------------+\r\n| Percentage |  # Accounts |  Balance equals (or greater than) |\r\n+------------+-------------+-----------------------------------+\r\n| Percentage |  # Accounts |  Balance equals (or greater than) |\r\n| 0.01 %     |  691        |  6,692,587.586946 XRP             |\r\n| 0.1 %      |  6,910      |  350,491.824569 XRP               |\r\n| 0.2 %      |  13,820     |  197,695.303092 XRP               |\r\n| 0.5 %      |  34,549     |  96,445.903096 XRP                |\r\n| 1 %        |  69,098     |  50,025.789126 XRP                |\r\n| 2 %        |  138,197    |  25,003.992913 XRP                |\r\n| 3 %        |  207,295    |  15,642.899993 XRP                |\r\n| 4 %        |  276,394    |  10,686.116118 XRP                |\r\n| 5 %        |  345,492    |  8,370.264763 XRP                 |\r\n| 10 %       |  690,984    |  2,396.754360 XRP                 |\r\n+------------+-------------+-----------------------------------+\r\n```\r\n\r\n## Contributing\r\n\r\nContributions are welcomed.\r\nTests can be run with with `pytest -v`, please ensure that all tests are passing and that you've checked your code with the following packages before submitting a pull request:\r\n\r\n* black\r\n* flake8\r\n* isort\r\n* mypy\r\n* pytest-cov\r\n\r\nI am not adhering to them strictly, but try to clean up what's reasonable.\r\n\r\n## License\r\n\r\nDistributed under the terms of the [MIT](https://opensource.org/licenses/MIT) license, \"mdtable\" is free and open source software.\r\n\r\n## Issues\r\n\r\nIf you encounter any problems, please [file an issue](https://github.com/clamytoe/toepack/issues) along with a detailed description.\r\n\r\n## Changelog\r\n\r\n* **v0.1.0** Initial commit.\r\n\r\n[python-version]:https://img.shields.io/badge/python-3.13.3-brightgreen.svg\r\n[latest-version]:https://img.shields.io/badge/version-0.1.0-blue.svg\r\n[issues-image]:https://img.shields.io/github/issues/clamytoe/mdtable.svg\r\n[issues-url]:https://github.com/clamytoe/mdtable/issues\r\n[fork-image]:https://img.shields.io/github/forks/clamytoe/mdtable.svg\r\n[fork-url]:https://github.com/clamytoe/mdtable/network\r\n[stars-image]:https://img.shields.io/github/stars/clamytoe/mdtable.svg\r\n[stars-url]:https://github.com/clamytoe/mdtable/stargazers\r\n[license-image]:https://img.shields.io/github/license/clamytoe/mdtable.svg\r\n[license-url]:https://github.com/clamytoe/mdtable/blob/main/LICENSE\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclamytoe%2Fmdtable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclamytoe%2Fmdtable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclamytoe%2Fmdtable/lists"}