A powerful cross-platform CLI project templating tool.
- Creates project directories of any size in seconds
- Project templates are based on individual config files
- Structure of GitHub/GitLab repos can be imported to project configs
- Structure of directories can be imported to project configs
- Infinitely extendable through integration of custom shell scripts
- Supports custom template files
- Shareable project configs
- Projects are not bound to any language or framework
- Boosts your productivity and simplifies your workflow
- Works on Windows, macOS and Linux
Quick comparison between proji and a common way of project creation. In the demo we create a python project which consists of three folders and two files. We create a virtualenv, install three python packages, initialize the project as a git repo and finally make the first commit and add a develop branch.
Proji:
Common Way:
As you can see proji would have saved you about 1:15 minutes and 230 keystrokes. Note that in this example only a very small project is created. The advantages of proji increase exponentially with increasing project complexity.
You can easily import the structure of your favorite projects from GitHub and GitLab as proji classes.
Proji is cross-platform and runs on Linux, MacOS and Windows.
Important: After the installation process has successfully completed, you must run 'proji init' once. This initializes proji's main configuration folder and is mandatory.
Install the correct binary for your operating system and architecture in ./bin with a single command:
curl -sfL https://git.io/proji | sh
yay -S proji
brew install nikoksr/taps/proji
scoop bucket add nikoksr https://github.com/nikoksr/scoop-bucket
scoop install proji
Note: The
masterbranch may be in an unstable or even broken state during development. Please use releases instead of themasterbranch in order to get stable binaries.
go get -u github.com/nikoksr/proji
cd $GOPATH/src/github.com/nikoksr/proji
go install ./cmd/proji
Validate the success of your installation by executing proji version.
go vet ./...
go test -v ./...
Note: Export the environment variable
PROJI_SKIP_NETWORK_TESTS=1if you want to skip internet-dependent tests.
Proji does support tab completion under bash and zsh but at the moment you have to set it up yourself. The following instructions were inspired by kubernetes completion.
For tab-completion under bash you first need to install and enable bash_completion.
You now need to ensure that the proji completion script gets sourced in all your shell sessions.
# Create the completion file
proji completion bash > $HOME/.config/proji/completion.bash.inc
# Make your bash_profile source it
printf "
# Proji shell completion
source '$HOME/.config/proji/completion.bash.inc'
" >> $HOME/.bash_profile
# Source it once for immediate completion
source $HOME/.bash_profile
This command will create a zsh completion file in your current users default zsh completion folder:
proji completion zsh > "${fpath[1]}/_proji"
Suppose I create python projects on a regular basis and want to have the same directory structure for each of these projects. I would therefore have to execute every command necessary to create the appropriate directories and files and would then have to run tools like git and virtualenv to fully get my usual development environment up and running.
That would not be too bad if you only create a new project every few weeks or months. However, if you want to create new projects more regularly, be it to test something quickly, learn something new, or quickly create an environment to reproduce and potentially solve a problem found on stackoverflow, then this process quickly becomes very tiring.
To solve this problem with proji, we first have to create a so-called class. A class in proji defines the structure and behavior for projects of a particular topic (python in this example). It serves as a template through which proji will create new projects for you in the future. This class will determine which directories and files we always want to get created by proji and which scripts proji should execute. For example a script which automatically initializes git in the project, creates a develop branch and makes a first commit.
Note that folders and files can either be created new and empty or be copied from a so-called template. In the config folder you can find the template folder (~/.config/proji/templates/) in which you can store folders and files that you want to use as templates. In our example we could put a python file into this folder. The file could contain a very basic python script something like a 'hello world' program. We can tell proji to always copy this file into our newly created python projects. The same goes for folders. The goal of the templates is to save you even more time.
In addition, we can assign scripts to a proji class which will be executed in a desired and defined order. Scripts must be saved under ~/.config/proji/scripts/ and can then be referenced by name in the class config.
A collection of example configs can be found here.
- Name: A name that describes the topic of the class (e.g.
python) - Label: A label that serves as an abbreviation for easily calling the class (e.g.
py) - Folders: A list of folders to be created
- Files: A list of files to be created
- Scripts: A list of scripts to run after the project directory has been created
There are four ways to create a new class:
Proji offers the possibility to export and import classes through config files. The easiest way to create a new class would be to export the proji sample config and then adapt it to your needs. To do so, execute the command proji class export --example.
Proji creates the file proji-class-example.toml in the current working directory. If you open this file in a text editor, you will find a richly annotated configuration of an example class. This config should then be adapted according to your needs.
Once the config has been edited and saved, it can be imported using the proji class import --config proji-class-example.toml (or whatever you named the file) command. Proji then creates a new class based on the imported config.
Proji can import the structure of a local directory as a class. It will analyze the directory and create a class config based on all sub-directories and files.
To do so, first create the config with proji class import --directory path/to/dir. Then edit the resulting config as needed in your editor of choice. For example, remove folders and files that you do not want to add to your class, or add files, folders, and scripts that are missing. When you are done, import the configuration as seen above with proji class import --config proji-dir.toml.
Similar behaviour as the directory example but instead of importing the structure of a local directory you can import the structure of a remote repository. Currently tested and supported code hosting platforms are github and gitlab.
As an example, let's create a class based on this repository. First, run the command proji class import --remote-repo https://github.com/nikoksr/proji. Similar to the directory flag this will export a class config based on the remote repository. You can then edit the config to your liking and needs and import it afterwards with proji class import --config proji-proji.toml.
The third option is to use the proji class add CLASS-NAME [CLASS-NAME...] command to create one or more classes in an interactive CLI. Proji will query the necessary data for the new class from you and then create the new class based on that data.
The advantage of the config file is that incorrect information can easily be corrected. For example, if you entered a script that does not exist or whose name was simply misspelled, you can easily change the name in the configuration file. This is not possible in the CLI menu. If the entry is incorrect, the creation process must be restarted.
After the class has been created or imported, we can use the command proji class ls to display a list of our available classes. The command proji class show LABEL [LABEL...] allows us to display a detailed view of one or more classes.
Now that we have created our python class in proji, we can use it to easily create new projects. A class is created once and is then reused by proji over and over again, and although the process of creating a class might initially seem a bit complex, you will very soon start saving a lot of time and keystrokes and will improve the general consistency of your projects structures.
Assuming our class has been assigned the label py, we will create three projects with the command proji create py my-py-project-1 my-py-project-2 my-py-project-3.
And voila, proji has created three new project directories where you can start your work immediately. The project directories are all built identically, have the same subdirectories and files, and all ran the same scripts.
Take a look at the python class config, the git and virtualenv scripts that were used in this example.
Help for all commands is also available with proji help.
-
Add a class:
proji class add NAME -
Remove one or more classes:
proji class rm LABEL [LABEL...] -
Import one or more classes from configs:
proji class import --config FILE [--config FILE...] -
Import one or more classes from directories:
proji class import --directory DIR [--directory DIR...] -
Import one or more classes from remote repositories:
proji class import --remote-repo URL [--remote-repo URL...] -
Export one or more classes:
proji class export LABEL [LABEL...] -
List all classes:
proji class ls -
Show details of one or more classes:
proji class show LABEL [LABEL...]
-
Create one or more projects:
proji create LABEL NAME [NAME...] -
Add a project:
proji add LABEL PATH STATUS -
Remove one or more projects:
proji rm ID [ID...] -
Set new project path:
proji set path PATH PROJECT-ID -
Set new project status:
proji set status STATUS PROJECT-ID -
List all projects:
proji ls -
Clean up project database:
proji clean
-
Add one or more statuses:
proji status add STATUS [STATUS...] -
Remove one or more statuses:
proji status rm ID [ID...] -
List all statuses:
proji status ls
Contributions to the project are highly appreciated. Take a look at the code of conduct and at the contribution instructions and you should be good to go.
-
Logo by Alex Potterson
-
AUR Maintainer Scrumplex
Proji is released under the MIT license. See LICENSE