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

#884 in Command-line interface

Download history 55/week @ 2024-11-29 70/week @ 2024-12-06 56/week @ 2024-12-13 12/week @ 2024-12-20 5/week @ 2024-12-27 12/week @ 2025-01-03 43/week @ 2025-01-10 51/week @ 2025-01-17 24/week @ 2025-01-24 44/week @ 2025-01-31 239/week @ 2025-02-07 57/week @ 2025-02-14 55/week @ 2025-02-21 36/week @ 2025-02-28 22/week @ 2025-03-07 113/week @ 2025-03-14

236 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