Crate atelier_describe

This crate provides two mechanisms for generating human-readable documentation for a Smithy model using the crate somedoc.

Firstly, the DocumentationWriter structure implements the ModelWriter trait and so may be used in the same manner as other model writers. The ModelWriter::new function takes an argument that will denote the format to produce, but provides little other control over the generation. Internally this writer implementation calls the following function.

The function describe_model will produce a Document instance from a Model. This instance may then be rendered according to the writers provided by somedoc. This provides complete control over the actual formatting step and the same generated Document may be written multiple times if required.

Examples

The following demonstrates how to use the describe_model function.

use atelier_core::model::Model;
use atelier_describe::describe_model;
use somedoc::write::{write_document_to_string, OutputFormat};

let model = make_model();
let documentation = describe_model(&model).unwrap();

let doc_string = write_document_to_string(&documentation, OutputFormat::Html).unwrap();

The following example demonstrates the ModelWriter trait and outputs the documentation to stdout.

use atelier_core::model::Model;
use atelier_core::io::ModelWriter;
use atelier_describe::{describe_model, DocumentationWriter};
use somedoc::write::{write_document_to_string, OutputFormat};
use std::io::stdout;

let model = make_model();
let mut writer = DocumentationWriter::new(OutputFormat::Html);
let documentation = writer.write(&mut stdout(), &model).unwrap();

Structs

DocumentationWriter

A ModelWriter for creating documentation of a model instance.

Functions

describe_model

Create a Document instance describing the Model provided. This can then be rendered using the somedoc write_document or write_document_to_string functions.