Project Init (pi)

pi is a command-line utility to initialize projects. It is written in rust.

It is intended to provide something like cookiecutter, but faster.

Reasons to use pi:

• You want to automate the process of starting a new project, for all your projects.
• You want project initialization that's quick

Reasons to use pi over cookiecutter:

• Templates are smaller. Define files you need in a .toml.
• Fast. pi is 30x faster than cookiecutter when rendering the sample vim plugin template.
• pi uses mustache, a logic-less language, for templates.
• pi can initialize a darcs, pijul, mercurial, or git repository inside your projects
• pi provides opinionated templates for many languages
• pi is extensible in Rust

Reasons to not use pi over cookiecutter:

• cookiecutter uses jinja templates, which are far more sophisticated.
• pi is newer and presumably more buggy
• cookiecutter is extensible in Python

Benchmarks (with Haskell's bench):

Tool	Language	Time (vim example plugin)	Time (rust library)
pi init	rust	10.10 ms	8.809 ms
pi new	rust	6.672 ms	8.653 ms
cookiecutter	python	317.1 ms	316.9 ms

Installation

Cargo

First, install cargo. Then:

 $ cargo install --git https://github.com/legion-labs/project-init

Use

First, you can initialize a global $HOME/.pi.toml configuration file using

$ pi init

pi reads from $HOME/.pi_templates/ and your current directory. So, if you place a template in the $HOME/.pi_templates/rust-cli/, you can initialize a project anywhere with

 $ pi new rust-cli my-awesome-cli

Or to fetch a template from github:

 $ pi git vmchale/haskell-ats ambitious-insane-project

Examples

• haskell-ats - a template for Haskell/ATS polyglot projects.
• madlang-miso - a template for frontend using Miso and Madlang.
• ats-makefile - a template for ATS projects that uses a plain Makefile.

Configuration

Global configuration is via the $HOME/.pi.toml file. The following is an example:

license = "BSD3"         # set default license to BSD3
version_control = "git"  # initialize new repositories with git
version = "0.1.0"        # start new projects at version 0.1.0

[author]
name = "Vanessa McHale"
email = "[email protected]"
github_username = "vmchale"

# put any custom keys you want under a [[custom_keys]] table
[[custom_keys]]
website = "https://vmchale.com"

Project-specific config lives in $PROJECT_NAME/template.toml. The following is an example for a vim plugin:

license = "BSD3"        # overrides global value if set
with_readme = true      # add README.md

[files]
files = ["syntax/{{ project }}.vim","plugin/{{ project }}.vim","doc/{{ project }}.txt"] # blank files
directories = ["doc","syntax","plugin"]
templates = ["vimball.txt"] # files to be processed

[config]
version = "0.1.0"
version_control = "darcs"

# put any custom keys you want below [[custom_keys]]
[[custom_keys]]
vim_org_username = "vmchale"

This will generate the following directory structure:

vim-plugin
├── LICENSE
├── README.md
├── doc
│  └── vim-plugin.txt
├── plugin
│  └── vim-plugin.vim
├── syntax
│  └── vim-plugin.vim
└── vimball.txt

For a more in-depth example, see here. This is a template based off the recursion schemes generator.

Templates

pi uses mustache for templating, via the rustache crate.

You can find examples and help on the mustache page, or you can my look at the example repo.