Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

122 lines (71 sloc) 3.07 kb
git-cola: a highly caffeinated git gui
Cola is a sweet, carbonated git gui known for its
sugary flavour and caffeine-inspired features.
Copyright (C) 2008 David Aguilar
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
REQUIREMENTS
Python 2.4 or newer
http://python.org/
PyQt 4.3 or newer
http://www.riverbankcomputing.co.uk/software/pyqt/intro
simplejson
http://pypi.python.org/pypi/simplejson
ACKNOWLEDGEMENTS
git-cola includes a copy of the GitPython module:
http://gitorious.org/projects/git-python/
INSTALLATION
Debian and RPM users can download freshly built binaries here:
http://cola.tuxfamily.org/
sudo dpkg -i cola_*.deb
sudo rpm -ivh cola-*.rpm
If you downloaded a tarball, make sure /path/to/cola/bin is in your $PATH.
HOW TO RUN
Take your pick--any of the following incantations work from the command line:
git cola
git-cola
cola
Launching cola on repositories outside your $CWD:
git cola /repo/path-1 /repo/path-2 .. /repo/path-N
BUILDING FROM SOURCE
You will need the PyQt development tools (v4.3 or greater):
Synopsis:
sudo apt-get install pyqt4-dev-tools
git clone git://gitorious.org/git-cola/mainline.git cola
cd cola
./configure --prefix=/usr
make
sudo make install
WINDOWS INSTALLATION
1) Install the native Python2.5 and PyQt4 installers (in that order):
http://python.org/download/
http://www.riverbankcomputing.co.uk/pyqt/download.php
3) Install msysgit:
http://git.or.cz/gitwiki/WindowsInstall
4) Install the GnuWin32 'file' command:
http://gnuwin32.sourceforge.net/packages/file.htm
Add the installed directory (default: c:\GnuWin32\bin) to your path.
5) Install simplejson
http://pypi.python.org/pypi/simplejson
6) Download cola:
http://cola.tuxfamily.org/releases/
7) Install cola (from a Git Bash):
cd /c/Python25/Lib/site-packages
tar xvfz /path/to/cola-win32-*.tar.gz
mv cola-win32-* cola
8) Create an executable in your path for bash, cmd.exe, or both:
echo '/c/Python25/python.exe /c/Python25/Lib/site-packages/cola/bin/git-cola' >> /usr/bin/cola
echo 'c:\\Python25\\python.exe c:\\Python25\\Lib\\site-packages\\bin\\git-cola' > /c/Windows/System32/cola.bat
This assumes the you have Python/PyQt4 installed in C:/Python25.
If this is not the case simply edit the commands accordingly.
voila, cola on Windows.
NOTE: Windows is not the developer's primary platform.
Patches are greatly appreciated.
Jump to Line
Something went wrong with that request. Please try again.