===
gsc
===

:Author: Nathan R. Yergler <nathan@yergler.net>
:Copyright: 
   2009, Nathan R. Yergler;
   licensed to the public under a `BSD license 
   <http://opensource.org/licenses/bsd-license.php>`_.

.. contents::

*gsc* is a utility for cloning Subversion repositories in git,
including any ``svn:externals``.


Installation
============

*gsc* is written in Python and requires `setuptools`_.  With
``setuptools`` installed, you can checkout gsc and install it ::

  $ git clone git://gitorious.org/gsc/mainline.git
  $ cd mainline
  $ python setup.py install

`setuptools` will installing pyparsing_ and GitPython_ if needed.


Usage
=====

Running ``gsc`` with ``-h`` will display the usage information.

To clone a Subversion project and all of its history into a git
repository, run something like ::

  $ gsc http://example.org/svnroot/project/trunk

If you'd like to clone the complete project, including branches and
tags, specify the "standard" layout ::

  $ gsc -s http://example.org/svnroot/project

Note that the path specified does not include the ``trunk``
specifier.  

.. warning::

   ``gsc`` currently only supports the "standard" Subversion
   layout (trunk/tags/branches as sibling paths).

If you're not interested in the full project history, you can clone
the latest revision only ::

  $ gsc --no-history http://example.org/svnroot/project/trunk


.. _setuptools: http://pypi.python.org/pypi/setuptools
.. _pyparsing: http://pypi.python.org/pypi/pyparsing
.. _GitPython: http://pypi.python.org/pypi/GitPython