#osstring #arg #argument #cli #ostr

from-os-str

A macro that uses autoref based specialization to guess how to convert a &OsStr to a more useful type

1 unstable release

0.1.0 Apr 5, 2022

#975 in Command-line interface

MIT/Apache

12KB
201 lines

From OsStr

A macro to convert a &OsStr to a more useful types

Crates.io Crates.io License License Build Status

Dual-licensed under Apache 2.0 or MIT

About

A macro for trying to convert an &OsStr to another more usefull type There are lots of ways to do that and this will pick the best via autoref based specialization

e.g. a PathBuf will be created via From<OsString> not From<String> so non UTF8 paths will work.

It is most useful in other macros where you don't know the type you are converting to.

Example

use from_os_str::*;
use std::ffi::OsStr;
use std::path::Path;
let os_str = OsStr::new("123");
let path = try_from_os_str!(os_str as &Path);
assert_eq!(path, Ok(Path::new("123")));
let int = try_from_os_str!(os_str as u8);
assert_eq!(int, Ok(123));

Conversion Methods

It will use one of the following traits (in order of preferece) to convert the &OsStr to the type you want.

  • From<&OsStr>
  • From<&Path>
  • From
  • From<&str>
  • From
  • TryFrom<&OsStr>
  • TryFrom<&str>
  • FromStr

No runtime deps