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: 3 months ago
JSON representation
Split text into multiple files by line
- Host: GitHub
- URL: https://github.com/thealgorythm/zsplit
- Owner: TheAlgorythm
- License: gpl-3.0
- Created: 2021-11-30T14:47:51.000Z (over 3 years ago)
- Default Branch: MAIN
- Last Pushed: 2024-04-08T14:02:08.000Z (about 1 year ago)
- Last Synced: 2024-04-09T05:39:54.298Z (about 1 year ago)
- Topics: cli, coreutils, rust, split, text, utility
- Language: Rust
- Homepage: https://zschoen.dev/projects/zsplit
- Size: 202 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zsplit
[](https://github.com/TheAlgorythm/zsplit/actions?query=workflow%3ARust)
[](https://crates.io/crates/zsplit-cli)
[](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
```
#### 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
```
#### 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
```
## Installation
### Cargo
```console
$ cargo install zsplit-cli
```
When the installation is done with the MSRV, it could be necessary to add the `--locked` CLI argument as some dependencies may increase their MSRV without a version bump according to SemVer.
## 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)