from-os-str

Crates.iofrom-os-str
lib.rsfrom-os-str
version0.1.0
sourcesrc
created_at2022-04-05 14:03:35.409207
updated_at2022-04-05 14:03:35.409207
descriptionA macro that uses autoref based specialization to guess how to convert a &OsStr to a more useful type
homepage
repositoryhttps://github.com/aj-bagwell/from-os-str
max_upload_size
id562622
size12,117
AJ Bagwell (aj-bagwell)

documentation

https://docs.rs/from-os-str/

README

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
Commit count: 4

cargo fmt