╔════════════════════════════════╗
║                                ║
║   ████   ████  ██  ██ ██  ██   ║
║  ██     ██     ██  ██ ██  ██   ║
║  ██      ████  ██  ██ ██  ██   ║
║  ██         ██  ████  ██  ██   ║
║   ████  █████    ██    ████    ║
║                                ║
║                                ║
╚════════════════════════════════╝

Unleashing CSV Power, One Line at a Time!

Overview

The csvu is a dynamic CSV utility designed to streamline data handling. It effectively parses and presents CSV files in a user-friendly tabular format, with automatic delimiter recognition and data validation. Providing a precise terminal dimension fetcher, csvu ensures seamless cross-platform compatibility. Ideal for developers and data enthusiasts seeking robust, reliable, and easy-to-navigate data solutions.

Example Output

-----------------------------------------------------------------------------------
|country |latitude   |longitude   |name                                           |
-----------------------------------------------------------------------------------
|AD      |42.546245  |1.601554    |Andorra                                        |
|AE      |23.424076  |53.847818   |"United Arab Emirates"                         |
|AF      |33.93911   |67.709953   |Afghanistan                                    |
|AG      |17.060816  |-61.796428  |"Antigua and Barbuda"                          |
|AI      |18.220554  |-63.068615  |Anguilla                                       |
|AL      |41.153332  |20.168331   |Albania                                        |
|AM      |40.069099  |45.038189   |Armenia                                        |
|AN      |12.226079  |-69.060087  |"Netherlands Antilles"                         |
|AO      |-11.202692 |17.873887   |Angola                                         |
|AQ      |-75.250973 |-0.071389   |Antarctica                                     |
|VC      |12.984305  |-61.287228  |"Saint Vincent and the Grenadines"             |
|VE      |6.42375    |-66.58973   |Venezuela                                      |
|VG      |18.420695  |-64.639968  |"British Virgin Islands"                       |
|VI      |18.335765  |-64.896335  |"U.S. Virgin Islands"                          |
|VN      |14.058324  |108.277199  |Vietnam                                        |
|VU      |-15.376706 |166.959158  |Vanuatu                                        |
|WF      |-13.768752 |-177.156097 |"Wallis and Futuna"                            |
|WS      |-13.759029 |-172.104629 |Samoa                                          |
|XK      |42.602636  |20.902977   |Kosovo                                         |
|YE      |15.552727  |48.516388   |Yemen                                          |
|YT      |-12.8275   |45.166244   |Mayotte                                        |
|ZA      |-30.559482 |22.937506   |"South Africa"                                 |
|ZM      |-13.133897 |27.849332   |Zambia                                         |
|ZW      |-19.015438 |29.154857   |Zimbabwe                                       |
-----------------------------------------------------------------------------------

---

Project Structure

└── csvu/
    ├── LICENSE
    ├── build.zig
    ├── build.zig.zon
    ├── demo.csv
    └── src
        ├── csv.zig
        ├── main.zig
        ├── root.zig
        └── term.zig

---

Getting Started

Prerequisites

Before getting started with csvu, ensure your runtime environment meets the following requirements:

• Programming Language: Zig
• Zig Version: 0.14.0 or later

Installation

Install csvu using one of the following methods:

Build from source:

1. Clone the csvu repository:

❯ git clone https://github.com/Tilo-K/csvu

2. Navigate to the project directory:

❯ cd csvu

3. Build the project using Zig:

zig build --release=fast

Usage

Run csvu using the following command: csvu [file]

---

Project Roadmap

• Print basic tables: Be able to print basic tables.
• Search in rows: Implement a basic search feature for rows.
• Colors: Implement colored output for better readability.

---

Contributing

• 💬 Join the Discussions: Share your insights, provide feedback, or ask questions.
• 🐛 Report Issues: Submit bugs found or log feature requests for the csvu project.
• 💡 Submit Pull Requests: Review open PRs, and submit your own PRs.

Contributing Guidelines

1. Fork the Repository: Start by forking the project repository to your github account.

2. Clone Locally: Clone the forked repository to your local machine using a git client.

   git clone https://github.com/Tilo-K/csvu

3. Create a New Branch: Always work on a new branch, giving it a descriptive name.

   git checkout -b new-feature-x

4. Make Your Changes: Develop and test your changes locally.

5. Commit Your Changes: Commit with a clear message describing your updates.

   git commit -m 'Implemented new feature x.'

6. Push to github: Push the changes to your forked repository.

   git push origin new-feature-x

7. Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.

8. Review: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!

Contributor Graph

---