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

Unleashing CSV Power, One Line at a Time!

repo-top-language repo-language-count

## 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 ```sh └── 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: ```sh ❯ git clone https://github.com/Tilo-K/csvu ``` 2. Navigate to the project directory: ```sh ❯ cd csvu ``` 3. Build the project using Zig: zig build --release=fast ### Usage Run csvu using the following command: csvu [file] --- ## Project Roadmap - [X] **`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](https://github.com/Tilo-K/csvu/discussions)**: Share your insights, provide feedback, or ask questions. - **🐛 [Report Issues](https://github.com/Tilo-K/csvu/issues)**: Submit bugs found or log feature requests for the `csvu` project. - **💡 [Submit Pull Requests](https://github.com/Tilo-K/csvu/blob/main/CONTRIBUTING.md)**: 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. ```sh git clone https://github.com/Tilo-K/csvu ``` 3. **Create a New Branch**: Always work on a new branch, giving it a descriptive name. ```sh 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. ```sh git commit -m 'Implemented new feature x.' ``` 6. **Push to github**: Push the changes to your forked repository. ```sh 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

---