modman (Module Manager)
Developing extensions for software that doesn't allow you to separate your files from core files, and keeping that extension under version control and making it easy to deploy is now much, much easier. Development of this script was inspired by Magento which forces you to mix your extension files all throughout the core code directories. With modman, you can specify in a text file where you want your directories and files to be mapped to, and it will maintain symlinks for you so that your code is easy to hack and deploy.
All of your cloned/checked-out modules will be kept in a directory named
.modman in the location where you run
- Linux/Unix or OSX (not cygwin, see Windows Users below)
- Common utilities available in your PATH: grep (POSIX), find, ln, cp, basename, dirname
- Web server must follow symlinks
- git and/or subversion are optional (not required for "deploy" command)
- For Magento, if using template files in a modman module, you must enable "Allow Symlinks" (found under System > Configuration > Advanced > Developer)
NOTE: There is no additional security risk to allowing symlinks, despite the warning which says otherwise...
Windows (including cygwin) is not supported by this script, but there is a PHP-port of modman which works on Windows. I am not affiliated with the authors and do not provide support for the PHP port, only a link here for reference.
bash < <(wget -q --no-check-certificate -O - https://raw.github.com/colinmollenhour/modman/master/modman-installer)
bash < <(curl -s -L https://raw.github.com/colinmollenhour/modman/master/modman-installer)
Note: modman is simply a bash script, so to use it you just need to place it in your $PATH and change its mode to executable.
modman --help to get the basic usage summary or
modman --tutorial to
see a brief tutorial. For more in-depth information please see the
Version Control Systems
Modman currently supports subversion and git. Other VCSs could be used by manually checking out the source code into the proper directory and using the "deploy" command.
Copyright 2009 Colin Mollenhour
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.