moved to codeberg

* fix #77: parse floats and nils as well and convert them to string

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: "[bug-report]"
+labels: bug
+assignees: TLINDEN
+
+---
+
+**Description**
+<!-- Please provide a clear and concise description of the issue: -->
+
+
+**Steps To Reproduce**
+<!-- Please detail the steps to reproduce the behavior: -->
+
+
+**Expected behavior**
+<!-- What do you expected to happen instead? -->
+
+
+**Version information**
+<!--
+Please provide as much version information as possible:
+- if you have just installed a binary, provide the output of: tablizer --version
+- if you installed from source, provide the output of: make show-version
+- provide additional details: operating system and version and shell environment
+-->
+
+
+**Additional informations**

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest a feature
+title: "[feature-request]"
+labels: feature-request
+assignees: TLINDEN
+
+---
+
+**Description**
+<!-- Please provide a clear and concise description of the feature you desire: -->
+
+
+
+**Version information**
+<!--
+Just in case the feature is already present, please provide as
+much version information as possible:
+- if you have just installed a binary, provide the output of: tablizer --version
+- if you installed from source, provide the output of: make show-version
+- provide additional details: operating system and version and shell environment
+-->
+

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "gomod"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+        interval: "monthly"

.github/workflows/ci.yaml

@@ -1,25 +0,0 @@
-name: build-and-test-tablizer
-on: [push, pull_request]
-jobs:
-  build:
-    strategy:
-      matrix:
-        version: [1.17, 1.18, 1.19]
-        os: [ubuntu-latest, windows-latest, macos-latest]
-    name: Build
-    runs-on: ${{ matrix.os }}
-    steps:
-    - name: Set up Go 1.18
-      uses: actions/setup-go@v3
-      with:
-        go-version: ${{ matrix.version }}
-      id: go
-
-    - name: checkout
-      uses: actions/checkout@v3
-
-    - name: build
-      run: make
-
-    - name: test
-      run: make test

.gitignore

@@ -0,0 +1,3 @@
+releases
+tablizer
+*.out

Makefile

@@ -1,59 +0,0 @@
-
-# Copyright © 2022 Thomas von Dein
-
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-
-# You should have received a copy of the GNU General Public License
-# along with this program. If not, see <http://www.gnu.org/licenses/>.
-
-
-#
-# no need to modify anything below
-tool    = tablizer
-version = $(shell egrep "= .v" lib/common.go | cut -d'=' -f2 | cut -d'"' -f 2)
-archs   = android darwin freebsd linux netbsd openbsd windows
-PREFIX  = /usr/local
-UID     = root
-GID     = 0
-BRANCH  = $(shell git describe --all | cut -d/ -f2)
-COMMIT  = $(shell git rev-parse --short=8 HEAD)
-BUILD   = $(shell date +%Y.%m.%d.%H%M%S) 
-VERSION:= $(if $(filter $(BRANCH), development),$(version)-$(BRANCH)-$(COMMIT)-$(BUILD))
-
-
-all: $(tool).1 cmd/$(tool).go buildlocal
-
-%.1: %.pod
-	pod2man -c "User Commands" -r 1 -s 1 $*.pod > $*.1
-
-cmd/%.go: %.pod
-	echo "package cmd" > cmd/$*.go
-	echo "var manpage = \`" >> cmd/$*.go
-	pod2text $*.pod >> cmd/$*.go
-	echo "\`" >> cmd/$*.go
-
-buildlocal:
-	go build -ldflags "-X 'github.com/tlinden/tablizer/lib.VERSION=$(VERSION)'"
-
-release:
-	./mkrel.sh $(tool) $(version)
-
-install: buildlocal
-	install -d -o $(UID) -g $(GID) $(PREFIX)/bin
-	install -d -o $(UID) -g $(GID) $(PREFIX)/man/man1
-	install -o $(UID) -g $(GID) -m 555 $(tool)  $(PREFIX)/sbin/
-	install -o $(UID) -g $(GID) -m 444 $(tool).1 $(PREFIX)/man/man1/
-
-clean:
-	rm -rf $(tool) releases
-
-test:
-	go test -v ./...

README.md

@@ -1,11 +1,93 @@
-[![Actions](https://github.com/tlinden/tablizer/actions/workflows/ci.yaml/badge.svg)](https://github.com/tlinden/tablizer/actions)
-[![License](https://img.shields.io/badge/license-GPL-blue.svg)](https://github.com/tlinden/tablizer/blob/master/LICENSE)
+[![status-badge](https://ci.codeberg.org/api/badges/15519/status.svg)](https://ci.codeberg.org/repos/15519)
+[![License](https://img.shields.io/badge/license-GPL-blue.svg)](https://codeberg.org/scip/tablizer/blob/master/LICENSE)
+[![Go Report Card](https://goreportcard.com/badge/codeberg.org/scip/tablizer)](https://goreportcard.com/report/codeberg.org/scip/tablizer)
 
 ## tablizer - Manipulate tabular output of other programs
 
+> [!IMPORTANT]
+> This software is now being maintained on [Codeberg](https://codeberg.org/scip/tablizer/).
+
 Tablizer  can   be  used   to  re-format   tabular  output   of  other
 programs. While you  could do this using standard unix  tools, in some
-cases it's a hard job.
+cases it's a hard job. With tablizer you can filter by column[s],
+ignore certain column[s] by regex, name or number. It can output the
+tabular data in a range of formats (see below). There's even an
+interactive filter/selection tool available.
+
+## FEATURES
+
+- supports csv, json or ascii format input from files or stdin
+- split any tabular input data by character or regular expression into columns
+- add headers if input data doesn't contain them (automatically or manually)
+- print tabular data as ascii table, org-mode, markdown, csv, shell-evaluable or yaml format
+- filter rows by regular expression (saves a call to `| grep ...`)
+- filter rows by column filter
+- filters may also be negations eg `-Fname!=cow.*` or `-v`
+- modify cells wih regular expressions
+- reduce columns by specifying which columns to show, with regex support
+- color support
+- sort by any field[s], multiple sort modes are supported
+- shell completion for options
+- regular used options can be put into a config file
+- filter TUI where where you can interactively sort and filter rows
+
+## Demo
+
+![demo cast](vhsdemo/demo.gif)
+
+
+## Usage
+
+```default
+Usage:
+  tablizer [regex,...] [file, ...] [flags]
+
+Operational Flags:
+  -c, --columns string               Only show the speficied columns (separated by ,)
+  -v, --invert-match                 select non-matching rows
+  -n, --numbering                    Enable header numbering
+  -N, --no-color                     Disable pattern highlighting
+  -H, --no-headers                   Disable headers display
+  -s, --separator <string>           Custom field separator
+  -k, --sort-by <int|name>           Sort by column (default: 1)
+  -z, --fuzzy                        Use fuzzy search [experimental]
+  -F, --filter <field[!]=reg>        Filter given field with regex, can be used multiple times
+  -T, --transpose-columns string     Transpose the speficied columns (separated by ,)
+  -R, --regex-transposer </from/to/> Apply /search/replace/ regexp to fields given in -T
+  -j, --json                         Read JSON input (must be array of hashes)
+  -I, --interactive                  Interactively filter and select rows
+      --auto-headers                 Generate headers if there are none present in input
+      --custom-headers a,b,...       Use custom headers, separated by comma
+
+
+Output Flags (mutually exclusive):
+  -X, --extended                     Enable extended output
+  -M, --markdown                     Enable markdown table output
+  -O, --orgtbl                       Enable org-mode table output
+  -S, --shell                        Enable shell evaluable output
+  -Y, --yaml                         Enable yaml output
+  -C, --csv                          Enable CSV output
+  -A, --ascii                        Default output mode, ascii tabular
+  -L, --hightlight-lines             Use alternating background colors for tables
+  -y, --yank-columns                 Yank specified columns (separated by ,) to clipboard,
+                                     space separated
+      --ofs <char>                   Output field separator, used by -A and -C. 
+
+Sort Mode Flags (mutually exclusive):
+  -a, --sort-age                     sort according to age (duration) string
+  -D, --sort-desc                    Sort in descending order (default: ascending)
+  -i, --sort-numeric                 sort according to string numerical value
+  -t, --sort-time                    sort according to time string
+
+Other Flags:
+  -r  --read-file <file>             Use <file> as input instead of STDIN
+      --completion <shell>           Generate the autocompletion script for <shell>
+  -f, --config <file>                Configuration file (default: ~/.config/tablizer/config)
+  -d, --debug                        Enable debugging
+  -h, --help                         help for tablizer
+  -m, --man                          Display manual page
+  -V, --version                      Print program version
+```
 
 Let's take this output:
 ```
@@ -20,41 +102,42 @@ But you're only interested in the  NAME and STATUS columns. Here's how
 to do this with tablizer:
 
 ```
-% kubectl get pods | ./tablizer 
-NAME(1)                      READY(2) STATUS(3)  RESTARTS(4)    AGE(5)
+% kubectl get pods | tablizer 
+NAME                         READY    STATUS     RESTARTS       AGE
 repldepl-7bcd8d5b64-7zq4l    1/1      Running    1 (69m ago)    5h26m
 repldepl-7bcd8d5b64-m48n8    1/1      Running    1 (69m ago)    5h26m
 repldepl-7bcd8d5b64-q2bf4    1/1      Running    1 (69m ago)    5h26m
 
-% kubectl get pods | ./tablizer -c 1,3
-NAME(1)                      STATUS(3)
+% kubectl get pods | tablizer -c 1,3
+NAME                         STATUS
 repldepl-7bcd8d5b64-7zq4l    Running
 repldepl-7bcd8d5b64-m48n8    Running
 repldepl-7bcd8d5b64-q2bf4    Running 
 ```
 
 Another use case is when the tabular  output is so wide that lines are
-being broken and  the whole output is completely distorted.  In such a
-case you can use the `-x` flag to get an output similar to `\x` in `psql`:
+being broken and the whole output  is completely distorted.  In such a
+case you can use the `-o extended  | -X` flag to get an output similar
+to `\x` in `psql`:
 
 ```
-% kubectl get pods | ./tablizer -x    
-    NAME: repldepl-7bcd8d5b64-7zq4l  
-   READY: 1/1    
-  STATUS: Running  
-RESTARTS: 1 (71m ago)  
+% kubectl get pods | tablizer -X
+    NAME: repldepl-7bcd8d5b64-7zq4l
+   READY: 1/1
+  STATUS: Running
+RESTARTS: 1 (71m ago)
      AGE: 5h28m
 
-    NAME: repldepl-7bcd8d5b64-m48n8  
-   READY: 1/1    
-  STATUS: Running  
-RESTARTS: 1 (71m ago)  
+    NAME: repldepl-7bcd8d5b64-m48n8
+   READY: 1/1
+  STATUS: Running
+RESTARTS: 1 (71m ago)
      AGE: 5h28m
 
-    NAME: repldepl-7bcd8d5b64-q2bf4  
-   READY: 1/1    
-  STATUS: Running  
-RESTARTS: 1 (71m ago)  
+    NAME: repldepl-7bcd8d5b64-q2bf4
+   READY: 1/1
+  STATUS: Running
+RESTARTS: 1 (71m ago)
      AGE: 5h28m
 ```
 
@@ -63,17 +146,56 @@ Tablize can read one or more files or - if none specified - from STDIN.
 You can also specify a regex pattern to reduce the output:
 
 ```
-% kubectl get pods | ./tablizer q2bf4
-NAME(1)                      READY(2) STATUS(3)  RESTARTS(4)    AGE(5)
+% kubectl get pods | tablizer q2bf4
+NAME                         READY    STATUS     RESTARTS       AGE
 repldepl-7bcd8d5b64-q2bf4    1/1      Running    1 (69m ago)    5h26m
 ```
 
+Sometimes a filter regex is to broad  and you wish to filter only on a
+particular column. This is possible using `-F`:
+```
+% kubectl get pods | tablizer -Fname=2
+NAME                            READY   STATUS  RESTARTS        AGE
+repldepl-7bcd8d5b64-q2bf4       1/1     Running 1 (69m ago)     5h26m
+```
+
+Here we filtered  the `NAME` column for `2`, which  would have matched
+otherwise on all rows.
+
+There are more output modes like org-mode (orgtbl) and markdown.
+
+You can also use it to modify certain cells using regular expression
+matching. For example:
+
+```shell
+kubectl get pods | tablizer -T4 -R '/ /-/'
+NAME                            READY   STATUS  RESTARTS        AGE
+repldepl-7bcd8d5b64-7zq4l       1/1     Running 1-(69m-ago)     5h26m
+repldepl-7bcd8d5b64-m48n8       1/1     Running 1-(69m-ago)     5h26m
+repldepl-7bcd8d5b64-q2bf4       1/1     Running 1-(69m-ago)     5h26m
+```
+
+Here, we modified the 4th column (`-T4`) by replacing every space with
+a dash. If you need to work with `/` characters, you can also use any
+other separator, for instance: `-R '| |-|'`.
+
+There's also an interactive mode, invoked with the option B<-I>, where
+you can interactively filter and select rows:
+
+<img width="937" height="293" alt="interactive" src="https://github.com/user-attachments/assets/0d4d65e2-d156-43ed-8021-39047c7939ed" />
+
+
 
 ## Installation
 
 There are multiple ways to install **tablizer**:
 
-- Go to the [latest release page](https://github.com/muesli/mango/releases/latest),
+- You can use [stew](https://github.com/marwanhawari/stew) to install tablizer:
+  ```default
+  stew install tlinden/tablizer
+  ```
+
+- Go to the [latest release page](https://codeberg.org/scip/tablizer/releases),
   locate the binary for your operating system and platform.
   
   Download it and put it into some directory within your `$PATH` variable.
@@ -86,7 +208,7 @@ There are multiple ways to install **tablizer**:
   
 - You can also install from source. Issue the following commands in your shell:
   ```
-  git clone https://github.com/TLINDEN/tablizer.git
+  git clone https://codeberg.org/scip/tablizer.git
   cd tablizer
   make
   sudo make install
@@ -98,14 +220,17 @@ hesitate to ask me about it, I'll add it.
 ## Documentation
 
 The  documentation  is  provided  as  a unix  man-page.   It  will  be
-automatically installed if  you install from source.  However, you can
-read the man-page online:
+automatically installed if  you install from source.
 
-https://github.com/TLINDEN/tablizer/blob/main/tablizer.pod
+[However, you can read the man-page online](https://codeberg.org/scip/tablizer/raw/branch/tablizer.pod).
 
 Or if you cloned  the repository you can read it  this way (perl needs
 to be installed though): `perldoc tablizer.pod`.
 
+If you have the binary installed, you  can also read the man page with
+this command:
+
+    tablizer --man
 
 ## Getting help
 
@@ -114,7 +239,42 @@ that's the best way for me to forget to do something.
 
 In order to report a bug, unexpected behavior, feature requests
 or to submit a patch, please open an issue on github:
-https://github.com/TLINDEN/tablizer/issues.
+https://codeberg.org/scip/tablizer/issues.
+
+## Prior Art
+
+When I started with tablizer I was not aware that other tools
+exist. Here is a non-exhausive list of the ones I find especially
+awesome:
+
+### [miller](https://github.com/johnkerl/miller)
+
+This is a really powerful tool to work with tabular data and it also
+allows other inputs as json, csv etc. You can filter, manipulate,
+create pipelines, there's even a programming language builtin to do
+even more amazing things.
+
+### [csvq](https://github.com/mithrandie/csvq)
+
+Csvq allows you to query CSV and TSV data using SQL queries. How nice
+is that? Highly recommended if you have to work with a large (and
+wide) dataset and need to apply a complicated set of rules.
+
+### [goawk](https://github.com/benhoyt/goawk)
+
+Goawk is a 100% POSIX compliant AWK implementation in GO, which also
+supports CSV and TSV data as input (using `-i csv` for example). You
+can apply any kind of awk code to your tabular data, there are no
+limit to your creativity!
+
+### [teip](https://github.com/greymd/teip)
+
+I particularly like teip, it's a real gem. You can use it to drill
+"holes" into your tabular data and modify these "holes" using small
+external unix commands such as grep or sed. The possibilities are
+endless, you can even use teip to modify data inside a hole created by
+teip. Highly recommended.
+
 
 ## Copyright and license
 
@@ -126,4 +286,4 @@ T.v.Dein <tom AT vondein DOT org>
 
 ## Project homepage
 
-https://github.com/TLINDEN/tablizer
+https://codeberg.org/scip/tablizer

TODO

@@ -1 +0,0 @@
-

cmd/root.go

@@ -1,106 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-package cmd
-
-import (
-	"bytes"
-	"fmt"
-	"github.com/spf13/cobra"
-	"github.com/tlinden/tablizer/lib"
-	"log"
-	"os"
-	"os/exec"
-)
-
-var ShowManual = false
-
-func man() {
-	man := exec.Command("less", "-")
-
-	var b bytes.Buffer
-	b.Write([]byte(manpage))
-
-	man.Stdout = os.Stdout
-	man.Stdin = &b
-	man.Stderr = os.Stderr
-
-	err := man.Run()
-
-	if err != nil {
-		log.Fatal(err)
-	}
-}
-
-var rootCmd = &cobra.Command{
-	Use:   "tablizer [regex] [file, ...]",
-	Short: "[Re-]tabularize tabular data",
-	Long:  `Manipulate tabular output of other programs`,
-	RunE: func(cmd *cobra.Command, args []string) error {
-		if lib.ShowVersion {
-			fmt.Printf("This is tablizer version %s\n", lib.VERSION)
-			return nil
-		}
-
-		if ShowManual {
-			man()
-			return nil
-		}
-
-		err := lib.PrepareColumns()
-		if err != nil {
-			return err
-		}
-
-		err = lib.PrepareModeFlags()
-		if err != nil {
-			return err
-		}
-
-		return lib.ProcessFiles(args)
-	},
-}
-
-func Execute() {
-	err := rootCmd.Execute()
-	if err != nil {
-		os.Exit(1)
-	}
-}
-
-func init() {
-	rootCmd.PersistentFlags().BoolVarP(&lib.Debug, "debug", "d", false, "Enable debugging")
-	rootCmd.PersistentFlags().BoolVarP(&lib.NoNumbering, "no-numbering", "n", false, "Disable header numbering")
-	rootCmd.PersistentFlags().BoolVarP(&lib.ShowVersion, "version", "V", false, "Print program version")
-	rootCmd.PersistentFlags().BoolVarP(&lib.InvertMatch, "invert-match", "v", false, "select non-matching rows")
-	rootCmd.PersistentFlags().BoolVarP(&ShowManual, "man", "m", false, "Display manual page")
-	rootCmd.PersistentFlags().StringVarP(&lib.Separator, "separator", "s", lib.DefaultSeparator, "Custom field separator")
-	rootCmd.PersistentFlags().StringVarP(&lib.Columns, "columns", "c", "", "Only show the speficied columns (separated by ,)")
-
-	// output flags, only 1 allowed, hidden, since just short cuts
-	rootCmd.PersistentFlags().BoolVarP(&lib.OutflagExtended, "extended", "X", false, "Enable extended output")
-	rootCmd.PersistentFlags().BoolVarP(&lib.OutflagMarkdown, "markdown", "M", false, "Enable markdown table output")
-	rootCmd.PersistentFlags().BoolVarP(&lib.OutflagOrgtable, "orgtbl", "O", false, "Enable org-mode table output")
-	rootCmd.PersistentFlags().BoolVarP(&lib.OutflagShell, "shell", "S", false, "Enable shell mode output")
-	rootCmd.MarkFlagsMutuallyExclusive("extended", "markdown", "orgtbl", "shell")
-	rootCmd.Flags().MarkHidden("extended")
-	rootCmd.Flags().MarkHidden("orgtbl")
-	rootCmd.Flags().MarkHidden("markdown")
-	rootCmd.Flags().MarkHidden("shell")
-
-	// same thing but more common, takes precedence over above group
-	rootCmd.PersistentFlags().StringVarP(&lib.OutputMode, "output", "o", "", "Output mode - one of: orgtbl, markdown, extended, shell, ascii(default)")
-}

cmd/tablizer.go

@@ -1,131 +0,0 @@
-package cmd
-var manpage = `
-NAME
-    tablizer - Manipulate tabular output of other programs
-
-SYNOPSIS
-        Usage:
-          tablizer [regex] [file, ...] [flags]
-    
-        Flags:
-          -c, --columns string     Only show the speficied columns (separated by ,)
-          -d, --debug              Enable debugging
-          -h, --help               help for tablizer
-          -v, --invert-match       select non-matching rows
-          -m, --man                Display manual page
-          -n, --no-numbering       Disable header numbering
-          -o, --output string      Output mode - one of: orgtbl, markdown, extended, ascii(default)
-          -X, --extended           Enable extended output
-          -M, --markdown           Enable markdown table output
-          -O, --orgtbl             Enable org-mode table output
-          -s, --separator string   Custom field separator
-          -v, --version            Print program version
-
-DESCRIPTION
-    Many programs generate tabular output. But sometimes you need to
-    post-process these tables, you may need to remove one or more columns or
-    you may want to filter for some pattern or you may need the output in
-    another program and need to parse it somehow. Standard unix tools such
-    as awk(1), grep(1) or column(1) may help, but sometimes it's a tedious
-    business.
-
-    Let's take the output of the tool kubectl. It contains cells with
-    withespace and they do not separate columns by TAB characters. This is
-    not easy to process.
-
-    You can use tablizer to do these and more things.
-
-    tablizer analyses the header fiels of a table, registers the column
-    positions of each header field and separates columns by those positions.
-
-    Without any options it reads its input from "STDIN", but you can also
-    specify a file as a parameter. If you want to reduce the output by some
-    regular expression, just specify it as its first parameter. You may also
-    use the -v option to exclude all rows which match the pattern. Hence:
-
-       # read from STDIN
-       kubectl get pods | tablizer
-
-       # read a file
-       tablizer filename
-
-       # search for pattern in a file (works like grep)
-       tablizer regex filename
-
-       # search for pattern in STDIN
-       kubectl get pods | tablizer regex
-
-    The output looks like the original one but every header field will have
-    a numer associated with it, e.g.:
-
-       NAME(1) READY(2) STATUS(3) RESTARTS(4) AGE(5)
-
-    These numbers denote the column and you can use them to specify which
-    columns you want to have in your output:
-
-       kubectl get pods | tablizer -c1,3
-
-    You can specify the numbers in any order but output will always follow
-    the original order.
-
-    The numbering can be suppressed by using the -n option.
-
-    Finally the -d option enables debugging output which is mostly usefull
-    for the developer.
-
-  OUTPUT MODES
-    There might be cases when the tabular output of a program is way too
-    large for your current terminal but you still need to see every column.
-    In such cases the -o extended or -X option can be usefull which enables
-    *extended mode*. In this mode, each row will be printed vertically,
-    header left, value right, aligned by the field widths. Here's an
-    example:
-
-        kubectl get pods | ./tablizer -o extended
-            NAME: repldepl-7bcd8d5b64-7zq4l  
-           READY: 1/1    
-          STATUS: Running  
-        RESTARTS: 1 (71m ago)  
-             AGE: 5h28m
-
-    You can of course still use a regex to reduce the number of rows
-    displayed.
-
-    The option -o shell can be used if the output has to be processed by the
-    shell, it prints variable assignments for each cell, one line per row:
-
-        kubectl get pods | ./tablizer -o extended ./tablizer -o shell
-        NAME="repldepl-7bcd8d5b64-7zq4l" READY="1/1" STATUS="Running" RESTARTS="9 (47m ago)" AGE="4d23h" 
-        NAME="repldepl-7bcd8d5b64-m48n8" READY="1/1" STATUS="Running" RESTARTS="9 (47m ago)" AGE="4d23h" 
-        NAME="repldepl-7bcd8d5b64-q2bf4" READY="1/1" STATUS="Running" RESTARTS="9 (47m ago)" AGE="4d23h"
-
-    You can use this in an eval loop.
-
-    Beside normal ascii mode (the default) and extended mode there are more
-    output modes available: orgtbl which prints an Emacs org-mode table and
-    markdown which prints a Markdown table.
-
-BUGS
-    In order to report a bug, unexpected behavior, feature requests or to
-    submit a patch, please open an issue on github:
-    <https://github.com/TLINDEN/tablizer/issues>.
-
-LICENSE
-    This software is licensed under the GNU GENERAL PUBLIC LICENSE version
-    3.
-
-    Copyright (c) 2022 by Thomas von Dein
-
-    This software uses the following GO libraries:
-
-    repr (https://github.com/alecthomas/repr)
-        Released under the MIT License, Copyright (c) 2016 Alec Thomas
-
-    cobra (https://github.com/spf13/cobra)
-        Released under the Apache 2.0 license, Copyright 2013-2022 The Cobra
-        Authors
-
-AUTHORS
-    Thomas von Dein tom AT vondein DOT org
-
-`

go.mod

@@ -1,16 +0,0 @@
-module github.com/tlinden/tablizer
-
-go 1.18
-
-require (
-	github.com/alecthomas/repr v0.0.0-20180818092828-117648cd9897
-	github.com/olekukonko/tablewriter v0.0.5
-	github.com/spf13/cobra v1.5.0
-)
-
-require (
-	github.com/inconshreveable/mousetrap v1.0.0 // indirect
-	github.com/mattn/go-runewidth v0.0.9 // indirect
-	github.com/spf13/pflag v1.0.5 // indirect
-	github.com/stretchr/testify v1.8.0 // indirect
-)

go.sum

@@ -1,29 +0,0 @@
-github.com/alecthomas/repr v0.0.0-20180818092828-117648cd9897 h1:p9Sln00KOTlrYkxI1zYWl1QLnEqAqEARBEYa8FQnQcY=
-github.com/alecthomas/repr v0.0.0-20180818092828-117648cd9897/go.mod h1:xTS7Pm1pD1mvyM075QCDSRqH6qRLXylzS24ZTpRiSzQ=
-github.com/cpuguy83/go-md2man/v2 v2.0.2/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
-github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/inconshreveable/mousetrap v1.0.0 h1:Z8tu5sraLXCXIcARxBp/8cbvlwVa7Z1NHg9XEKhtSvM=
-github.com/inconshreveable/mousetrap v1.0.0/go.mod h1:PxqpIevigyE2G7u3NXJIT2ANytuPF1OarO4DADm73n8=
-github.com/mattn/go-runewidth v0.0.9 h1:Lm995f3rfxdpd6TSmuVCHVb/QhupuXlYr8sCI/QdE+0=
-github.com/mattn/go-runewidth v0.0.9/go.mod h1:H031xJmbD/WCDINGzjvQ9THkh0rPKHF+m2gUSrubnMI=
-github.com/olekukonko/tablewriter v0.0.5 h1:P2Ga83D34wi1o9J6Wh1mRuqd4mF/x/lgBS7N7AbDhec=
-github.com/olekukonko/tablewriter v0.0.5/go.mod h1:hPp6KlRPjbx+hW8ykQs1w3UBbZlj6HuIJcUGPhkA7kY=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
-github.com/spf13/cobra v1.5.0 h1:X+jTBEBqF0bHN+9cSMgmfuvv2VHJ9ezmFNf9Y/XstYU=
-github.com/spf13/cobra v1.5.0/go.mod h1:dWXEIy2H428czQCjInthrTRUg7yKbok+2Qi/yBIJoUM=
-github.com/spf13/pflag v1.0.5 h1:iy+VFUOCP1a+8yFto/drg2CJ5u0yRoB7fZw3DKv/JXA=
-github.com/spf13/pflag v1.0.5/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
-github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
-github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
-github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
-github.com/stretchr/testify v1.8.0 h1:pSgiaMZlXftHpm5L7V1+rVB+AZJydKsMxsQBIJw4PKk=
-github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
-gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
-gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
-gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

lib/common.go

@@ -1,47 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package lib
-
-var (
-	// command line flags
-	Debug            bool
-	XtendedOut       bool
-	NoNumbering      bool
-	ShowVersion      bool
-	Columns          string
-	UseColumns       []int
-	DefaultSeparator string = `(\s\s+|\t)`
-	Separator        string = `(\s\s+|\t)`
-	OutflagExtended  bool
-	OutflagMarkdown  bool
-	OutflagOrgtable  bool
-	OutflagShell     bool
-	OutputMode       string
-	InvertMatch      bool
-
-	// used for validation
-	validOutputmodes = "(orgtbl|markdown|extended|ascii)"
-
-	// main program version
-	Version = "v1.0.6"
-
-	// generated  version string, used  by -v contains  lib.Version on
-	//  main  branch,   and  lib.Version-$branch-$lastcommit-$date  on
-	// development branch
-	VERSION string
-)

lib/helpers.go

@@ -1,132 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package lib
-
-import (
-	"errors"
-	"fmt"
-	"regexp"
-	"strconv"
-	"strings"
-)
-
-func contains(s []int, e int) bool {
-	for _, a := range s {
-		if a == e {
-			return true
-		}
-	}
-	return false
-}
-
-func PrepareColumns() error {
-	if len(Columns) > 0 {
-		for _, use := range strings.Split(Columns, ",") {
-			usenum, err := strconv.Atoi(use)
-			if err != nil {
-				msg := fmt.Sprintf("Could not parse columns list %s: %v", Columns, err)
-				return errors.New(msg)
-			}
-			UseColumns = append(UseColumns, usenum)
-		}
-	}
-	return nil
-}
-
-func numberizeHeaders(data *Tabdata) {
-	// prepare headers: add numbers to headers
-	numberedHeaders := []string{}
-	for i, head := range data.headers {
-		if len(Columns) > 0 {
-			// -c specified
-			if !contains(UseColumns, i+1) {
-				// ignore this one
-				continue
-			}
-		}
-		if NoNumbering {
-			numberedHeaders = append(numberedHeaders, head)
-		} else {
-			numberedHeaders = append(numberedHeaders, fmt.Sprintf("%s(%d)", head, i+1))
-		}
-	}
-	data.headers = numberedHeaders
-}
-
-func reduceColumns(data *Tabdata) {
-	// exclude columns, if any
-	if len(Columns) > 0 {
-		reducedEntries := [][]string{}
-		reducedEntry := []string{}
-		for _, entry := range data.entries {
-			reducedEntry = nil
-			for i, value := range entry {
-				if !contains(UseColumns, i+1) {
-					continue
-				}
-
-				reducedEntry = append(reducedEntry, value)
-			}
-			reducedEntries = append(reducedEntries, reducedEntry)
-		}
-		data.entries = reducedEntries
-	}
-}
-
-func PrepareModeFlags() error {
-	if len(OutputMode) == 0 {
-		// associate short flags like -X with mode selector
-		switch {
-		case OutflagExtended:
-			OutputMode = "extended"
-		case OutflagMarkdown:
-			OutputMode = "markdown"
-		case OutflagOrgtable:
-			OutputMode = "orgtbl"
-		case OutflagShell:
-			OutputMode = "shell"
-			NoNumbering = true
-		default:
-			OutputMode = "ascii"
-		}
-	} else {
-		r, err := regexp.Compile(validOutputmodes)
-
-		if err != nil {
-			return errors.New("Failed to validate output mode spec!")
-		}
-
-		match := r.MatchString(OutputMode)
-
-		if !match {
-			return errors.New("Invalid output mode!")
-		}
-	}
-
-	return nil
-}
-
-func trimRow(row []string) []string {
-	// FIXME: remove this when we only use Tablewriter and strip in ParseFile()!
-	var fixedrow []string
-	for _, cell := range row {
-		fixedrow = append(fixedrow, strings.TrimSpace(cell))
-	}
-
-	return fixedrow
-}

lib/helpers_test.go

@@ -1,117 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package lib
-
-import (
-	"fmt"
-	"reflect"
-	"testing"
-)
-
-func Testcontains(t *testing.T) {
-	var tests = []struct {
-		list   []int
-		search int
-		want   bool
-	}{
-		{[]int{1, 2, 3}, 2, true},
-		{[]int{2, 3, 4}, 5, false},
-	}
-
-	for _, tt := range tests {
-		testname := fmt.Sprintf("contains-%d,%d,%t", tt.list, tt.search, tt.want)
-		t.Run(testname, func(t *testing.T) {
-			answer := contains(tt.list, tt.search)
-			if answer != tt.want {
-				t.Errorf("got %t, want %t", answer, tt.want)
-			}
-		})
-	}
-}
-
-func TestPrepareColumns(t *testing.T) {
-	var tests = []struct {
-		input     string
-		exp       []int
-		wanterror bool // expect error
-	}{
-		{"1,2,3", []int{1, 2, 3}, false},
-		{"1,2,", []int{}, true},
-		{"a,b", []int{}, true},
-	}
-
-	for _, tt := range tests {
-		testname := fmt.Sprintf("PrepareColumns-%s-%t", tt.input, tt.wanterror)
-		t.Run(testname, func(t *testing.T) {
-			Columns = tt.input
-			err := PrepareColumns()
-			if err != nil {
-				if !tt.wanterror {
-					t.Errorf("got error: %v", err)
-				}
-			} else {
-				if !reflect.DeepEqual(UseColumns, tt.exp) {
-					t.Errorf("got: %v, expected: %v", UseColumns, tt.exp)
-				}
-			}
-		})
-	}
-}
-
-func TestReduceColumns(t *testing.T) {
-	var tests = []struct {
-		expect  [][]string
-		columns []int
-	}{
-		{
-			expect:  [][]string{[]string{"a", "b"}},
-			columns: []int{1, 2},
-		},
-		{
-			expect:  [][]string{[]string{"a", "c"}},
-			columns: []int{1, 3},
-		},
-		{
-			expect:  [][]string{[]string{"a"}},
-			columns: []int{1},
-		},
-		{
-			expect:  [][]string{nil},
-			columns: []int{4},
-		},
-	}
-
-	input := [][]string{[]string{"a", "b", "c"}}
-
-	Columns = "y" // used as a flag with len(Columns)...
-
-	for _, tt := range tests {
-		testname := fmt.Sprintf("reduce-columns-by-%+v", tt.columns)
-		t.Run(testname, func(t *testing.T) {
-			UseColumns = tt.columns
-			data := Tabdata{entries: input}
-			reduceColumns(&data)
-			if !reflect.DeepEqual(data.entries, tt.expect) {
-				t.Errorf("reduceColumns returned invalid data:\ngot: %+v\nexp: %+v", data.entries, tt.expect)
-			}
-		})
-	}
-
-	Columns = "" // reset for other tests
-	UseColumns = nil
-}

lib/io.go

@@ -1,83 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package lib
-
-import (
-	"errors"
-	"io"
-	"os"
-)
-
-func ProcessFiles(args []string) error {
-	fds, pattern, err := determineIO(args)
-
-	if err != nil {
-		return err
-	}
-
-	for _, fd := range fds {
-		data, err := parseFile(fd, pattern)
-		if err != nil {
-			return err
-		}
-		printData(&data)
-	}
-
-	return nil
-}
-
-func determineIO(args []string) ([]io.Reader, string, error) {
-	var pattern string
-	var fds []io.Reader
-	var havefiles bool
-
-	if len(args) > 0 {
-		// threre were args left, take a look
-		if _, err := os.Stat(args[0]); err != nil {
-			// first  one is  not a  file, consider  it as  regexp and
-			// shift arg list
-			pattern = args[0]
-			args = args[1:]
-		}
-
-		if len(args) > 0 {
-			// only files
-			for _, file := range args {
-				fd, err := os.OpenFile(file, os.O_RDONLY, 0755)
-
-				if err != nil {
-					return nil, "", err
-				}
-
-				fds = append(fds, fd)
-			}
-			havefiles = true
-		}
-	}
-
-	if !havefiles {
-		stat, _ := os.Stdin.Stat()
-		if (stat.Mode() & os.ModeCharDevice) == 0 {
-			fds = append(fds, os.Stdin)
-		} else {
-			return nil, "", errors.New("No file specified and nothing to read on stdin!")
-		}
-	}
-
-	return fds, pattern, nil
-}

lib/parser.go

@@ -1,130 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package lib
-
-import (
-	"bufio"
-	"errors"
-	"fmt"
-	"github.com/alecthomas/repr"
-	"io"
-	"regexp"
-	"strings"
-)
-
-// contains a whole parsed table
-type Tabdata struct {
-	maxwidthHeader int      // longest header
-	maxwidthPerCol []int    // max width per column
-	columns        int      // count
-	headers        []string // [ "ID", "NAME", ...]
-	entries        [][]string
-}
-
-/*
-   Parse tabular input.
-*/
-func parseFile(input io.Reader, pattern string) (Tabdata, error) {
-	data := Tabdata{}
-
-	var scanner *bufio.Scanner
-
-	hadFirst := false
-	separate := regexp.MustCompile(Separator)
-	patternR, err := regexp.Compile(pattern)
-	if err != nil {
-		return data, errors.Unwrap(fmt.Errorf("Regexp pattern %s is invalid: %w", pattern, err))
-	}
-
-	scanner = bufio.NewScanner(input)
-
-	for scanner.Scan() {
-		line := strings.TrimSpace(scanner.Text())
-		parts := separate.Split(line, -1)
-
-		if !hadFirst {
-			// header processing
-			data.columns = len(parts)
-			// if Debug {
-			// 	fmt.Println(parts)
-			// }
-
-			// process all header fields
-			for _, part := range parts {
-				// if Debug {
-				// 	fmt.Printf("Part: <%s>\n", string(line[beg:part[0]]))
-				//}
-
-				// register widest header field
-				headerlen := len(part)
-				if headerlen > data.maxwidthHeader {
-					data.maxwidthHeader = headerlen
-				}
-
-				// register fields data
-				data.headers = append(data.headers, strings.TrimSpace(part))
-
-				// done
-				hadFirst = true
-			}
-		} else {
-			// data processing
-			if len(pattern) > 0 {
-				if patternR.MatchString(line) == InvertMatch {
-					// by default  -v is false, so if a  line does NOT
-					// match the pattern, we will ignore it. However,
-					// if the user specified -v, the matching is inverted,
-					// so we ignore all lines, which DO match.
-					continue
-				}
-			}
-
-			idx := 0 // we cannot use the header index, because we could exclude columns
-			values := []string{}
-			for _, part := range parts {
-				width := len(strings.TrimSpace(part))
-
-				if len(data.maxwidthPerCol)-1 < idx {
-					data.maxwidthPerCol = append(data.maxwidthPerCol, width)
-				} else {
-					if width > data.maxwidthPerCol[idx] {
-						data.maxwidthPerCol[idx] = width
-					}
-				}
-
-				// if Debug {
-				// 	fmt.Printf("<%s> ", value)
-				// }
-				values = append(values, strings.TrimSpace(part))
-
-				idx++
-			}
-			data.entries = append(data.entries, values)
-		}
-	}
-
-	if scanner.Err() != nil {
-		return data, errors.Unwrap(fmt.Errorf("Failed to read from io.Reader: %w", scanner.Err()))
-	}
-
-	if Debug {
-		repr.Print(data)
-	}
-
-	return data, nil
-}

lib/parser_test.go

@@ -1,112 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package lib
-
-import (
-	"fmt"
-	"reflect"
-	"strings"
-	"testing"
-)
-
-func TestParser(t *testing.T) {
-	data := Tabdata{
-		maxwidthHeader: 5,
-		maxwidthPerCol: []int{
-			5, 5, 8,
-		},
-		columns: 3,
-		headers: []string{
-			"ONE", "TWO", "THREE",
-		},
-		entries: [][]string{
-			[]string{
-				"asd", "igig", "cxxxncnc",
-			},
-			[]string{
-				"19191", "EDD 1", "X",
-			},
-		},
-	}
-
-	table := `ONE    TWO    THREE  
-asd    igig   cxxxncnc  
-19191  EDD 1  X`
-
-	readFd := strings.NewReader(table)
-	gotdata, err := parseFile(readFd, "")
-	Separator = DefaultSeparator
-
-	if err != nil {
-		t.Errorf("Parser returned error: %s\nData processed so far: %+v", err, gotdata)
-	}
-
-	if !reflect.DeepEqual(data, gotdata) {
-		t.Errorf("Parser returned invalid data, Regex: %s\nExp: %+v\nGot: %+v\n", Separator, data, gotdata)
-	}
-}
-
-func TestParserPatternmatching(t *testing.T) {
-	var tests = []struct {
-		entries [][]string
-		pattern string
-		invert  bool
-	}{
-		{
-			entries: [][]string{
-				[]string{
-					"asd", "igig", "cxxxncnc",
-				},
-			},
-			pattern: "ig",
-			invert:  false,
-		},
-		{
-			entries: [][]string{
-				[]string{
-					"19191", "EDD 1", "X",
-				},
-			},
-			pattern: "ig",
-			invert:  true,
-		},
-	}
-
-	table := `ONE    TWO    THREE  
-asd    igig   cxxxncnc  
-19191  EDD 1  X`
-
-	for _, tt := range tests {
-		testname := fmt.Sprintf("parse-with-inverted-pattern-%t", tt.invert)
-		t.Run(testname, func(t *testing.T) {
-			InvertMatch = tt.invert
-
-			readFd := strings.NewReader(table)
-			gotdata, err := parseFile(readFd, tt.pattern)
-
-			if err != nil {
-				t.Errorf("Parser returned error: %s\nData processed so far: %+v", err, gotdata)
-			}
-
-			if !reflect.DeepEqual(tt.entries, gotdata.entries) {
-				t.Errorf("Parser returned invalid data (pattern: %s, invert: %t)\nExp: %+v\nGot: %+v\n",
-					tt.pattern, tt.invert, tt.entries, gotdata.entries)
-			}
-		})
-	}
-}

lib/printer.go

@@ -1,176 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package lib
-
-import (
-	"fmt"
-	"github.com/olekukonko/tablewriter"
-	"os"
-	"regexp"
-	"strings"
-)
-
-func printData(data *Tabdata) {
-	if OutputMode != "shell" {
-		numberizeHeaders(data)
-	}
-	reduceColumns(data)
-
-	switch OutputMode {
-	case "extended":
-		printExtendedData(data)
-	case "ascii":
-		printAsciiData(data)
-	case "orgtbl":
-		printOrgmodeData(data)
-	case "markdown":
-		printMarkdownData(data)
-	case "shell":
-		printShellData(data)
-	default:
-		printAsciiData(data)
-	}
-}
-
-/*
-   Emacs org-mode compatible table (also orgtbl-mode)
-*/
-func printOrgmodeData(data *Tabdata) {
-	tableString := &strings.Builder{}
-	table := tablewriter.NewWriter(tableString)
-
-	table.SetHeader(data.headers)
-
-	for _, row := range data.entries {
-		table.Append(trimRow(row))
-	}
-
-	table.Render()
-
-	/* fix output for org-mode (orgtbl)
-	   tableWriter output:
-	   +------+------+
-	   | cell | cell |
-	   +------+------+
-
-	   Needed for org-mode compatibility:
-	   |------+------|
-	   | cell | cell |
-	   |------+------|
-	*/
-	leftR := regexp.MustCompile("(?m)^\\+")
-	rightR := regexp.MustCompile("\\+(?m)$")
-
-	fmt.Print(rightR.ReplaceAllString(leftR.ReplaceAllString(tableString.String(), "|"), "|"))
-}
-
-/*
-   Markdown table
-*/
-func printMarkdownData(data *Tabdata) {
-	table := tablewriter.NewWriter(os.Stdout)
-
-	table.SetHeader(data.headers)
-
-	for _, row := range data.entries {
-		table.Append(trimRow(row))
-	}
-
-	table.SetBorders(tablewriter.Border{Left: true, Top: false, Right: true, Bottom: false})
-	table.SetCenterSeparator("|")
-
-	table.Render()
-}
-
-/*
-   Simple ASCII table without any borders etc, just like the input we expect
-*/
-func printAsciiData(data *Tabdata) {
-	table := tablewriter.NewWriter(os.Stdout)
-
-	table.SetHeader(data.headers)
-	table.AppendBulk(data.entries)
-
-	// for _, row := range data.entries {
-	// 	table.Append(trimRow(row))
-	// }
-
-	table.SetAutoWrapText(false)
-	table.SetAutoFormatHeaders(true)
-	table.SetHeaderAlignment(tablewriter.ALIGN_LEFT)
-	table.SetAlignment(tablewriter.ALIGN_LEFT)
-	table.SetCenterSeparator("")
-	table.SetColumnSeparator("")
-	table.SetRowSeparator("")
-	table.SetHeaderLine(false)
-	table.SetBorder(false)
-	table.SetTablePadding("\t") // pad with tabs
-	table.SetNoWhiteSpace(true)
-
-	table.Render()
-}
-
-/*
-   We simulate the \x command of psql (the PostgreSQL client)
-*/
-func printExtendedData(data *Tabdata) {
-	// needed for data output
-	format := fmt.Sprintf("%%%ds: %%s\n", data.maxwidthHeader) // FIXME: re-calculate if -c has been set
-
-	if len(data.entries) > 0 {
-		var idx int
-		for _, entry := range data.entries {
-			idx = 0
-			for i, value := range entry {
-				if len(Columns) > 0 {
-					if !contains(UseColumns, i+1) {
-						continue
-					}
-				}
-
-				fmt.Printf(format, data.headers[idx], value)
-				idx++
-			}
-			fmt.Println()
-		}
-	}
-}
-
-/*
-   Shell output, ready to be eval'd. Just like FreeBSD stat(1)
-*/
-func printShellData(data *Tabdata) {
-	if len(data.entries) > 0 {
-		var idx int
-		for _, entry := range data.entries {
-			idx = 0
-			shentries := []string{}
-			for i, value := range entry {
-				if len(Columns) > 0 {
-					if !contains(UseColumns, i+1) {
-						continue
-					}
-				}
-
-				shentries = append(shentries, fmt.Sprintf("%s=\"%s\"", data.headers[idx], value))
-				idx++
-			}
-			fmt.Println(strings.Join(shentries, " "))
-		}
-	}
-}

lib/printer_test.go

@@ -1,99 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package lib
-
-import (
-	"fmt"
-	"os"
-	"strings"
-	"testing"
-)
-
-func TestPrinter(t *testing.T) {
-	startdata := Tabdata{
-		maxwidthHeader: 5,
-		maxwidthPerCol: []int{
-			5,
-			5,
-			8,
-		},
-		columns: 3,
-		headers: []string{
-			"ONE", "TWO", "THREE",
-		},
-		entries: [][]string{
-			[]string{
-				"asd", "igig", "cxxxncnc",
-			},
-			[]string{
-				"19191", "EDD 1", "X",
-			},
-		},
-	}
-
-	expects := map[string]string{
-		"ascii": `ONE(1)	TWO(2)	THREE(3) 
-asd   	igig  	cxxxncnc	
-19191 	EDD 1 	X`,
-		"orgtbl": `|--------+--------+----------|
-| ONE(1) | TWO(2) | THREE(3) |
-|--------+--------+----------|
-| asd    | igig   | cxxxncnc |
-|  19191 | EDD 1  | X        |
-|--------+--------+----------|`,
-		"markdown": `| ONE(1) | TWO(2) | THREE(3) |
-|--------|--------|----------|
-| asd    | igig   | cxxxncnc |
-|  19191 | EDD 1  | X        |`,
-		"shell": `ONE="asd" TWO="igig" THREE="cxxxncnc"
-ONE="19191" TWO="EDD 1" THREE="X"`,
-	}
-
-	r, w, err := os.Pipe()
-	if err != nil {
-		t.Fatal(err)
-	}
-	origStdout := os.Stdout
-	os.Stdout = w
-
-	for mode, expect := range expects {
-		testname := fmt.Sprintf("print-%s", mode)
-		t.Run(testname, func(t *testing.T) {
-
-			OutputMode = mode
-			data := startdata // we need to reset our mock data, since it's being modified in printData()
-			printData(&data)
-
-			buf := make([]byte, 1024)
-			n, err := r.Read(buf)
-			if err != nil {
-				t.Fatal(err)
-			}
-			buf = buf[:n]
-			output := strings.TrimSpace(string(buf))
-
-			if output != expect {
-				t.Errorf("output mode: %s, got:\n%s\nwant:\n%s\n (%d <=> %d)", mode, output, expect, len(output), len(expect))
-			}
-		})
-	}
-
-	// Restore
-	os.Stdout = origStdout
-
-}

main.go

@@ -1,26 +0,0 @@
-/*
-Copyright © 2022 Thomas von Dein
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package main
-
-import (
-	"github.com/tlinden/tablizer/cmd"
-)
-
-func main() {
-	cmd.Execute()
-}

mkrel.sh

@@ -1,65 +0,0 @@
-#!/bin/bash
-
-# Copyright © 2022 Thomas von Dein
-
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-
-# You should have received a copy of the GNU General Public License
-# along with this program. If not, see <http://www.gnu.org/licenses/>.
-
-
-# get list with: go tool dist list
-DIST="darwin/amd64
-freebsd/amd64
-linux/amd64
-netbsd/amd64
-openbsd/amd64
-windows/amd64"
-
-tool="$1"
-version="$2"
-
-if test -z "$version"; then
-  echo "Usage: $0 <tool name> <release version>"
-  exit 1
-fi
-
-rm -rf releases
-mkdir -p releases
-
-
-for D in $DIST; do
-    os=${D/\/*/}
-    arch=${D/*\//}
-    binfile="releases/${tool}-${os}-${arch}-${version}"
-    tardir="${tool}-${os}-${arch}-${version}"
-    tarfile="releases/${tool}-${os}-${arch}-${version}.tar.gz"
-    set -x
-    GOOS=${os} GOARCH=${arch} go build -o ${binfile}
-    mkdir -p ${tardir}
-    cp ${binfile} README.md LICENSE ${tardir}/
-    echo 'tool = tablizer
-PREFIX = /usr/local
-UID    = root
-GID    = 0
-
-install:
-	install -d -o $(UID) -g $(GID) $(PREFIX)/bin
-	install -d -o $(UID) -g $(GID) $(PREFIX)/man/man1
-	install -o $(UID) -g $(GID) -m 555 $(tool)  $(PREFIX)/sbin/
-	install -o $(UID) -g $(GID) -m 444 $(tool).1 $(PREFIX)/man/man1/' > ${tardir}/Makefile
-    tar cpzf ${tarfile} ${tardir}
-    sha256sum ${binfile} | cut -d' ' -f1 > ${binfile}.sha256
-    sha256sum ${tarfile} | cut -d' ' -f1 > ${tarfile}.sha256
-    rm -rf ${tardir}
-    set +x
-done
-

tablizer.1

@@ -1,280 +0,0 @@
-.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
-.\"
-.\" Standard preamble:
-.\" ========================================================================
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-.fi
-..
-.\" Set up some character translations and predefined strings.  \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
-.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-.    ds -- \(*W-
-.    ds PI pi
-.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
-.    ds L" ""
-.    ds R" ""
-.    ds C` ""
-.    ds C' ""
-'br\}
-.el\{\
-.    ds -- \|\(em\|
-.    ds PI \(*p
-.    ds L" ``
-.    ds R" ''
-.    ds C`
-.    ds C'
-'br\}
-.\"
-.\" Escape single quotes in literal strings from groff's Unicode transform.
-.ie \n(.g .ds Aq \(aq
-.el       .ds Aq '
-.\"
-.\" If the F register is >0, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
-.\" entries marked with X<> in POD.  Of course, you'll have to process the
-.\" output yourself in some meaningful fashion.
-.\"
-.\" Avoid warning from groff about undefined register 'F'.
-.de IX
-..
-.nr rF 0
-.if \n(.g .if rF .nr rF 1
-.if (\n(rF:(\n(.g==0)) \{\
-.    if \nF \{\
-.        de IX
-.        tm Index:\\$1\t\\n%\t"\\$2"
-..
-.        if !\nF==2 \{\
-.            nr % 0
-.            nr F 2
-.        \}
-.    \}
-.\}
-.rr rF
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
-.    \" fudge factors for nroff and troff
-.if n \{\
-.    ds #H 0
-.    ds #V .8m
-.    ds #F .3m
-.    ds #[ \f1
-.    ds #] \fP
-.\}
-.if t \{\
-.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-.    ds #V .6m
-.    ds #F 0
-.    ds #[ \&
-.    ds #] \&
-.\}
-.    \" simple accents for nroff and troff
-.if n \{\
-.    ds ' \&
-.    ds ` \&
-.    ds ^ \&
-.    ds , \&
-.    ds ~ ~
-.    ds /
-.\}
-.if t \{\
-.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-.    \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-.    \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-.    \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-.    ds : e
-.    ds 8 ss
-.    ds o a
-.    ds d- d\h'-1'\(ga
-.    ds D- D\h'-1'\(hy
-.    ds th \o'bp'
-.    ds Th \o'LP'
-.    ds ae ae
-.    ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ========================================================================
-.\"
-.IX Title "TABLIZER 1"
-.TH TABLIZER 1 "2022-10-05" "1" "User Commands"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
-.\" way too many mistakes in technical documents.
-.if n .ad l
-.nh
-.SH "NAME"
-tablizer \- Manipulate tabular output of other programs
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-.Vb 2
-\&    Usage:
-\&      tablizer [regex] [file, ...] [flags]
-\&    
-\&    Flags:
-\&      \-c, \-\-columns string     Only show the speficied columns (separated by ,)
-\&      \-d, \-\-debug              Enable debugging
-\&      \-h, \-\-help               help for tablizer
-\&      \-v, \-\-invert\-match       select non\-matching rows
-\&      \-m, \-\-man                Display manual page
-\&      \-n, \-\-no\-numbering       Disable header numbering
-\&      \-o, \-\-output string      Output mode \- one of: orgtbl, markdown, extended, ascii(default)
-\&      \-X, \-\-extended           Enable extended output
-\&      \-M, \-\-markdown           Enable markdown table output
-\&      \-O, \-\-orgtbl             Enable org\-mode table output
-\&      \-s, \-\-separator string   Custom field separator
-\&      \-v, \-\-version            Print program version
-.Ve
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-Many  programs generate  tabular  output.  But  sometimes  you need  to
-post-process these tables, you may need  to remove one or more columns
-or you may want to filter for  some pattern or you may need the output
-in another program and need to  parse it somehow.  Standard unix tools
-such as  \fBawk\fR\|(1), \fBgrep\fR\|(1) or \fBcolumn\fR\|(1)  may help, but sometimes  it's a
-tedious business.
-.PP
-Let's take  the output of  the tool  kubectl.  It contains  cells with
-withespace and they do not separate columns by \s-1TAB\s0 characters. This is
-not easy to process.
-.PP
-You can use \fBtablizer\fR to do these and more things.
-.PP
-\&\fBtablizer\fR analyses the header fiels of a table, registers the column
-positions  of  each  header  field  and  separates  columns  by  those
-positions.
-.PP
-Without any options it reads its input from \f(CW\*(C`STDIN\*(C'\fR, but you can also
-specify a  file as a  parameter. If you want  to reduce the  output by
-some regular expression,  just specify it as its  first parameter. You
-may also  use the  \fB\-v\fR option  to exclude all  rows which  match the
-pattern. Hence:
-.PP
-.Vb 2
-\&   # read from STDIN
-\&   kubectl get pods | tablizer
-\&
-\&   # read a file
-\&   tablizer filename
-\&
-\&   # search for pattern in a file (works like grep)
-\&   tablizer regex filename
-\&
-\&   # search for pattern in STDIN
-\&   kubectl get pods | tablizer regex
-.Ve
-.PP
-The output  looks like the  original one  but every header  field will
-have a numer associated with it, e.g.:
-.PP
-.Vb 1
-\&   NAME(1) READY(2) STATUS(3) RESTARTS(4) AGE(5)
-.Ve
-.PP
-These numbers denote the column and  you can use them to specify which
-columns you want to have in your output:
-.PP
-.Vb 1
-\&   kubectl get pods | tablizer \-c1,3
-.Ve
-.PP
-You can specify the numbers in any order but output will always follow
-the original order.
-.PP
-The numbering can be suppressed by using the \fB\-n\fR option.
-.PP
-Finally the  \fB\-d\fR option  enables debugging  output which  is mostly
-usefull for the developer.
-.SS "\s-1OUTPUT MODES\s0"
-.IX Subsection "OUTPUT MODES"
-There might be cases  when the tabular output of a  program is way too
-large  for your  current  terminal but  you still  need  to see  every
-column.   In such  cases the  \fB\-o extended\fR  or \fB\-X\fR  option can  be
-usefull which enables \fIextended mode\fR. In this mode, each row will be
-printed vertically,  header left,  value right,  aligned by  the field
-widths. Here's an example:
-.PP
-.Vb 6
-\&    kubectl get pods | ./tablizer \-o extended
-\&        NAME: repldepl\-7bcd8d5b64\-7zq4l  
-\&       READY: 1/1    
-\&      STATUS: Running  
-\&    RESTARTS: 1 (71m ago)  
-\&         AGE: 5h28m
-.Ve
-.PP
-You can  of course  still use  a regex  to reduce  the number  of rows
-displayed.
-.PP
-The option \fB\-o shell\fR  can be used if the output  has to be processed
-by the shell,  it prints variable assignments for each  cell, one line
-per row:
-.PP
-.Vb 4
-\&    kubectl get pods | ./tablizer \-o extended ./tablizer \-o shell
-\&    NAME="repldepl\-7bcd8d5b64\-7zq4l" READY="1/1" STATUS="Running" RESTARTS="9 (47m ago)" AGE="4d23h" 
-\&    NAME="repldepl\-7bcd8d5b64\-m48n8" READY="1/1" STATUS="Running" RESTARTS="9 (47m ago)" AGE="4d23h" 
-\&    NAME="repldepl\-7bcd8d5b64\-q2bf4" READY="1/1" STATUS="Running" RESTARTS="9 (47m ago)" AGE="4d23h"
-.Ve
-.PP
-You can use this in an eval loop.
-.PP
-Beside normal  ascii mode  (the default) and  extended mode  there are
-more output modes available: \fBorgtbl\fR  which prints an Emacs org-mode
-table and \fBmarkdown\fR which prints a Markdown table.
-.SH "BUGS"
-.IX Header "BUGS"
-In order to report a bug, unexpected behavior, feature requests
-or to submit a patch, please open an issue on github:
-<https://github.com/TLINDEN/tablizer/issues>.
-.SH "LICENSE"
-.IX Header "LICENSE"
-This software is licensed under the \s-1GNU GENERAL PUBLIC LICENSE\s0 version 3.
-.PP
-Copyright (c) 2022 by Thomas von Dein
-.PP
-This software uses the following \s-1GO\s0 libraries:
-.IP "repr (https://github.com/alecthomas/repr)" 4
-.IX Item "repr (https://github.com/alecthomas/repr)"
-Released under the \s-1MIT\s0 License, Copyright (c) 2016 Alec Thomas
-.IP "cobra (https://github.com/spf13/cobra)" 4
-.IX Item "cobra (https://github.com/spf13/cobra)"
-Released under the Apache 2.0 license, Copyright 2013\-2022 The Cobra Authors
-.SH "AUTHORS"
-.IX Header "AUTHORS"
-Thomas von Dein \fBtom \s-1AT\s0 vondein \s-1DOT\s0 org\fR

tablizer.pod

@@ -1,173 +0,0 @@
-=head1 NAME
-
-tablizer - Manipulate tabular output of other programs
-
-=head1 SYNOPSIS
-
-    Usage:
-      tablizer [regex] [file, ...] [flags]
-    
-    Flags:
-      -c, --columns string     Only show the speficied columns (separated by ,)
-      -d, --debug              Enable debugging
-      -h, --help               help for tablizer
-      -v, --invert-match       select non-matching rows
-      -m, --man                Display manual page
-      -n, --no-numbering       Disable header numbering
-      -o, --output string      Output mode - one of: orgtbl, markdown, extended, ascii(default)
-      -X, --extended           Enable extended output
-      -M, --markdown           Enable markdown table output
-      -O, --orgtbl             Enable org-mode table output
-      -s, --separator string   Custom field separator
-      -v, --version            Print program version
-
-
-=head1 DESCRIPTION
-
-Many  programs generate  tabular output.   But sometimes  you need  to
-post-process these tables, you may need  to remove one or more columns
-or you  may want to filter  for some pattern (See  L<PATTERNS>) or you
-may need the  output in another program and need  to parse it somehow.
-Standard unix tools such as awk(1), grep(1) or column(1) may help, but
-sometimes it's a tedious business.
-
-Let's take  the output of  the tool  kubectl.  It contains  cells with
-withespace and they do not separate columns by TAB characters. This is
-not easy to process.
-
-You can use B<tablizer> to do these and more things.
-
-B<tablizer> analyses the header fiels of a table, registers the column
-positions  of  each  header  field  and  separates  columns  by  those
-positions.
-
-Without any options it reads its input from C<STDIN>, but you can also
-specify a  file as a  parameter. If you want  to reduce the  output by
-some regular expression,  just specify it as its  first parameter. You
-may also  use the  B<-v> option  to exclude all  rows which  match the
-pattern. Hence:
-
-   # read from STDIN
-   kubectl get pods | tablizer
-
-   # read a file
-   tablizer filename
-
-   # search for pattern in a file (works like grep)
-   tablizer regex filename
-
-   # search for pattern in STDIN
-   kubectl get pods | tablizer regex
-
-The output  looks like the  original one  but every header  field will
-have a numer associated with it, e.g.:
-
-   NAME(1) READY(2) STATUS(3) RESTARTS(4) AGE(5)
-
-These numbers denote the column and  you can use them to specify which
-columns you want to have in your output:
-
-   kubectl get pods | tablizer -c1,3
-
-You can specify the numbers in any order but output will always follow
-the original order.
-
-The numbering can be suppressed by using the B<-n> option.
-
-Finally the  B<-d> option  enables debugging  output which  is mostly
-usefull for the developer.
-
-=head2 PATTERNS
-
-You can reduce the rows being  displayed by using a regular expression
-pattern.  The  regexp is  PCRE compatible, refer  to the  syntax cheat
-sheet here: L<https://github.com/google/re2/wiki/Syntax>.  If you want
-to read  a more comprehensive  documentation about the topic  and have
-perl installed you can read it with:
-
-    perldoc perlre
-
-Or read it online: L<https://perldoc.perl.org/perlre>.
-
-A note on  modifiers: the regexp engine used in  tablizer uses another
-modifier syntax:
-
-    (?MODIFIER)
-
-The most important modifiers are:
-
-C<i> ignore case
-C<m> multiline mode
-C<s> single line mode
-
-Example for a case insensitve search:
-
-    kubectl get pods -A | tablizer "(?i)account"
-
-
-=head2 OUTPUT MODES
-
-There might be cases  when the tabular output of a  program is way too
-large  for your  current  terminal but  you still  need  to see  every
-column.   In such  cases the  B<-o extended>  or B<-X>  option can  be
-usefull which enables I<extended mode>. In this mode, each row will be
-printed vertically,  header left,  value right,  aligned by  the field
-widths. Here's an example:
-
-    kubectl get pods | ./tablizer -o extended
-        NAME: repldepl-7bcd8d5b64-7zq4l  
-       READY: 1/1    
-      STATUS: Running  
-    RESTARTS: 1 (71m ago)  
-         AGE: 5h28m
-
-You can  of course  still use  a regex  to reduce  the number  of rows
-displayed.
-
-The option B<-o shell>  can be used if the output  has to be processed
-by the shell,  it prints variable assignments for each  cell, one line
-per row:
-
-    kubectl get pods | ./tablizer -o extended ./tablizer -o shell
-    NAME="repldepl-7bcd8d5b64-7zq4l" READY="1/1" STATUS="Running" RESTARTS="9 (47m ago)" AGE="4d23h" 
-    NAME="repldepl-7bcd8d5b64-m48n8" READY="1/1" STATUS="Running" RESTARTS="9 (47m ago)" AGE="4d23h" 
-    NAME="repldepl-7bcd8d5b64-q2bf4" READY="1/1" STATUS="Running" RESTARTS="9 (47m ago)" AGE="4d23h" 
-
-You can use this in an eval loop.
-
-Beside normal  ascii mode  (the default) and  extended mode  there are
-more output modes available: B<orgtbl>  which prints an Emacs org-mode
-table and B<markdown> which prints a Markdown table.
-
-=head1 BUGS
-
-In order to report a bug, unexpected behavior, feature requests
-or to submit a patch, please open an issue on github:
-L<https://github.com/TLINDEN/tablizer/issues>.
-
-=head1 LICENSE
-
-This software is licensed under the GNU GENERAL PUBLIC LICENSE version 3.
-
-Copyright (c) 2022 by Thomas von Dein
-
-This software uses the following GO libraries:
-
-=over 4
-
-=item repr (https://github.com/alecthomas/repr)
-
-Released under the MIT License, Copyright (c) 2016 Alec Thomas
-
-=item cobra (https://github.com/spf13/cobra)
-
-Released under the Apache 2.0 license, Copyright 2013-2022 The Cobra Authors
-
-=back
-
-=head1 AUTHORS
-
-Thomas von Dein B<tom AT vondein DOT org>
-
-=cut
-