57 lines
1.1 KiB
Markdown
57 lines
1.1 KiB
Markdown
# EString
|
||
|
||
A simple way to parse a string using type annotations.
|
||
|
||
This package was originally designed for [enve]
|
||
|
||
[enve]: https://github.com/pleshevskiy/itconfig-rs/tree/redesign
|
||
|
||
## Getting started
|
||
|
||
```rust
|
||
use estring::{SepVec, EString};
|
||
|
||
type PlusVec<T> = SepVec<T, '+'>;
|
||
type MulVec<T> = SepVec<T, '*'>;
|
||
|
||
fn main() -> Result<(), estring::ParseError> {
|
||
let res = EString::from("10+5*2+3")
|
||
.parse::<PlusVec<MulVec<f32>>>()?
|
||
.iter()
|
||
.map(|m| m.iter().product::<f32>())
|
||
.sum::<f32>();
|
||
|
||
assert_eq!(res, 23.0);
|
||
Ok(())
|
||
}
|
||
```
|
||
|
||
You can use custom types as annotations! Just implement `TryFrom<EString>`!
|
||
|
||
## Installation
|
||
|
||
**The MSRV is 1.51.0**
|
||
|
||
Add `estring = { version = "0.1", features = ["vec", "number"] }` as a
|
||
dependency in `Cargo.toml`.
|
||
|
||
`Cargo.toml` example:
|
||
|
||
```toml
|
||
[package]
|
||
name = "my-crate"
|
||
version = "0.1.0"
|
||
authors = ["Me <user@rust-lang.org>"]
|
||
|
||
[dependencies]
|
||
estring = { version = "0.1", features = ["vec", "number"] }
|
||
```
|
||
|
||
## License
|
||
|
||
**MIT**. See [LICENSE](./LICENSE) to see the full text.
|
||
|
||
## Contributors
|
||
|
||
[pleshevskiy](https://github.com/pleshevskiy) (Dmitriy Pleshevskiy) – creator,
|
||
maintainer.
|