Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/thealgorythm/zsplit

Split text into multiple files by line
https://github.com/thealgorythm/zsplit

cli coreutils rust split text utility

Last synced: 4 months ago
JSON representation

Split text into multiple files by line

Awesome Lists containing this project

README 

        
# zsplit



![GPL 3.0 License](https://img.shields.io/crates/l/zsplit-cli?style=for-the-badge&logo=open-source-initiative)

[![Workflow Status](https://img.shields.io/github/actions/workflow/status/TheAlgorythm/zsplit/check.yml?branch=MAIN&style=for-the-badge)](https://github.com/TheAlgorythm/zsplit/actions?query=workflow%3ARust)

[![Crates.io](https://img.shields.io/crates/v/zsplit-cli?style=for-the-badge&logo=rust)](https://crates.io/crates/zsplit-cli)

[![crev reviews](https://web.crev.dev/rust-reviews/badge/crev_count/zsplit-cli.svg)](https://web.crev.dev/rust-reviews/crate/zsplit-cli/)



Split text into multiple files by line.



## Usage



```console

$ zsplit --help

zsplit 0.4.0

ZSchoen 

Split text into multiple files by line



USAGE:

    zsplit [OPTIONS]  ...



ARGS:

                 The file which should be splitted. Use '-' for piping the content to

                         zsplit

    ...    A list of destinations for the splitted contents



OPTIONS:

    -d, --distributions ...

            Defines how many lines are assigned to a destination. The distributions have to be in

            the same order as the destinations. It defaults to 1



    -f, --line-factor 

            A factor to multiply the grouping size of the distribution [default: 1]



    -h, --help

            Print help information



    -V, --version

            Print version information

```



It splits the input into single lines and writes them Round Robin like to the output files.



### Examples



#### Setup



```console

$ seq 0 9 >test_folder/ten.txt; cat test_folder/ten.txt

0

1

2

[...]

8

9

```



#### Simple



```console

$ zsplit test_folder/ten.txt test_folder/{a,b,c}

$ cat test_folder/a

0

3

6

9

$ cat test_folder/b

1

4

7

$ cat test_folder/c

2

5

8

```



![Visualisation of simple](docs/simple.svg)



#### Unsymmetric Distribution



```console

$ zsplit test_folder/ten.txt test_folder/{a,b,c} --distribution 3 3 # The last distribution value is implicitly 1

$ cat test_folder/a

0

1

2

7

8

9

$ cat test_folder/b

3

4

5

$ cat test_folder/c

6

```



![Visualisation of unsymmetric distribution](docs/unsymmetric_distribution.svg)



#### Multiple Lines



```console

$ zsplit test_folder/ten.txt test_folder/{a,b,c} --line-factor 2

$ cat test_folder/a

0

1

6

7

$ cat test_folder/b

2

3

8

9

$ cat test_folder/c

4

5

```



![Visualisation of multiple lines](docs/multiple_lines.svg)



## Installation



### Cargo



```console

$ cargo install zsplit-cli

```



## CREV - Rust code reviews - Raise awareness



Please, spread this info !\

Open source code needs a community effort to express trustworthiness.\

Start with reading the reviews of the crates you use. Example: [web.crev.dev/rust-reviews/crate/num-traits/](https://web.crev.dev/rust-reviews/crate/num-traits/) \

Than install the CLI [cargo-crev](https://github.com/crev-dev/cargo-crev)\. Read the [Getting Started guide](https://github.com/crev-dev/cargo-crev/blob/master/cargo-crev/src/doc/getting_started.md). \

On your Rust project, verify the trustworthiness of all dependencies, including transient dependencies with `cargo crev verify`\

Write a new review ! \

Describe the crates you trust. Or warn about the crate versions you think are dangerous.\

Help other developers, inform them and share your opinion.\

Use the helper on this webpage: [web.crev.dev/rust-reviews/review_new](https://web.crev.dev/rust-reviews/review_new)