tablify-csv 0.1.0

CLI tool that turns a CSV file into an HTML table with basic formatting

tablify-csv

CLI tool to convert data in a CSV file into an HTML table with basic formatting.

The tool lets you:

• Specify column headings to be displayed on the final HTML table
• Assign class names to any column (assign to td tags that fall under a given column)
• Save the output (prettified) HTML into a file

Requirements

• Python >= 3.8
• lxml >= 4.5.2
• prompt-toolkit >= 3.0.6
• typer >= 0.3.2

Please see requirements.txt and dev-requirements.txt for full list of dependencies.

Installation

It's recommended to create and activate a virtual environment before installing.

To install the latest development version, run the following:

$ pip install git+https://github.com/ralphqq/tablify-csv

Usage

If applicable, make sure that the virtual environment where you pip installed tablify-csv is activated.

To convert a CSV file, run:

$ tablify-csv CSV_FILENAME

This will save the HTML table in a file with the same name as the CSV file except the extension will be .html.

To specify a filename for the output file, run:

$ tablify-csv CSV_FILENAME --output-file OUTPUT_FILENAME

Development Setup

1. Clone this repo at https://github.com/ralphqq/tablify-csv
2. Create and activate a virtual environment
3. Install the development dependencies:

   $ pip install -r dev-requirements.txt
   

4. Run the test suite:

   $ pytest
   

Note: To ensure coding style consistency, this project uses pre-commit hooks. You may also want to initialize pre-commits into your local development clone (this is strongly recommended if you want to contribute, see Contributing section).

$ pre-commit install

Contributing

1. Fork this repo at https://github.com/ralphqq/tablify-csv
2. Clone your fork into your local machine
3. Follow steps in Development Setup but skip step 1
4. Initialize pre-commit hooks

   $ pre-commit install
   

5. Create your feature branch:

   $ git checkout -b feature/some-new-thing
   

6. Commit your changes:

   $ git commit -m "Develop new thing"
   

7. Push to the branch:

   $ git push origin feature/some-new-thing
   

8. Create a pull request

License

tablify-csv is available under the MIT License.