Skip to content
This repository
Fetching contributors…

Cannot retrieve contributors at this time

file 121 lines (71 sloc) 3.07 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121
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.
Something went wrong with that request. Please try again.