4 releases
0.1.3 | Jan 10, 2024 |
---|---|
0.1.2 | Jan 10, 2024 |
0.1.1 | Jan 8, 2024 |
0.1.0 | Jan 8, 2024 |
#1159 in Rust patterns
105 downloads per month
Used in 2 crates
(via logfather)
15KB
80 lines
Simplicio
Get rid of the annoying boilerplate in Rust and simplify creation of String
s and HashMap
s.
Features
s!()
can be used to:- create a new
String
- convert any value that implements the
Display
trait into a string - concatinate values together that implement the
Display
trait - concatinate while inserting a space between each value with the
.
prefix (e.g.s!(.a, b, c)
)
- create a new
cnct!()
is a wrapper arounds!()
for preferential purposesmap()
creates a HashMap with initial values or from a Vec/array of tuple pairsmap!(k1 v1, k1 v2)
|map!(k1: v1, k2:v2)
|map!(k1 => v1, k2 => v2)
|map!(k1 -> v1, k2 -> v2)
Path
variables, if used as keys, are limited to=>
,:
, or[value]
delimiters- Create a new
HashMap
withmap!()
- Can extend
HashMap
s
Getting Started
To start using Simplicio, add the following to your Cargo.toml
:
[dependencies]
simplicio = "0.1.3"
- Minimum supported Rust version:
1.56.1
Usage
String creation and concatination
use simplicio::{s, cnct};
// Creating an enum for example purposes
enum Enum { Value } //Create the enum, Enum
impl std::fmt::Display for Enum { // Implement the Display trait
fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
match self { Enum::Value => write!(f, "value"), }
}
}
fn main() {
assert_eq!(String::new(), s!()); // Make a new string
assert_eq!(String::from("This is a String"), s!("This is a String")); // Stop using .to_string() or String::from()
assert_eq!(true.to_string(), s!(true)); // Converts bools
assert_eq!(123840.to_string(), s!(123840)); // Convert numbers fast boiiii
assert_eq!(Enum::Value.to_string(), s!(Enum::Value)); // As long as it implements the ToString or Display traits, it will work
let (a, b, c, d) = ("This", "is", "a", "String");
assert_eq!(String::from("This is a String"), cnct!(.a, b, c, d)); // '.' prefix to automate spacing
assert_eq!(s!(a, b, c, d), cnct!(a, b, c ,d)); // `cnct!()` is just a wrapper around `s!()`
}
Creating HashMaps
use simplicio::*;
fn main() {
let mut tester = std::collections::HashMap::new();
tester.insert("k1", "v1");
tester.insert("k2", "v2");
assert_eq!(map!("k1""v1", "k2" "v2"), tester); // ' ' delimiter
assert_eq!(map!("k1":"v1", "k2" : "v2"), tester); // ':' delimiter
assert_eq!(map!("k1"=>"v1", "k2" => "v2"), tester); // '=>' delimiter
assert_eq!(map!("k1"->"v1", "k2" -> "v2"), tester); // '->' delimiter
assert_eq!(map!("k1"["v1"], "k2" ["v2"]), tester); // Key[Value]
assert_eq!(map!([("k1", "v1"), ("k2", "v2")]), tester); // Similar to Hashmap::from(/*...*/)
let vecmap = Vec::from([("k1", "v1"), ("k2", "v2")]);
assert_eq!(map!(vecmap), tester); // Can convert a Vec<(_,_)>
let arrmap = [("k1", "v1"), ("k2", "v2")];
assert_eq!(map!(arrmap), tester); // Can convert an array [(_,_)]
}
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
._. why would you do this?