Metadata-Version: 1.0
Name: gitserve
Version: 0.2.0
Summary: A helper tool for git that mimics mercurial's serve command
Home-page: http://github.com/jezdez/git-serve/
Author: Jannis Leidel
Author-email: jannis@leidel.info
License: GPL-2
Description: ========
        gitserve
        ========
        
        This is a helper tool for git that mimics mercurial_'s serve_ command.
        
        It makes it very easy to see all your git project via git_'s own gitweb_ by
        running a lightweight local server.
        
        .. _mercurial: http://www.selenic.com/mercurial/
        .. _serve: http://www.selenic.com/mercurial/wiki/index.cgi/hgserve
        .. _git: http://git.or.cz/
        .. _gitweb: http://git.or.cz/gitwiki/Gitweb
        
        Usage
        -----
        
        When ``gitserve`` was installed correctly (with ``sudo``) it's usually located
        in ``/usr/local/bin``. Note that this directory needs to be on your ``$PATH``
        environment variable to be found by your shell.
        
        Usage pretty easy::
        
        $ gitserve --help
        Usage: gitserve [options] <dir>
        
        Options:
        --version             show program's version number and exit
        -h, --help            show this help message and exit
        -v, --verbose         print status messages to stdout
        -q, --quiet           don't print anything to stdout
        -p PORT, --port=PORT  port to listen on (default: 8000)
        -a ADDRESS, --address=ADDRESS
        address to listen on (default: hostname)
        -l, --local           only listen on 127.0.0.1
        -b, --browser         open default browser automatically
        -d, --daemon          detach from terminal and become a daemon
        --pid-file=PIDFILE    write the spawned process-id to this file
        --gitweb=GITWEB       use this gitweb cgi file instead of the included
        version
        
        As the only argument you can specify a directory that contains your git
        projects. If you leave this argument blank ``gitserve`` will automatically uses
        the current directory as the source for the gitweb script. E.g.::
        
        $ gitserve /home/jannis/git-projects
        
        Shortcuts in the directory argument are also possible and will be expanded on
        runtime::
        
        $ gitserve ~/git-projects
        
        The default ``gitserve`` process will listen on your machine's hostname and on
        port 8000, for example: http://127.0.0.1:8000/
        
        If you provide a ``--port`` or ``--address`` option while starting ``gitserve``
        you can have ``gitserve`` listen on your choices. You need to be root to run
        it on port 80 or any other port below 1024. The ``--local`` option tells
        ``gitserve`` to listen only on ``127.0.0.1``.
        
        The ``--browser`` option tells ``gitserve`` to automatically start your system's
        default web browser with the URL of the ``gitserve`` server while starting it.
        
        The ``--daemon`` option causes the whole ``gitserve`` process to detach from
        your current shell session, becoming a daemon process that runs in background.
        This is very useful in combination with the ``--pid-file`` option that write
        the process id in the given file.
        
        You can specify the location of the gitweb.cgi file that ``gitserve`` uses
        with the ``--gitweb`` option (e.g. /home/jannis/lib/git/gitweb.cgi).
        
Keywords: git dvcs mercurial serve cgi
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Version Control
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
