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

not needed
add support for template output mode with new option --templage <tmpl> (#47 )
2025-12-18 21:11:03 +01:00 · 2025-12-08 22:30:09 +01:00 · 2025-12-08 22:10:06 +01:00 · 2025-12-08 22:01:15 +01:00 · 2025-11-05 09:00:28 +01:00 · 2025-11-05 08:46:56 +01:00
35 changed files with 916 additions and 267 deletions
--- a/.github/workflows/ci.yaml
+++ b/.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
--- a/.github/workflows/release.yaml
+++ b/.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}}
--- a/.goreleaser.yaml
+++ b/.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 }})
--- a/.woodpecker/build.yaml
+++ b/.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]
--- a/.woodpecker/release.yaml
+++ b/.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
--- a/CHANGELOG.md
+++ b/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.
--- a/4
+++ b/4
@@ -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
--- a/Makefile.dist
+++ b/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/
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
-[![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)
-[![Go Report Card](https://goreportcard.com/badge/github.com/tlinden/tablizer)](https://goreportcard.com/report/github.com/tlinden/tablizer)
+[![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

@@ -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
--- a/cfg/config.go
+++ b/cfg/config.go
@@ -27,13 +27,26 @@ import (
 	"github.com/hashicorp/hcl/v2/hclsimple"
 )

-const DefaultSeparator string = `(\s\s+|\t)`
-const Version string = "v1.5.8"
-const MAXPARTS = 2
+const (
+	Version  = "v1.5.12"
+	MAXPARTS = 2
+)

-var DefaultConfigfile = os.Getenv("HOME") + "/.config/tablizer/config"
+var (
+	DefaultConfigfile = os.Getenv("HOME") + "/.config/tablizer/config"
+	VERSION           string // maintained by -x

-var VERSION string // maintained by -x
+	SeparatorTemplates = map[string]string{
+		":tab:":      `\s*\t\s*`,                               // tab but eats spaces around
+		":spaces:":   `\s{2,}`,                                 // 2 or more spaces
+		":pipe:":     `\s*\|\s*`,                               // one pipe eating spaces around
+		":default:":  `(\s\s+|\t)`,                             // 2 or more spaces or tab
+		":nonword:":  `\W`,                                     // word boundary
+		":nondigit:": `\D`,                                     // same for numbers
+		":special:":  `[\*\+\-_\(\)\[\]\{\}?\\/<>=&$§"':,\^]+`, // match any special char
+		":nonprint:": `[[:^print:]]+`,                          // non printables
+	}
+)

 // public config, set via config file or using defaults
 type Settings struct {
@@ -80,6 +93,9 @@ type Config struct {
 	UseHighlight   bool
 	Interactive    bool
 	InputJSON      bool
+	AutoHeaders    bool
+	CustomHeaders  []string
+	Template       string

 	SortMode        string
 	SortDescending  bool
@@ -126,6 +142,8 @@ type Modeflag struct {
 	Y bool
 	A bool
 	C bool
+	J bool
+	P bool // template
 }

 // used for switching printers
@@ -137,6 +155,8 @@ const (
 	Yaml
 	CSV
 	ASCII
+	Json
+	Template
 )

 // various sort types
@@ -275,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
 	}
@@ -356,6 +380,13 @@ func (conf *Config) ApplyDefaults() {
 	if conf.OutputMode == Yaml || conf.OutputMode == CSV {
 		conf.Numbering = false
 	}
+
+	if conf.Separator[0] == ':' && conf.Separator[len(conf.Separator)-1] == ':' {
+		separator, ok := SeparatorTemplates[conf.Separator]
+		if ok {
+			conf.Separator = separator
+		}
+	}
 }

 func (conf *Config) PreparePattern(patterns []*Pattern) error {
@@ -393,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 {
--- a/cmd/root.go
+++ b/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())

@@ -123,7 +125,7 @@ func Execute() {
 		"Use alternating background colors")
 	rootCmd.PersistentFlags().StringVarP(&ShowCompletion, "completion", "", "",
 		"Display completion code")
-	rootCmd.PersistentFlags().StringVarP(&conf.Separator, "separator", "s", cfg.DefaultSeparator,
+	rootCmd.PersistentFlags().StringVarP(&conf.Separator, "separator", "s", cfg.SeparatorTemplates[":default:"],
 		"Custom field separator")
 	rootCmd.PersistentFlags().StringVarP(&conf.Columns, "columns", "c", "",
 		"Only show the speficied columns (separated by ,)")
@@ -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,
--- a/cmd/shortusage.go
+++ b/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
-k col,...   sort by specified columns             -j  read JSON input
-F col=reg   filter field with regexp              -v  invert match
-T col,...   transpose specified columns           -n  numberize columns
-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
--ofs char   output field separator	               -s  specify field separator
-r file      read input from file                  -z  use fuzzy search
-f file      read config from file                 -I  interactive filter mode
-                                                   -d  debug
-O org -C CSV -M md -X ext -S shell -Y yaml        -D  sort descending order
-m  show manual       --help  show detailed help   -v  show version
-a  sort by age       -i      sort numerically     -t  sort by time`
+-c col,...   show specified columns                  -L  highlight matching lines
+-k col,...   sort by specified columns               -j  read JSON input
+-F col=reg   filter field with regexp                -v  invert match
+-T col,...   transpose specified columns             -n  numberize columns
+-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
+--ofs char   output field separator                  -s  specify field separator
+-r file      read input from file                    -z  use fuzzy search
+-f file      read config from file                   -I  interactive filter mode
+-x col,...   use custom headers                      -d  debug
+-o char      use char as output separator            -g  auto generate headers
+
+-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`
--- a/cmd/tablizer.go
+++ b/cmd/tablizer.go
@@ -14,7 +14,7 @@ SYNOPSIS
          -n, --numbering                    Enable header numbering
          -N, --no-color                     Disable pattern highlighting
          -H, --no-headers                   Disable headers display
-          -s, --separator <string>           Custom field separator
+          -s, --separator <string>           Custom field separator (maybe char, string or :class:)
          -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
@@ -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
@@ -141,6 +145,57 @@ DESCRIPTION
    Finally the -d option enables debugging output which is mostly useful
    for the developer.

+  SEPARATOR
+    The option -s can be a single character, in which case the CSV parser
+    will be invoked. You can also specify a string as separator. The string
+    will be interpreted as literal string unless it is a valid go regular
+    expression. For example:
+
+        -s '\t{2,}\'
+
+    is being used as a regexp and will match two or more consecutive tabs.
+
+        -s 'foo'
+
+    on the other hand is no regular expression and will be used literally.
+
+    To make live easier, there are a couple of predefined regular
+    expressions, which you can specify as classes:
+
+        * :tab:
+
+        Matches a tab and eats spaces around it.
+
+        * :spaces:
+
+        Matches 2 or more spaces.
+
+        * :pipe:
+
+        Matches a pipe character and eats spaces around it.
+
+        * :default:
+
+        Matches 2 or more spaces or tab. This is the default separator if
+        none is specified.
+
+        * :nonword:
+
+        Matches a non-word character.
+
+        * :nondigit:
+
+        Matches a non-digit character.
+
+        * :special:
+
+        Matches one or more special chars like brackets, dollar sign,
+        slashes etc.
+
+        * :nonprint:
+
+        Matches one or more non-printable characters.
+
  PATTERNS AND FILTERING
    You can reduce the rows being displayed by using one or more regular
    expression patterns. The regexp language being used is the one of
@@ -164,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,
@@ -230,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
@@ -261,7 +316,7 @@ DESCRIPTION

    Example:

-        cat t/testtable2
+        > cat t/testtable2
        NAME  DURATION
        x     10
        a     100
@@ -269,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     
@@ -285,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  
@@ -298,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"
@@ -310,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
@@ -410,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
@@ -458,7 +525,7 @@ Operational Flags:
  -n, --numbering                    Enable header numbering
  -N, --no-color                     Disable pattern highlighting
  -H, --no-headers                   Disable headers display
-  -s, --separator <string>           Custom field separator
+  -s, --separator <string>           Custom field separator (maybe char, string or :class:)
  -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
@@ -466,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
@@ -473,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
--- a/go.mod
+++ b/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
--- a/go.sum
+++ b/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=
--- a/lib/filter.go
+++ b/lib/filter.go
@@ -23,7 +23,7 @@ import (
 	"strings"

 	"github.com/lithammer/fuzzysearch/fuzzy"
-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )

 /*
--- a/lib/filter_test.go
+++ b/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) {
--- a/lib/helpers.go
+++ b/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) {
--- a/lib/helpers_test.go
+++ b/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) {
--- a/lib/io.go
+++ b/lib/io.go
@@ -23,7 +23,7 @@ import (
 	"io"
 	"os"

-	"github.com/tlinden/tablizer/cfg"
+	"codeberg.org/scip/tablizer/cfg"
 )

 const RWRR = 0755
--- a/lib/parser.go
+++ b/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 {
-			data.entries = records[1:]
+		if len(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 {
--- a/lib/parser_test.go
+++ b/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 {
@@ -34,7 +34,7 @@ var input = []struct {
 }{
 	{
 		name:      "tabular-data",
-		separator: cfg.DefaultSeparator,
+		separator: cfg.SeparatorTemplates[":default:"],
 		text: `
 ONE    TWO    THREE  
 asd    igig   cxxxncnc  
@@ -148,7 +148,7 @@ asd    igig
 19191  EDD 1  X`

 	readFd := strings.NewReader(strings.TrimSpace(table))
-	conf := cfg.Config{Separator: cfg.DefaultSeparator}
+	conf := cfg.Config{Separator: cfg.SeparatorTemplates[":default:"]}
 	gotdata, err := wrapValidateParser(conf, readFd)

 	assert.NoError(t, err)
@@ -314,6 +314,108 @@ func TestParserJSONInput(t *testing.T) {
 	}
 }

+func TestParserSeparators(t *testing.T) {
+	list := []string{"alpha", "beta", "delta"}
+
+	tests := []struct {
+		input string
+		sep   string
+	}{
+		{
+			input: `🎲`,
+			sep:   ":nonprint:",
+		},
+		{
+			input: `|`,
+			sep:   ":pipe:",
+		},
+		{
+			input: `   `,
+			sep:   ":spaces:",
+		},
+		{
+			input: "   \t  ",
+			sep:   ":tab:",
+		},
+		{
+			input: `-`,
+			sep:   ":nonword:",
+		},
+		{
+			input: `//$`,
+			sep:   ":special:",
+		},
+	}
+
+	for _, testdata := range tests {
+		testname := fmt.Sprintf("parse-%s", testdata.sep)
+		t.Run(testname, func(t *testing.T) {
+			header := strings.Join(list, testdata.input)
+			row := header
+			content := header + "\n" + row
+
+			readFd := strings.NewReader(strings.TrimSpace(content))
+			conf := cfg.Config{Separator: testdata.sep}
+			conf.ApplyDefaults()
+
+			gotdata, err := wrapValidateParser(conf, readFd)
+
+			assert.NoError(t, err)
+			assert.EqualValues(t, [][]string{list}, gotdata.entries)
+		})
+	}
+}
+
+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)

--- a/lib/printer.go
+++ b/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)
+	}
+}
--- a/lib/printer_test.go
+++ b/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",
@@ -292,6 +317,7 @@ func TestPrinter(t *testing.T) {
 				conf.UseSortByColumn = []int{testdata.column}
 			}

+			conf.Separator = cfg.SeparatorTemplates[":default:"]
 			conf.ApplyDefaults()

 			// the test checks the len!
--- a/lib/sort.go
+++ b/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
--- a/lib/sort_test.go
+++ b/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) {
--- a/lib/tabdata.go
+++ b/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
+}
--- a/lib/tableeditor.go
+++ b/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
--- a/lib/yank.go
+++ b/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) {
--- a/lib/yank_test.go
+++ b/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 {
--- a/main.go
+++ b/main.go
@@ -20,7 +20,7 @@ package main
 import (
 	"os"

-	"github.com/tlinden/tablizer/cmd"
+	"codeberg.org/scip/tablizer/cmd"
 )

 func main() {
--- a/mkrel.sh
+++ b/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}/
--- a/t/test-template.txtar
+++ b/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
--- a/tablizer.1
+++ b/tablizer.1
@@ -133,7 +133,7 @@
 .\" ========================================================================
 .\"
 .IX Title "TABLIZER 1"
-.TH TABLIZER 1 "2025-10-01" "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
@@ -152,7 +152,7 @@ tablizer \- Manipulate tabular output of other programs
 \&      \-n, \-\-numbering                    Enable header numbering
 \&      \-N, \-\-no\-color                     Disable pattern highlighting
 \&      \-H, \-\-no\-headers                   Disable headers display
-\&      \-s, \-\-separator <string>           Custom field separator
+\&      \-s, \-\-separator <string>           Custom field separator (maybe char, string or :class:)
 \&      \-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
@@ -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
@@ -293,6 +297,62 @@ Sorts timestamps.
 .PP
 Finally the  \fB\-d\fR option  enables debugging  output which  is mostly
 useful for the developer.
+.SS "\s-1SEPARATOR\s0"
+.IX Subsection "SEPARATOR"
+The option \fB\-s\fR can be a single character, in which case the \s-1CSV\s0
+parser will be invoked. You can also specify a string as
+separator. The string will be interpreted as literal string unless it
+is a valid go regular expression. For example:
+.PP
+.Vb 1
+\&    \-s \*(Aq\et{2,}\e\*(Aq
+.Ve
+.PP
+is being used as a regexp and will match two or more consecutive tabs.
+.PP
+.Vb 1
+\&    \-s \*(Aqfoo\*(Aq
+.Ve
+.PP
+on the other hand is no regular expression and will be used literally.
+.PP
+To make live easier, there are a couple of predefined regular
+expressions, which you can specify as classes:
+.Sp
+.RS 4
+* 		:tab:
+.Sp
+Matches a tab and eats spaces around it.
+.Sp
+*		:spaces:
+.Sp
+Matches 2 or more spaces.
+.Sp
+*		:pipe:
+.Sp
+Matches a pipe character and eats spaces around it.
+.Sp
+*		:default:
+.Sp
+Matches 2 or more spaces or tab. This is the default separator if none
+is specified.
+.Sp
+*		:nonword:
+.Sp
+Matches a non-word character.
+.Sp
+*		:nondigit:
+.Sp
+Matches a non-digit character.
+.Sp
+*		:special:
+.Sp
+Matches one or more special chars like brackets, dollar sign, slashes etc.
+.Sp
+*		:nonprint:
+.Sp
+Matches one or more non-printable characters.
+.RE
 .SS "\s-1PATTERNS AND FILTERING\s0"
 .IX Subsection "PATTERNS AND FILTERING"
 You can reduce  the rows being displayed by using  one or more regular
@@ -322,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
@@ -401,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
@@ -438,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
@@ -446,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     
@@ -464,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  
@@ -480,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"
@@ -491,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
@@ -618,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.
--- a/tablizer.pod
+++ b/tablizer.pod
@@ -13,7 +13,7 @@ tablizer - Manipulate tabular output of other programs
      -n, --numbering                    Enable header numbering
      -N, --no-color                     Disable pattern highlighting
      -H, --no-headers                   Disable headers display
-      -s, --separator <string>           Custom field separator
+      -s, --separator <string>           Custom field separator (maybe char, string or :class:)
      -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
@@ -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
@@ -153,6 +157,62 @@ Sorts timestamps.
 Finally the  B<-d> option  enables debugging  output which  is mostly
 useful for the developer.

+=head2 SEPARATOR
+
+The option B<-s> can be a single character, in which case the CSV
+parser will be invoked. You can also specify a string as
+separator. The string will be interpreted as literal string unless it
+is a valid go regular expression. For example:
+
+    -s '\t{2,}\'
+
+is being used as a regexp and will match two or more consecutive tabs.
+
+    -s 'foo'
+
+on the other hand is no regular expression and will be used literally.
+
+To make live easier, there are a couple of predefined regular
+expressions, which you can specify as classes:
+
+=over
+
+* 		:tab:      
+
+Matches a tab and eats spaces around it.
+
+*		:spaces:
+
+Matches 2 or more spaces.
+
+*		:pipe:
+
+Matches a pipe character and eats spaces around it.
+
+*		:default:
+
+Matches 2 or more spaces or tab. This is the default separator if none
+is specified.
+
+*		:nonword:
+
+Matches a non-word character.
+
+*		:nondigit:
+
+Matches a non-digit character.
+
+*		:special:
+
+Matches one or more special chars like brackets, dollar sign, slashes etc.
+
+*		:nonprint:
+
+Matches one or more non-printable characters.
+
+
+=back
+
 =head2 PATTERNS AND FILTERING

 You can reduce  the rows being displayed by using  one or more regular
@@ -177,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
@@ -248,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
@@ -281,7 +341,7 @@ use a regexp containing the C</> character, eg:

 Example:
    
-    cat t/testtable2
+    > cat t/testtable2
    NAME  DURATION
    x     10
    a     100
@@ -289,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     
@@ -306,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  
@@ -320,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" 
@@ -330,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
@@ -454,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
Author	SHA1	Message	Date
T. von Dein	46fde289f5	fix #46 : check sort array index before using it for sorting (#48 )	2025-12-08 22:30:09 +01:00
Thomas von Dein	d331f0b2e6	not needed	2025-12-08 22:10:06 +01:00
T. von Dein	fc0352efa9	add support for template output mode with new option --templage <tmpl> (#47 )	2025-12-08 22:01:15 +01:00
Thomas von Dein	2bb0cdb0af	fix link	2025-11-05 09:00:28 +01:00
Thomas von Dein	fad8a59023	fix changelog link	2025-11-05 08:46:56 +01:00
T. von Dein	bd5ee90324	move to codeberg (#45 )	2025-11-03 22:06:11 +01:00
Thomas von Dein	bc717baa3f	fix typo	2025-10-25 21:51:56 +02:00
Thomas von Dein	c34f030914	add stew	2025-10-25 21:50:31 +02:00
T.v.Dein	f1aa9d0000	add json output mode (-J) (#87 )	2025-10-14 07:18:30 +02:00
Thomas von Dein	736dd37f16	fixed feature entry	2025-10-13 07:24:35 +02:00
Thomas von Dein	e0dc6bb845	updated and added feature list	2025-10-13 07:23:54 +02:00
T.v.Dein	8bdb3db105	fix #85 : add --auto-headers and --custom-headers (#86 )	2025-10-10 13:08:16 +02:00
Thomas von Dein	4ce6c30f54	fix short usage formatting	2025-10-09 23:16:07 +02:00
T.v.Dein	ec0b210167	add some handy builtin character classes as split separators (#84 )	2025-10-09 23:03:57 +02:00