kle-serial 0.3.4

Rust deserialisation library for Keyboard Layout Editor JSON files
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# kle-serial   [![Test Status]][actions] [![Test Coverage]][codecov] [![Crate Version]][crates] [![Rust Version]][crates]

[test status]: https://img.shields.io/github/actions/workflow/status/staticintlucas/kle-serial-rs/test.yml?branch=main&label=tests&style=flat-square
[test coverage]: https://img.shields.io/codecov/c/gh/staticintlucas/kle-serial-rs?style=flat-square
[crate version]: https://img.shields.io/crates/v/kle-serial?style=flat-square
[rust version]: https://img.shields.io/crates/msrv/kle-serial?style=flat-square

[actions]: https://github.com/staticintlucas/kle-serial-rs/actions?query=branch%3Amain
[codecov]: https://app.codecov.io/github/staticintlucas/kle-serial-rs
[crates]: https://crates.io/crates/kle-serial

<!-- cargo-rdme start -->

A Rust library for deserialising [Keyboard Layout Editor] files. Designed to be used in
conjunction with [`serde_json`] to deserialize JSON files exported from KLE.

## Example

![example]

```rust
// kle_serial::Keyboard uses f64 coordinates by default. If you need f32 coordinates use
// kle_serial::Keyboard<f32> or kle_serial::f32::Keyboard instead.
use kle_serial::Keyboard;

let keyboard: Keyboard = serde_json::from_str(
    r#"[
        {"name": "example"},
        [{"f": 4}, "!\n1\n¹\n¡"]
    ]"#
).unwrap();

assert_eq!(keyboard.metadata.name, "example");
assert_eq!(keyboard.keys.len(), 1);

assert!(keyboard.keys[0].legends[0].is_some());
let legend = keyboard.keys[0].legends[0].as_ref().unwrap();

assert_eq!(legend.text, "!");
assert_eq!(legend.size, 4);

assert!(keyboard.keys[0].legends[1].is_none());
```

[Keyboard Layout Editor]: http://www.keyboard-layout-editor.com/
[`serde_json`]: https://crates.io/crates/serde_json
[example]: https://raw.githubusercontent.com/staticintlucas/kle-serial-rs/main/doc/example.png

<!-- cargo-rdme end -->

## Licence

Licensed under either of

* Apache License, Version 2.0 ([LICENCE-APACHE](LICENCE-APACHE) or [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0))
* MIT license ([LICENCE-MIT](LICENCE-MIT) or [http://opensource.org/licenses/MIT](http://opensource.org/licenses/MIT))

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in
this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without
any additional terms or conditions.