2 releases

0.3.2 Jul 21, 2020
0.3.1 Jul 10, 2020

#1517 in Development tools

MIT license

33KB
717 lines

rendr

A project scaffolding tool

MIT License GitHub release User Guide

Check out the User Guide for the full documentation.

This project is currently under heavy development. The API is expected to change before reaching a 1.0.0 release. That said, it is functional and useful already! Try it out and provide any feedback you have by opening an issue.

Features

rendr is a scaffolding tool which allows generating entire projects (or anything else) from blueprints, using standard templating engines and simple customization via parameters. It is generic enough to apply to a wide variety of applications and tech stacks, but powerful and flexible enough to provide value, fast. The tool itself is really a generic template renderer. It's up to you, the template creator, to decide what to put in your template.

Use cases

Here are just a few possible use cases:

  • Enable rapid spin-up of new projects, complete with CI/CD pipelines, code quality gates, security analysis, and more
  • Ship "Hello, World!" projects immediately to production, enabling instant iteration on features
  • Include CI/CD standards baked into projects from the start, easily kept up to date
  • Simplify repeated patterns like creating new microservices, libraries, or submodules on an existing project

Installation

Homebrew

To install the latest release:

brew install jamf/tap/rendr

Cargo (from source)

Again, the latest release can be installed with:

cargo install rendr

Binaries for Linux and macOS

Alternatively, you can download the CLI binary directly from the Releases page and put it on your system path.

Usage

More detailed usage can be found in the User Guide.

View available commands:

 rendr help

The basic usage to generate a project looks like this:

rendr init my-project --blueprint https://github.com/your/template

Provide values to the template with the -v flag:

rendr init my-project -b https://github.com/your/template -v name:foo -v version:1.0.0

Contributing

Feedback and pull requests are welcome! Let us know if you have issues using the tool, or see use cases that are not yet supported. We'd love to expand its usefulness!

Dependencies

~15–28MB
~514K SLoC