From 50e1b43408e85fd2350b9df50e4ceb0c6a495a4f Mon Sep 17 00:00:00 2001 From: joey Date: Tue, 21 Aug 2007 03:10:35 +0000 Subject: [PATCH] * Add monotone support, contributed by William Uther. --- IkiWiki.pm | 1 + IkiWiki/Rcs/monotone.pm | 628 ++++++++++++++++++++++++++++++++++++++++ debian/changelog | 3 +- doc/ikiwiki.setup | 14 + doc/setup.mdwn | 26 ++ 5 files changed, 671 insertions(+), 1 deletion(-) create mode 100644 IkiWiki/Rcs/monotone.pm diff --git a/IkiWiki.pm b/IkiWiki.pm index 3f7bdb2a6..5eef40878 100644 --- a/IkiWiki.pm +++ b/IkiWiki.pm @@ -33,6 +33,7 @@ sub defaultconfig () { #{{{ wiki_file_prune_regexps => [qr/\.\./, qr/^\./, qr/\/\./, qr/\.x?html?$/, qr/\.ikiwiki-new$/, qr/(^|\/).svn\//, qr/.arch-ids\//, qr/{arch}\//, + qr/(^|\/)_MTN\//, qr/\.dpkg-tmp$/], wiki_link_regexp => qr{ \[\[ # beginning of link diff --git a/IkiWiki/Rcs/monotone.pm b/IkiWiki/Rcs/monotone.pm new file mode 100644 index 000000000..97b263aef --- /dev/null +++ b/IkiWiki/Rcs/monotone.pm @@ -0,0 +1,628 @@ +#!/usr/bin/perl +# Monotone revision control. +# http://monotone.ca/ + +# This requires the Monotone perl module from the monotone contrib/ directory to be installed. +# In particlar, we require version 0.03 or higher of that module. +# It is available from the monotone source repository at: +# http://viewmtn.angrygoats.net/branch/changes/net.venge.monotone + +use warnings; +use strict; +use IkiWiki; +use Monotone; +use Date::Parse qw(str2time); +use Date::Format qw(time2str); + +package IkiWiki; + +my $sha1_pattern = qr/[0-9a-fA-F]{40}/; # pattern to validate sha1sums + +sub check_config() { + if (!defined($config{srcdir})) { + error("Ikiwiki srcdir not defined!"); + } + if (!defined($config{mtnrootdir})) { + $config{mtnrootdir} = $config{srcdir}; + } + if (! -d "$config{mtnrootdir}/_MTN") { + error("Ikiwiki srcdir does not seem to be a Monotone workspace (or set the mtnrootdir)!"); + } + + if (!defined($config{mtnmergerc})) { + $config{mtnmergerc} = "$config{mtnrootdir}/_MTN/mergerc"; + } + + chdir $config{srcdir} + or error("Cannot chdir to $config{srcdir}: $!"); +} + +sub get_rev () { + my $sha1 = `mtn --root=$config{mtnrootdir} automate get_base_revision_id`; + + ($sha1) = $sha1 =~ m/($sha1_pattern)/; # sha1 is untainted now + if (! $sha1) { + warn("Unable to get base revision for '$config{srcdir}'.") + } + + return $sha1; +} + +sub get_rev_auto ($) { + my $automator=shift; + + my @results = $automator->call("get_base_revision_id"); + + my $sha1 = $results[0]; + ($sha1) = $sha1 =~ m/($sha1_pattern)/; # sha1 is untainted now + if (! $sha1) { + warn("Unable to get base revision for '$config{srcdir}'.") + } + + return $sha1; +} + +sub mtn_merge ($$$$$) { + my $leftRev=shift; + my $rightRev=shift; + my $branch=shift; + my $author=shift; + my $message=shift; # ignored for the moment because mtn doesn't support it + + my $mergeRev; + + my $mergerc = $config{mtnmergerc}; + + my $child = open(MTNMERGE, "-|"); + if (! $child) { + open STDERR, ">&STDOUT"; + exec("mtn", "--root=$config{mtnrootdir}", "--rcfile", $mergerc, "explicit_merge", $leftRev, $rightRev, $branch, "--author", $author, "--key", $config{mtnkey}) || error("mtn merge failed to run"); + } + + while () { + if (/^mtn.\s.merged.\s($sha1_pattern)$/) { + $mergeRev=$1; + } + } + + close MTNMERGE || return undef; + + warn("merged $leftRev, $rightRev to make $mergeRev"); + + return $mergeRev; +} + +sub commit_file_to_new_rev($$$$$$$$) { + my $automator=shift; + my $wsfilename=shift; + my $oldFileID=shift; + my $newFileContents=shift; + my $oldrev=shift; + my $branch=shift; + my $author=shift; + my $message=shift; + + #store the file + my ($out, $err) = $automator->call("put_file", $oldFileID, $newFileContents); + my ($newFileID) = ($out =~ m/^($sha1_pattern)$/); + error("Failed to store file data for $wsfilename in repository") if (!defined($newFileID) || 40 != length $newFileID); + + # get the mtn filename rather than the workspace filename + ($out, $err) = $automator->call("get_corresponding_path", $oldrev, $wsfilename, $oldrev); + my ($filename) = ($out =~ m/^file "(.*)"$/); + error("Couldn't find monotone repository path for file $wsfilename") if (! $filename); + warn("Converted ws filename of $wsfilename to repos filename of $filename"); + + # then stick in a new revision for this file + my $manifest = "format_version \"1\"\n\n". + "new_manifest [0000000000000000000000000000000000000000]\n\n". + "old_revision [$oldrev]\n\n". + "patch \"$filename\"\n". + " from [$oldFileID]\n". + " to [$newFileID]\n"; + ($out, $err) = $automator->call("put_revision", $manifest); + my ($newRevID) = ($out =~ m/^($sha1_pattern)$/); + error("Unable to make new monotone repository revision") if (!defined($newRevID) || 40 != length $newRevID); + warn("put revision: $newRevID"); + + # now we need to add certs for this revision... + # author, branch, changelog, date + $automator->call("cert", $newRevID, "author", $author); + $automator->call("cert", $newRevID, "branch", $branch); + $automator->call("cert", $newRevID, "changelog", $message); + $automator->call("cert", $newRevID, "date", time2str("%Y-%m-%dT%T", time, "UTC")); + + warn("Added certs for rev: $newRevID"); + return $newRevID; +} + +sub check_mergerc() { + my $mergerc = $config{mtnmergerc}; + if (! -r $mergerc ) { + warn("$mergerc doesn't exist. Creating file with default mergers."); + open(DATA, ">$mergerc") or error("can't open $mergerc $!"); + my $defaultrc = "". +" function local_execute_redirected(stdin, stdout, stderr, path, ...)\n". +" local pid\n". +" local ret = -1\n". +" io.flush();\n". +" pid = spawn_redirected(stdin, stdout, stderr, path, unpack(arg))\n". +" if (pid ~= -1) then ret, pid = wait(pid) end\n". +" return ret\n". +" end\n". +" if (not execute_redirected) then -- use standard function if available\n". +" execute_redirected = local_execute_redirected\n". +" end\n". +" if (not mergers.fail) then -- use standard merger if available\n". +" mergers.fail = {\n". +" cmd = function (tbl) return false end,\n". +" available = function () return true end,\n". +" wanted = function () return true end\n". +" }\n". +" end\n". +" mergers.diffutils_force = {\n". +" cmd = function (tbl)\n". +" local ret = execute_redirected(\n". +" \"\",\n". +" tbl.outfile,\n". +" \"\",\n". +" \"diff3\",\n". +" \"--merge\",\n". +" \"--show-overlap\",\n". +" \"--label\", string.format(\"[Yours]\", tbl.left_path ),\n". +" \"--label\", string.format(\"[Original]\", tbl.anc_path ),\n". +" \"--label\", string.format(\"[Theirs]\", tbl.right_path),\n". +" tbl.lfile,\n". +" tbl.afile,\n". +" tbl.rfile\n". +" )\n". +" if (ret > 1) then\n". +" io.write(gettext(\"Error running GNU diffutils 3-way difference tool 'diff3'\"))\n". +" return false\n". +" end\n". +" return tbl.outfile\n". +" end,\n". +" available =\n". +" function ()\n". +" return program_exists_in_path(\"diff3\");\n". +" end,\n". +" wanted =\n". +" function ()\n". +" return true\n". +" end\n". +" }\n"; + print DATA $defaultrc; + close(DATA); + } +} + +sub read_certs ($$) { + my $automator=shift; + my $rev=shift; + my @results = $automator->call("certs", $rev); + my @ret; + + my $line = $results[0]; + while ($line =~ m/\s+key\s"(.*?)"\nsignature\s"(ok|bad|unknown)"\n\s+name\s"(.*?)"\n\s+value\s"(.*?)"\n\s+trust\s"(trusted|untrusted)"\n/sg) { + push @ret, { + key => $1, + signature => $2, + name => $3, + value => $4, + trust => $5, + }; + } + + return @ret; +} + +sub get_changed_files ($$) { + my $automator=shift; + my $rev=shift; + + my @results = $automator->call("get_revision", $rev); + my $changes=$results[0]; + + my @ret; + my %seen = (); + + while ($changes =~ m/\s*(add_file|patch|delete|rename)\s"(.*?)(?new(); + $automator->open_args("--root", $config{mtnrootdir}, "--key", $config{mtnkey}); + + # Something has been committed, has this file changed? + my ($out, $err); + #$automator->setOpts("-r", $oldrev, "-r", $rev); + #my ($out, $err) = $automator->call("content_diff", $file); + #debug("Problem committing $file") if ($err ne ""); + my $diff = `mtn --root=$config{mtnrootdir} au content_diff -r $oldrev -r $rev $file`; # was just $out; + + if ($diff) { + # this file has changed + # commit a revision with just this file changed off the old revision + # first get the contents + warn("File changed: forming branch\n"); + my $newfile=readfile("$config{srcdir}/$file"); + + # then get the old content ID from the diff + if ($diff !~ m/^---\s$file\s+($sha1_pattern)$/m) { + error("Unable to find previous file ID for $file"); + } + my $oldFileID = $1; + + # get the branch we're working in + ($out, $err) = $automator->call("get_option", "branch"); + chomp $out; + error("Illegal branch name in monotone workspace") if ($out !~ m/^([-\@\w\.]+)$/); + my $branch = $1; + + # then put the new content into the DB (and record the new content ID) + my $newRevID = commit_file_to_new_rev($automator, $file, $oldFileID, $newfile, $oldrev, $branch, $author, $message); + + $automator->close(); + + # if we made it to here then the file has been committed... revert the local copy + if (system($config{mtnbinpath}, "--root=$config{mtnrootdir}", "revert", $file) != 0) { + warn("Unable to revert $file after merge on conflicted commit!"); + } + warn("Divergence created! Attempting auto-merge."); + + check_mergerc(); + + # see if it will merge cleanly + $ENV{MTN_MERGE}="fail"; + my $mergeResult = mtn_merge($newRevID, $rev, $branch, $author, "Auto-merging parallel web edits."); + $ENV{MTN_MERGE}=""; + + # push any changes so far + if (defined($config{mtnsync}) && $config{mtnsync}) { + if (system($config{mtnbinpath}, "--root=$config{mtnrootdir}", "push", "--quiet", "--ticker=none", "--key", $config{mtnkey}) != 0) { + warn("monotone push failed\n"); + } + } + + if (defined($mergeResult)) { + # everything is merged - bring outselves up to date + if (system($config{mtnbinpath}, "--root=$config{mtnrootdir}", "update", "-r", $mergeResult) != 0) { + warn("Unable to update to rev $mergeResult after merge on conflicted commit!"); + } + } else { + warn("Auto-merge failed. Using diff-merge to add conflict markers."); + + $ENV{MTN_MERGE}="diffutils_force"; + my $mergeResult = mtn_merge($newRevID, $rev, $branch, $author, "Merge parallel conflicting web edits (adding inline conflict markers).\nThis revision should be cleaned up manually."); + $ENV{MTN_MERGE}=""; + + if (!defined($mergeResult)) { + warn("Unable to insert conflict markers!"); + error("Your commit succeeded. Unfortunately, someone else committed something to the same\n". + "part of the wiki at the same time. Both versions are stored in the monotone repository,\n". + "but at present the different versions cannot be reconciled through the web interface.\n\n". + "Please use the non-web interface to resolve the conflicts.\n"); + } + + # suspend this revision because it has conflict markers... + if (system($config{mtnbinpath}, "--root=$config{mtnrootdir}", "update", "-r", $mergeResult) != 0) { + warn("Unable to update to rev $mergeResult after conflict-enhanced merge on conflicted commit!"); + } + + # return "conflict enhanced" file to the user for cleanup + # note, this relies on the fact that ikiwiki seems to call rcs_prepedit() again + # after we return + return readfile("$config{srcdir}/$file"); + } + return undef; + } + $automator->close(); + } + + # if we reached here then the file we're looking at hasn't changed since $oldrev. Commit it. + + if (system($config{mtnbinpath}, "--root=$config{mtnrootdir}", "commit", "--quiet", "--author", $author, "--key", $config{mtnkey}, + "-m", possibly_foolish_untaint($message), $file) != 0) { + warn("Traditional commit failed!\nReturning data as conflict.\n"); + my $conflict=readfile("$config{srcdir}/$file"); + if (system($config{mtnbinpath}, "--root=$config{mtnrootdir}", "revert", "--quiet", $file) != 0) { + warn("monotone revert failed\n"); + } + return $conflict; + } + if (defined($config{mtnsync}) && $config{mtnsync}) { + if (system($config{mtnbinpath}, "--root=$config{mtnrootdir}", "sync", "--quiet", "--ticker=none", "--key", $config{mtnkey}) != 0) { + warn("monotone sync failed\n"); + } + } + + return undef # success +} + +sub rcs_add ($) { + # Add a file. The filename is relative to the root of the srcdir. + my $file=shift; + + check_config(); + + if (system($config{mtnbinpath}, "--root=$config{mtnrootdir}", "add", "--quiet", "$config{srcdir}/$file") != 0) { + error("Monotone add failed"); + } +} + +sub rcs_recentchanges ($) { + # Examine the RCS history and generate a list of recent changes. + # The data structure returned for each change is: + # { + # user => # name of user who made the change, + # committype => # either "web" or the name of the rcs, + # when => # time when the change was made, + # message => [ + # { line => "commit message line" }, + # { line => "commit message line" }, + # # etc, + # ], + # pages => [ + # { + # page => # name of page changed, + # diffurl => # optional url to a diff showing + # # the changes, + # }, + # # repeat for each page changed in this commit, + # ], + # } + + my $num=shift; + my @ret; + + check_config(); + + # use log --brief to get a list of revs, as this + # gives the results in a nice order + # (otherwise we'd have to do our own date sorting) + + my @revs; + + my $child = open(MTNLOG, "-|"); + if (! $child) { + exec($config{mtnbinpath}, "log", "--root=$config{mtnrootdir}", "--no-graph", "--brief") || error("mtn log failed to run"); + } + + my $line; + + while (($num >= 0) and ($line = )) { + if ($line =~ m/^($sha1_pattern)/) { + push @revs, $1; + $num -= 1; + } + } + close MTNLOG || warn "mtn log exited $?"; + + my $automator = Monotone->new(); + $automator->open(undef, $config{mtnrootdir}); + + while (@revs != 0) { + my $rev = shift @revs; + # first go through and figure out the messages, etc + + my $certs = [read_certs($automator, $rev)]; + + my $user; + my $when; + my $committype; + my (@pages, @message); + + foreach my $cert (@$certs) { + if ($cert->{signature} eq "ok" && $cert->{trust} eq "trusted") { + if ($cert->{name} eq "author") { + $user = $cert->{value}; + # detect the source of the commit from the changelog + if ($cert->{key} eq $config{mtnkey}) { + $committype = "web"; + } else { + $committype = "monotone"; + } + } elsif ($cert->{name} eq "date") { + $when = time - str2time($cert->{value}, 'UTC'); + } elsif ($cert->{name} eq "changelog") { + my $messageText = $cert->{value}; + # split the changelog into multiple lines + foreach my $msgline (split(/\n/, $messageText)) { + push @message, { line => $msgline }; + } + } + } + } + + my @changed_files = get_changed_files($automator, $rev); + my $file; + + foreach $file (@changed_files) { + push @pages, { + page => pagename($file), + } if length $file; + } + + push @ret, { + rev => $rev, + user => $user, + committype => $committype, + when => $when, + message => [@message], + pages => [@pages], + } if @pages; + } + + $automator->close(); + + return @ret; +} + +sub rcs_notify () { + # This function is called when a change is committed to the wiki, + # and ikiwiki is running as a post-commit hook from the RCS. + # It should examine the repository to somehow determine what pages + # changed, and then send emails to users subscribed to those pages. + + warn("The monotone rcs_notify function is currently untested. Use at own risk!"); + + if (! exists $ENV{REV}) { + error(gettext("REV is not set, not running from mtn post-commit hook, cannot send notifications")); + } + if ($ENV{REV} !~ m/($sha1_pattern)/) { # sha1 is untainted now + error(gettext("REV is not a valid revision identifier, cannot send notifications")); + } + my $rev = $1; + + check_config(); + + my $automator = Monotone->new(); + $automator->open(undef, $config{mtnrootdir}); + + my $certs = [read_certs($automator, $rev)]; + my $user; + my $message; + my $when; + + foreach my $cert (@$certs) { + if ($cert->{signature} eq "ok" && $cert->{trust} eq "trusted") { + if ($cert->{name} eq "author") { + $user = $cert->{value}; + } elsif ($cert->{name} eq "date") { + $when = $cert->{value}; + } elsif ($cert->{name} eq "changelog") { + $message = $cert->{value}; + } + } + } + + my @changed_pages = get_changed_files($automator, $rev); + + $automator->close(); + + require IkiWiki::UserInfo; + send_commit_mails( + sub { + return $message; + }, + sub { + `$config{mtnbinpath} --root=$config{mtnrootdir} au content_diff -r $rev`; + }, $user, @changed_pages); +} + +sub rcs_getctime ($) { + # Optional, used to get the page creation time from the RCS. + # error gettext("getctime not implemented"); + my $file=shift; + + check_config(); + + my $child = open(MTNLOG, "-|"); + if (! $child) { + exec($config{mtnbinpath}, "log", "--root=$config{mtnrootdir}", "--no-graph", "--brief", $file) || error("mtn log $file failed to run"); + } + + my $firstRev; + while () { + if (/^($sha1_pattern)/) { + $firstRev=$1; + } + } + close MTNLOG || warn "mtn log $file exited $?"; + + if (! defined $firstRev) { + warn "failed to parse mtn log for $file\n"; + return 0; + } + + my $automator = Monotone->new(); + $automator->open(undef, $config{mtnrootdir}); + + my $certs = [read_certs($automator, $firstRev)]; + + $automator->close(); + + my $date; + + foreach my $cert (@$certs) { + if ($cert->{signature} eq "ok" && $cert->{trust} eq "trusted") { + if ($cert->{name} eq "date") { + $date = $cert->{value}; + } + } + } + + if (! defined $date) { + warn "failed to find date cert for revision $firstRev when looking for creation time of $file\n"; + return 0; + } + + $date=str2time($date, 'UTC'); + debug("found ctime ".localtime($date)." for $file"); + return $date; +} diff --git a/debian/changelog b/debian/changelog index 267274cf8..5bcf097db 100644 --- a/debian/changelog +++ b/debian/changelog @@ -44,8 +44,9 @@ ikiwiki (2.6) UNRELEASED; urgency=low * Pass buttons to all other formbuilder_setup hooks too. * Add color parameter to postsparkline. Closes: #438900 * Add proper Homepage field to Debian package (needs uber-new dpkg). + * Add monotone support, contributed by William Uther. - -- Joey Hess Mon, 20 Aug 2007 16:21:05 -0400 + -- Joey Hess Mon, 20 Aug 2007 23:09:11 -0400 ikiwiki (2.5) unstable; urgency=low diff --git a/doc/ikiwiki.setup b/doc/ikiwiki.setup index a9a9b9f19..864dc928f 100644 --- a/doc/ikiwiki.setup +++ b/doc/ikiwiki.setup @@ -43,6 +43,20 @@ use IkiWiki::Setup::Standard { #historyurl => "http://localhost:8000/", # hg serve'd local repository #diffurl => "http://localhost:8000/?fd=[[changeset]];file=[[file]]", + # Monotone stuff + #rcs => "monotone", + #mtnkey => "web\@machine.company.com", + # Monotone options + #mtnsync => 0, # set this if you want the wiki to sync on update and commit + #mtnrootdir => "path/to/root/of/workspace", # The path to your workspace (defaults to the srcdir itself) + # e.g. use if your srcdir is a subdirectory of the workspace + #mtnbinpath => "path/to/montone/binary", # by default we just use "mtn" and assume it is in your path. + #mtnmergerc => "path/to/mergerc", # this is a monotone lua hook file used by ikiwiki for + # inserting conflict markers. By default we use + # mtnrootdir/_MTN/mergerc. This hook will be populated with + # default code the first time you use ikiwiki. You can + # change it to alter how conflict markers are inserted. + wrappers => [ #{ # # The cgi wrapper. diff --git a/doc/setup.mdwn b/doc/setup.mdwn index abd6ac7ad..8e5653442 100644 --- a/doc/setup.mdwn +++ b/doc/setup.mdwn @@ -154,6 +154,32 @@ This tutorial will walk you through setting up a wiki with ikiwiki. hg commit -m "initial import" """]] + [[toggle id=monotone text="Monotone"]] + [[toggleable id=montone text=""" + # These instructions are standard instructions to import a directory into monotone + # and set it up so that you don't need any passwords to use it + REPOSITORY=~/.ikiwiki/mtn.db + BRANCH=com.company.wikiname + # remember the password you use in the next step and + # substitute it for 'wikiKeyPass' in the get_passphrase() hook below + # note the you should never generate two monotone keys with the same name + mtn genkey web@machine.company.com + mtn db init --db=$REPOSITORY + mv $SRCDIR $SRCDIR-old + cd $SRCDIR-old + echo ".ikiwiki" > $SRCDIR-old/.mtn-ignore + mtn --db=$REPOSITORY --branch=$BRANCH import . -m "initial import" + cd .. + mtn --db=$REPOSITORY --branch=$BRANCH checkout $SRCDIR + mv $SRCDIR-old/.ikiwiki $SRCDIR + cat << EOF > $SRCDIR/_MTN/monotonerc + function get_passphrase (branchname) + return "wikiKeyPass" + end + EOF + rm -r $SRCDIR-old + """]] + 9. Configure ikiwiki to use revision control. Once your wiki is checked in to the revision control system, -- 2.32.0.93.g670b81a890