Skip to content

A small CLI for quickly creating and using templates

Notifications You must be signed in to change notification settings

HyperCodec/cltemplate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CLTemplate

github crates.io

Small commandline tool to create and use templates quickly

Installation

Simply run cargo install cltemplate to install the tool.

Using Templates

To use a template, do the following:

  1. CD into the folder of the template (your terminal should be running at path/to/template)
  2. Run template path/to/output and check the directory you provided

Optionally, you can use the --template-path param instead of CDing to the the template folder

Writing Templates

To write a template that others can use with this tool, you must:

  1. Create a folder for the template

  2. In the root directory of the folder, create a template.txt file. In this file, there should be the name of each replaceable item, separated by newlines (ex:

    foo
    bar
    buz
    qux
    quux
    corge
    grault
    garply
    waldo
    fred
    plugh
    xyzzy
    thud
    

    )

  3. Fill in the rest of the folder with the files provided in the template. Anything defined in template.txt that has % around it (ex: %foo%) will be replaced by whatever the user inputs. Anything surrounded by % that is not included in template.txt will remain unchanged.

  4. Share your template and usage instructions via your preferred method.

License

This tool is licensed under the MIT license.

Roadmap