Struct TakeBytes 

pub struct TakeBytes { /* private fields */ }

A source of bytes from either stdin or a file path.

TakeBytes implements FromStr, making it easy to use with clap’s derive API. When parsing:

• "-" is interpreted as stdin
• Any other string is treated as a file path

Example

use clap::Parser;
use take_bytes::TakeBytes;

#[derive(Parser)]
struct Cli {
    /// Input file or "-" for stdin
    #[arg(default_value = "-")]
    input: TakeBytes,
}

Programmatic Construction

use take_bytes::TakeBytes;

// Read from stdin
let stdin_input = TakeBytes::stdin();

// Read from a file (note: file must exist when calling from_str)
// let file_input = TakeBytes::file("/path/to/file");

Implementations

impl TakeBytes

pub fn stdin() -> Self

Create a TakeBytes that reads from stdin.

Example

use take_bytes::TakeBytes;

let input = TakeBytes::stdin();

pub fn file(path: PathBuf) -> Self

Create a TakeBytes that reads from a file.

Note: This does not check if the file exists. The check happens when you call try_into_bytes.

Example

use take_bytes::TakeBytes;
use std::path::PathBuf;

let input = TakeBytes::file(PathBuf::from("/path/to/file"));

pub fn try_into_bytes(self) -> Result<Vec<u8>, Error>

Read the entire contents from the input source, returning as bytes.

Errors

Returns an error if:

• The file cannot be opened (for file sources)
• Reading from the source fails

Example

use take_bytes::TakeBytes;

let input: TakeBytes = "-".parse()?;
let bytes = input.try_into_bytes()?;

Trait Implementations

impl Clone for TakeBytes

fn clone(&self) -> TakeBytes

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TakeBytes

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromStr for TakeBytes

fn from_str(s: &str) -> Result<Self, Self::Err>

Parse a string into a TakeBytes.

• "-" is interpreted as stdin
• Any other string is treated as a file path

Errors

Returns io::ErrorKind::NotFound if the path does not exist.

type Err = Error

The associated error which can be returned from parsing.