historian 0.0.1

data/spec/fixtures/after_0_0_2_history

@@ -0,0 +1,17 @@
+== In Git
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2
+
+
+== 0.0.2 Bubbling Baboon
+
+=== Bugfixes
+* more fur
+
+
+== 0.0.1 Addled Adder
+
+=== Bugfixes
+* more scales

data/spec/fixtures/all_types_history

@@ -0,0 +1,17 @@
+== In Git
+
+=== Major Changes
+* major #1
+
+=== Minor Changes
+* minor #1
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2
+
+
+== 11.22.33 Addled Adder
+
+=== Bugfixes
+* more scales

data/spec/fixtures/anonymous_release_log

@@ -0,0 +1,7 @@
+== 12.0.0 - 2010/12/12
+
+=== Major Changes
+* major #1
+
+=== Bugfixes
+* bugfix #1

data/spec/fixtures/arbitrary_text

@@ -0,0 +1,21 @@
+== In Git
+
+=== Major Changes
+* major #1
+
+=== Minor Changes
+* minor #1
+
+This line has some arbitrary text, which would be nice to support
+without having the parser blow up, really, but for now it'll have to do
+to at least be strict about the format.
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2
+
+
+== 11.22.33 Addled Adder
+
+=== Bugfixes
+* more scales

data/spec/fixtures/courageous_camel_history

@@ -0,0 +1,13 @@
+== 12.0.0 Courageous Camel - 2010/12/12
+
+=== Major Changes
+* major #1
+
+=== Bugfixes
+* bugfix #1
+
+
+== 11.22.33 Addled Adder
+
+=== Bugfixes
+* more scales

data/spec/fixtures/courageous_camel_release_log

@@ -0,0 +1,7 @@
+== 12.0.0 Courageous Camel - 2010/12/12
+
+=== Major Changes
+* major #1
+
+=== Bugfixes
+* bugfix #1

data/spec/fixtures/invalid_significance

@@ -0,0 +1,17 @@
+== In Git
+
+=== This Line Is An Invalid Significance
+* major #1
+
+=== Minor Changes
+* minor #1
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2
+
+
+== 11.22.33 Addled Adder
+
+=== Bugfixes
+* more scales

data/spec/fixtures/missing_significance

@@ -0,0 +1,16 @@
+== In Git
+
+* this line does not follow a significance (triple-equals) marker
+
+=== Minor Changes
+* minor #1
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2
+
+
+== 11.22.33 Addled Adder
+
+=== Bugfixes
+* more scales

data/spec/fixtures/normal

@@ -0,0 +1,10 @@
+== In Git
+
+=== Bugfixes
+* bugfix #1
+
+
+== 11.22.33 Addled Adder
+
+=== Bugfixes
+* more scales

data/spec/fixtures/normal_changelog_after_major

@@ -0,0 +1,11 @@
+== In Git
+
+=== Major Changes
+* major #1
+
+=== Minor Changes
+* minor #1
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2

data/spec/fixtures/normal_changelog_after_minor

@@ -0,0 +1,8 @@
+== In Git
+
+=== Minor Changes
+* minor #1
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2

data/spec/fixtures/normal_history_after_major

@@ -0,0 +1,17 @@
+== In Git
+
+=== Major Changes
+* major #1
+
+=== Minor Changes
+* minor #1
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2
+
+
+== 11.22.33 Addled Adder
+
+=== Bugfixes
+* more scales

data/spec/fixtures/normal_history_after_minor

@@ -0,0 +1,14 @@
+== In Git
+
+=== Minor Changes
+* minor #1
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2
+
+
+== 11.22.33 Addled Adder
+
+=== Bugfixes
+* more scales

data/spec/fixtures/patch_on_nothing

@@ -0,0 +1,5 @@
+== In Git
+
+=== Bugfixes
+* bugfix #1
+

data/spec/fixtures/release_on_nothing

@@ -0,0 +1 @@
+== 0.0.1 Addled Adder - 2010/12/12

data/spec/fixtures/second_patch_on_nothing

@@ -0,0 +1,6 @@
+== In Git
+
+=== Bugfixes
+* bugfix #1
+* bugfix #2
+

data/spec/historian/cli_spec.rb

@@ -0,0 +1,210 @@
+require 'spec_helper'
+
+describe Historian::CLI do
+  include GitHelpers
+
+  before do
+    create_test_repo
+    Dir.chdir repo_directory
+  end
+
+  context "on initialization" do
+    it "finds the root of the current git repository" do
+      subdir = File.join repo_directory, "subdir/subdir"
+      FileUtils.mkdir_p subdir
+      Dir.chdir subdir
+      Dir.pwd.should eql(subdir)
+      cli = Historian::CLI.new
+      cli.git.repo_directory.should eq(repo_directory)
+    end
+
+    it "creates a history file if none exists" do
+      ProjectScout.stub :scan => repo_directory
+      File.should_receive(:exists?).and_return(false)
+      File.stub(:open).and_return(StringIO.new)
+      File.should_receive(:open).at_least(:once).with(/History.txt/, "w")
+      cli = Historian::CLI.new
+    end
+
+    it "initializes a GitHookInstaller with the repository directory" do
+      Historian::Git.should_receive(:new).with(repo_directory, anything).and_return(@ghi)
+      cli = Historian::CLI.new
+    end
+
+  end
+
+  describe "#commit-msg" do
+    before do
+      @message_file = "/tmp/historian_test_message"
+      @cli = Historian::CLI.new
+    end
+
+    context "when an amendment flag exists" do
+      before do
+        @amend_flag = File.join(repo_directory, ".git", "historian-amend")
+        File.open(@amend_flag, "w")
+      end
+
+      it "does not parse the commit message" do
+        File.should_not_receive(:open).with(@message_file)
+        @cli.commit_msg @message_file
+      end
+    end
+
+    context "when message contains no historian tokens" do
+      before do
+        File.open(@message_file, "w") do |f|
+          f.puts "test bugfix"
+        end
+        @cli.commit_msg @message_file
+      end
+
+      after do
+        File.unlink @message_file
+      end
+
+      it "doesn't create an amend flag" do
+        amend_flag = File.join(repo_directory, ".git", "historian-amend")
+        File.exists?(amend_flag).should be_false
+      end
+
+      it "doesn't update the history file" do
+        history_file = File.join repo_directory, "History.txt"
+        modified?(history_file).should be_false
+      end
+    end
+
+    context "when message contains historian tokens" do
+      before do
+        File.open(@message_file, "w") do |f|
+          f.puts "b:test bugfix"
+        end
+        @cli.commit_msg @message_file
+      end
+
+      after do
+        File.unlink @message_file
+      end
+
+      it "creates an amend flag" do
+        amend_flag = File.join(repo_directory, ".git", "historian-amend")
+        File.exists?(amend_flag).should be_true
+      end
+
+      it "updates the history file" do
+        history_file = File.join repo_directory, "History.txt"
+        history = File.readlines(history_file)
+        history.grep(/test bugfix/).should have(1).match
+        modified?(history_file).should be_true
+      end
+
+      it "strips the tokens out of the message file" do
+        File.read(@message_file).should_not match(/b:/)
+      end
+
+      it "updates the commit message with tokens and suppressed lines removed" do
+        File.read(@message_file).should eq("test bugfix\n")
+      end
+    end
+
+    context "when the message contains a release token" do
+      before do
+        File.open(@message_file, "w") do |f|
+          f.puts "!:Addled Adder"
+        end
+        @cli.commit_msg @message_file
+      end
+
+      after do
+        File.unlink @message_file
+      end
+
+      it "creates a release flag" do
+        release_flag = File.join(repo_directory, ".git", "historian-release")
+        File.exists?(release_flag).should be_true
+      end
+
+      it "creates an amend flag" do
+        amend_flag = File.join(repo_directory, ".git", "historian-amend")
+        File.exists?(amend_flag).should be_true
+      end
+
+      it "strips the tokens out of the message file" do
+        File.read(@message_file).should_not match(/!:/)
+      end
+
+      it "updates the history file" do
+        history_file = File.join repo_directory, "History.txt"
+        history = File.readlines(history_file)
+        history.grep(/== 0.0.1 Addled Adder/).should have(1).match
+        modified?(history_file).should be_true
+      end
+    end
+  end
+
+  describe "#install" do
+    before do
+      @git = mock("Historian::Git", :install_hook => nil)
+      Historian::Git.stub(:new).and_return(@git)
+      @cli = Historian::CLI.new
+    end
+
+    subject { @cli }
+
+    it "installs the commit-msg hook" do
+      @git.should_receive(:install_hook).with(:commit_msg).at_least(:once)
+      subject.install
+    end
+
+    it "installs the post-commit hook" do
+      @git.should_receive(:install_hook).at_least(:once).with(:post_commit)
+      subject.install
+    end
+  end
+
+
+  describe "#post-commit" do
+    before do
+      @git = mock("Historian::Git",
+                  :bundle_history_file => nil,
+                  :tag_release => nil)
+      Historian::Git.stub(:new).and_return(@git)
+      @cli = Historian::CLI.new
+    end
+
+    context "when an amendment flag exists" do
+      before do
+        @amend_flag = File.join(repo_directory, ".git", "historian-amend")
+        File.open(@amend_flag, "w")
+      end
+
+      it "bundles the history file" do
+        @git.should_receive :bundle_history_file
+        @cli.post_commit
+      end
+
+      it "deletes the amendment flag" do
+        @cli.post_commit
+        File.exists?(@amend_flag).should_not be_true
+      end
+    end
+
+    context "when a release flag exists" do
+      before do
+        @release_flag = File.join(repo_directory, ".git", "historian-release")
+        File.open(@release_flag, "w")
+      end
+
+      it "tags the release" do
+        @git.should_receive :tag_release
+        @cli.post_commit
+      end
+
+      it "deletes the release flag" do
+        @cli.post_commit
+        File.exists?(@release_flag).should_not be_true
+      end
+    end
+  end
+
+end

data/spec/historian/commit_message_spec.rb

@@ -0,0 +1,95 @@
+require 'spec_helper'
+
+describe Historian::CommitMessage do
+  describe "#parse line" do
+    describe "#supressed?" do
+      subject { Historian::CommitMessage.parse_line(@line) }
+
+      it "is suppressed if the line contains a supression token" do
+        @line = "b#: suppress me"
+        subject.should be_suppressed
+      end
+
+      it "is not suppressed if the line doesn't have a suppression token" do
+        @line = "b: don't suppress me"
+        subject.should_not be_suppressed
+      end
+
+      it "is not suppressed if the line has no Historian token" do
+        @line = "x: not really a token!"
+        subject.should_not be_suppressed
+      end
+    end
+
+    describe "#to_s" do
+      subject { Historian::CommitMessage.parse_line(@line).to_s }
+
+      it "returns the input if the string contains no Historian token" do
+        @line = "a line without a token"
+        subject.should eq(@line)
+      end
+      it "is strips the Historian token from the string if present" do
+        @line = "M: * major!"
+        subject.should eq(" * major!")
+      end
+    end
+
+    describe "#to_messsage_s" do
+      subject { Historian::CommitMessage.parse_line(@line).to_message_s }
+
+      it "is nil with no token" do
+        @line = "no token"
+        subject.should be_nil
+      end
+
+      it "strips whitespace from the beginning of the string" do
+        @line = "M: major!"
+        subject.should eq("major!")
+      end
+
+      it "strips non alphanumeric characters from the beginning of the string" do
+        @line = "M: * major!"
+        subject.should eq("major!")
+      end
+    end
+
+    describe "#significance" do
+      subject { Historian::CommitMessage.parse_line(@line).significance }
+
+      it "is nil with token that doesn't precede an alphanumeric" do
+        @line = "b: * ^^ !"
+        subject.should be_nil
+      end
+
+      it "is nil with no Historian token" do
+        @line = "there's no token here"
+        subject.should be_nil
+      end
+
+      it "is nil if the token doesn't start at the beginning of the line" do
+        @line = " b: this isn't a bugfix"
+        subject.should be_nil
+      end
+
+      it "is :patch with a bugfix token" do
+        @line = "b: this is a bugfix"
+        subject.should eq(:patch)
+      end
+
+      it "is :minor with a minor improvement token" do
+        @line = "m: this is a minor improvement"
+        subject.should eq(:minor)
+      end
+
+      it "is :major with a major improvement token" do
+        @line = "M: this is a major improvement"
+        subject.should eq(:major)
+      end
+
+      it "is :release with a release token" do
+        @line = "!: this is a release"
+        subject.should eq(:release)
+      end
+    end
+  end
+end