๐บ(tv) Tidy Viewer is a cross-platform CLI csv pretty printer that uses column styling to maximize viewer enjoyment.
--config-details
or -C
. This will allow users to see the current configuration of tv
. This is useful for debugging. Here is an example of the output:> tidy-viewer -C
tv.toml
[+] delimiter = ","
[+] title = ""
[-] footer = None
[+] upper_column_width = 20
[+] lower_column_width = 2
[+] number = 35
[-] extend_width_length = None
[+] meta_color = [Integer(255), Integer(0), Integer(0)]
[+] header_color = [Integer(232), Integer(168), Integer(124)]
[+] std_color = [Integer(133), Integer(205), Integer(202)]
[+] na_color = [Integer(226), Integer(125), Integer(95)]
[-] neg_num_color = None
The [+]
indicates that the values was found in the tv.toml
file.
The [-]
indicates that the value was not found in the tv.toml
file and the default value was used.
tv.toml
has had a long history of being buggy. This is because users must provide entries for every key. I removed this constraint. Now, if a key is not provided, the default value is used. This should make the tv.toml
more user friendly. Thanks @winter-again for the bug report.--number of rows to output
requires spaces between words instead of dashes. All other long form options use a dash to delimit words. Thanks @derekmahar for bug report.tv
is 1 year old ๐๐ฅณ๐.
tv
would not print remaining columns if the number of rows was less than n
.Changed if rows_remaining > 0
to if rows_remaining > 0 || (cols - num_cols_to_print) > 0
as the
condition needed to get the footer to kick in.
Also, I was looking through the changelog and saw that I never gave credit to @burntsushi for holding my hand as I was starting this project 1 year ago. I had a vision for this CLI, but was struggling with some basics as I was learning Rust. Thank You!
Note: Yes, I know there are a lot of versions skipped! I was struggling with getting some automated builds for one of the releases. One quark is that builds are triggered with git tags. I used up a lot of git tags to test things out. Which reminds me, thanks @certifiedloud for making the most recent builds possible. I could not have done it without you.
This update was mainly focused on feature enhancements. I also did some clippy
formatting.
I did not realize that I had the alignment wrong. I was doing left alignment, but it was brought to my attention that tibble
uses right alignment.
This is now corrected. Thanks for the sharp eye @briandconnelly.
-n
option doesn't work when combined with --extend-rows
This was a bug I was not aware of that I wanted to knock out. Thanks @atsalolikhin-spokeo for using this package and reporting the issue. Your report made the cli a little better.
As requested I implemented -R
, --no-row-numbering
for this functionality
As requested I implemented -D
, --no-dimensions
for this functionality
-e
was added as an option I found that it was not overriding the -n
argument. The fix was made with a simple if/else statement.It may seem odd to bump the version with such a small bug, but I did not want to have something in the help file that was not functional in the CLI.
-e
flag to extend rows (don't truncate).This new version gives a flag option to extend rows rather than truncate. This is especially useful for wide csv files that would overflow the terminal width. When using the extend mode, pipe output to less -S
to enables scrolling right and left with arrow keys.
I also did some clean up work. I removed a binary I was not using.
I was not aware of this until @ismaelgv opened the issue. less -R
and bat -p
can do color comprehension. In previous versions of tv
we just stripped the color if the output was piped to programs like less. Now the user can override this behavior with a -a
flag.
We made it!! Version #1!!
Technically it is version 1.4.2. The 42 is a homage to Geek culture.
What makes this release version 1? My view is that version 1 should encapsulate the original vision of the software. The features of the current package is what I imagined when I started drawing up the project. Of course, as I have continued to work on the package I have found many additional enhancements. Also, if it were not for users of the software I would not have had additional feedback which has improved on this package tremendously. I will continue to work on enhancements. There are currently a list of issues I plan to address. I will also address bugs as they are reported. A special thanks goes to all of the contributors. Not only has tv
been improved by smart contributors, but my own learning experience has been enhanced. Thank you!
sigfig
from the command line with the g
option. PR #107. Thanks to @rlewicki for this fantastic contribution๐Thanks to @Lireer and @rlewicki for the fantastic contributions in this release ๐
\t
as tab delimiter PR #99
Along with these new features came additional tests.
Since PR #98 was a aesthetic change it was also added as an additional parameter to be tweaked with a config file.
tv.toml
We also saw @namitaarya fix a help file typo.
f64::from_str
We also saw some code quality improvements in this release. PR #82
The version number jump was due to testing out github actions on automated releases using git tags as the release name. It took a few tries to get right.
snapcraft
to increase accessibility.The rest of the updates had to do with README updates and spelling errors in code comments.
This version was made possible by the contributions of @Lireer! Thank You!
delimiter
option.clippy
warnings and code refactoring..len()
to .chars().count()
to avoid potential column widths if the value contains code points consisting of multiple bytes.lower-column-width
lower-column-width
: The lower (minimum) width of columns. Must be 2 or larger. Default 2.
upper-column-width
: The upper (maximum) width of columns. Default 20.
debug-mode
: Print object details to make it easier for the maintainer to find and resolve bugs.
This is to save me time in the future :smile:tv
was not printing the last columnMinor Mistakes:
Feature Enhancement:
This update was mainly focused on feature enhancements. I also did some clippy
formatting.
I did not realize that I had the alignment wrong. I was doing left alignment, but it was brought to my attention that tibble
uses right alignment.
This is now corrected. Thanks for the sharp eye @briandconnelly.
-n
option doesn't work when combined with --extend-rows
This was a bug I was not aware of that I wanted to knock out. Thanks @atsalolikhin-spokeo for using this package and reporting the issue. Your report made the cli a little better.
As requested I implemented -R
, --no-row-numbering
for this functionality
As requested I implemented -D
, --no-dimensions
for this functionality
The release also has a solarized light theme. The first light theme ever. Thanks to @jwuphysics!
-e
was added as an option I found that it was not overriding the -n
argument. The fix was made with a simple if/else statement.It may seem odd to bump the version with such a small bug, but I did not want to have something in the help file that was not functional in the CLI.
Bug/e (#128)
* fix bug in -e
* dont bump the version
* push new version
* update change log
-e
flag to extend rows (don't truncate).This new version gives a flag option to extend rows rather than truncate. This is especially useful for wide csv files that would overflow the terminal width. When using the extend mode, pipe output to less -S
to enables scrolling right and left with arrow keys.
I also did some clean up work. I removed a binary I was not using.
I was not aware of this until @ismaelgv opened the issue. less -R
and bat -p
can do color comprehension. In previous versions of tv
we just stripped the color if the output was piped to programs like less. Now the user can override this behaviour with a -a
flag.
We made it!! Version #1!!
Technically it is version 1.4.2. The 42 is a homage to Geek culture.
What makes this release version 1? My view is that version 1 should encapsulate the original vision of the software. The features of the current package is what I imagined when I started drawing up the project. Of course, as I have continued to work on the package I have found many additional enhancements. Also, if it were not for users of the software I would not have had additional feedback which has improved on this package tremendously. I will continue to work on enhancements. There are currently a list of issues I plan to address. I will also address bugs as they are reported. A special thanks goes to all of the contributors. Not only has tv
been improved by smart contributors, but my own learning experience has been enhanced. Thank you!
sigfig
from the command line with the g
option. PR #107. Thanks to @rlewicki for this fantastic contribution๐Thanks to @Lireer and @rlewicki for the fantastic contributions in this release ๐
\t
as tab delimiter PR #99
Along with these new features came additional tests.
Since PR #98 was a aesthetic change it was also added as an additional parameter to be tweaked with a config file.
tv.toml
We also saw @namitaarya fix a help file typo.
f64::from_str
We also saw some code quality improvements in this release. PR #82
The version number jump was due to testing out github actions on automated releases using git tags as the release name. It took a few tries to get right.
The rest of the updates had to do with README updates and spelling errors in code comments.
This version was made possible by the contributions of @Lireer! Thank You!
delimiter
option.clippy
warnings and code refactoring..len()
to .chars().count()
to avoid potential column widths if the calue contains code points consisting of multiple bytes.lower-column-width
lower-column-width
: The lower (minimum) width of columns. Must be 2 or larger. Default 2.
upper-column-width
: The upper (maxiumum) width of columns. Default 20.
debug-mode
: Print object details to make it easier for the maintainer to find and resolve bugs.
This is to save me time in the futre :smile:tv
was not printing the last columnMinor Mistakes:
Feature Enhancement:
We made it!!
Technically it is version 1.4.2. The 42 is a homage to geek culture.
What makes this release version 1?
My view is that version 1 should encapsulate the original vision of the software. The features of the current package is what I imagined when I started drawing up the project. Of course, as I have continued to work on the package I have found many additional enhancements. Also, if it were not for users of the software I would not have had additional feedback which has improved on this package tremendously. I will continue to work on enhancements. There are currently a list of issues I plan to address. I will also address bugs as they are reported. A special thanks goes to all of the contributors. Not only has tv
been improved by smart contributors, but my own learning experience has been enhanced. Thank you!
sigfig
from the command line with the g
option. PR #107. Thanks to @rlewicki for this fantastic contribution๐Thanks to @Lireer and @rlewicki for the fantastic contributions in this release ๐
\t
as tab delimiter PR #99
Along with these new features came additional tests.
Since PR #98 was a aesthetic change it was also added as an additional parameter to be tweaked with a config file.
tv.toml
We also saw @namitaarya fix a help file typo.
f64::from_str
We also saw some code quality improvements in this release. PR #82
The version number jump was due to testing out github actions on automated releases using git tags as the release name. It took a few tries to get right.
The rest of the updates had to do with README updates and spelling errors in code comments.
This version was made possible by the contributions of @Lireer! Thank You!
delimiter
option.clippy
warnings and code refactoring..len()
to .chars().count()
to avoid potential column widths if the calue contains code points consisting of multiple bytes.lower-column-width
lower-column-width
: The lower (minimum) width of columns. Must be 2 or larger. Default 2.
upper-column-width
: The upper (maxiumum) width of columns. Default 20.
debug-mode
: Print object details to make it easier for the maintainer to find and resolve bugs.
This is to save me time in the futre :smile:tv
was not printing the last columnMinor Mistakes:
Feature Enhancement: