tos-kamiya / joyn

Join input files. Create a thread for each input file that reads a line, and write a line each time any thread reads it.

joyn

A command-line utility to join input files. Create a thread for each input file that reads a line, and write a line each time any thread reads it.

Keywords: command line utility, pipe, parallel execution

Installation

cargo install joyn

Usage

joyn file1 file2 ...

Read input files and their content lines and output them. The order of lines in the output is "interleaved". That is, unlike the cat command, lines in the file specified earlier in the command line may be output later.

However, the expected use of joyn is to invoke the processes that run command lines and merge their output lines. In the case of bash shell, this usage can be accomplished with a command line such as:

joyn <(command line 1) <(command line 2) ...

Samples

→ Difference between command substitution joined with cat and joined with joyn

→ Line-oriented handling

Release history

0.4.0

• feat: add option --info to replace option --summary. In addition to the number of lines displayed by --summary, print the buffer size when the input is a pipe
• fix: reduce number of bytes copied (between buffers)

0.3.0

• feat: new option --buffer-size

0.2.4

• fix: reduce number of mutex operations
• fix: characters in the input files were sometime missed
• chore: enable LTO in release build

0.2.2

• fix: add code to avoid the potential race conditions

0.2.0

• feat: new option --summary to print LOC of each input file on exit

0.1.0

• First release