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 claco@chrislaco.com http://today.icantfocus.com/blog/