NAME
Catalyst::Model::SVN - Catalyst Model to browse Subversion repositories
SYNOPSIS
# Model
__PACKAGE__->config(
repository => '/path/to/svn/root/or/path'
);
# 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
[email protected]
http://today.icantfocus.com/blog/
