p - bash project manager
P(1) User Commands P(1)
NAME
p - project manager
SYNOPSIS
p [create] project-name
p menu
AVAILABILITY
bash
DESCRIPTION
Utility for your shell that lets you easily step to project directories while
loading a project-specific profile into your shell.
You can use a user-wide profile ('pfile') and/or project specific profiles.
OPTIONS
−s step to the project directory in a subshell.
EXAMPLES
p foo open project foo
p -s foo open project foo in subshell
p create bar create and open project bar in current directory
p create create project at current directory named as current folder
EXPERIMENTAL FEATURES
p global <projectname> sources the projects p-file in the current shell with the first parameter as "global".
Used to load a project's features to the global shell environment. E.g. add 'p global myproject' to your init script.
p runin <projectname> <cmd> runs cmd in projectname's folder. The pfile is not used!
p runall <cmd> runs cmd in all projects folder's. The pfile is not used!
NOTES
Automatic installation:
bash <(curl -s https://raw.githubusercontent.com/hhallman/p/master/p-projectmanager-install.sh)
Manual installation:
Put something like this in your $HOME/.bashrc or $HOME/.zshrc:
. /path/to/p.sh
create some projects and enjoy!
Optionally:
Set $_P_CMD to change the command name (default p).
(These settings should go in .bashrc/.zshrc before the lines added
above.)
Install the provided man page p.1 somewhere like /usr/local/man/man1.
Tab Completion:
p supports tab completion. After typing the p command, press TAB to
complete project names that match (optionally) written project names.
Project menu:
The project menu might be handy. To get a project-greeting in new shells, type
$ p menu.
It may be handy to get the project-menu in new shells:
$ echo 'p menu' >> ~/.bash_profile
PFILES
When opening a project, p will source global and local 'pfiles',
~/.pfile.sh and ./.pfile.sh with arguments "enter" "project-name" "project-directory".
If the project is loaded in subshell, the pfiles will be sourced with "leave"
instead of "enter" when the shell exits.
Example of global pfile:
[ "$1" == "enter" ] && [ -d .git ] && echo "git status" && git status;
[ "$1" == "enter" ] && [ -d .svn ] && echo "svn status" && svn status;
ENVIRONMENT
A function _p() is defined.
The contents of the variable $_P_CMD is aliased to _p. If not set,
$_P_CMD defaults to p.
To set the subshell behavior as default, set variable _p_subshell=true
FILES
Data is stored in $HOME/.p. This can be overridden by setting the
$_P_DATA environment variable.
A man page (p.1) is provided.
SEE ALSO
z(1), pushd, popd,
Please file bugs at https://github.com/hhallman/p/
This project has been inspired by the z bash extension by "Rupa".
Please use it, z is awesome! https://github.com/rupa/z
p December 2012 P(1)