#text #filter

bin+lib aki-xcat

concatenate files that are plain, gzip, xz and zstd

20 releases

0.1.30 Nov 15, 2021
0.1.29 Nov 15, 2021
0.1.28 Sep 11, 2021
0.1.26 Jun 24, 2021
0.1.13 Feb 23, 2021

#286 in Text processing

Download history 36/week @ 2021-08-10 1/week @ 2021-08-17 2/week @ 2021-08-24 30/week @ 2021-09-07 12/week @ 2021-09-14 19/week @ 2021-09-21 2/week @ 2021-09-28 20/week @ 2021-10-05 10/week @ 2021-10-12 20/week @ 2021-10-19 4/week @ 2021-10-26 1/week @ 2021-11-02 42/week @ 2021-11-09 23/week @ 2021-11-16 25/week @ 2021-11-23

91 downloads per month
Used in aki-txpr-macro

MIT/Apache

31KB
512 lines

aki-xcat

concatenate files that are plain, gzip, xz and zstd.

Features

  • concatenate files that are plain, gzip ... etc.
  • input files are decompressed by auto.
  • minimum support rustc 1.51.0 (2fd73fabe 2021-03-23)

Command help

aki-xcat --help
Usage:
  aki-xcat [options] [<file>...]

this is like a cat, zcat, xzcat, zstdcat and lz4cat.
with no <file> or when <file> is -, read standard input.
automatic discovery file type: plain, gz, xz, zst and lz4.

Options:
  -n, --number          output line number for each lines
  -f, --file-name       output file name for each lines
      --path-name       output path name for each lines
  -p, --pipe-in <num>   read from pipe <num> [unimplemented]

  -H, --help        display this help and exit
  -V, --version     display version information and exit

Argument:
  <file>         utf-8 encoded text file. A compressed file of it by gzip, xz, zstd, lz4.

Examples:
  You can simple use. Just arrange the files.
    aki-xcat file1 file2.gz file3.xz file4.zst file5.lz4

Quick install

  1. you can install this into cargo bin path:
cargo install aki-xcat
  1. you can build debian package:
cargo deb

and install .deb into your local repository of debian package.

Examples

The input file used in this example looks like this:

cat fixtures/plain.txt

result output :

abcdefg
hijklmn
zcat fixtures/gztext.txt.gz

result output :

ABCDEFG
HIJKLMN

Example 1: simple concatenate

concatenate plain text file and gzip text file.

aki-xcat fixtures/plain.txt fixtures/gztext.txt.gz

result output :

abcdefg
hijklmn
ABCDEFG
HIJKLMN

Example 2: multi file formats

concatenate plain text file, gzip text file, xz text file, zstd text file and lz4 text file.

aki-xcat fixtures/plain.txt fixtures/gztext.txt.gz fixtures/xztext.txt.xz  fixtures/zstext.txt.zst fixtures/lz4text.txt.lz4

Example 3: output all line number

concatenate plain text file and gzip text file.

aki-xcat -n fixtures/plain.txt fixtures/gztext.txt.gz

result output :

     1  abcdefg
     2  hijklmn
     3  ABCDEFG
     4  HIJKLMN

Example 4: file name and line number

concatenate plain text file and gzip text file.

aki-xcat -n -f fixtures/plain.txt fixtures/gztext.txt.gz

result output :

"plain.txt"     1   abcdefg
"plain.txt"     2   hijklmn
"gztext.txt.gz"     1   ABCDEFG
"gztext.txt.gz"     2   HIJKLMN

Example 5: path name and line number

concatenate plain text file and gzip text file.

aki-xcat -n --path-name fixtures/plain.txt fixtures/gztext.txt.gz

result output :

"fixtures/plain.txt"     1  abcdefg
"fixtures/plain.txt"     2  hijklmn
"fixtures/gztext.txt.gz"     1  ABCDEFG
"fixtures/gztext.txt.gz"     2  HIJKLMN

Library example

See fn execute() for this library examples.

Changelogs

This crate's changelog here.

License

This project is licensed under either of

at your option.

Dependencies

~6MB
~116K SLoC

Ǒa