Metadata-Version: 2.0
Name: svn
Version: 0.3.21
Summary: Intuitive Subversion wrapper.
Home-page: https://github.com/dsoprea/PySvn
Author: Dustin Oprea
Author-email: myselfasunder@gmail.com
License: GPL 2
Keywords: svn subversion
Platform: UNKNOWN
Requires-Dist: python-dateutil (==2.2)
Requires-Dist: six (==1.7.2)

------------
Introduction
------------

*svn* is a simple Subversion library for Python. I wrote it so that there could be a lightweight and accessible library that was also available on *PyPI*. It is compatible with both Python 2.7 and 3.3+.

I've only implemented the functionality that I have required:

- Listing entries
- Getting info
- Getting log
- Checking-out
- Exporting

**You are more than welcome to submit pull-requests to add more support for additional subcommands.**


-----
Usage
-----

Usage is divided between two clients that either allow for access to a local working-directory or a remote repository.

Both clients inherit a common set of methods that work with both local working-directories and remote repositories.


LocalClient
===========

*LocalClient* allows access to a local working copy.

Example *LocalClient* usage::

    import svn.local
    import pprint

    r = svn.local.LocalClient('/dev/repo')
    r.export('/tmp/export')

    pprint.pprint(r.info())

Output::

    {'commit#revision': 0,
     'commit/author': None,
     'commit/date': datetime.datetime(2014, 4, 1, 5, 50, 27, 826988, tzinfo=tzutc()),
     'entry#kind': 'dir',
     'entry#path': 'working_copy',
     'entry#revision': 0,
     'relative_url': '^/',
     'repository/root': 'file:///svn/test/repo',
     'repository/uuid': '48195b71-8d94-4528-a019-ec81ebc7e65a',
     'url': 'file:///svn/test/repo',
     'wc-info/depth': 'infinity',
     'wc-info/schedule': 'normal',
     'wc-info/wcroot-abspath': '/svn/dev/working_copy'}


RemoteClient
============

*RemoteClient* allows access to a remote repository.

- checkout(path)

Example *RemoteClient* usage::

    import svn.remote

    r = svn.remote.RemoteClient('https://repo.local/svn')
    r.checkout('/tmp/working')


Common Functionality
====================

These methods are available on both clients.

- info()
- export(path)
- cat(rel_filepath)
- log_default(timestamp_from_dt=None, timestamp_to_dt=None, limit=None)


Important
=========

Previously, the *LocalClient* and *RemoteClient* classes were exposed at the 
package level:

- svn.LocalClient
- svn.RemoteClient

Unfortunately, this interfered with dependency management during installation.
The imports will now have to be, respectively:

- svn.local (for LocalClient)
- svn.remote (for RemoteClient)

We're sorry for the inconvenience.


