Skip to main content

Poor man's yo generator.

Project description

Quick project generation.


pip install arst

Creating a new project

Two shortcuts are installed: ars, and arst. These keys are consecutive if you’re using a Colemak keyboard layout.

ars generate project-type

or if a project is already created, and we want to reaply the templates, but with a tree diff for all the conflicting files. This will use the program specified in the ARS_DIFF_TOOL or in case the variable is not defined vimdiff:

arst generate project-type

This copies all the resources from the ~/.projects/project-type into the current folder. Files that have the .hbs extension will be used as templates, and copied with the extension removed.

The project type is sent as NAME into the handlebars templates.

Thus if you have a structure such as:

├── package.json.hbs
└── static
    └── index.html

After the ars project-type command you will have in your current folder:

├── package.json
└── static
    └── index.html

The package.json file will be parsed as expected.

If the file name from the project ends with .KEEP on subsequent calls from the same folder, it won’t be overwritten.


Parameters can be also passed to the templates themselves. In case a parameter does not have a value, true will be set instead.

ars generate package-type name1=value name2 name3=3

This will generate a package-type project with the following parameters sent into the handlebars template:

    "templates" : ["package-type"],
    "name1" : "value",
    "name2" : true,
    "name3" : "3",
    "arg0": "name1",
    "arg1": "name2",
    "arg2": "name3"

Since the templating also happens to the file names themselves, so a file named {{name1}}.txt will be installed as value.txt. This is particularly useful in conjunction with the positional argument names, making possible scenarios such as:

ars generate new-model User

If in our project we have: {{arg0}}.html.hbs and {{arg0}}.js.hbs, they will be expanded as: User.html and User.js.

Extra Commands

Command Description
diff Diff a file against the template
edit Edit a file from the project
generate Generate or update the project sources
lls List a folder from the project
ls List the project folder
push Push a file into the template
pwd Display the project location
tree Display the project tree
version Print the current application version

Table: Extra Commands


If you store your project files into a different folder, you can use the ARS_PROJECTS_FOLDER environment variable to point to the absolute path of it.

Implicitly when creating a new project, an .ars file will be created with the current settings, so if the project is changed, you can reaplly your project template. If you want not to have this file created, just add a .noars file in the project template.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for arst, version 1.3.0
Filename, size File type Python version Upload date Hashes
Filename, size arst-1.3.0.tar.gz (11.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page