SvnLog 1.0.0

data/bin/svnlog

@@ -0,0 +1,3 @@
+require 'svnlog'
+
+Svn::Log::Application.new.run

data/lib/svnlog.rb

@@ -0,0 +1,221 @@
+$:.unshift File.dirname(__FILE__)
+
+require 'svnlog/log'
+require 'svnlog/index'
+
+require 'optparse'
+require 'time'
+
+module Svn
+  module Log
+
+    # The main program
+    class Application
+
+      def initialize(argv = ARGV)
+        @argv = argv
+      end
+
+      # Run the program
+      def run
+        begin
+          create_command(@argv).run
+        rescue
+          puts $!
+        end
+      end
+
+      # Creates the command
+      def create_command(argv)
+        command = nil
+        name = argv[0]
+        if name
+          command = Application.commands[name.downcase]
+        end
+        command ||= HelpCommand
+        command.new(argv)
+      end
+
+      # Returns a list of the available commands
+      def self.commands
+        commands = {}
+        Application.constants.each do |c|
+          if c =~ /(.+)Command/
+            commands[$1.downcase] = eval(c)
+          end
+        end
+        commands
+      end
+
+      # A command for displaying command usage
+      class HelpCommand
+
+        def initialize(argv)
+        end
+
+        def run
+          puts "Usage: svnlog <command> [options]"
+          puts
+          puts "Available commands are:"
+          for name in Application.commands.keys.sort
+            puts "  #{name}"
+          end
+          puts
+          puts "Type \"svnlog <command> --help\" for help on a specific command."
+        end
+      end
+
+      # A command for populating an index
+      class IndexCommand
+        
+        def initialize(argv)
+          parse_options(argv)
+        end
+
+        def parse_options(argv)
+          OptionParser.new do |opt|
+            opt.banner = <<END
+Populates an index with log entries from an SVN repository.
+
+Examples:
+  svnlog index -p C:\\MyIndex -r svn://server/repos/path/to/something
+  svnlog index -p C:\\MyIndex
+
+Usage: svnlog index [options]
+END
+            opt.on("-p", "--path <val>", "The path to the index") { |@path| }
+            opt.on("-r", "--repository-url <val>", "The url of the SVN repository") { |@repository_url| }
+            opt.parse!(argv)
+          end
+        end
+
+        def run
+          Index.new(@path, @repository_url).update
+        end
+      end
+
+      # A command for displaying information about an index
+      class InfoCommand
+        
+        def initialize(argv)
+          parse_options(argv)
+        end
+
+        def parse_options(argv)
+          OptionParser.new do |opt|
+            opt.banner = <<END
+Displays information about an index.
+
+Example:
+  svnlog info -p C:\\MyIndex
+
+Usage: svnlog info [options]
+END
+            opt.on("-p", "--path <val>", "The path to the index") { |@path| }
+            opt.parse!(argv)
+          end
+        end
+
+        def run
+          index = Index.new(@path)
+          return if index.size == 0
+          puts "Repository URL: #{index.repository_url}"
+          puts "Last Revision: #{index.last_revision}"
+        end
+      end
+
+      # A command for searching an index
+      class SearchCommand
+
+        def initialize(argv)
+          parse_options(argv)
+          @printer ||= SvnLogTextPrinter
+        end
+
+        def parse_options(argv)
+          OptionParser.new do |opt|
+            opt.banner = <<END
+Searches an index for log entries that match a query.
+
+Examples:
+  svnlog search -p C:\\MyIndex -q \"Fixed\"
+  svnlog search -p C:\\MyIndex -q \"Fixed\" --xml
+
+Usage: svnlog search [options]
+END
+            opt.on("-p", "--path <val>", "The path to the index") { |@path| }
+            opt.on("-q", "--query <val>", "The search query") { |@query| }
+            opt.on("-x", "--xml", "Output in XML") { @printer = SvnLogXmlPrinter }
+            opt.parse!(argv)
+          end
+        end
+
+        def run
+          entries = Index.new(@path).search(@query)
+          @printer.print entries
+        end
+
+        # Prints entries in the 'svn log' text format
+        class SvnLogTextPrinter
+
+          def self.print(entries)
+            print_entry_separator
+            for entry in entries
+              print_entry(entry)
+              print_entry_separator
+            end
+          end
+
+          private
+
+          def self.print_entry(entry)
+            puts "r#{entry[:revision]} | #{entry[:author]} | #{date(entry)} | #{line_count(entry)}"
+            puts
+            puts entry[:message]
+          end
+
+          def self.print_entry_separator
+            puts "-" * 72
+          end
+
+          def self.date(entry)
+            time = Time.parse(entry[:date]).localtime
+            time.strftime("%Y-%m-%d %H:%M:%S #{DateTime.parse(time.rfc822).zone} (%a, %d %B %Y)")
+          end
+
+          def self.line_count(entry)
+            line_count = entry[:message].count("\n") + 1
+            str = "#{line_count} line"
+            str += "s" if line_count > 1
+            str
+          end
+        end
+
+        # Prints entries in the 'svn log' xml format
+        class SvnLogXmlPrinter
+
+          def self.print(entries)
+            return unless entries.size > 0
+            puts "<?xml version=\"1.0\"?>"
+            puts "<log>"
+            for entry in entries
+              puts "<logentry revision=\"#{entry[:revision]}\">"
+              puts "<author>#{entry[:author]}</author>"
+              puts "<date>#{entry[:date]}</date>"
+              puts "<msg>#{entry[:message]}</msg>"
+              puts "</logentry>"
+            end
+            puts "</log>"
+          end
+        end
+      end
+    end
+
+  end
+end
+
+if __FILE__ == $0 then
+  Svn::Log::Application.new.run
+end
+
+

data/lib/svnlog/index.rb

@@ -0,0 +1,111 @@
+require 'ferret'
+include Ferret
+include Ferret::Document
+include Ferret::Search
+
+require 'yaml'
+
+module Svn
+  module Log
+
+    # An index of svn log entries
+    class Index
+
+      def initialize(path = nil, repository_url = nil)
+        @path = path
+        @index = Ferret::Index::Index.new(:path => @path, :key => :revision)
+        # load the properties
+        properties_path = @path && File.join(@path, "properties.yml")
+        @props = Properties.new(properties_path)
+        @props[:repository_url] ||= repository_url
+      end
+
+      # Returns the path to the index
+      def path
+        @path
+      end
+
+      # Returns the url of the repository that is indexed
+      def repository_url
+        @props[:repository_url]
+      end
+
+      # Returns the revision number of the last entry indexed
+      def last_revision
+        @props[:last_revision]
+      end
+
+      # Returns the number of entries in the index
+      def size
+        @index.size
+      end
+
+      # Updates the index with the latest entries
+      def update
+        revision = "#{last_revision.to_i}:HEAD"
+        entries = Log.new(repository_url).find(revision)
+        return if entries.size == 0
+        for entry in entries
+          add_entry(entry)
+        end
+        @index.flush
+        @props[:last_revision] = entries.last[:revision]
+      end
+
+      # Returns all entries that match the query
+      def search(query)
+        entries = []
+        options = {:num_docs => @index.size, :sort => SortField::FIELD_DOC }
+        for doc_id, score in @index.search(query, options)
+          entries << @index[doc_id]
+        end
+        entries
+      end
+
+      # Close the index when you're done with it
+      def close
+        @index.close
+      end
+
+      private
+
+      # Adds a new entry to the index
+      def add_entry(entry)
+        doc = Document.new
+        doc << Field.new(:revision, entry[:revision], Field::Store::YES, Field::Index::UNTOKENIZED)
+        doc << Field.new(:author,   entry[:author],   Field::Store::YES, Field::Index::UNTOKENIZED)
+        doc << Field.new(:message,  entry[:message],  Field::Store::YES, Field::Index::TOKENIZED)
+        doc << Field.new(:date,     entry[:date],     Field::Store::YES, Field::Index::UNTOKENIZED)
+        @index << doc
+      end
+    end
+
+    # A set of persistent properties
+    class Properties
+
+      def initialize(path = nil)
+        @data = {}
+        @path = path
+        if @path && File.exists?(@path)
+          File.open(@path) do |file|
+            @data = YAML.load(file)
+          end
+        end
+      end
+
+      def [](name)
+        @data[name]
+      end
+
+      def []=(name, value)
+        @data[name] = value
+        if @path
+          File.open(@path, "w") do |file|
+            YAML.dump(@data, file)
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/svnlog/log.rb

@@ -0,0 +1,37 @@
+require 'rexml/document'
+
+module Svn
+  module Log    
+
+    # An svn log
+    class Log
+
+      def initialize(repository_url)
+        @repository_url = repository_url
+      end
+
+      # Returns all entries
+      def entries
+        find("1:HEAD")
+      end
+
+      # Returns entries that match the specified revision (which can be a range)
+      def find(revision)
+        entries = []
+        doc = REXML::Document.new(`svn log \"#{@repository_url}\" --revision #{revision} --xml`)
+        doc.elements.each('/log/logentry') do |element|
+          entry = {}
+          entry[:revision] = element.attribute('revision').value
+          entry[:author] = element.text('author')
+          entry[:message] = element.text('msg')
+          entry[:date] = element.text('date')
+          entries << entry
+        end
+        entries
+      end
+
+      alias [] find
+    end
+
+  end
+end

data/test/data/repos/README.txt

@@ -0,0 +1,5 @@
+This is a Subversion repository; use the 'svnadmin' tool to examine
+it.  Do not add, delete, or modify files here unless you know how
+to avoid corrupting the repository.
+
+Visit http://subversion.tigris.org/ for more information.

data/test/data/repos/conf/authz

@@ -0,0 +1,21 @@
+### This file is an example authorization file for svnserve.
+### Its format is identical to that of mod_authz_svn authorization
+### files.
+### As shown below each section defines authorizations for the path and
+### (optional) repository specified by the section name.
+### The authorizations follow. An authorization line can refer to a
+### single user, to a group of users defined in a special [groups]
+### section, or to anyone using the '*' wildcard.  Each definition can
+### grant read ('r') access, read-write ('rw') access, or no access
+### ('').
+
+# [groups]
+# harry_and_sally = harry,sally
+
+# [/foo/bar]
+# harry = rw
+# * =
+
+# [repository:/baz/fuz]
+# @harry_and_sally = rw
+# * = r

data/test/data/repos/conf/passwd

@@ -0,0 +1,8 @@
+### This file is an example password file for svnserve.
+### Its format is similar to that of svnserve.conf. As shown in the
+### example below it contains one section labelled [users].
+### The name and password for each user follow, one account per line.
+
+# [users]
+# harry = harryssecret
+# sally = sallyssecret

data/test/data/repos/conf/svnserve.conf

@@ -0,0 +1,30 @@
+### This file controls the configuration of the svnserve daemon, if you
+### use it to allow access to this repository.  (If you only allow
+### access through http: and/or file: URLs, then this file is
+### irrelevant.)
+
+### Visit http://subversion.tigris.org/ for more information.
+
+# [general]
+### These options control access to the repository for unauthenticated
+### and authenticated users.  Valid values are "write", "read",
+### and "none".  The sample settings below are the defaults.
+# anon-access = read
+# auth-access = write
+### The password-db option controls the location of the password
+### database file.  Unless you specify a path starting with a /,
+### the file's location is relative to the conf directory.
+### Uncomment the line below to use the default password file.
+# password-db = passwd
+### The authz-db option controls the location of the authorization
+### rules for path-based access control.  Unless you specify a path
+### starting with a /, the file's location is relative to the conf
+### directory.  If you don't specify an authz-db, no path-based access
+### control is done.
+### Uncomment the line below to use the default authorization file.
+# authz-db = authz
+### This option specifies the authentication realm of the repository.
+### If two repositories have the same authentication realm, they should
+### have the same password database, and vice versa.  The default realm
+### is repository's uuid.
+# realm = My First Repository

data/test/data/repos/db/current

@@ -0,0 +1 @@
+3 2 1

data/test/data/repos/db/format

@@ -0,0 +1 @@
+1

data/test/data/repos/db/fs-type

@@ -0,0 +1 @@
+fsfs

data/test/data/repos/db/revprops/0

@@ -0,0 +1,5 @@
+K 8
+svn:date
+V 27
+2006-05-27T14:45:25.061201Z
+END

data/test/data/repos/db/revprops/1

@@ -0,0 +1,13 @@
+K 10
+svn:author
+V 4
+Josh
+K 8
+svn:date
+V 27
+2006-05-27T14:47:41.978078Z
+K 7
+svn:log
+V 19
+Initial add of file
+END

data/test/data/repos/db/revprops/2

@@ -0,0 +1,13 @@
+K 10
+svn:author
+V 4
+Josh
+K 8
+svn:date
+V 27
+2006-05-27T14:48:12.852473Z
+K 7
+svn:log
+V 20
+Changed a few things
+END

data/test/data/repos/db/revprops/3

@@ -0,0 +1,13 @@
+K 10
+svn:author
+V 4
+Josh
+K 8
+svn:date
+V 27
+2006-05-27T14:49:01.762803Z
+K 7
+svn:log
+V 18
+Yet another change
+END

data/test/data/repos/db/revs/0

@@ -0,0 +1,11 @@
+PLAIN
+END
+ENDREP
+id: 0.0.r0/17
+type: dir
+count: 0
+text: 0 0 4 4 2d2977d1c96f487abe4a1e202dd03b4e
+cpath: /
+
+
+17 107

data/test/data/repos/db/uuid

@@ -0,0 +1 @@
+27638544-d82e-7546-8798-448353dc9678

data/test/data/repos/format

@@ -0,0 +1 @@
+3

data/test/data/repos/hooks/post-commit.tmpl

@@ -0,0 +1,51 @@
+#!/bin/sh
+
+# POST-COMMIT HOOK
+#
+# The post-commit hook is invoked after a commit.  Subversion runs
+# this hook by invoking a program (script, executable, binary, etc.)
+# named 'post-commit' (for which this file is a template) with the 
+# following ordered arguments:
+#
+#   [1] REPOS-PATH   (the path to this repository)
+#   [2] REV          (the number of the revision just committed)
+#
+# The default working directory for the invocation is undefined, so
+# the program should set one explicitly if it cares.
+#
+# Because the commit has already completed and cannot be undone,
+# the exit code of the hook program is ignored.  The hook program
+# can use the 'svnlook' utility to help it examine the
+# newly-committed tree.
+#
+# On a Unix system, the normal procedure is to have 'post-commit'
+# invoke other programs to do the real work, though it may do the
+# work itself too.
+#
+# Note that 'post-commit' must be executable by the user(s) who will
+# invoke it (typically the user httpd runs as), and that user must
+# have filesystem-level permission to access the repository.
+#
+# On a Windows system, you should name the hook program
+# 'post-commit.bat' or 'post-commit.exe',
+# but the basic idea is the same.
+# 
+# The hook program typically does not inherit the environment of
+# its parent process.  For example, a common problem is for the
+# PATH environment variable to not be set to its usual value, so
+# that subprograms fail to launch unless invoked via absolute path.
+# If you're having unexpected problems with a hook program, the
+# culprit may be unusual (or missing) environment variables.
+# 
+# Here is an example hook script, for a Unix /bin/sh interpreter.
+# For more examples and pre-written hooks, see those in
+# the Subversion repository at
+# http://svn.collab.net/repos/svn/trunk/tools/hook-scripts/ and
+# http://svn.collab.net/repos/svn/trunk/contrib/hook-scripts/
+
+
+REPOS="$1"
+REV="$2"
+
+commit-email.pl "$REPOS" "$REV" commit-watchers@example.org
+log-commit.py --repository "$REPOS" --revision "$REV"

data/test/data/repos/hooks/post-lock.tmpl

@@ -0,0 +1,44 @@
+#!/bin/sh
+
+# POST-LOCK HOOK
+#
+# The post-lock hook is run after a path is locked.  Subversion runs
+# this hook by invoking a program (script, executable, binary, etc.)
+# named 'post-lock' (for which this file is a template) with the 
+# following ordered arguments:
+#
+#   [1] REPOS-PATH   (the path to this repository)
+#   [2] USER         (the user who created the lock)
+#
+# The paths that were just locked are passed to the hook via STDIN (as
+# of Subversion 1.2, only one path is passed per invocation, but the
+# plan is to pass all locked paths at once, so the hook program
+# should be written accordingly).
+#
+# The default working directory for the invocation is undefined, so
+# the program should set one explicitly if it cares.
+#
+# Because the lock has already been created and cannot be undone,
+# the exit code of the hook program is ignored.  The hook program
+# can use the 'svnlook' utility to help it examine the
+# newly-created lock.
+#
+# On a Unix system, the normal procedure is to have 'post-lock'
+# invoke other programs to do the real work, though it may do the
+# work itself too.
+#
+# Note that 'post-lock' must be executable by the user(s) who will
+# invoke it (typically the user httpd runs as), and that user must
+# have filesystem-level permission to access the repository.
+#
+# On a Windows system, you should name the hook program
+# 'post-lock.bat' or 'post-lock.exe',
+# but the basic idea is the same.
+# 
+# Here is an example hook script, for a Unix /bin/sh interpreter:
+
+REPOS="$1"
+USER="$2"
+
+# Send email to interested parties, let them know a lock was created:
+mailer.py lock "$REPOS" "$USER" /path/to/mailer.conf

data/test/data/repos/hooks/post-revprop-change.tmpl

@@ -0,0 +1,56 @@
+#!/bin/sh
+
+# POST-REVPROP-CHANGE HOOK
+#
+# The post-revprop-change hook is invoked after a revision property
+# has been added, modified or deleted.  Subversion runs this hook by
+# invoking a program (script, executable, binary, etc.) named
+# 'post-revprop-change' (for which this file is a template), with the
+# following ordered arguments:
+#
+#   [1] REPOS-PATH   (the path to this repository)
+#   [2] REV          (the revision that was tweaked)
+#   [3] USER         (the username of the person tweaking the property)
+#   [4] PROPNAME     (the property that was changed)
+#   [5] ACTION       (the property was 'A'dded, 'M'odified, or 'D'eleted)
+#
+#   [STDIN] PROPVAL  ** the old property value is passed via STDIN.
+#
+# Because the propchange has already completed and cannot be undone,
+# the exit code of the hook program is ignored.  The hook program
+# can use the 'svnlook' utility to help it examine the
+# new property value.
+#
+# On a Unix system, the normal procedure is to have 'post-revprop-change'
+# invoke other programs to do the real work, though it may do the
+# work itself too.
+#
+# Note that 'post-revprop-change' must be executable by the user(s) who will
+# invoke it (typically the user httpd runs as), and that user must
+# have filesystem-level permission to access the repository.
+#
+# On a Windows system, you should name the hook program
+# 'post-revprop-change.bat' or 'post-revprop-change.exe',
+# but the basic idea is the same.
+# 
+# The hook program typically does not inherit the environment of
+# its parent process.  For example, a common problem is for the
+# PATH environment variable to not be set to its usual value, so
+# that subprograms fail to launch unless invoked via absolute path.
+# If you're having unexpected problems with a hook program, the
+# culprit may be unusual (or missing) environment variables.
+# 
+# Here is an example hook script, for a Unix /bin/sh interpreter.
+# For more examples and pre-written hooks, see those in
+# the Subversion repository at
+# http://svn.collab.net/repos/svn/trunk/tools/hook-scripts/ and
+# http://svn.collab.net/repos/svn/trunk/contrib/hook-scripts/
+
+
+REPOS="$1"
+REV="$2"
+USER="$3"
+PROPNAME="$4"
+ACTION="$5"
+
+propchange-email.pl "$REPOS" "$REV" "$USER" "$PROPNAME" watchers@example.org

data/test/data/repos/hooks/post-unlock.tmpl

@@ -0,0 +1,42 @@
+#!/bin/sh
+
+# POST-UNLOCK HOOK
+#
+# The post-unlock hook runs after a path is unlocked.  Subversion runs
+# this hook by invoking a program (script, executable, binary, etc.)
+# named 'post-unlock' (for which this file is a template) with the 
+# following ordered arguments:
+#
+#   [1] REPOS-PATH   (the path to this repository)
+#   [2] USER         (the user who destroyed the lock)
+#
+# The paths that were just unlocked are passed to the hook via STDIN
+# (as of Subversion 1.2, only one path is passed per invocation, but
+# the plan is to pass all unlocked paths at once, so the hook program
+# should be written accordingly).
+#
+# The default working directory for the invocation is undefined, so
+# the program should set one explicitly if it cares.
+#
+# Because the lock has already been destroyed and cannot be undone,
+# the exit code of the hook program is ignored.
+#
+# On a Unix system, the normal procedure is to have 'post-unlock'
+# invoke other programs to do the real work, though it may do the
+# work itself too.
+#
+# Note that 'post-unlock' must be executable by the user(s) who will
+# invoke it (typically the user httpd runs as), and that user must
+# have filesystem-level permission to access the repository.
+#
+# On a Windows system, you should name the hook program
+# 'post-unlock.bat' or 'post-unlock.exe',
+# but the basic idea is the same.
+# 
+# Here is an example hook script, for a Unix /bin/sh interpreter:
+
+REPOS="$1"
+USER="$2"
+
+# Send email to interested parties, let them know a lock was removed:
+mailer.py unlock "$REPOS" "$USER" /path/to/mailer.conf

data/test/data/repos/hooks/pre-commit.tmpl

@@ -0,0 +1,70 @@
+#!/bin/sh
+
+# PRE-COMMIT HOOK
+#
+# The pre-commit hook is invoked before a Subversion txn is
+# committed.  Subversion runs this hook by invoking a program
+# (script, executable, binary, etc.) named 'pre-commit' (for which
+# this file is a template), with the following ordered arguments:
+#
+#   [1] REPOS-PATH   (the path to this repository)
+#   [2] TXN-NAME     (the name of the txn about to be committed)
+#
+# The default working directory for the invocation is undefined, so
+# the program should set one explicitly if it cares.
+#
+# If the hook program exits with success, the txn is committed; but
+# if it exits with failure (non-zero), the txn is aborted, no commit
+# takes place, and STDERR is returned to the client.   The hook
+# program can use the 'svnlook' utility to help it examine the txn.
+#
+# On a Unix system, the normal procedure is to have 'pre-commit'
+# invoke other programs to do the real work, though it may do the
+# work itself too.
+#
+#   ***  NOTE: THE HOOK PROGRAM MUST NOT MODIFY THE TXN, EXCEPT  ***
+#   ***  FOR REVISION PROPERTIES (like svn:log or svn:author).   ***
+#
+#   This is why we recommend using the read-only 'svnlook' utility.
+#   In the future, Subversion may enforce the rule that pre-commit
+#   hooks should not modify the versioned data in txns, or else come
+#   up with a mechanism to make it safe to do so (by informing the
+#   committing client of the changes).  However, right now neither
+#   mechanism is implemented, so hook writers just have to be careful.
+#
+# Note that 'pre-commit' must be executable by the user(s) who will
+# invoke it (typically the user httpd runs as), and that user must
+# have filesystem-level permission to access the repository.
+#
+# On a Windows system, you should name the hook program
+# 'pre-commit.bat' or 'pre-commit.exe',
+# but the basic idea is the same.
+#
+# The hook program typically does not inherit the environment of
+# its parent process.  For example, a common problem is for the
+# PATH environment variable to not be set to its usual value, so
+# that subprograms fail to launch unless invoked via absolute path.
+# If you're having unexpected problems with a hook program, the
+# culprit may be unusual (or missing) environment variables.
+# 
+# Here is an example hook script, for a Unix /bin/sh interpreter.
+# For more examples and pre-written hooks, see those in
+# the Subversion repository at
+# http://svn.collab.net/repos/svn/trunk/tools/hook-scripts/ and
+# http://svn.collab.net/repos/svn/trunk/contrib/hook-scripts/
+
+
+REPOS="$1"
+TXN="$2"
+
+# Make sure that the log message contains some text.
+SVNLOOK=/usr/local/bin/svnlook
+$SVNLOOK log -t "$TXN" "$REPOS" | \
+   grep "[a-zA-Z0-9]" > /dev/null || exit 1
+
+# Check that the author of this commit has the rights to perform
+# the commit on the files and directories being modified.
+commit-access-control.pl "$REPOS" "$TXN" commit-access-control.cfg || exit 1
+
+# All checks passed, so allow the commit.
+exit 0

data/test/data/repos/hooks/pre-lock.tmpl

@@ -0,0 +1,64 @@
+#!/bin/sh
+
+# PRE-LOCK HOOK
+#
+# The pre-lock hook is invoked before an exclusive lock is
+# created.  Subversion runs this hook by invoking a program 
+# (script, executable, binary, etc.) named 'pre-lock' (for which
+# this file is a template), with the following ordered arguments:
+#
+#   [1] REPOS-PATH   (the path to this repository)
+#   [2] PATH         (the path in the repository about to be locked)
+#   [3] USER         (the user creating the lock)
+#
+# The default working directory for the invocation is undefined, so
+# the program should set one explicitly if it cares.
+#
+# If the hook program exits with success, the lock is created; but
+# if it exits with failure (non-zero), the lock action is aborted
+# and STDERR is returned to the client.
+
+# On a Unix system, the normal procedure is to have 'pre-lock'
+# invoke other programs to do the real work, though it may do the
+# work itself too.
+#
+# Note that 'pre-lock' must be executable by the user(s) who will
+# invoke it (typically the user httpd runs as), and that user must
+# have filesystem-level permission to access the repository.
+#
+# On a Windows system, you should name the hook program
+# 'pre-lock.bat' or 'pre-lock.exe',
+# but the basic idea is the same.
+#
+# Here is an example hook script, for a Unix /bin/sh interpreter:
+
+REPOS="$1"
+PATH="$2"
+USER="$3"
+
+# If a lock exists and is owned by a different person, don't allow it
+# to be stolen (e.g., with 'svn lock --force ...').
+
+# (Maybe this script could send email to the lock owner?)
+SVNLOOK=/usr/local/bin/svnlook
+GREP=/bin/grep
+SED=/bin/sed
+
+LOCK_OWNER=`$SVNLOOK lock "$REPOS" "$PATH" | \
+            $GREP '^Owner: ' | $SED 's/Owner: //'`
+
+# If we get no result from svnlook, there's no lock, allow the lock to
+# happen:
+if [ "$LOCK_OWNER" == "" ]; then
+  exit 0
+fi
+
+# If the person locking matches the lock's owner, allow the lock to
+# happen:
+if [ "$LOCK_OWNER" == "$USER" ]; then
+  exit 0
+fi
+
+# Otherwise, we've got an owner mismatch, so return failure:
+echo "Error: $PATH already locked by ${LOCK_OWNER}." 1>&2
+exit 1

data/test/data/repos/hooks/pre-revprop-change.tmpl

@@ -0,0 +1,66 @@
+#!/bin/sh
+
+# PRE-REVPROP-CHANGE HOOK
+#
+# The pre-revprop-change hook is invoked before a revision property
+# is added, modified or deleted.  Subversion runs this hook by invoking
+# a program (script, executable, binary, etc.) named 'pre-revprop-change'
+# (for which this file is a template), with the following ordered
+# arguments:
+#
+#   [1] REPOS-PATH   (the path to this repository)
+#   [2] REVISION     (the revision being tweaked)
+#   [3] USER         (the username of the person tweaking the property)
+#   [4] PROPNAME     (the property being set on the revision)
+#   [5] ACTION       (the property is being 'A'dded, 'M'odified, or 'D'eleted)
+#
+#   [STDIN] PROPVAL  ** the new property value is passed via STDIN.
+#
+# If the hook program exits with success, the propchange happens; but
+# if it exits with failure (non-zero), the propchange doesn't happen.
+# The hook program can use the 'svnlook' utility to examine the 
+# existing value of the revision property.
+#
+# WARNING: unlike other hooks, this hook MUST exist for revision
+# properties to be changed.  If the hook does not exist, Subversion 
+# will behave as if the hook were present, but failed.  The reason
+# for this is that revision properties are UNVERSIONED, meaning that
+# a successful propchange is destructive;  the old value is gone
+# forever.  We recommend the hook back up the old value somewhere.
+#
+# On a Unix system, the normal procedure is to have 'pre-revprop-change'
+# invoke other programs to do the real work, though it may do the
+# work itself too.
+#
+# Note that 'pre-revprop-change' must be executable by the user(s) who will
+# invoke it (typically the user httpd runs as), and that user must
+# have filesystem-level permission to access the repository.
+#
+# On a Windows system, you should name the hook program
+# 'pre-revprop-change.bat' or 'pre-revprop-change.exe',
+# but the basic idea is the same.
+#
+# The hook program typically does not inherit the environment of
+# its parent process.  For example, a common problem is for the
+# PATH environment variable to not be set to its usual value, so
+# that subprograms fail to launch unless invoked via absolute path.
+# If you're having unexpected problems with a hook program, the
+# culprit may be unusual (or missing) environment variables.
+# 
+# Here is an example hook script, for a Unix /bin/sh interpreter.
+# For more examples and pre-written hooks, see those in
+# the Subversion repository at
+# http://svn.collab.net/repos/svn/trunk/tools/hook-scripts/ and
+# http://svn.collab.net/repos/svn/trunk/contrib/hook-scripts/
+
+
+REPOS="$1"
+REV="$2"
+USER="$3"
+PROPNAME="$4"
+ACTION="$5"
+
+if [ "$ACTION" = "M" -a "$PROPNAME" = "svn:log" ]; then exit 0; fi
+
+echo "Changing revision properties other than svn:log is prohibited" >&2
+exit 1

data/test/data/repos/hooks/pre-unlock.tmpl

@@ -0,0 +1,60 @@
+#!/bin/sh
+
+# PRE-UNLOCK HOOK
+#
+# The pre-unlock hook is invoked before an exclusive lock is
+# destroyed.  Subversion runs this hook by invoking a program 
+# (script, executable, binary, etc.) named 'pre-unlock' (for which
+# this file is a template), with the following ordered arguments:
+#
+#   [1] REPOS-PATH   (the path to this repository)
+#   [2] PATH         (the path in the repository about to be unlocked)
+#   [3] USER         (the user destroying the lock)
+#
+# The default working directory for the invocation is undefined, so
+# the program should set one explicitly if it cares.
+#
+# If the hook program exits with success, the lock is destroyed; but
+# if it exits with failure (non-zero), the unlock action is aborted
+# and STDERR is returned to the client.
+
+# On a Unix system, the normal procedure is to have 'pre-unlock'
+# invoke other programs to do the real work, though it may do the
+# work itself too.
+#
+# Note that 'pre-unlock' must be executable by the user(s) who will
+# invoke it (typically the user httpd runs as), and that user must
+# have filesystem-level permission to access the repository.
+#
+# On a Windows system, you should name the hook program
+# 'pre-unlock.bat' or 'pre-unlock.exe',
+# but the basic idea is the same.
+#
+# Here is an example hook script, for a Unix /bin/sh interpreter:
+
+REPOS="$1"
+PATH="$2"
+USER="$3"
+
+# If a lock is owned by a different person, don't allow it be broken.
+# (Maybe this script could send email to the lock owner?)
+
+SVNLOOK=/usr/local/bin/svnlook
+GREP=/bin/grep
+SED=/bin/sed
+
+LOCK_OWNER=`$SVNLOOK lock "$REPOS" "$PATH" | \
+            $GREP '^Owner: ' | $SED 's/Owner: //'`
+
+# If we get no result from svnlook, there's no lock, return success:
+if [ "$LOCK_OWNER" == "" ]; then
+  exit 0
+fi
+# If the person unlocking matches the lock's owner, return success:
+if [ "$LOCK_OWNER" == "$USER" ]; then
+  exit 0
+fi
+
+# Otherwise, we've got an owner mismatch, so return failure:
+echo "Error: $PATH locked by ${LOCK_OWNER}." 1>&2
+exit 1

data/test/data/repos/hooks/start-commit.tmpl

@@ -0,0 +1,54 @@
+#!/bin/sh
+
+# START-COMMIT HOOK
+#
+# The start-commit hook is invoked before a Subversion txn is created
+# in the process of doing a commit.  Subversion runs this hook
+# by invoking a program (script, executable, binary, etc.) named
+# 'start-commit' (for which this file is a template)
+# with the following ordered arguments:
+#
+#   [1] REPOS-PATH   (the path to this repository)
+#   [2] USER         (the authenticated user attempting to commit)
+#
+# The default working directory for the invocation is undefined, so
+# the program should set one explicitly if it cares.
+#
+# If the hook program exits with success, the commit continues; but
+# if it exits with failure (non-zero), the commit is stopped before
+# a Subversion txn is created, and STDERR is returned to the client.
+#
+# On a Unix system, the normal procedure is to have 'start-commit'
+# invoke other programs to do the real work, though it may do the
+# work itself too.
+#
+# Note that 'start-commit' must be executable by the user(s) who will
+# invoke it (typically the user httpd runs as), and that user must
+# have filesystem-level permission to access the repository.
+#
+# On a Windows system, you should name the hook program
+# 'start-commit.bat' or 'start-commit.exe',
+# but the basic idea is the same.
+# 
+# The hook program typically does not inherit the environment of
+# its parent process.  For example, a common problem is for the
+# PATH environment variable to not be set to its usual value, so
+# that subprograms fail to launch unless invoked via absolute path.
+# If you're having unexpected problems with a hook program, the
+# culprit may be unusual (or missing) environment variables.
+# 
+# Here is an example hook script, for a Unix /bin/sh interpreter.
+# For more examples and pre-written hooks, see those in
+# the Subversion repository at
+# http://svn.collab.net/repos/svn/trunk/tools/hook-scripts/ and
+# http://svn.collab.net/repos/svn/trunk/contrib/hook-scripts/
+
+
+REPOS="$1"
+USER="$2"
+
+commit-allower.pl --repository "$REPOS" --user "$USER" || exit 1
+special-auth-check.py --user "$USER" --auth-level 3 || exit 1
+
+# All checks passed, so allow the commit.
+exit 0

data/test/data/repos/locks/db-logs.lock

@@ -0,0 +1,3 @@
+This file is not used by Subversion 1.3.x or later.
+However, its existence is required for compatibility with
+Subversion 1.2.x or earlier.

data/test/data/repos/locks/db.lock

@@ -0,0 +1,3 @@
+This file is not used by Subversion 1.3.x or later.
+However, its existence is required for compatibility with
+Subversion 1.2.x or earlier.

data/test/helper.rb

@@ -0,0 +1,9 @@
+$:.unshift File.dirname(__FILE__)
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+
+require 'test/unit'
+
+require 'svnlog'
+include Svn::Log
+
+REPOSITORY_URL = "file:///" + File.join(File.dirname(File.expand_path(__FILE__)), "data", "repos")

data/test/test_all.rb

@@ -0,0 +1,4 @@
+require File.dirname(__FILE__) + '/helper'
+
+require 'test_log'
+require 'test_index'

data/test/test_index.rb

@@ -0,0 +1,71 @@
+require File.dirname(__FILE__) + '/helper'
+
+require 'tmpdir'
+require 'fileutils'
+
+class IndexTest < Test::Unit::TestCase
+
+  TEMP_DIR = File.join(Dir.tmpdir, "SvnLogTest")
+
+  # Create the index
+  def setup
+    FileUtils.makedirs(TEMP_DIR)
+    path = File.join(TEMP_DIR, "index")
+    @index = Index.new(path, REPOSITORY_URL)
+    @index.update
+  end
+
+  # Delete the index
+  def teardown
+    @index.close
+    FileUtils.remove_dir(TEMP_DIR, true)
+  end
+
+  def test_duplicate_entries_not_added
+    assert_equal 3, @index.size
+    @index.update
+    assert_equal 3, @index.size
+  end
+
+  # The index should remember the url of the repository resource it is indexing
+  def test_remember_repository_url
+    index = Index.new(@index.path)
+    assert_equal REPOSITORY_URL, index.repository_url
+  end
+
+  # The index should remember the revision of the last entry indexed
+  def test_remember_last_revision
+    index = Index.new(@index.path)
+    assert_equal "3", index.last_revision
+  end
+
+  def test_default_search
+    entries = @index.search("Changed")
+    assert_equal 1, entries.size
+    entries.each do |entry|
+      assert_equal "2", entry[:revision]
+      assert_equal "Josh", entry[:author]
+      assert_equal "Changed a few things", entry[:message]
+    end
+  end
+
+  def test_message_search
+    entries = @index.search("message:Changed")
+    assert_equal 1, entries.size
+    entries.each do |entry|
+      assert_equal "2", entry[:revision]
+      assert_equal "Josh", entry[:author]
+      assert_equal "Changed a few things", entry[:message]
+    end
+  end
+
+  def test_revision_search
+    entries = @index.search("revision:2")
+    assert_equal 1, entries.size
+    entries.each do |entry|
+      assert_equal "2", entry[:revision]
+      assert_equal "Josh", entry[:author]
+      assert_equal "Changed a few things", entry[:message]
+    end
+  end
+end

data/test/test_log.rb

@@ -0,0 +1,29 @@
+require File.dirname(__FILE__) + '/helper'
+
+class LogTest < Test::Unit::TestCase
+
+  def setup
+    @log = Log.new(REPOSITORY_URL)
+  end
+
+  def test_find_single_entry
+    entries = @log.find("2")
+    assert_equal 1, entries.size
+    entry = entries[0]
+    assert_equal "Josh", entry[:author]
+    assert_equal "Changed a few things", entry[:message]
+    entries = @log["2"]
+    assert_equal 1, entries.size
+    entry = entries[0]
+    assert_equal "Josh", entry[:author]
+    assert_equal "Changed a few things", entry[:message]
+  end
+
+  def test_find_all_entries
+    entries = @log.entries
+    assert_equal 3, entries.size
+    assert_equal "1", entries[0][:revision]
+    assert_equal "2", entries[1][:revision]
+    assert_equal "3", entries[2][:revision]
+  end
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.10
+specification_version: 1
+name: SvnLog
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2006-06-13
+summary: Full-text search of Subversion commit logs
+require_paths: 
+  - lib
+email: jdaltry@gmail.com
+homepage: 
+rubyforge_project: 
+description: 
+autorequire: 
+default_executable: svnlog
+bindir: bin
+has_rdoc: false
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+    - 
+      - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+  version: 
+platform: ruby
+authors: 
+  - Josh Daltry
+files: 
+  - bin/svnlog
+  - lib/svnlog
+  - lib/svnlog.rb
+  - lib/svnlog/index.rb
+  - lib/svnlog/log.rb
+  - test/data
+  - test/helper.rb
+  - test/test_all.rb
+  - test/test_index.rb
+  - test/test_log.rb
+  - test/data/repos
+  - test/data/repos/conf
+  - test/data/repos/dav
+  - test/data/repos/db
+  - test/data/repos/format
+  - test/data/repos/hooks
+  - test/data/repos/locks
+  - test/data/repos/README.txt
+  - test/data/repos/conf/authz
+  - test/data/repos/conf/passwd
+  - test/data/repos/conf/svnserve.conf
+  - test/data/repos/db/current
+  - test/data/repos/db/format
+  - test/data/repos/db/fs-type
+  - test/data/repos/db/revprops
+  - test/data/repos/db/revs
+  - test/data/repos/db/transactions
+  - test/data/repos/db/uuid
+  - test/data/repos/db/write-lock
+  - test/data/repos/db/revprops/0
+  - test/data/repos/db/revprops/1
+  - test/data/repos/db/revprops/2
+  - test/data/repos/db/revprops/3
+  - test/data/repos/db/revs/0
+  - test/data/repos/db/revs/1
+  - test/data/repos/db/revs/2
+  - test/data/repos/db/revs/3
+  - test/data/repos/hooks/post-commit.tmpl
+  - test/data/repos/hooks/post-lock.tmpl
+  - test/data/repos/hooks/post-revprop-change.tmpl
+  - test/data/repos/hooks/post-unlock.tmpl
+  - test/data/repos/hooks/pre-commit.tmpl
+  - test/data/repos/hooks/pre-lock.tmpl
+  - test/data/repos/hooks/pre-revprop-change.tmpl
+  - test/data/repos/hooks/pre-unlock.tmpl
+  - test/data/repos/hooks/start-commit.tmpl
+  - test/data/repos/locks/db-logs.lock
+  - test/data/repos/locks/db.lock
+test_files: 
+  - test/test_all.rb
+rdoc_options: []
+extra_rdoc_files: []
+executables: 
+  - svnlog
+extensions: []
+requirements: []
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: ferret
+    version_requirement: 
+    version_requirements: !ruby/object:Gem::Version::Requirement 
+      requirements: 
+        - 
+          - ">="
+          - !ruby/object:Gem::Version 
+            version: 0.9.0
+      version: