varsun: Variable Substituion Functions(s) for Rust

varsunとは - About of varsun -

Go言語における os.ExpandEnv 相当のものが欲しかったけど、標準ライブラリには見当たらなかった。 そんなわけで必要な機能を持ったものを作ろうとした結果がこの varsun である。

できること - Features -

• $foo や ${bar} を見つけて、それを対応する文字列へと置き換える
• %foo% も対応。
• varsun 直下の関数を使うと、Windows なら %foo% を、それ以外は %foo を認識するように自動的に切り替わる。
• ついでに環境変数展開を標準装備。
  • 使い方の参考でもある。

やりたいこと - TODO -

• 効率のいい文字列探索
  • さすがに一文字ずつ見てくのは非効率といわざるを得ない
• マクロ使ってみたい
• ベンチマーク
  • cargo bench が動かん(´・ω・｀)

使い方 - Usage -

```rust extern crate varsun;

// on Linux system. let homedir = varsun::substitute("$HOME", |name: &str| -> Option { match ::std::env::var(name) { Ok(val) => Some(val), Err(_) => NOne, } });

// on Windows. let homedir = varsun::substitute("%USERPROFILE%", |name: &str| -> Option { match ::std::env::var(name) { Ok(val) => Some(val), Err(_) => None, } }); ```

常にPOSIX ($HOGE) を使う - Use POSIX ($HOGE) style always -

```rust extern crate varsun;

// on Linux. let homedir = varsun::posix::substitute("${HOME}", |name: &str| -> Option { match ::std::env::var(name) { Ok(val) => Some(val), Err(_) => None, } });

// on Windows. let homedir = varsun::posix::substitute("${USERPROFILE}", |name: &str| -> Option { match ::std::env::var(name) { Ok(val) => Some(val), Err(_) => None, } }); ```

常にWindows (%HOGE%) を使う - Use Windows (%HOGE%) style always -

```rust extern crate varsun;

// on Linux. let homedir = varsun::windows::substitute("%HOME%", |name: &str| -> Option { match ::std::env::var(name) { Ok(val) => Some(val), Err(_) => None, } });

// on Windows. let homedir = varsun::windows::substitute("%USERPROFILE%", |name: &str| -> Option { match ::std::env::var(name) { Ok(val) => Some(val), Err(_) => None, } }); ```

作者 - Author -

TANAKA Kenichi aka chikuchikugonzalez (ちくちく('ω')ごんざれす)

• chiku2gonzalez on Twitter
• chikuchikugonzalez on Hatena Blog

ライセンス - LICENSE -

MIT License