Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexdelorenzo/nth_rs
Return or exclude the nth item via stdin
https://github.com/alexdelorenzo/nth_rs
coreutils stdin stdout unix-command utility
Last synced: 26 days ago
JSON representation
Return or exclude the nth item via stdin
- Host: GitHub
- URL: https://github.com/alexdelorenzo/nth_rs
- Owner: alexdelorenzo
- License: agpl-3.0
- Created: 2020-08-31T18:58:46.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2020-09-25T07:02:08.000Z (about 4 years ago)
- Last Synced: 2024-09-14T04:43:03.491Z (about 2 months ago)
- Topics: coreutils, stdin, stdout, unix-command, utility
- Language: Rust
- Homepage:
- Size: 30.3 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nth_rs
Return or exclude the `nth` lines supplied from stdin as output on stdout. See the Python version of this utility here: [nth_py](https://github.com/alexdelorenzo/nth_py).
This project utilizes [`byte_lines`](https://github.com/alexdelorenzo/byte_lines) to iterate over standard input as lines of bytes, instead of strings or individual bytes.
# Install
```bash
cargo install nth_rs
```
# Usage
```bash
$ dmesg | nth_rs 0 1 2 3
[ 4.095065] xhci-hcd xhci-hcd.3.auto: xHCI Host Controller
[ 4.100328] xhci-hcd xhci-hcd.3.auto: new USB bus registered, assigned bus number 4
[ 4.107985] xhci-hcd xhci-hcd.3.auto: Host supports USB 3.0 SuperSpeed
[ 4.109677] mmc_host mmc0: Bus speed (slot 0) = 50000000Hz (slot req 52000000Hz, actual 50000000HZ div = 0)
```
To better illustrate, let's enumerate each line of stdin:
```bash
$ dmesg | count | nth_rs 0 1 2 3
0 [ 4.095065] xhci-hcd xhci-hcd.3.auto: xHCI Host Controller
1 [ 4.100328] xhci-hcd xhci-hcd.3.auto: new USB bus registered, assigned bus number 4
2 [ 4.107985] xhci-hcd xhci-hcd.3.auto: Host supports USB 3.0 SuperSpeed
3 [ 4.109677] mmc_host mmc0: Bus speed (slot 0) = 50000000Hz (slot req 52000000Hz, actual 50000000HZ div = 0)
```
## Help
```bash
$ nth_rs --help
nth 0.2.0
AlexDeLorenzo.dev
Return the contents of stdin from the line numbers supplied as arguments.
USAGE:
nth_rs [FLAGS] ...
FLAGS:
-h, --help Prints help information
-r, --reverse Write every line, except the line numbers supplied as LINES, from stdin to stdout.
-V, --version Prints version information
ARGS:
... Line numbers to select
```
# License
See `LICENSE`. If you'd like to use this project with a different license, please get in touch.