fix #46: check sort array index before using it for sorting

.github/workflows/ci.yaml

@@ -1,38 +0,0 @@
-name: build-and-test-tablizer
-on: [push]
-jobs:
-  build:
-    strategy:
-      matrix:
-        version: ['1.24']
-        os: [ubuntu-latest, macos-latest, windows-latest]
-    name: Build
-    runs-on: ${{ matrix.os }}
-    steps:
-    - name: Set up Go ${{ matrix.version }}
-      uses: actions/setup-go@v6
-      with:
-        go-version: '${{ matrix.version }}'
-      id: go
-
-    - name: checkout
-      uses: actions/checkout@v5
-
-    - name: build
-      run: make
-
-    - name: test
-      run: make test
-
-  golangci:
-    name: lint
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/setup-go@v6
-        with:
-          go-version: 1.24
-      - uses: actions/checkout@v5
-      - name: golangci-lint
-        uses: golangci/golangci-lint-action@v6
-        with:
-          skip-cache: true

.github/workflows/release.yaml

@@ -1,87 +0,0 @@
-name: build-release
-on:
-  push:
-    tags:
-      - "v*.*.*"
-
-jobs:
-  release:
-    name: Build Release Assets
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v5
-
-      - name: Set up Go
-        uses: actions/setup-go@v6
-        with:
-          go-version: 1.24.0
-
-      - name: Build the executables
-        run: ./mkrel.sh tablizer ${{ github.ref_name}}
-
-      - name: List the executables
-        run: ls -l ./releases
-
-      - name: Upload the binaries
-        uses: svenstaro/upload-release-action@v2
-        with:
-          repo_token: ${{ secrets.GITHUB_TOKEN }}
-          tag: ${{ github.ref_name }}
-          file: ./releases/*
-          file_glob: true
-
-      - name: Build Changelog
-        id: github_release
-        uses: mikepenz/release-changelog-builder-action@v5
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          mode: "PR"
-          configurationJson: |
-            {
-              "template": "#{{CHANGELOG}}\n\n**Full Changelog**: #{{RELEASE_DIFF}}",
-              "pr_template": "- #{{TITLE}} (##{{NUMBER}}) by #{{AUTHOR}}\n#{{BODY}}",
-              "empty_template": "- no changes",
-              "categories": [
-                {
-                    "title": "## New Features",
-                    "labels": ["add", "feature"]
-                },
-                {
-                    "title": "## Bug Fixes",
-                    "labels": ["fix", "bug", "revert"]
-                },
-                {
-                    "title": "## Documentation Enhancements",
-                    "labels": ["doc"]
-                },
-                {
-                    "title": "## Refactoring Efforts",
-                    "labels": ["refactor"]
-                },
-                {
-                    "title": "## Miscellaneus Changes",
-                    "labels": []
-                }
-              ],
-              "ignore_labels": [
-                 "duplicate", "good first issue", "help wanted", "invalid", "question", "wontfix"
-              ],
-              "label_extractor": [
-                 {
-                    "pattern": "(.) (.+)",
-                    "target": "$1"
-                 },
-                 {
-                    "pattern": "(.) (.+)",
-                    "target": "$1",
-                    "on_property": "title"
-                 }
-              ]
-            }
-    
-      - name: Create Release
-        uses: softprops/action-gh-release@v2
-        with:
-          body: ${{steps.github_release.outputs.changelog}}

.goreleaser.yaml

@@ -0,0 +1,69 @@
+# vim: set ts=2 sw=2 tw=0 fo=cnqoj
+
+version: 2
+
+before:
+  hooks:
+    - go mod tidy
+
+gitea_urls:
+  api: https://codeberg.org/api/v1
+  download: https://codeberg.org
+  
+builds:
+  - env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
+      - freebsd
+
+archives:
+  - formats: [tar.gz]
+    # this name template makes the OS and Arch compatible with the results of `uname`.
+    name_template: >-
+      {{ .ProjectName }}_
+      {{- title .Os }}_
+      {{- if eq .Arch "amd64" }}x86_64
+      {{- else if eq .Arch "386" }}i386
+      {{- else }}{{ .Arch }}{{ end }}
+      {{- if .Arm }}v{{ .Arm }}{{ end }}_{{ .Tag }}
+    # use zip for windows archives
+    format_overrides:
+      - goos: windows
+        formats: [zip]
+      - goos: linux
+        formats: [tar.gz,binary]
+    files:
+      - src: "*.md"
+        strip_parent: true
+      - src: "docs/*"
+        strip_parent: true
+      - src: Makefile.dist
+        dst: Makefile
+    wrap_in_directory: true
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - "^docs:"
+      - "^test:"
+  groups:
+    - title: Improved
+      regexp: '^.*?(feat|add|new)(\([[:word:]]+\))??!?:.+$'
+      order: 0
+    - title: Fixed
+      regexp: '^.*?(bug|fix)(\([[:word:]]+\))??!?:.+$'
+      order: 1
+    - title: Changed
+      order: 999
+
+release:
+  header: "# Release Notes"
+  footer: >-
+
+    ---
+
+    Full Changelog: [{{ .PreviousTag }}...{{ .Tag }}](https://codeberg.org/scip/tablizer/compare/{{ .PreviousTag }}...{{ .Tag }})

.woodpecker/build.yaml

@@ -0,0 +1,36 @@
+matrix:
+  platform:
+    - linux/amd64
+  goversion:
+    - 1.24
+
+labels:
+  platform: ${platform}
+    
+steps:
+  build:
+    when:
+      event: [push]
+    image: golang:${goversion}
+    commands:
+      - go get
+      - go build
+
+  linter:
+    when:
+      event: [push]
+    image: golang:${goversion}
+    commands:
+      - curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/HEAD/install.sh | sh -s -- -b $(go env GOPATH)/bin v2.5.0
+      - golangci-lint --version
+      - golangci-lint run ./...
+    depends_on: [build]
+
+  test:
+    when:
+      event: [push]
+    image: golang:${goversion}
+    commands:
+      - go get
+      - go test -v -cover
+    depends_on: [build,linter]

.woodpecker/release.yaml

@@ -0,0 +1,15 @@
+# build release
+
+labels:
+  platform: linux/amd64
+    
+steps:
+  goreleaser:
+    image: goreleaser/goreleaser
+    when:
+      event: [tag]
+    environment:
+      GITEA_TOKEN:
+        from_secret: DEPLOY_TOKEN
+    commands:
+      - goreleaser release --clean --verbose

CHANGELOG.md

@@ -4,9 +4,9 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](http://semver.org).
 
-## [v1.0.14](https://github.com/TLINDEN/tablizer/tree/v1.0.14) - 2023-01-23
+## [v1.0.14](https://codeberg.org/scip/tablizer/tree/v1.0.14) - 2023-01-23
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.13...v1.0.14)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.13...v1.0.14)
 
 ### Fixed
 
@@ -28,9 +28,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 - updated dependencies (go module versions)
 
 
-## [v1.0.13](https://github.com/TLINDEN/tablizer/tree/v1.0.13) - 2022-11-03
+## [v1.0.13](https://codeberg.org/scip/tablizer/tree/v1.0.13) - 2022-11-03
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.12...v1.0.13)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.12...v1.0.13)
 
 ### Added
 
@@ -47,9 +47,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
   manpage.
 
 
-## [v1.0.12](https://github.com/TLINDEN/tablizer/tree/v1.0.12) - 2022-10-25
+## [v1.0.12](https://codeberg.org/scip/tablizer/tree/v1.0.12) - 2022-10-25
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.11...v1.0.12)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.11...v1.0.12)
 
 ### Added
 
@@ -72,14 +72,14 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
   
 ### Fixed
 
-- Fixed  [Bug #5](https://github.com/TLINDEN/tablizer/issues/5), where
+- Fixed  [Bug #5](https://codeberg.org/scip/tablizer/issues/5), where
   matches have not been highlighted correctly in some rare cases.
 
 
 
-## [v1.0.11](https://github.com/TLINDEN/tablizer/tree/v1.0.11) - 2022-10-19
+## [v1.0.11](https://codeberg.org/scip/tablizer/tree/v1.0.11) - 2022-10-19
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.10...v1.0.11)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.10...v1.0.11)
 
 ### Added
 
@@ -101,9 +101,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.10](https://github.com/TLINDEN/tablizer/tree/v1.0.10) - 2022-10-15
+## [v1.0.10](https://codeberg.org/scip/tablizer/tree/v1.0.10) - 2022-10-15
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.9...v1.0.10)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.9...v1.0.10)
 
 ### Added
 
@@ -123,9 +123,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.9](https://github.com/TLINDEN/tablizer/tree/v1.0.9) - 2022-10-14
+## [v1.0.9](https://codeberg.org/scip/tablizer/tree/v1.0.9) - 2022-10-14
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.8...v1.0.9)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.8...v1.0.9)
 
 ### Added
 
@@ -137,9 +137,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.8](https://github.com/TLINDEN/tablizer/tree/v1.0.8) - 2022-10-13
+## [v1.0.8](https://codeberg.org/scip/tablizer/tree/v1.0.8) - 2022-10-13
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.7...v1.0.8)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.7...v1.0.8)
 
 ### Added
 
@@ -147,9 +147,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.7](https://github.com/TLINDEN/tablizer/tree/v1.0.7) - 2022-10-11
+## [v1.0.7](https://codeberg.org/scip/tablizer/tree/v1.0.7) - 2022-10-11
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.6...v1.0.7)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.6...v1.0.7)
 
 ### Added
 
@@ -165,9 +165,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.6](https://github.com/TLINDEN/tablizer/tree/v1.0.6) - 2022-10-05
+## [v1.0.6](https://codeberg.org/scip/tablizer/tree/v1.0.6) - 2022-10-05
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.5...v1.0.6)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.5...v1.0.6)
 
 ### Added
 
@@ -183,9 +183,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.5](https://github.com/TLINDEN/tablizer/tree/v1.0.5) - 2022-10-05
+## [v1.0.5](https://codeberg.org/scip/tablizer/tree/v1.0.5) - 2022-10-05
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.4...v1.0.5)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.4...v1.0.5)
 
 ### Added
 
@@ -203,9 +203,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
   
 
 
-## [v1.0.4](https://github.com/TLINDEN/tablizer/tree/v1.0.4) - 2022-10-04
+## [v1.0.4](https://codeberg.org/scip/tablizer/tree/v1.0.4) - 2022-10-04
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.3...v1.0.4)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.3...v1.0.4)
 
 ### Added
 
@@ -221,9 +221,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.3](https://github.com/TLINDEN/tablizer/tree/v1.0.3) - 2022-10-03
+## [v1.0.3](https://codeberg.org/scip/tablizer/tree/v1.0.3) - 2022-10-03
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.2...v1.0.3)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.2...v1.0.3)
 
 ### Added
 
@@ -237,9 +237,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.2](https://github.com/TLINDEN/tablizer/tree/v1.0.2) - 2022-10-02
+## [v1.0.2](https://codeberg.org/scip/tablizer/tree/v1.0.2) - 2022-10-02
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.1...v1.0.2)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.1...v1.0.2)
 
 ### Added
 
@@ -255,9 +255,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.1](https://github.com/TLINDEN/tablizer/tree/v1.0.1) - 2022-09-30
+## [v1.0.1](https://codeberg.org/scip/tablizer/tree/v1.0.1) - 2022-09-30
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/v1.0.0...v1.0.1)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/v1.0.0...v1.0.1)
 
 ### Added
 
@@ -271,8 +271,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 
 
-## [v1.0.0](https://github.com/TLINDEN/tablizer/tree/v1.0.0) - 2022-09-28
+## [v1.0.0](https://codeberg.org/scip/tablizer/tree/v1.0.0) - 2022-09-28
 
-[Full Changelog](https://github.com/TLINDEN/tablizer/compare/02a64a5c3fe4220df2c791ff1421d16ebd428c19...v1.0.0)
+[Full Changelog](https://codeberg.org/scip/tablizer/compare/02a64a5c3fe4220df2c791ff1421d16ebd428c19...v1.0.0)
 
 Initial release.

Makefile

@@ -50,7 +50,7 @@ ifdef HAVE_POD
 endif
 
 buildlocal:
-	go build -ldflags "-X 'github.com/tlinden/tablizer/cfg.VERSION=$(VERSION)'"
+	go build -ldflags "-X 'codeberg.org/scip/tablizer/cfg.VERSION=$(VERSION)'"
 
 release:
 	gh release create $(version) --generate-notes
@@ -69,7 +69,7 @@ test: clean
 
 singletest:
 	@echo "Call like this: 'make singletest TEST=TestPrepareColumns MOD=lib'"
-	go test -run $(TEST) github.com/tlinden/tablizer/$(MOD) $(OPTS)
+	go test -run $(TEST) codeberg.org/scip/tablizer/$(MOD) $(OPTS)
 
 cover-report:
 	go test ./... -cover -coverprofile=coverage.out

Makefile.dist

@@ -0,0 +1,20 @@
+# -*-make-*-
+
+.PHONY: install all
+
+tool   = rpn
+PREFIX = /usr/local
+UID    = root
+GID    = 0
+
+all:
+	@echo "Type 'sudo make install' to install the tool."
+	@echo "To change prefix, type 'sudo make install PREFIX=/opt'"
+
+install:
+	install -d -o $(UID) -g $(GID) $(PREFIX)/bin
+	install -d -o $(UID) -g $(GID) $(PREFIX)/man/man1
+	install -d -o $(UID) -g $(GID) $(PREFIX)/share/doc
+	install -o $(UID) -g $(GID) -m 555 $(tool)  $(PREFIX)/sbin/
+	install -o $(UID) -g $(GID) -m 444 $(tool).1 $(PREFIX)/man/man1/
+	install -o $(UID) -g $(GID) -m 444 *.md $(PREFIX)/share/doc/

README.md

@@ -1,6 +1,6 @@
-[![Actions](https://github.com/tlinden/tablizer/actions/workflows/ci.yaml/badge.svg)](https://github.com/tlinden/tablizer/actions)
+[![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://github.com/tlinden/tablizer/blob/master/LICENSE)
+[![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/github.com/tlinden/tablizer)](https://goreportcard.com/report/github.com/tlinden/tablizer)
+[![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
 
@@ -11,6 +11,23 @@ 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)
@@ -36,6 +53,9 @@ Operational Flags:
   -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
@@ -167,7 +187,12 @@ you can interactively filter and select rows:
 
 There are multiple ways to install **tablizer**:
 
-- Go to the [latest release page](https://github.com/tlinden/tablizer/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.
@@ -180,7 +205,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
@@ -194,7 +219,7 @@ hesitate to ask me about it, I'll add it.
 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](https://github.com/TLINDEN/tablizer/blob/main/tablizer.pod).
+[However, you can read the man-page online](https://codeberg.org/scip/tablizer/raw/branch/main/tablizer.pod).
 
 Or if you cloned  the repository you can read it  this way (perl needs
 to be installed though): `perldoc tablizer.pod`.
@@ -211,7 +236,7 @@ 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
 
@@ -258,4 +283,4 @@ T.v.Dein <tom AT vondein DOT org>
 
 ## Project homepage
 
-https://github.com/TLINDEN/tablizer
+https://codeberg.org/scip/tablizer

cfg/config.go

@@ -28,7 +28,7 @@ import (
 )
 
 const (
-	Version  = "v1.5.9"
+	Version  = "v1.5.12"
 	MAXPARTS = 2
 )
 
@@ -93,6 +93,9 @@ type Config struct {
 	UseHighlight   bool
 	Interactive    bool
 	InputJSON      bool
+	AutoHeaders    bool
+	CustomHeaders  []string
+	Template       string
 
 	SortMode        string
 	SortDescending  bool
@@ -139,6 +142,8 @@ type Modeflag struct {
 	Y bool
 	A bool
 	C bool
+	J bool
+	P bool // template
 }
 
 // used for switching printers
@@ -150,6 +155,8 @@ const (
 	Yaml
 	CSV
 	ASCII
+	Json
+	Template
 )
 
 // various sort types
@@ -288,6 +295,10 @@ func (conf *Config) PrepareModeFlags(flag Modeflag) {
 		conf.OutputMode = Yaml
 	case flag.C:
 		conf.OutputMode = CSV
+	case flag.J:
+		conf.OutputMode = Json
+	case conf.Template != "":
+		conf.OutputMode = Template
 	default:
 		conf.OutputMode = ASCII
 	}
@@ -413,6 +424,12 @@ func (conf *Config) PreparePattern(patterns []*Pattern) error {
 	return nil
 }
 
+func (conf *Config) PrepareCustomHeaders(custom string) {
+	if len(custom) > 0 {
+		conf.CustomHeaders = strings.Split(custom, ",")
+	}
+}
+
 // Parse config file.  Ignore if the file doesn't exist  but return an
 // error if it exists but fails to read or parse
 func (conf *Config) ParseConfigfile() error {

cmd/root.go

@@ -23,9 +23,9 @@ import (
 	"slices"
 	"strings"
 
+	"codeberg.org/scip/tablizer/cfg"
+	"codeberg.org/scip/tablizer/lib"
 	"github.com/spf13/cobra"
-	"github.com/tlinden/tablizer/cfg"
-	"github.com/tlinden/tablizer/lib"
 )
 
 func completion(cmd *cobra.Command, mode string) error {
@@ -59,6 +59,7 @@ func Execute() {
 		ShowCompletion string
 		modeflag       cfg.Modeflag
 		sortmode       cfg.Sortmode
+		headers        string
 	)
 
 	var rootCmd = &cobra.Command{
@@ -91,6 +92,7 @@ func Execute() {
 			conf.CheckEnv()
 			conf.PrepareModeFlags(modeflag)
 			conf.PrepareSortFlags(sortmode)
+			conf.PrepareCustomHeaders(headers)
 
 			wrapE(conf.PrepareFilters())
 
@@ -133,10 +135,14 @@ func Execute() {
 		"Transpose the speficied columns (separated by ,)")
 	rootCmd.PersistentFlags().BoolVarP(&conf.Interactive, "interactive", "I", false,
 		"interactive mode")
-	rootCmd.PersistentFlags().StringVarP(&conf.OFS, "ofs", "", "",
+	rootCmd.PersistentFlags().StringVarP(&conf.OFS, "ofs", "o", "",
 		"Output field separator (' ' for ascii table, ',' for CSV)")
 	rootCmd.PersistentFlags().BoolVarP(&conf.InputJSON, "json", "j", false,
 		"JSON input mode")
+	rootCmd.PersistentFlags().BoolVarP(&conf.AutoHeaders, "auto-headers", "g", false,
+		"Generate headers automatically")
+	rootCmd.PersistentFlags().StringVarP(&headers, "custom-headers", "x", "",
+		"Custom headers")
 
 	// sort options
 	rootCmd.PersistentFlags().StringVarP(&conf.SortByColumn, "sort-by", "k", "",
@@ -165,12 +171,16 @@ func Execute() {
 		"Enable shell mode output")
 	rootCmd.PersistentFlags().BoolVarP(&modeflag.Y, "yaml", "Y", false,
 		"Enable yaml output")
+	rootCmd.PersistentFlags().BoolVarP(&modeflag.J, "jsonout", "J", false,
+		"Enable json output")
 	rootCmd.PersistentFlags().BoolVarP(&modeflag.C, "csv", "C", false,
 		"Enable CSV output")
 	rootCmd.PersistentFlags().BoolVarP(&modeflag.A, "ascii", "A", false,
 		"Enable ASCII output (default)")
 	rootCmd.MarkFlagsMutuallyExclusive("extended", "markdown", "orgtbl",
 		"shell", "yaml", "csv")
+	rootCmd.PersistentFlags().StringVarP(&conf.Template, "template", "P", "",
+		"template for template output mode")
 
 	// config file
 	rootCmd.PersistentFlags().StringVarP(&conf.Configfile, "config", "f", cfg.DefaultConfigfile,

cmd/shortusage.go

@@ -1,16 +1,18 @@
 package cmd
 
 const shortusage = `tablizer [regex,...] [-r file] [flags]
--c col,...   show specified columns                -L  highlight matching lines
+-c col,...   show specified columns                  -L  highlight matching lines
--k col,...   sort by specified columns             -j  read JSON input
+-k col,...   sort by specified columns               -j  read JSON input
--F col=reg   filter field with regexp              -v  invert match
+-F col=reg   filter field with regexp                -v  invert match
--T col,...   transpose specified columns           -n  numberize columns
+-T col,...   transpose specified columns             -n  numberize columns
--R /from/to/ apply replacement to columns in -T    -N  do not use colors
+-R /from/to/ apply replacement to columns in -T      -N  do not use colors
--y col,...   yank columns to clipboard             -H  do not show headers
+-y col,...   yank columns to clipboard               -H  do not show headers
---ofs char   output field separator                -s  specify field separator
+--ofs char   output field separator                  -s  specify field separator
--r file      read input from file                  -z  use fuzzy search
+-r file      read input from file                    -z  use fuzzy search
--f file      read config from file                 -I  interactive filter mode
+-f file      read config from file                   -I  interactive filter mode
-                                                   -d  debug
+-x col,...   use custom headers                      -d  debug
--O org -C CSV -M md -X ext -S shell -Y yaml        -D  sort descending order
+-o char      use char as output separator            -g  auto generate headers
--m  show manual       --help  show detailed help   -v  show version
+
--a  sort by age       -i      sort numerically     -t  sort by time`
+-O org  -C CSV  -M md  -X ext  -S shell  -Y yaml  -J json  -P template
+-a sort by age   -i sort numerically   -t sort by time   -D sort descending order
+-m show manual   -v  show version      --help  show detailed help`

cmd/tablizer.go

@@ -22,6 +22,8 @@ SYNOPSIS
           -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
+          -g, --auto-headers                 Generate headers if there are none present in input
+          -x, --custom-headers a,b,...       Use custom headers, separated by comma
 
         Output Flags (mutually exclusive):
           -X, --extended                     Enable extended output
@@ -29,12 +31,14 @@ SYNOPSIS
           -O, --orgtbl                       Enable org-mode table output
           -S, --shell                        Enable shell evaluable output
           -Y, --yaml                         Enable yaml output
+          -J, --jsonout                      Enable JSON output
           -C, --csv                          Enable CSV output
           -A, --ascii                        Default output mode, ascii tabular
+          -P, --template <tpl>               Enable template mode with template <tpl>
           -L, --hightlight-lines             Use alternating background colors for tables
+          -o, --ofs <char>                   Output field separator, used by -A and -C. 
           -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
@@ -74,16 +78,16 @@ DESCRIPTION
     use the -v option to exclude all rows which match the pattern. Hence:
 
        # read from STDIN
-       kubectl get pods | tablizer
+       > kubectl get pods | tablizer
 
        # read a file
-       tablizer -r filename
+       > tablizer -r filename
 
        # search for pattern in a file (works like grep)
-       tablizer regex -r filename
+       > tablizer regex -r filename
 
        # search for pattern in STDIN
-       kubectl get pods | tablizer regex
+       > kubectl get pods | tablizer regex
 
     The output looks like the original one. You can add the option -n, then
     every header field will have a numer associated with it, e.g.:
@@ -93,18 +97,18 @@ DESCRIPTION
     These numbers denote the column and you can use them to specify which
     columns you want to have in your output (see COLUMNS:
 
-       kubectl get pods | tablizer -c1,3
+       > kubectl get pods | tablizer -c1,3
 
     You can specify the numbers in any order but output will always follow
     the original order.
 
     However, you may also just use the header names instead of numbers, eg:
 
-       kubectl get pods | tablizer -cname,status
+       > kubectl get pods | tablizer -cname,status
 
     You can also use regular expressions with -c, eg:
 
-       kubectl get pods | tablizer -c '[ae]'
+       > kubectl get pods | tablizer -c '[ae]'
 
     By default tablizer shows a header containing the names of each column.
     This can be disabled using the -H option. Be aware that this only
@@ -215,7 +219,7 @@ DESCRIPTION
 
     Example for a case insensitive search:
 
-        kubectl get pods -A | tablizer "/account/i"
+        > kubectl get pods -A | tablizer "/account/i"
 
     If you use the "!" flag, then the regex match will be negated, that is,
     if a line in the input matches the given regex, but "!" is supplied,
@@ -281,7 +285,7 @@ DESCRIPTION
 
     We want to see only the CMD column and use a regex for this:
 
-        ps | tablizer -s '\s+' -c C
+        > ps | tablizer -s '\s+' -c C
         CMD(4)
         bash
         ps
@@ -312,7 +316,7 @@ DESCRIPTION
 
     Example:
 
-        cat t/testtable2
+        > cat t/testtable2
         NAME  DURATION
         x     10
         a     100
@@ -320,7 +324,7 @@ DESCRIPTION
         u     4
         k     6
     
-        cat t/testtable2 | tablizer -T2 -R '/^\d/4/' -n
+        > cat t/testtable2 | tablizer -T2 -R '/^\d/4/' -n
         NAME    DURATION 
         x       40      
         a       400     
@@ -336,7 +340,7 @@ DESCRIPTION
     header left, value right, aligned by the field widths. Here's an
     example:
 
-        kubectl get pods | ./tablizer -o extended
+        > kubectl get pods | ./tablizer -o extended
             NAME: repldepl-7bcd8d5b64-7zq4l  
            READY: 1/1    
           STATUS: Running  
@@ -349,7 +353,7 @@ DESCRIPTION
     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
+        > 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"
@@ -361,6 +365,18 @@ DESCRIPTION
     markdown which prints a Markdown table, yaml, which prints yaml encoding
     and CSV mode, which prints a comma separated value file.
 
+    A special output mode ist the Template mode, activated with the option
+    "--template". Template language is the Golang template language:
+    <https://pkg.go.dev/text/template>. You can also use lot's of additional
+    functions from: <https://masterminds.github.io/sprig/>. Here's an
+    example:
+
+        > kubectl get pods | tablizer --template "{{.name}} is {{.status}}"
+        alertmanager-kube-prometheus-alertmanager-0 is Running
+        grafana-fcc54cbc9-bk7s8 is Running
+
+    You can use header names as variables.
+
   PUT FIELDS TO CLIPBOARD
     You can let tablizer put fields to the clipboard using the option "-y".
     This best fits the use-case when the result of your filtering yields
@@ -461,7 +477,7 @@ CONFIGURATION AND COLORS
 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>.
+    <https://codeberg.org/scip/tablizer/issues>.
 
 LICENSE
     This software is licensed under the GNU GENERAL PUBLIC LICENSE version
@@ -517,6 +533,8 @@ Operational Flags:
   -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
+  -g, --auto-headers                 Generate headers if there are none present in input
+  -x, --custom-headers a,b,...       Use custom headers, separated by comma
 
 Output Flags (mutually exclusive):
   -X, --extended                     Enable extended output
@@ -524,12 +542,14 @@ Output Flags (mutually exclusive):
   -O, --orgtbl                       Enable org-mode table output
   -S, --shell                        Enable shell evaluable output
   -Y, --yaml                         Enable yaml output
+  -J, --jsonout                      Enable JSON output
   -C, --csv                          Enable CSV output
   -A, --ascii                        Default output mode, ascii tabular
+  -P, --template <tpl>               Enable template mode with template <tpl>
   -L, --hightlight-lines             Use alternating background colors for tables
+  -o, --ofs <char>                   Output field separator, used by -A and -C. 
   -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

go.mod

@@ -1,4 +1,4 @@
-module github.com/tlinden/tablizer
+module codeberg.org/scip/tablizer
 
 go 1.24.0
 
@@ -22,6 +22,10 @@ require (
 )
 
 require (
+	dario.cat/mergo v1.0.1 // indirect
+	github.com/Masterminds/goutils v1.1.1 // indirect
+	github.com/Masterminds/semver/v3 v3.3.0 // indirect
+	github.com/Masterminds/sprig/v3 v3.3.0 // indirect
 	github.com/agext/levenshtein v1.2.3 // indirect
 	github.com/apparentlymart/go-textseg/v15 v15.0.0 // indirect
 	github.com/atotto/clipboard v0.1.4 // indirect
@@ -34,12 +38,16 @@ require (
 	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
 	github.com/fatih/color v1.18.0 // indirect
 	github.com/google/go-cmp v0.6.0 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/huandu/xstrings v1.5.0 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/lucasb-eyer/go-colorful v1.2.0 // indirect
 	github.com/mattn/go-colorable v0.1.14 // indirect
 	github.com/mattn/go-localereader v0.0.1 // indirect
 	github.com/mattn/go-runewidth v0.0.16 // indirect
+	github.com/mitchellh/copystructure v1.2.0 // indirect
 	github.com/mitchellh/go-wordwrap v1.0.1 // indirect
+	github.com/mitchellh/reflectwalk v1.0.2 // indirect
 	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
 	github.com/muesli/cancelreader v0.2.2 // indirect
 	github.com/muesli/reflow v0.3.0 // indirect
@@ -49,9 +57,12 @@ require (
 	github.com/pkg/errors v0.9.1 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
 	github.com/rivo/uniseg v0.4.7 // indirect
+	github.com/shopspring/decimal v1.4.0 // indirect
+	github.com/spf13/cast v1.7.0 // indirect
 	github.com/spf13/pflag v1.0.9 // indirect
 	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
 	github.com/zclconf/go-cty v1.16.3 // indirect
+	golang.org/x/crypto v0.38.0 // indirect
 	golang.org/x/exp v0.0.0-20231006140011-7918f672742d // indirect
 	golang.org/x/mod v0.21.0 // indirect
 	golang.org/x/sync v0.15.0 // indirect

go.sum

@@ -1,3 +1,11 @@
+dario.cat/mergo v1.0.1 h1:Ra4+bf83h2ztPIQYNP99R6m+Y7KfnARDfID+a+vLl4s=
+dario.cat/mergo v1.0.1/go.mod h1:uNxQE+84aUszobStD9th8a29P2fMDhsBdgRYvZOxGmk=
+github.com/Masterminds/goutils v1.1.1 h1:5nUrii3FMTL5diU80unEVvNevw1nH4+ZV4DSLVJLSYI=
+github.com/Masterminds/goutils v1.1.1/go.mod h1:8cTjp+g8YejhMuvIA5y2vz3BpJxksy863GQaJW2MFNU=
+github.com/Masterminds/semver/v3 v3.3.0 h1:B8LGeaivUe71a5qox1ICM/JLl0NqZSW5CHyL+hmvYS0=
+github.com/Masterminds/semver/v3 v3.3.0/go.mod h1:4V+yj/TJE1HU9XfppCwVMZq3I84lprf4nC11bSS5beM=
+github.com/Masterminds/sprig/v3 v3.3.0 h1:mQh0Yrg1XPo6vjYXgtf5OtijNAKJRNcTdOOGZe3tPhs=
+github.com/Masterminds/sprig/v3 v3.3.0/go.mod h1:Zy1iXRYNqNLUolqCpL4uhk6SHUMAOSCzdgBfDb35Lz0=
 github.com/agext/levenshtein v1.2.3 h1:YB2fHEn0UJagG8T1rrWknE3ZQzWM06O8AMAatNn7lmo=
 github.com/agext/levenshtein v1.2.3/go.mod h1:JEDfjyjHDjOF/1e4FlBE/PkbqA9OfWu2ki2W0IB5558=
 github.com/alecthomas/repr v0.5.2 h1:SU73FTI9D1P5UNtvseffFSGmdNci/O6RsqzeXJtP0Qs=
@@ -38,12 +46,16 @@ github.com/go-test/deep v1.0.3 h1:ZrJSEWsXzPOxaZnFteGEfooLba+ju3FYIbOrS+rQd68=
 github.com/go-test/deep v1.0.3/go.mod h1:wGDj63lr65AM2AQyKZd/NYHGb0R+1RLqB8NKt3aSFNA=
 github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
 github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/gookit/assert v0.1.1 h1:lh3GcawXe/p+cU7ESTZ5Ui3Sm/x8JWpIis4/1aF0mY0=
 github.com/gookit/assert v0.1.1/go.mod h1:jS5bmIVQZTIwk42uXl4lyj4iaaxx32tqH16CFj0VX2E=
 github.com/gookit/color v1.6.0 h1:JjJXBTk1ETNyqyilJhkTXJYYigHG24TM9Xa2M1xAhRA=
 github.com/gookit/color v1.6.0/go.mod h1:9ACFc7/1IpHGBW8RwuDm/0YEnhg3dwwXpoMsmtyHfjs=
 github.com/hashicorp/hcl/v2 v2.24.0 h1:2QJdZ454DSsYGoaE6QheQZjtKZSUs9Nh2izTWiwQxvE=
 github.com/hashicorp/hcl/v2 v2.24.0/go.mod h1:oGoO1FIQYfn/AgyOhlg9qLC6/nOJPX3qGbkZpYAcqfM=
+github.com/huandu/xstrings v1.5.0 h1:2ag3IFq9ZDANvthTwTiqSSZLjDc+BedvHPAp5tJy2TI=
+github.com/huandu/xstrings v1.5.0/go.mod h1:y5/lhBue+AyNmUVz9RLU9xbLR0o4KIIExikq4ovT0aE=
 github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
 github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
 github.com/lithammer/fuzzysearch v1.1.8 h1:/HIuJnjHuXS8bKaiTMeeDlW2/AyIWk2brx1V8LFgLN4=
@@ -60,8 +72,12 @@ github.com/mattn/go-runewidth v0.0.10/go.mod h1:RAqKPSqVFrSLVXbA8x7dzmKdmGzieGRC
 github.com/mattn/go-runewidth v0.0.12/go.mod h1:RAqKPSqVFrSLVXbA8x7dzmKdmGzieGRCM46jaSJTDAk=
 github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
 github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
+github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw=
+github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s=
 github.com/mitchellh/go-wordwrap v1.0.1 h1:TLuKupo69TCn6TQSyGxwI1EblZZEsQ0vMlAFQflz0v0=
 github.com/mitchellh/go-wordwrap v1.0.1/go.mod h1:R62XHJLzvMFRBbcrT7m7WgmE1eOyTSsCt+hzestvNj0=
+github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ=
+github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw=
 github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
 github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
 github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
@@ -88,6 +104,10 @@ github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0t
 github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
 github.com/scylladb/termtables v0.0.0-20191203121021-c4c0b6d42ff4/go.mod h1:C1a7PQSMz9NShzorzCiG2fk9+xuCgLkPeCvMHYR2OWg=
+github.com/shopspring/decimal v1.4.0 h1:bxl37RwXBklmTi0C79JfXCEBD1cqqHt0bbgBAGFp81k=
+github.com/shopspring/decimal v1.4.0/go.mod h1:gawqmDU56v4yIKSwfBSFip1HdCCXN8/+DMd9qYNcwME=
+github.com/spf13/cast v1.7.0 h1:ntdiHjuueXFgm5nzDRdOS4yfT43P5Fnud6DH50rz/7w=
+github.com/spf13/cast v1.7.0/go.mod h1:ancEpBxwJDODSW/UG4rDrAqiKolqNNh2DX3mk86cAdo=
 github.com/spf13/cobra v1.10.1 h1:lJeBwCfmrnXthfAupyUTzJ/J4Nc1RsHC/mSRU2dll/s=
 github.com/spf13/cobra v1.10.1/go.mod h1:7SmJGaTHFVBY0jW4NXGluQoLvhqFQM+6XSKD+P4XaB0=
 github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
@@ -107,6 +127,8 @@ github.com/zclconf/go-cty-debug v0.0.0-20240509010212-0d6042c53940 h1:4r45xpDWB6
 github.com/zclconf/go-cty-debug v0.0.0-20240509010212-0d6042c53940/go.mod h1:CmBdvvj3nqzfzJ6nTCIwDTPZ56aVGvDrmztiO5g3qrM=
 golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
 golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
+golang.org/x/crypto v0.38.0 h1:jt+WWG8IZlBnVbomuhg2Mdq0+BBQaHbtqHEFEigjUV8=
+golang.org/x/crypto v0.38.0/go.mod h1:MvrbAqul58NNYPKnOra203SB9vpuZW0e+RRZV+Ggqjw=
 golang.org/x/exp v0.0.0-20231006140011-7918f672742d h1:jtJma62tbqLibJ5sFQz8bKtEM8rJBtfilJ2qTU199MI=
 golang.org/x/exp v0.0.0-20231006140011-7918f672742d/go.mod h1:ldy0pHrwJyGW56pPQzzkH36rKxoZW1tw7ZJpeKx+hdo=
 golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=

lib/filter.go

@@ -23,7 +23,7 @@ import (
 	"strings"
 
 	"github.com/lithammer/fuzzysearch/fuzzy"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 /*

lib/filter_test.go

@@ -22,7 +22,7 @@ import (
 	"testing"
 
 	"github.com/stretchr/testify/assert"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 func TestMatchPattern(t *testing.T) {

lib/helpers.go

@@ -27,7 +27,7 @@ import (
 	"strings"
 
 	"github.com/gookit/color"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 func findindex(s []int, e int) (int, bool) {

lib/helpers_test.go

@@ -23,7 +23,7 @@ import (
 	"testing"
 
 	"github.com/stretchr/testify/assert"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 func TestContains(t *testing.T) {

lib/io.go

@@ -23,7 +23,7 @@ import (
 	"io"
 	"os"
 
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 const RWRR = 0755

lib/parser.go

@@ -30,7 +30,7 @@ import (
 	"strings"
 
 	"github.com/alecthomas/repr"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 /*
@@ -66,6 +66,43 @@ func Parse(conf cfg.Config, input io.Reader) (Tabdata, error) {
 	return data, err
 }
 
+/*
+ * Setup headers,  given headers might  be usable headers or  just the
+ * first row, which we use to  determine how many headers to generate,
+ * if enabled.
+ */
+func SetHeaders(conf cfg.Config, headers []string) []string {
+	if !conf.AutoHeaders && len(conf.CustomHeaders) == 0 {
+		return headers
+	}
+
+	if conf.AutoHeaders {
+		heads := make([]string, len(headers))
+		for idx := range headers {
+			heads[idx] = fmt.Sprintf("%d", idx+1)
+		}
+
+		return heads
+	}
+
+	if len(conf.CustomHeaders) == len(headers) {
+		return conf.CustomHeaders
+	}
+
+	// use as much custom ones we have, generate the remainder
+	heads := make([]string, len(headers))
+
+	for idx := range headers {
+		if idx < len(conf.CustomHeaders) {
+			heads[idx] = conf.CustomHeaders[idx]
+		} else {
+			heads[idx] = fmt.Sprintf("%d", idx+1)
+		}
+	}
+
+	return heads
+}
+
 /*
 Parse CSV input.
 */
@@ -87,7 +124,7 @@ func parseCSV(conf cfg.Config, input io.Reader) (Tabdata, error) {
 	}
 
 	if len(records) >= 1 {
-		data.headers = records[0]
+		data.headers = SetHeaders(conf, records[0])
 		data.columns = len(records)
 
 		for _, head := range data.headers {
@@ -98,9 +135,14 @@ func parseCSV(conf cfg.Config, input io.Reader) (Tabdata, error) {
 			}
 		}
 
-		if len(records) > 1 {
+		if len(records) >= 1 {
-			data.entries = records[1:]
+			if conf.AutoHeaders || len(conf.CustomHeaders) > 0 {
+				data.entries = records
+			} else {
+				data.entries = records[1:]
+			}
 		}
+
 	}
 
 	return data, nil
@@ -128,7 +170,9 @@ func parseTabular(conf cfg.Config, input io.Reader) (Tabdata, error) {
 			data.columns = len(parts)
 
 			// process all header fields
-			for _, part := range parts {
+			firstrow := make([]string, len(parts))
+
+			for idx, part := range parts {
 				// register widest header field
 				headerlen := len(part)
 				if headerlen > data.maxwidthHeader {
@@ -136,11 +180,22 @@ func parseTabular(conf cfg.Config, input io.Reader) (Tabdata, error) {
 				}
 
 				// register fields data
-				data.headers = append(data.headers, strings.TrimSpace(part))
+				firstrow[idx] = strings.TrimSpace(part)
 
 				// done
 				hadFirst = true
 			}
+
+			data.headers = SetHeaders(conf, firstrow)
+
+			if conf.AutoHeaders || len(conf.CustomHeaders) > 0 {
+				// we do not use generated headers, consider as row
+				if matchPattern(conf, line) == conf.InvertMatch {
+					continue
+				}
+
+				data.entries = append(data.entries, firstrow)
+			}
 		} else {
 			// data processing
 			if matchPattern(conf, line) == conf.InvertMatch {

lib/parser_test.go

@@ -24,7 +24,7 @@ import (
 	"testing"
 
 	"github.com/stretchr/testify/assert"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 var input = []struct {
@@ -366,6 +366,56 @@ func TestParserSeparators(t *testing.T) {
 	}
 }
 
+func TestParserSetHeaders(t *testing.T) {
+	row := []string{"c", "b", "c", "d", "e"}
+
+	tests := []struct {
+		name   string
+		custom []string
+		expect []string
+		auto   bool
+	}{
+		{
+			name:   "default",
+			expect: row,
+		},
+		{
+			name:   "auto",
+			expect: strings.Split("1 2 3 4 5", " "),
+			auto:   true,
+		},
+		{
+			name:   "custom-complete",
+			custom: strings.Split("A B C D E", " "),
+			expect: strings.Split("A B C D E", " "),
+		},
+		{
+			name:   "custom-too-short",
+			custom: strings.Split("A B", " "),
+			expect: strings.Split("A B 3 4 5", " "),
+		},
+		{
+			name:   "custom-too-long",
+			custom: strings.Split("A B C D E F G", " "),
+			expect: strings.Split("A B C D E", " "),
+		},
+	}
+
+	for _, testdata := range tests {
+		testname := fmt.Sprintf("parse-%s", testdata.name)
+		t.Run(testname, func(t *testing.T) {
+			conf := cfg.Config{
+				AutoHeaders:   testdata.auto,
+				CustomHeaders: testdata.custom,
+			}
+			headers := SetHeaders(conf, row)
+
+			assert.NotNil(t, headers)
+			assert.EqualValues(t, testdata.expect, headers)
+		})
+	}
+}
+
 func wrapValidateParser(conf cfg.Config, input io.Reader) (Tabdata, error) {
 	data, err := Parse(conf, input)
 

lib/printer.go

@@ -19,17 +19,20 @@ package lib
 
 import (
 	"encoding/csv"
+	"encoding/json"
 	"fmt"
 	"io"
 	"log"
 	"strconv"
 	"strings"
+	"text/template"
 
+	"codeberg.org/scip/tablizer/cfg"
+	"github.com/Masterminds/sprig/v3"
 	"github.com/gookit/color"
 	"github.com/olekukonko/tablewriter"
 	"github.com/olekukonko/tablewriter/renderer"
 	"github.com/olekukonko/tablewriter/tw"
-	"github.com/tlinden/tablizer/cfg"
 	"gopkg.in/yaml.v3"
 )
 
@@ -61,15 +64,22 @@ func printData(writer io.Writer, conf cfg.Config, data *Tabdata) {
 		printShellData(writer, data)
 	case cfg.Yaml:
 		printYamlData(writer, data)
+	case cfg.Json:
+		printJsonData(writer, data)
 	case cfg.CSV:
 		printCSVData(writer, conf, data)
+	case cfg.Template:
+		printTemplateData(writer, conf, data)
 	default:
 		printASCIIData(writer, conf, data)
 	}
 }
 
 func output(writer io.Writer, str string) {
-	fmt.Fprint(writer, str)
+	_, err := fmt.Fprint(writer, str)
+	if err != nil {
+		log.Fatalf("failed to print output: %s", err)
+	}
 }
 
 /*
@@ -291,6 +301,35 @@ func printShellData(writer io.Writer, data *Tabdata) {
 	output(writer, out)
 }
 
+func printJsonData(writer io.Writer, data *Tabdata) {
+	objlist := make([]map[string]any, len(data.entries))
+
+	if len(data.entries) > 0 {
+		for i, entry := range data.entries {
+			obj := make(map[string]any, len(entry))
+
+			for idx, value := range entry {
+				num, err := strconv.Atoi(value)
+				if err == nil {
+					obj[data.headers[idx]] = num
+				} else {
+					obj[data.headers[idx]] = value
+				}
+			}
+
+			objlist[i] = obj
+		}
+	}
+
+	jsonstr, err := json.MarshalIndent(&objlist, "", "  ")
+
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	output(writer, string(jsonstr))
+}
+
 func printYamlData(writer io.Writer, data *Tabdata) {
 	type Data struct {
 		Entries []map[string]interface{} `yaml:"entries"`
@@ -353,3 +392,25 @@ func printCSVData(writer io.Writer, conf cfg.Config, data *Tabdata) {
 		log.Fatal(err)
 	}
 }
+
+func printTemplateData(writer io.Writer, conf cfg.Config, data *Tabdata) {
+	tmpl, err := template.New("printer").Funcs(sprig.TxtFuncMap()).Parse(conf.Template)
+	if err != nil {
+		log.Fatalf("failed to parse template: %s", err)
+	}
+
+	buf := strings.Builder{}
+
+	for line, dict := range data.ToMap() {
+		err = tmpl.Execute(&buf, dict)
+		if err != nil {
+			log.Fatalf("failed to execute template in line %d: %s", line, err)
+		}
+
+		buf.WriteString("\n")
+	}
+
+	if _, err := fmt.Fprintln(writer, buf.String()); err != nil {
+		log.Fatalf("failed to print output: %s", err)
+	}
+}

lib/printer_test.go

@@ -24,7 +24,7 @@ import (
 	"testing"
 
 	"github.com/stretchr/testify/assert"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 func newData() Tabdata {
@@ -125,6 +125,31 @@ ceta,33d12h,9,06/Jan/2008 15:04:05 -0700`,
 NAME="beta" DURATION="1d10h5m1s" COUNT="33" WHEN="3/1/2014"
 NAME="alpha" DURATION="4h35m" COUNT="170" WHEN="2013-Feb-03"
 NAME="ceta" DURATION="33d12h" COUNT="9" WHEN="06/Jan/2008 15:04:05 -0700"`,
+	},
+	{
+		name:      "json",
+		mode:      cfg.Json,
+		numberize: false,
+		expect: `[
+  {
+    "COUNT": 33,
+    "DURATION": "1d10h5m1s",
+    "NAME": "beta",
+    "WHEN": "3/1/2014"
+  },
+  {
+    "COUNT": 170,
+    "DURATION": "4h35m",
+    "NAME": "alpha",
+    "WHEN": "2013-Feb-03"
+  },
+  {
+    "COUNT": 9,
+    "DURATION": "33d12h",
+    "NAME": "ceta",
+    "WHEN": "06/Jan/2008 15:04:05 -0700"
+  }
+]`,
 	},
 	{
 		name:      "yaml",

lib/sort.go

@@ -23,8 +23,8 @@ import (
 	"sort"
 	"strconv"
 
+	"codeberg.org/scip/tablizer/cfg"
 	"github.com/araddon/dateparse"
-	"github.com/tlinden/tablizer/cfg"
 )
 
 func sortTable(conf cfg.Config, data *Tabdata) {
@@ -38,6 +38,12 @@ func sortTable(conf cfg.Config, data *Tabdata) {
 		return
 	}
 
+	for _, column := range conf.UseSortByColumn {
+		if column > len(data.headers) {
+			return
+		}
+	}
+
 	// actual sorting
 	sort.SliceStable(data.entries, func(i, j int) bool {
 		// holds the result of a sort of one column

lib/sort_test.go

@@ -22,7 +22,7 @@ import (
 	"testing"
 
 	"github.com/stretchr/testify/assert"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 func TestDuration2Seconds(t *testing.T) {

lib/tabdata.go

@@ -1,5 +1,5 @@
 /*
-Copyright © 2022-2024 Thomas von Dein
+Copyright © 2022-2025 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
@@ -17,6 +17,11 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
 
 package lib
 
+import (
+	"strconv"
+	"strings"
+)
+
 // contains a whole parsed table
 type Tabdata struct {
 	maxwidthHeader int      // longest header
@@ -34,3 +39,41 @@ func (data *Tabdata) CloneEmpty() Tabdata {
 
 	return newdata
 }
+
+// convert our internal data to a list of maps
+func (data *Tabdata) ToMap() []map[string]any {
+	dictlist := make([]map[string]any, len(data.entries))
+	headers := make([]string, len(data.headers))
+
+	for idx, header := range data.headers {
+		headers[idx] = strings.ToLower(header)
+	}
+
+	for line, row := range data.entries {
+		dict := make(map[string]any, len(data.headers))
+
+		for col, cell := range row {
+			n, ok := strconv.Atoi(cell)
+			if ok == nil {
+				dict[headers[col]] = n
+				continue
+			}
+
+			if strings.ToLower(cell) == "true" {
+				dict[headers[col]] = true
+				continue
+			}
+
+			if strings.ToLower(cell) == "false" {
+				dict[headers[col]] = false
+				continue
+			}
+
+			dict[headers[col]] = cell
+		}
+
+		dictlist[line] = dict
+	}
+
+	return dictlist
+}

lib/tableeditor.go

@@ -26,7 +26,7 @@ import (
 	"github.com/charmbracelet/lipgloss"
 	"github.com/evertras/bubble-table/table"
 	"github.com/mattn/go-isatty"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 // The context exists outside of the bubble loop, and is being used as

lib/yank.go

@@ -22,7 +22,7 @@ import (
 	"strings"
 
 	"github.com/tiagomelo/go-clipboard/clipboard"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 func yankColumns(conf cfg.Config, data *Tabdata) {

lib/yank_test.go

@@ -24,7 +24,7 @@ import (
 
 	"github.com/stretchr/testify/assert"
 	"github.com/tiagomelo/go-clipboard/clipboard"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )
 
 var yanktests = []struct {

main.go

@@ -20,7 +20,7 @@ package main
 import (
 	"os"
 
-	"github.com/tlinden/tablizer/cmd"
+	"codeberg.org/scip/tablizer/cmd"
 )
 
 func main() {

mkrel.sh

@@ -49,7 +49,7 @@ for D in $DIST; do
     fi
     
     set -x
-    GOOS=${os} GOARCH=${arch} go build -tags osusergo,netgo -ldflags "-extldflags=-static -w -X 'github.com/tlinden/tablizer/cfg.VERSION=${version}'" --trimpath $pie -o ${binfile}
+    GOOS=${os} GOARCH=${arch} go build -tags osusergo,netgo -ldflags "-extldflags=-static -w -X 'codeberg.org/scip/tablizer/cfg.VERSION=${version}'" --trimpath $pie -o ${binfile}
     strip --strip-all ${binfile}
     mkdir -p ${tardir}
     cp ${binfile} README.md LICENSE ${tardir}/

t/test-template.txtar

@@ -0,0 +1,16 @@
+exec tablizer -r testtable.txt -P '{{.species | title}}s are {{.type }}'
+stdout 'Humans are invasive'
+
+exec tablizer -r testtable.txt -P '{{.species | sha256sum}}'
+stdout '79a5478768d2447431a90f7f4549df735f50ad541371464c248abc7522dc3a01'
+
+exec tablizer -r testtable.txt -P '{{add 100 .count}}'
+stdout 104
+
+-- testtable.txt --
+SPECIES   TYPE         HOME     COUNT  STAGE
+human     invasive     earth    4      brink
+riedl     peaceful     keauna   33     civilized
+namak     invasive     namak    123    imperium
+heduu     peaceful     iu       66     imperium
+kenaha    peaceful     kohi     3333   hunter-gatherer

tablizer.1

@@ -133,7 +133,7 @@
 .\" ========================================================================
 .\"
 .IX Title "TABLIZER 1"
-.TH TABLIZER 1 "2025-10-09" "1" "User Commands"
+.TH TABLIZER 1 "2025-12-08" "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
@@ -160,6 +160,8 @@ tablizer \- Manipulate tabular output of other programs
 \&      \-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
+\&      \-g, \-\-auto\-headers                 Generate headers if there are none present in input
+\&      \-x, \-\-custom\-headers a,b,...       Use custom headers, separated by comma
 \&
 \&    Output Flags (mutually exclusive):
 \&      \-X, \-\-extended                     Enable extended output
@@ -167,12 +169,14 @@ tablizer \- Manipulate tabular output of other programs
 \&      \-O, \-\-orgtbl                       Enable org\-mode table output
 \&      \-S, \-\-shell                        Enable shell evaluable output
 \&      \-Y, \-\-yaml                         Enable yaml output
+\&      \-J, \-\-jsonout                      Enable JSON output
 \&      \-C, \-\-csv                          Enable CSV output
 \&      \-A, \-\-ascii                        Default output mode, ascii tabular
+\&      \-P, \-\-template <tpl>               Enable template mode with template <tpl>
 \&      \-L, \-\-hightlight\-lines             Use alternating background colors for tables
+\&      \-o, \-\-ofs <char>                   Output field separator, used by \-A and \-C. 
 \&      \-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
@@ -216,16 +220,16 @@ pattern. Hence:
 .PP
 .Vb 2
 \&   # read from STDIN
-\&   kubectl get pods | tablizer
+\&   > kubectl get pods | tablizer
 \&
 \&   # read a file
-\&   tablizer \-r filename
+\&   > tablizer \-r filename
 \&
 \&   # search for pattern in a file (works like grep)
-\&   tablizer regex \-r filename
+\&   > tablizer regex \-r filename
 \&
 \&   # search for pattern in STDIN
-\&   kubectl get pods | tablizer regex
+\&   > kubectl get pods | tablizer regex
 .Ve
 .PP
 The output looks like the original  one. You can add the option \fB\-n\fR,
@@ -239,7 +243,7 @@ These numbers denote the column and  you can use them to specify which
 columns you want to have in your output (see \s-1COLUMNS\s0:
 .PP
 .Vb 1
-\&   kubectl get pods | tablizer \-c1,3
+\&   > kubectl get pods | tablizer \-c1,3
 .Ve
 .PP
 You can specify the numbers in any order but output will always follow
@@ -249,13 +253,13 @@ However, you may also just use the header names instead of numbers,
 eg:
 .PP
 .Vb 1
-\&   kubectl get pods | tablizer \-cname,status
+\&   > kubectl get pods | tablizer \-cname,status
 .Ve
 .PP
 You can also use regular expressions with \fB\-c\fR, eg:
 .PP
 .Vb 1
-\&   kubectl get pods | tablizer \-c \*(Aq[ae]\*(Aq
+\&   > kubectl get pods | tablizer \-c \*(Aq[ae]\*(Aq
 .Ve
 .PP
 By  default tablizer  shows  a  header containing  the  names of  each
@@ -378,7 +382,7 @@ and append the flag. The following flags are supported:
 Example for a case insensitive search:
 .PP
 .Vb 1
-\&    kubectl get pods \-A | tablizer "/account/i"
+\&    > kubectl get pods \-A | tablizer "/account/i"
 .Ve
 .PP
 If you use the \f(CW\*(C`!\*(C'\fR flag, then the regex match will be negated, that
@@ -457,7 +461,7 @@ Lets take this table:
 We want to see only the \s-1CMD\s0 column and use a regex for this:
 .PP
 .Vb 6
-\&    ps | tablizer \-s \*(Aq\es+\*(Aq \-c C
+\&    > ps | tablizer \-s \*(Aq\es+\*(Aq \-c C
 \&    CMD(4)
 \&    bash
 \&    ps
@@ -494,7 +498,7 @@ use a regexp containing the \f(CW\*(C`/\*(C'\fR character, eg:
 Example:
 .PP
 .Vb 7
-\&    cat t/testtable2
+\&    > cat t/testtable2
 \&    NAME  DURATION
 \&    x     10
 \&    a     100
@@ -502,7 +506,7 @@ Example:
 \&    u     4
 \&    k     6
 \&    
-\&    cat t/testtable2 | tablizer \-T2 \-R \*(Aq/^\ed/4/\*(Aq \-n
+\&    > cat t/testtable2 | tablizer \-T2 \-R \*(Aq/^\ed/4/\*(Aq \-n
 \&    NAME    DURATION 
 \&    x       40      
 \&    a       400     
@@ -520,7 +524,7 @@ printed vertically,  header left,  value right,  aligned by  the field
 widths. Here's an example:
 .PP
 .Vb 6
-\&    kubectl get pods | ./tablizer \-o extended
+\&    > kubectl get pods | ./tablizer \-o extended
 \&        NAME: repldepl\-7bcd8d5b64\-7zq4l  
 \&       READY: 1/1    
 \&      STATUS: Running  
@@ -536,7 +540,7 @@ 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
+\&    > 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"
@@ -547,8 +551,22 @@ You can use this in an eval loop.
 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,  \fByaml\fR, which
-prints  yaml encoding  and \s-1CSV\s0  mode, which  prints a  comma separated
+prints  yaml encoding  and \fB\s-1CSV\s0\fR  mode, which  prints a  comma separated
 value file.
+.PP
+A special output mode ist the \fBTemplate\fR mode, activated with the
+option \f(CW\*(C`\-\-template\*(C'\fR. Template language is the Golang template
+language: <https://pkg.go.dev/text/template>. You can also use lot's
+of additional functions from:
+<https://masterminds.github.io/sprig/>. Here's an example:
+.PP
+.Vb 3
+\&    > kubectl get pods | tablizer \-\-template "{{.name}} is {{.status}}"
+\&    alertmanager\-kube\-prometheus\-alertmanager\-0 is Running
+\&    grafana\-fcc54cbc9\-bk7s8 is Running
+.Ve
+.PP
+You can use header names as variables.
 .SS "\s-1PUT FIELDS TO CLIPBOARD\s0"
 .IX Subsection "PUT FIELDS TO CLIPBOARD"
 You can let tablizer put fields to the clipboard using the option
@@ -674,7 +692,7 @@ parameter \f(CW\*(C`\-N\*(C'\fR or the environment variable \fB\s-1NO_COLOR\s0\f
 .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>.
+<https://codeberg.org/scip/tablizer/issues>.
 .SH "LICENSE"
 .IX Header "LICENSE"
 This software is licensed under the \s-1GNU GENERAL PUBLIC LICENSE\s0 version 3.

tablizer.pod

@@ -21,6 +21,8 @@ tablizer - Manipulate tabular output of other programs
       -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
+      -g, --auto-headers                 Generate headers if there are none present in input
+      -x, --custom-headers a,b,...       Use custom headers, separated by comma
 
     Output Flags (mutually exclusive):
       -X, --extended                     Enable extended output
@@ -28,12 +30,14 @@ tablizer - Manipulate tabular output of other programs
       -O, --orgtbl                       Enable org-mode table output
       -S, --shell                        Enable shell evaluable output
       -Y, --yaml                         Enable yaml output
+      -J, --jsonout                      Enable JSON output
       -C, --csv                          Enable CSV output
       -A, --ascii                        Default output mode, ascii tabular
+      -P, --template <tpl>               Enable template mode with template <tpl>
       -L, --hightlight-lines             Use alternating background colors for tables
+      -o, --ofs <char>                   Output field separator, used by -A and -C. 
       -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
@@ -77,16 +81,16 @@ may also  use the  B<-v> option  to exclude all  rows which  match the
 pattern. Hence:
 
    # read from STDIN
-   kubectl get pods | tablizer
+   > kubectl get pods | tablizer
 
    # read a file
-   tablizer -r filename
+   > tablizer -r filename
 
    # search for pattern in a file (works like grep)
-   tablizer regex -r filename
+   > tablizer regex -r filename
 
    # search for pattern in STDIN
-   kubectl get pods | tablizer regex
+   > kubectl get pods | tablizer regex
 
 The output looks like the original  one. You can add the option B<-n>,
 then every header field will have a numer associated with it, e.g.:
@@ -96,7 +100,7 @@ then every header field will have a numer associated with it, e.g.:
 These numbers denote the column and  you can use them to specify which
 columns you want to have in your output (see L<COLUMNS>:
 
-   kubectl get pods | tablizer -c1,3
+   > kubectl get pods | tablizer -c1,3
 
 You can specify the numbers in any order but output will always follow
 the original order.
@@ -104,11 +108,11 @@ the original order.
 However, you may also just use the header names instead of numbers,
 eg:
 
-   kubectl get pods | tablizer -cname,status
+   > kubectl get pods | tablizer -cname,status
 
 You can also use regular expressions with B<-c>, eg:
 
-   kubectl get pods | tablizer -c '[ae]'  
+   > kubectl get pods | tablizer -c '[ae]'  
 
 By  default tablizer  shows  a  header containing  the  names of  each
 column.  This can  be disabled using the B<-H> option.   Be aware that
@@ -233,7 +237,7 @@ and append the flag. The following flags are supported:
 
 Example for a case insensitive search:
 
-    kubectl get pods -A | tablizer "/account/i"
+    > kubectl get pods -A | tablizer "/account/i"
 
 If you use the C<!> flag, then the regex match will be negated, that
 is, if a line in the input matches the given regex, but C<!> is
@@ -304,7 +308,7 @@ Lets take this table:
 
 We want to see only the CMD column and use a regex for this:
 
-    ps | tablizer -s '\s+' -c C
+    > ps | tablizer -s '\s+' -c C
     CMD(4)
     bash
     ps
@@ -337,7 +341,7 @@ use a regexp containing the C</> character, eg:
 
 Example:
     
-    cat t/testtable2
+    > cat t/testtable2
     NAME  DURATION
     x     10
     a     100
@@ -345,7 +349,7 @@ Example:
     u     4
     k     6
     
-    cat t/testtable2 | tablizer -T2 -R '/^\d/4/' -n
+    > cat t/testtable2 | tablizer -T2 -R '/^\d/4/' -n
     NAME    DURATION 
     x       40      
     a       400     
@@ -362,7 +366,7 @@ useful 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
+    > kubectl get pods | ./tablizer -o extended
         NAME: repldepl-7bcd8d5b64-7zq4l  
        READY: 1/1    
       STATUS: Running  
@@ -376,7 +380,7 @@ 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
+    > 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" 
@@ -386,9 +390,22 @@ 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,  B<yaml>, which
-prints  yaml encoding  and CSV  mode, which  prints a  comma separated
+prints  yaml encoding  and B<CSV>  mode, which  prints a  comma separated
 value file.
 
+A special output mode ist the B<Template> mode, activated with the
+option C<--template>. Template language is the Golang template
+language: L<https://pkg.go.dev/text/template>. You can also use lot's
+of additional functions from:
+L<https://masterminds.github.io/sprig/>. Here's an example:
+
+    > kubectl get pods | tablizer --template "{{.name}} is {{.status}}"
+    alertmanager-kube-prometheus-alertmanager-0 is Running
+    grafana-fcc54cbc9-bk7s8 is Running
+
+
+You can use header names as variables.
+
 =head2 PUT FIELDS TO CLIPBOARD
 
 You can let tablizer put fields to the clipboard using the option
@@ -510,7 +527,7 @@ parameter C<-N> or the environment variable B<NO_COLOR> to a true value.
 
 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>.
+L<https://codeberg.org/scip/tablizer/issues>.
 
 =head1 LICENSE