Crate rustme[−][src]
Expand description
Generate your Rust project’s README-like files.
RustMe generates files by concatenating multiple sections into a new file. It has specific features that are useful for Rust projects:
- Rust-annotated markdown code blocks are processed to remove lines that start
with
#, making the blocks render the same as when used with#![doc = include_str!("...)]. This crate uses this functionality with the code snippet below. - Include snippets from other files. Annotate a file with special comments, and
import them. The “basic” example demonstrates this functionality.
- Snippets are automatically trimmed to remove equal whitespace at the beginning of each line.
- Include sections that are remote URLs.
- We manage a lot of repositories, and wanted to standardize specific sections of our README files across all repositories. This README’s footer is loaded from another repository.
- This can also be used to include standard files. We use that with our repositories to pull standardized files, such as licenses, from a central repository.
rustme command line interface
To install, simply run cargo install rustme.
Currently rustme ignores all command line arguments. It looks for a
Ron-formatted Configuration located in either
./rustme.ron or ./.rustme/config.ron, and generates the files relative to
the configuration file.
rustme as a library
let config = rustme::Configuration::load("examples/basic/.rustme.ron").unwrap();
config.generate(false).unwrap();Structs
A cache for loading snippets and glossaries.
A configuration of how to generate one or more READMEs.
A RustMe file configuration.
Enums
All errors that rustme can return.
A configuration for a File.
A mapping of replacements that can be used within the files using $name$
syntax.
Functions
Generates all RustMe configurations found within the current directory.
Generates all RustMe configurations found within directory.