implement File finding

lib/gollum/file.rb

@@ -1,6 +1,6 @@
 module Gollum
   class File
-    attr_accessor :wiki
+    attr_accessor :wiki, :blob
 
     # Initialize a file.
     #
@@ -10,5 +10,28 @@ module Gollum
     def initialize(wiki)
       self.wiki = wiki
     end
+
+    # The raw contents of the page.
+    #
+    # Returns the String data.
+    def raw_data
+      self.blob.data rescue nil
+    end
+
+    # Find a file in the given Gollum repo.
+    #
+    # name    - The full String path.
+    # version - The String version ID to find.
+    #
+    # Returns a Gollum::File or nil if the file could not be found.
+    def find(name, version)
+      commit = self.wiki.repo.commit(version)
+      if blob = commit.tree / name
+        self.blob = blob
+        self
+      else
+        nil
+      end
+    end
   end
 end

lib/gollum/wiki.rb

@@ -24,11 +24,12 @@ module Gollum
 
     # Get the static file for a given name.
     #
-    # name - The full String pathname to the file.
+    # name    - The full String pathname to the file.
+    # version - The String version ID to find (default: "master").
     #
     # Returns a Gollum::File or nil if no matching file was found.
-    def file(name)
-      File.new(self).find(name)
+    def file(name, version = 'master')
+      File.new(self).find(name, version)
     end
   end
 end

test/examples/lotr.git/refs/heads/master

@@ -1 +1 @@
-fbabba862dfa7ac35b39042dd4ad780c9f67b8cb
+f01428b3138994aab19d5f880b6f37336ddf1f24

test/test_file.rb

@@ -7,5 +7,11 @@ context "File" do
 
   test "new file" do
     file = Gollum::File.new(@wiki)
+    assert_nil file.raw_data
+  end
+
+  test "existing file" do
+    file = @wiki.file("Mordor/todo.txt")
+    assert_equal "[ ] Write section on Ents\n", file.raw_data
   end
 end

test/test_page.rb

@@ -18,7 +18,7 @@ context "Page" do
     assert page.formatted_data =~ /<h1>Bilbo Baggins<\/h1>\n\n<p>Bilbo Baggins/
     assert_equal 'Bilbo-Baggins.md', page.path
     assert_equal :markdown, page.format
-    assert_equal 'fbabba862dfa7ac35b39042dd4ad780c9f67b8cb', page.version.id
+    assert_equal @wiki.repo.commits.first.id, page.version.id
   end
 
   test "get nested page" do