Skip to content

A command-line tool to unweave interleaved streams of text lines using regular expression matching

Notifications You must be signed in to change notification settings

afrantzis/unweave

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

unweave

unweave is a command-line tool to separate interleaved streams of text lines into per-stream columns or files. Each line is classified based on a stream tag extracted using a regular expression pattern.

Documentation

Detailed information about the functionality and options of the unweave tool can be found in the man page at:

doc/unweave.1.md

Usage

Build with:

cargo build --release

To run from within the build directory use either:

cargo run --release -- [OPTIONS...] PATTERN [FILE...]

or directly with:

target/release/unweave [OPTIONS]... PATTERN [FILE]...

To build and install along with the manpage use the meson build system:

meson setup --buildtype=release -Dstrip=true build ninja -C build ninja -C build install

To install directly from crates.io:

cargo install unweave

Short intro

Consider the input file consisting of lines from three streams, tagged A, B and C:

[info] A: 1
[info] A: 2
[info] B: 1
[error] A: 3
[info] B: 2
[error] C: 1

Unweaving with the regex pattern A|B|C into columns gives:

$ unweave 'A|B|C' input
[info] A: 1
[info] A: 2
            [info] B: 1
[error] A: 3
            [info] B: 2
                       [error] C: 1

The width of each column and column separator can be set:

$ unweave -c 15 -s '|' 'A|B|C' input
[info] A: 1    |               |
[info] A: 2    |               |
               |[info] B: 1    |
[error] A: 3   |               |
               |[info] B: 2    |
               |               |[error] C: 1

For more complex cases the first capture group of the regex can be used to acquire the stream tag. Also the total output line width can be set, which will be equally split among the columns:

$ unweave -l 45 '] ([A-Z]): \d' input
[info] A: 1
[info] A: 2
               [info] B: 1
[error] A: 3
               [info] B: 2
                              [error] C: 1

To unweave into separate files with each output filename containing the stream tag and the stream id:

$ unweave --mode=files -o 'stream-%t-%2d' 'A|B|C' input
$ tail -n +1 stream-*
==> stream-A-00 <==
[info] A: 1
[info] A: 2
[error] A: 3

==> stream-B-01 <==
[info] B: 1
[info] B: 2

==> stream-C-02 <==
[error] C: 1

License

This project is licensed under the GNU General Public License Version 3.0 or later (LICENSE or https://gnu.org/licenses/gpl.html).

About

A command-line tool to unweave interleaved streams of text lines using regular expression matching

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published