toml-example 0.1.0

A lib help generate toml example
Documentation

Struct Patch

Crates.io MIT licensed Docs

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

Quick Example

use toml_example::TomlExample;

#[derive(TomlExample)]
struct Config {
    /// Config.a should be a number
    a: usize,
    /// Config.b should be a string
    b: String,
}
let doc = Config::toml_example();

// doc is String toml example base on the docstring

// # Config.a should be a number
// a = 0
// # Config.b should be a string
// b = ""

Will do later

  • handle Option
  • handle Vec
  • use structure doc for example header
  • optional the example header
  • nestring structure
  • function to write example file, to_toml_example(file_name)