Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kanarus/kozo
https://github.com/kanarus/kozo
Last synced: 19 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/kanarus/kozo
- Owner: kanarus
- Created: 2022-10-22T14:14:50.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2022-10-31T08:18:46.000Z (about 2 years ago)
- Last Synced: 2024-10-10T22:43:58.269Z (about 1 month ago)
- Language: Rust
- Size: 28.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
kozo provides some syntax sugars to use Rust's struct easily.\
Current kozo provides following 2 proc macros:
- `define!`
- `retrieve!`
# define!
`define!` macro enables to define nested structs in a way easy to see.
```rs
use kozo::define;
define!(struct NestedStruct {
a: Vec,
b: struct B {
c: struct C {
d: u8,
e: u8,
},
f: enum F {
X,
Y,
Other {
name: String,
id: usize
},
},
},
});
fn main() {
let sample = NestedStruct {
a: vec![1, 1, 0, 1, 0, 1, 1],
b: B {
c: C {
d: 0,
e: 1,
},
f: F::X,
},
};
println!("{}", sample.b.c.d); // 0
}
```
( examples/define_sample.rs )
Then, `define!` is **just a syntax sugar** of defining each named structs separately like
```rs
struct DeepNestedStruct {
a: Vec,
b: B,
}
struct B {
c: C,
f: F,
}
struct C {
d: u8,
e: u8,
}
enum F {
X,
Y,
Other {
name: String,
id: usize,
},
}
```
So please pay attension to that **all structs declared in define!(); are visible** in its scope.
# retrieve!
`retrieve!` enables to simply get more than 1 value from a struct:
```rs
use kozo::{define, retrieve};
define!(struct Sample {
a: u8,
b: struct B {
c: String,
d: Vec,
},
});
fn main() {
let s = Sample {
a: 0,
b: B {
c: "I have an apple?".into(),
d: vec![1, 1, 0, 1, 0, 1, 1],
},
};
retrieve!(a, b from s);
println!("{a}"); // 0,
println!("{}", b.c);
}
```
( examples/retrieve_sample.rs )
### NOTICEs
In next version (v0.2),
- `define!` will be able to accept `derive`s.
```rs
#[derive(Clone)]
define!(struct S {
// ...
})
```
- `retrieve!` will be able to get nested values directly like
```rs
let s = Sample {
a: 0,
b: B {
c: "You have an apple!".into(),
d: vec![1, 1, 0, 1, 0, 1, 1,],
},
};
retrieve!(a, c(b), from s);
```
In future, `retrieve!` will support named retrieving:
```rs
let s = Sample {
a: 0,
b: B {
c: "Is this an apple?".into(),
d: vec![1, 1, 0, 1, 0, 1, 1,],
},
};
retrieve!(var1 @ a, crazy_apple_man @ c(b), from s);
println!("{var1}"); // 0
```
for Japanese speakers...\
"kozo" は「小僧」の発音で読んでください。struct「構造」と掛けたネーミングで、構造体に関する小さく便利な機能を提供するクレートという意味を込めています。