6 releases (3 breaking)

0.4.1 Mar 24, 2020
0.4.0 Sep 26, 2017
0.3.1 Apr 6, 2017
0.3.0 Feb 12, 2017
0.1.0 Nov 19, 2016
Download history 46/week @ 2021-05-25 82/week @ 2021-06-01 72/week @ 2021-06-08 86/week @ 2021-06-15 27/week @ 2021-06-22 107/week @ 2021-06-29 158/week @ 2021-07-06 173/week @ 2021-07-13 155/week @ 2021-07-20 52/week @ 2021-07-27 55/week @ 2021-08-03 68/week @ 2021-08-10 17/week @ 2021-08-17 36/week @ 2021-08-24 3/week @ 2021-08-31 41/week @ 2021-09-07

311 downloads per month
Used in less than 11 crates

Apache-2.0

7KB
100 lines

Introduction

A pattern that often occurs in UNIX utilities is:

  • You want to read from a file when a filename argument is provided, otherwise from stdin.
  • You want to write to a file when a filename argument is provided, otherwise to stdout.

This is a small crate that accommodates that pattern.

Note: This package is still new, its API will change.

Installation

This package can be used with Cargo:

[dependencies]
stdinout = 0.1

lib.rs:

A pattern that often occurs when writing command-line utilities is that one wants to open a file when a filename argument is provided or read/write from/to stdin/stdout otherwise. Unfortunatlely, this is more work in Rust than it should be.

The stdinout crate provides a small wrapper that makes it easier to handle this scenario.

For reading from a file or the standard input:

let input = Input::from(matches.free.get(0));
let reader = or_exit(input.buf_read());

for line in reader.lines() {
    // Use 'line'
}

For writing to a file or the standard output:

let output = Output::from(args.get(1));

// Get an object that implements the Write trait.
let write = output.write().unwrap();

No runtime deps