https://github.com/rocher/mold

Meta-variable Operations for Lean Development
https://github.com/rocher/mold

ada alire-crate template template-engine template-project

Last synced: 5 months ago
JSON representation

Meta-variable Operations for Lean Development

• Host: GitHub
• URL: https://github.com/rocher/mold
• Owner: rocher
• License: mit
• Created: 2023-08-03T19:58:19.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2025-05-24T21:02:43.000Z (about 1 year ago)
• Last Synced: 2025-05-24T22:29:14.312Z (about 1 year ago)
• Topics: ada, alire-crate, template, template-engine, template-project
• Language: Ada
• Homepage: https://rocher.github.io/mold
• Size: 1.82 MB
• Stars: 6
• Watchers: 3
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Alire](https://img.shields.io/endpoint?url=https://alire.ada.dev/badges/mold.json)](https://alire.ada.dev/crates/mold.html)

[![Alire CI/CD](https://img.shields.io/endpoint?url=https://alire-crate-ci.ada.dev/badges/mold.json)](https://alire-crate-ci.ada.dev/crates/mold.html)

[![GitHub release](https://img.shields.io/github/release/rocher/mold.svg)](https://github.com/rocher/mold/releases/latest)

[![License](https://img.shields.io/github/license/rocher/mold.svg?color=blue)](https://github.com/rocher/mold/blob/master/LICENSE)



## Welcome to **Mold**

> **MOLD**: *Meta-variable Operations for Lean Development*

Mold is a Template Processor, or Template Engine, to work with repository

templates. The main motivation of Mold is to have repositories in GitHub used

as template repositories to create new, customized repositories for other

users.

Mold is the CLI wrapper of the [mold_lib](https://github.com/rocher/mold_lib),

the Ada library that implements all Mold functionality.

Main features supported in Mold include

  * variable replacement in mold files (*.mold)

  * definition of variables with a simple TOML file

  * for a given directory, variable replacement recursively for all mold files

    in all subdirectories

  * variable replacement in filenames

  * variables in variables

  * predefined text filters (and custom text filters)

  * inclusion of other templates

Variable replacement can be specified as *normal*, *optional* or *mandatory*.

For example, the variable `foo = "bar"` can be specified with `{{foo}}`,

`{{?foo}}` (optional) or `{{#foo}}` (mandatory). The difference is the handling

of errors when an undefined variable is encountered.

All mold files must end with the extension `.mold`, for example

`README.md.mold`. Destination files (with variables replaced) have the same

name without the mold extension: `README.md`. This simplifies the work done in

large subdirectories with few templates.

This crate contains the Ada library and unit tests. For a CLI tool, please

take a look at the crate `mold`.

## Reference Guide

Please visit [Mold documentation](https://rocher.github.io/mold) for more

information.

---

## License

MIT (c) 2023-2025 Francesc Rocher