Lib.rs

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();