NAME
    Catalyst::Model::SVN - Catalyst Model to browse Subversion repositories

SYNOPSIS
        # Model
        __PACKAGE__->config(
            repository => '/path/to/svn/root/or/path',
            revision   => 'HEAD,
        );

        # Controller
        sub default : Private {
            my ($self, $c) = @_;
            my $path = join('/', $c->req->args);
            my $revision = $c->req->param('revision') || 'HEAD';

            $c->stash->{'repository_revision'} = MyApp::M::SVN->revision;
            $c->stash->{'items'} = MyApp::M::SVN->ls($path, $revision);

            $c->stash->{'template'} = 'blog.tt';
        };

DESCRIPTION
    This model class uses the perl-subversion bindings to access a
    Subversion repository and list items and view their contents. It is
    currently only a read-only client but may expand to be a fill fledged
    client at a later time.

CONFIG
    The following configuration options are available:

  repository
    This is the full path to the root of, or any directory in your
    Subversion repository. This can be one of http://, svn://, or file:///
    schemes.

  revision
    This is the default revision to use when no revision is specified. By
    default, this will be "HEAD".

METHODS
  cat($path [, $revision])
    Returns the contents of the path specified. If "path" is a copy, the
    logs are transversed to find original. The request is then reissued for
    the original path for the "revision" specified.

  ls($path [, $revision])
    Returns a array of "Catalyst::Model::SVN::Item" objects in list context,
    each representing an entry in the specified repository path. In scalar
    context, it returns an array reference. If "path" is a copy, the logs
    are transversed to find the original. The request is then reissued for
    the original path for the "revision" specified.

    Each "Catalyst::Model::SVN::Item" object has the following methods:

    author
        The author of the latest revision of the current item.

    contents
        The contents of the of the current item. This is the same as calling
        "Catalyst::Model::SVN-"cat($item->uri, $item->revision)

    is_directory
        Returns 1 if the current item is a directory; 0 otherwise.

    is_file
        Returns 1 if the current item is a file; 0 otherwise.

    kind
        Returns the kind of the current item. See SVN::Core for the possible
        types, usually $SVN::Node::path or $SVN::Node::file.

    log Returns the last log entry for the current item. Be forewarned, this
        makes an extra call to the repository, which is slow. Only use this
        if you are listing a single item, and not when looping through large
        collections of items. If the current item is a copy, the logs are
        transversed to find the original. The request is then reissued for
        the original path for the "revision" specified.

    name
        Returns the name of the current item.

    path
        Returns the path of the current item relative to the repository
        root.

    revision
        Returns the revision of the current item.

    size
        Returns the raw file size in bytes for the current item.

    time
        Returns the last modified time of the current item as a DateTime
        object.

    uri Returns the full repository path of the current item.

  repository
    Returns the repository specified in the configuration "repository"
    option.

  revision
    Returns the latest revisions of the repository you are connected to.

SEE ALSO
    Catalyst::Manual, Catalyst::Helper, SVN::Client, SVN::Ra

AUTHOR
        Christopher H. Laco
        CPAN ID: CLACO
        claco@chrislaco.com
        http://today.icantfocus.com/blog/
