A Rust crate which allows to dynamically configure and read the schema based configuration files and also serialize data into JSON or binary files so later it could be deserialized into structs directly.
This crate also capable to construct a Rust structs and enumerators from the static schema files.
A statis scheme file is a file which contains a description of:
- how to read user provided config file
- how to store collected data
- how to serialize it (in which order)
A dynamic scheme file is a file which contains configurations which is required to read and serialize.
Features: - Serialize or deserialize - Data structures and collections - Structure/Enums back to scheme (human readable format)
For the syntax see /docs/.
```text V0.9 Removed generics from the Lexer. Now default int, uint types are i64 and u64 which should be deserialized into equal sized or lower types. The default long int and long uint are i128 and u128. This was specially made to bind the data types to avoid any sort of incompatability. Most of the systems are 64bits and I don't think that there is a need in 32bit mode.
V0.8.4 Fixed issue with arg-enums. Added static check which tests if enum item has same identifier name as define.
V0.8.3 Fixed problem with escape charater when converting back to the schema from structures. Added list of escape sequences in Lexer.
V0.8.2 Fixed misprint title of the function in RustCode. Fixed problem when argenum options were ordered in arbitrary order. An IndexSet is now used which should store items in hashset in sequence.
V0.8.1 Fixed error missing enum bind name for f/argenum in f/vector.
V0.8 Added functions to lib.rs
V0.7.2 Improved error reporting. There are still a room for improvements and analysis. Fixed error in serializing enumerators.
V0.7.1 Fixed error when serializing back (from structure) into scheme. Fixed error in analyzer.
V0.7.0 - Experimental: + Added conversion back to scheme from Rust structures.
V0.6.0 Syntax changes: Static Scheme: - struct now can be declared with comments which will be added above struct. - struct now can be declared with derive items
Added scheme_composer which serializes data from Rust structs back to scheme.
V0.5.0 Changes in syntax: not second argument of (struct) may be (none, "" or '("" "")). Now a single struct can describe more than one procedure to serialize.
V0.4.2 Added: the generator.rs now translate symbols defined in (define) to the rust code as a publicly available const, standalone fileds.
V0.4.1: Added (use) to include common structs/procedures.
V0.4: Some changes in syntax. Renamed: (allow) -> (proc-allow)
Added: (arg-enum-bind) ```
Until V1.0.0 this library is purely experimental and its code and syntax is subject for major changes.
Minor version number idicates changes in syntax of config files or code of the crate.
Build number is a bugfix. No changes to the code should be done.
text
┌───────────────────┐ ┌───────────────────────┐
│ static_scheme.shm │ │ dynamic_scheme.shm ◄─────────────┐
└────────┬──────────┘ └──────────┬────────────┘ │
│ │ │
│ │ │
│ │ │
┌───────▼─────────┐ ┌────────▼─────────┐ │
│ File / Buffer │ │ File / Buffer │ │
└───────┬─────────┘ └────────┬─────────┘ │
│ │ │
│ text │ text │
│ │ │
┌───────▼─────────┐ ┌───────▼─────────┐ │
│ Lexer │ │ Lexer │ │
└───────┬─────────┘ └───────┬─────────┘ │
│ │ │
│ │ data │
│ │ │
┌───────▼─────────┐ ┌───────▼──────────┐ │
│ │ structure │ │ │
│ StaticScheme ├──────────┬───────► DynamicScheme │ │
│ │ │ │ │ │
└───────┬─────────┘ │ └───────┬──────────┘ │
│ STRUCTURED DESCR │ │ │
│ │ │ Collected from scheme │
│ │ │ │
┌─────▼──────┐ │ ┌───────▼──────────┐ │
│ RustCode │ │ │ Structured Data │ │
└─────┬──────┘ │ └───────┬──────────┘ │
│ │ │ │
│ │ │ │
┌────▼──────┐ │ ┌───────▼──────────┐ │
│Generated │ └───────► Serializator │ │
│Rust Code │ └───────┬──────────┘ │
│Structures │ │ │
│Enums │ │ │
│Consts │ ┌───────▼──────────┐ │
└────┬──────┘ │ Serialized Data │ │
│ │ │ │
│structure │ Binary/JSON │ │
│ └──┬───────────────┘ │
│ │ │
│ │ │
┌───▼───────────────┐ data │ │
│ Serde Deserialize ◄───────────────┘ │
└────────┬──────────┘ │
│ │
│ data+structs ┌──────────────────┐ │
│ ┌──────────► Serde Serialize │ │
│ │ └───────┬──────────┘ │
│ │ │ │
┌────────▼──────────┤ ┌──────────▼──────────┐ │
│ Structures │ │ Composer ├─────────────────┘
│ Enums │ │ Struct2scheme │
└───────────────────┘ └─────────────────────┘
Example of dynamic scheme file which aka DynamicScheme
```scheme
(machine
(address "01:40/5010-A3F.0") ; router's address (to access admin panel)
(address "01:40/5010-A40.0") ; another adress (to access admin panel)
)
;; A 100MBit interface uplink from
;; A 1Gbit interface uplink from