read-only-gollum 1.4.0

data/lib/gollum/frontend/views/create.rb

@@ -0,0 +1,48 @@
+module Precious
+  module Views
+    class Create < Layout
+      include Editable
+
+      attr_reader :page, :name
+
+      def title
+        "Create a new page"
+      end
+
+      def is_create_page
+        true
+      end
+
+      def is_edit_page
+        false
+      end
+
+      def format
+        @format = (@page.format || false) if @format.nil? && @page
+        @format.to_s.downcase
+      end
+
+      def has_footer
+        @footer = (@page.footer || false) if @footer.nil? && @page
+        !!@footer
+      end
+
+      def has_sidebar
+        @sidebar = (@page.sidebar || false) if @sidebar.nil? && @page
+        !!@sidebar
+      end
+
+      def page_name
+        @name.gsub('-', ' ')
+      end
+
+      def formats
+        super(:markdown)
+      end
+
+      def default_markup
+        Precious::App.settings.default_markup
+      end
+    end
+  end
+end

data/lib/gollum/frontend/views/edit.rb

@@ -0,0 +1,52 @@
+module Precious
+  module Views
+    class Edit < Layout
+      include Editable
+
+      attr_reader :page, :content
+
+      def title
+        "#{@page.title}"
+      end
+
+      def page_name
+        @name.gsub('-', ' ')
+      end
+
+      def footer
+        if @footer.nil?
+          if page = @page.footer
+            @footer = page.raw_data
+          else
+            @footer = false
+          end
+        end
+        @footer
+      end
+
+      def sidebar
+        if @sidebar.nil?
+          if page = @page.sidebar
+            @sidebar = page.raw_data
+          else
+            @sidebar = false
+          end
+        end
+        @sidebar
+      end
+
+      def is_create_page
+        false
+      end
+
+      def is_edit_page
+        true
+      end
+
+      def format
+        @format = (@page.format || false) if @format.nil?
+        @format.to_s.downcase
+      end
+    end
+  end
+end

data/lib/gollum/frontend/views/editable.rb

@@ -0,0 +1,13 @@
+module Precious
+  module Editable
+    def formats(selected = @page.format)
+      Gollum::Page::FORMAT_NAMES.map do |key, val|
+        { :name     => val,
+          :id       => key.to_s,
+          :selected => selected == key}
+      end.sort do |a, b|
+        a[:name].downcase <=> b[:name].downcase
+      end
+    end
+  end
+end

data/lib/gollum/frontend/views/error.rb

@@ -0,0 +1,7 @@
+module Precious
+  module Views
+    class Error < Layout
+      attr_reader :message
+    end
+  end
+end

data/lib/gollum/frontend/views/history.rb

@@ -0,0 +1,44 @@
+module Precious
+  module Views
+    class History < Layout
+      attr_reader :page, :page_num
+
+      def title
+        @page.title
+      end
+
+      def versions
+        i = @versions.size + 1
+        @versions.map do |v|
+          i -= 1
+          { :id       => v.id,
+            :id7      => v.id[0..6],
+            :num      => i,
+            :selected => @page.version.id == v.id,
+            :author   => v.author.name,
+            :message  => v.message,
+            :date     => v.committed_date.strftime("%B %d, %Y"),
+            :gravatar => Digest::MD5.hexdigest(v.author.email) }
+        end
+      end
+
+      def previous_link
+        label = "&laquo; Previous"
+        if @page_num == 1
+          %(<span class="disabled">#{label}</span>)
+        else
+          %(<a href="/history/#{@page.name}?page=#{@page_num-1}" hotkey="h">#{label}</a>)
+        end
+      end
+
+      def next_link
+        label = "Next &raquo;"
+        if @versions.size == Gollum::Page.per_page
+          %(<a href="/history/#{@page.name}?page=#{@page_num+1}" hotkey="l">#{label}</a>)
+        else
+          %(<span class="disabled">#{label}</span>)
+        end
+      end
+    end
+  end
+end

data/lib/gollum/frontend/views/layout.rb

@@ -0,0 +1,20 @@
+require 'cgi'
+
+module Precious
+  module Views
+    class Layout < Mustache
+      include Rack::Utils
+      alias_method :h, :escape_html
+
+      attr_reader :name
+
+      def escaped_name
+        CGI.escape(@name)
+      end
+
+      def title
+        "Home"
+      end
+    end
+  end
+end

data/lib/gollum/frontend/views/page.rb

@@ -0,0 +1,57 @@
+module Precious
+  module Views
+    class Page < Layout
+      attr_reader :content, :page, :footer
+      DATE_FORMAT = "%Y-%m-%d %H:%M:%S"
+      DEFAULT_AUTHOR = 'you'
+
+      def title
+        @page.title
+      end
+
+      def format
+        @page.format.to_s
+      end
+
+      def author
+        return DEFAULT_AUTHOR unless @page.version
+        @page.version.author.name
+      end
+
+      def date
+        return Time.now.strftime(DATE_FORMAT) unless @page.version
+        @page.version.authored_date.strftime(DATE_FORMAT)
+      end
+
+      def editable
+        @editable
+      end
+
+      def has_footer
+        @footer = (@page.footer || false) if @footer.nil?
+        !!@footer
+      end
+
+      def footer_content
+        has_footer && @footer.formatted_data
+      end
+
+      def footer_format
+        has_footer && @footer.format.to_s
+      end
+
+      def has_sidebar
+        @sidebar = (@page.sidebar || false) if @sidebar.nil?
+        !!@sidebar
+      end
+
+      def sidebar_content
+        has_sidebar && @sidebar.formatted_data
+      end
+
+      def sidebar_format
+        has_sidebar && @sidebar.format.to_s
+      end
+    end
+  end
+end

data/lib/gollum/frontend/views/pages.rb

@@ -0,0 +1,19 @@
+module Precious
+  module Views
+    class Pages < Layout
+      attr_reader :results, :ref
+
+      def title
+        "All pages in #{@ref}"
+      end
+
+      def has_results
+        !@results.empty?
+      end
+
+      def no_results
+        @results.empty?
+      end
+    end
+  end
+end

data/lib/gollum/frontend/views/search.rb

@@ -0,0 +1,20 @@
+module Precious
+  module Views
+    class Search < Layout
+      attr_reader :content, :page, :footer, :results, :query
+
+      def title
+        "Search results for " + @query
+      end
+
+      def has_results
+        !@results.empty?
+      end
+
+      def no_results
+        @results.empty?
+      end
+
+    end
+  end
+end

data/lib/gollum/git_access.rb

@@ -0,0 +1,248 @@
+module Gollum
+  # Controls all access to the Git objects from Gollum.  Extend this class to
+  # add custom caching for special cases.
+  class GitAccess
+    # Initializes the GitAccess instance.
+    #
+    # path          - The String path to the Git repository that holds the
+    #                 Gollum site.
+    # page_file_dir - String the directory in which all page files reside
+    #
+    # Returns this instance.
+    def initialize(path, page_file_dir = nil)
+      @page_file_dir = page_file_dir
+      @path = path
+      @repo = Grit::Repo.new(path)
+      clear
+    end
+
+    # Public: Determines whether the Git repository exists on disk.
+    #
+    # Returns true if it exists, or false.
+    def exist?
+      @repo.git.exist?
+    end
+
+    # Public: Converts a given Git reference to a SHA, using the cache if
+    # available.
+    #
+    # ref - a String Git reference (ex: "master")
+    #
+    # Returns a String, or nil if the ref isn't found.
+    def ref_to_sha(ref)
+      ref = ref.to_s
+      return if ref.empty?
+      sha =
+        if sha?(ref)
+          ref
+        else
+          get_cache(:ref, ref) { ref_to_sha!(ref) }
+        end.to_s
+      sha.empty? ? nil : sha
+    end
+
+    # Public: Gets a recursive list of Git blobs for the whole tree at the
+    # given commit.
+    #
+    # ref - A String Git reference or Git SHA to a commit.
+    #
+    # Returns an Array of BlobEntry instances.
+    def tree(ref)
+      if sha = ref_to_sha(ref)
+        get_cache(:tree, sha) { tree!(sha) }
+      else
+        []
+      end
+    end
+
+    # Public: Fetches the contents of the Git blob at the given SHA.
+    #
+    # sha - A String Git SHA.
+    #
+    # Returns the String content of the blob.
+    def blob(sha)
+      cat_file!(sha)
+    end
+
+    # Public: Looks up the Git commit using the given Git SHA or ref.
+    #
+    # ref - A String Git SHA or ref.
+    #
+    # Returns a Grit::Commit.
+    def commit(ref)
+      if sha?(ref)
+        get_cache(:commit, ref) { commit!(ref) }
+      else
+        if sha = get_cache(:ref, ref)
+          commit(sha)
+        else
+          if cm = commit!(ref)
+            set_cache(:ref,    ref,   cm.id)
+            set_cache(:commit, cm.id, cm)
+          end
+        end
+      end
+    end
+
+    # Public: Clears all of the cached data that this GitAccess is tracking.
+    #
+    # Returns nothing.
+    def clear
+      @ref_map    = {}
+      @tree_map   = {}
+      @commit_map = {}
+    end
+
+    # Public: Refreshes just the cached Git reference data.  This should
+    # be called after every Gollum update.
+    #
+    # Returns nothing.
+    def refresh
+      @ref_map.clear
+    end
+
+    #########################################################################
+    #
+    # Internal Methods
+    #
+    #########################################################################
+
+    # Gets the String path to the Git repository.
+    attr_reader :path
+
+    # Gets the Grit::Repo instance for the Git repository.
+    attr_reader :repo
+
+    # Gets a Hash cache of refs to commit SHAs.
+    #
+    #   {"master" => "abc123", ...}
+    #
+    attr_reader :ref_map
+
+    # Gets a Hash cache of commit SHAs to a recursive tree of blobs.
+    #
+    #   {"abc123" => [<BlobEntry>, <BlobEntry>]}
+    #
+    attr_reader :tree_map
+
+    # Gets a Hash cache of commit SHAs to the Grit::Commit instance.
+    #
+    #     {"abcd123" => <Grit::Commit>}
+    #
+    attr_reader :commit_map
+
+    # Checks to see if the given String is a 40 character hex SHA.
+    #
+    # str - Possible String SHA.
+    #
+    # Returns true if the String is a SHA, or false.
+    def sha?(str)
+      !!(str =~ /^[0-9a-f]{40}$/)
+    end
+
+    # Looks up the Git SHA for the given Git ref.
+    #
+    # ref - String Git ref.
+    #
+    # Returns a String SHA.
+    def ref_to_sha!(ref)
+      @repo.git.rev_list({:max_count=>1}, ref)
+    rescue Grit::GitRuby::Repository::NoSuchShaFound
+    end
+
+    # Looks up the Git blobs for a given commit.
+    #
+    # sha - String commit SHA.
+    #
+    # Returns an Array of BlobEntry instances.
+    def tree!(sha)
+      tree  = @repo.git.native(:ls_tree,
+        {:r => true, :l => true, :z => true}, sha)
+      if tree.respond_to?(:force_encoding)
+        tree.force_encoding("UTF-8")
+      end
+      items = tree.split("\0").inject([]) do |memo, line|
+        memo << parse_tree_line(line)
+      end
+
+      if dir = @page_file_dir
+        regex = /^#{dir}\//
+        items.select { |i| i.path =~ regex }
+      else
+        items
+      end
+    end
+
+    # Reads the content from the Git db at the given SHA.
+    #
+    # sha - The String SHA.
+    #
+    # Returns the String content of the Git object.
+    def cat_file!(sha)
+      @repo.git.cat_file({:p => true}, sha)
+    end
+
+    # Reads a Git commit.
+    #
+    # sha - The string SHA of the Git commit.
+    #
+    # Returns a Grit::Commit.
+    def commit!(sha)
+      @repo.commit(sha)
+    end
+
+    # Attempts to get the given data from a cache.  If it doesn't exist, it'll
+    # pass the results of the yielded block to the cache for future accesses.
+    #
+    # name - The cache prefix used in building the full cache key.
+    # key  - The unique cache key suffix, usually a String Git SHA.
+    #
+    # Yields a block to pass to the cache.
+    # Returns the cached result.
+    def get_cache(name, key)
+      cache = instance_variable_get("@#{name}_map")
+      value = cache[key]
+      if value.nil? && block_given?
+        set_cache(name, key, value = yield)
+      end
+      value == :_nil ? nil : value
+    end
+
+    # Writes some data to the internal cache.
+    #
+    # name  - The cache prefix used in building the full cache key.
+    # key   - The unique cache key suffix, usually a String Git SHA.
+    # value - The value to write to the cache.
+    #
+    # Returns nothing.
+    def set_cache(name, key, value)
+      cache      = instance_variable_get("@#{name}_map")
+      cache[key] = value || :_nil
+    end
+
+    # Parses a line of output from the `ls-tree` command.
+    #
+    # line - A String line of output:
+    #          "100644 blob 839c2291b30495b9a882c17d08254d3c90d8fb53  Home.md"
+    #
+    # Returns an Array of BlobEntry instances.
+    def parse_tree_line(line)
+      mode, type, sha, size, *name = line.split(/\s+/)
+      BlobEntry.new(sha, name.join(' '), size.to_i)
+    end
+
+    # Decode octal sequences (\NNN) in tree path names.
+    #
+    # path - String path name.
+    #
+    # Returns a decoded String.
+    def decode_git_path(path)
+      if path[0] == ?" && path[-1] == ?"
+        path = path[1...-1]
+        path.gsub!(/\\\d{3}/)   { |m| m[1..-1].to_i(8).chr }
+      end
+      path.gsub!(/\\[rn"\\]/) { |m| eval(%("#{m.to_s}")) }
+      path
+    end
+  end
+end