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

#10 in #file-input

Download history 68/week @ 2024-03-11 66/week @ 2024-03-18 61/week @ 2024-03-25 121/week @ 2024-04-01 39/week @ 2024-04-08 56/week @ 2024-04-15 67/week @ 2024-04-22 61/week @ 2024-04-29 51/week @ 2024-05-06 63/week @ 2024-05-13 64/week @ 2024-05-20 58/week @ 2024-05-27 53/week @ 2024-06-03 39/week @ 2024-06-10 46/week @ 2024-06-17 49/week @ 2024-06-24

191 downloads per month
Used in 12 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