Toml Example

A lib help generate toml example

Introduction

This crate provides the TomlExample trait and an accompanying derive macro.

Deriving TomlExample on a struct will provide to_example function help generate toml example file base documentation - support #[serde(default)], #[serde(default = "function_name")] attributes (serde feature, opt-in) - provide #[toml_example(default)], #[toml_example(default = 0)], #[toml_example(default = "default_string")] attributes - The order matter of attribute macro, if #[serde(default = ..] and #[toml_example(default = ..)] existing at the same time with different value

Quick Example

```rust use toml_example::TomlExample;

/// Config is to arrange something or change the controls on a computer or other device /// so that it can be used in a particular way

[derive(TomlExample)]

struct Config { /// Config.a should be a number a: usize, /// Config.b should be a string b: String, /// Optional Config.c is a number c: Option, /// Config.d is a list of number d: Vec, /// Config.e should be a number #[serde(default = "defaultint")] e: usize, /// Config.f should be a string #[serde(default = "defaultstr")] f: String, /// Config.g should be a number #[tomlexample(default =7)] g: usize, /// Config.f should be a string #[tomlexample(default = "seven")] h: String, } fn defaultint() -> usize { 7 } fn defaultstr() -> String { "seven".into() }

Config::totomlexample("example.toml"); // write example to a file let example = Config::toml_example(); ```

Toml example base on the doc string of each field ```toml

Config is to arrange something or change the controls on a computer or other device

so that it can be used in a particular way

Config.a should be a number

a = 0

Config.b should be a string

b = ""

Optional Config.c is a number

c = 0

Config.d is a list of number

d = [ 0, ]

Config.e should be a number

e = 7

Config.f should be a string

f = "seven"

Config.g should be a number

g = 7

Config.h should be a string

h = "seven"

```

Will do later

• nesting structure