bringit 1.0.0

data/lib/bringit/rev_list.rb

@@ -0,0 +1,40 @@
+module Bringit
+  class RevList
+    attr_reader :repository, :env
+
+    ALLOWED_VARIABLES = %w[GIT_OBJECT_DIRECTORY GIT_ALTERNATE_OBJECT_DIRECTORIES].freeze
+
+    def initialize(oldrev, newrev, repository:, env: nil)
+      @repository = repository
+      @env = env.presence || {}
+      @args = ["git",
+                "--git-dir=#{repository.path}",
+                "rev-list",
+                "--max-count=1",
+                oldrev,
+                "^#{newrev}"]
+    end
+
+    def execute
+      Bringit::Popen.popen(@args, nil, parse_environment_variables)
+    end
+
+    def valid?
+      environment_variables.all? do |(name, value)|
+        value.to_s.start_with?(repository.path)
+      end
+    end
+
+    private
+
+    def parse_environment_variables
+      return {} unless valid?
+
+      environment_variables
+    end
+
+    def environment_variables
+      @environment_variables ||= env.slice(*ALLOWED_VARIABLES).compact
+    end
+  end
+end

data/lib/bringit/tag.rb

@@ -0,0 +1,19 @@
+module Bringit
+  class Tag < Ref
+    attr_reader :object_sha
+
+    def self.find(repository, name)
+      repository.tags.find { |tag| tag.name == name }
+    end
+
+    def initialize(repository, name, target, message = nil)
+      super(repository, name, target)
+
+      @message = message
+    end
+
+    def message
+      encode! @message
+    end
+  end
+end

data/lib/bringit/tree.rb

@@ -0,0 +1,104 @@
+module Bringit
+  class Tree
+    include Bringit::EncodingHelper
+
+    attr_accessor :id, :root_id, :name, :path, :type,
+      :mode, :commit_id, :submodule_url
+
+    class << self
+      # Get list of tree objects
+      # for repository based on commit sha and path
+      # Uses rugged for raw objects
+      def where(repository, sha, path = nil)
+        path = path&.sub(%r{\A/*}, '')
+        path = nil if path == '' || path == '/'
+
+        commit = repository.lookup(sha)
+        root_tree = commit.tree
+
+        tree = if path
+                  id = find_id_by_path(repository, root_tree.oid, path)
+                  if id
+                    repository.lookup(id)
+                  else
+                    []
+                  end
+                else
+                  root_tree
+                end
+
+        tree.map do |entry|
+          new(
+            id: entry[:oid],
+            root_id: root_tree.oid,
+            name: entry[:name],
+            type: entry[:type],
+            mode: entry[:filemode],
+            path: path ? File.join(path, entry[:name]) : entry[:name],
+            commit_id: sha,
+          )
+        end
+      end
+
+      # Recursive search of tree id for path
+      #
+      # Ex.
+      #   blog/            # oid: 1a
+      #     app/           # oid: 2a
+      #       models/      # oid: 3a
+      #       views/       # oid: 4a
+      #
+      #
+      # Tree.find_id_by_path(repo, '1a', 'app/models') # => '3a'
+      #
+      def find_id_by_path(repository, root_id, path)
+        root_tree = repository.lookup(root_id)
+        path = path.sub(%r{\A/*}, '')
+        path_arr = path.split('/')
+
+        entry = root_tree.find do |entry|
+          entry[:name] == path_arr[0] && entry[:type] == :tree
+        end
+
+        return nil unless entry
+
+        if path_arr.size > 1
+          path_arr.shift
+          find_id_by_path(repository, entry[:oid], path_arr.join('/'))
+        else
+          entry[:oid]
+        end
+      end
+    end
+
+    def initialize(options)
+      %w(id root_id name path type mode commit_id).each do |key|
+        self.send("#{key}=", options[key.to_sym])
+      end
+    end
+
+    def name
+      encode! @name
+    end
+
+    def dir?
+      type == :tree
+    end
+
+    def file?
+      type == :blob
+    end
+
+    def submodule?
+      type == :commit
+    end
+
+    def readme?
+      name =~ /^readme/i
+    end
+
+    def contributing?
+      name =~ /^contributing/i
+    end
+  end
+end

data/lib/bringit/util.rb

@@ -0,0 +1,16 @@
+module Bringit
+  module Util
+    LINE_SEP = "\n".freeze
+
+    def self.count_lines(string)
+      case string[-1]
+      when nil
+        0
+      when LINE_SEP
+        string.count(LINE_SEP)
+      else
+        string.count(LINE_SEP) + 1
+      end
+    end
+  end
+end

data/lib/bringit/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Bringit
+  VERSION = '1.0.0'
+end

data/lib/bringit/version_info.rb

@@ -0,0 +1,54 @@
+module Bringit
+  class VersionInfo
+    include Comparable
+
+    attr_reader :major, :minor, :patch
+
+    def self.parse(str)
+      if str && m = str.match(/(\d+)\.(\d+)\.(\d+)/)
+        VersionInfo.new(m[1].to_i, m[2].to_i, m[3].to_i)
+      else
+        VersionInfo.new
+      end
+    end
+
+    def initialize(major = 0, minor = 0, patch = 0)
+      @major = major
+      @minor = minor
+      @patch = patch
+    end
+
+    def <=>(other)
+      return unless other.is_a? VersionInfo
+      return unless valid? && other.valid?
+
+      if other.major < @major
+        1
+      elsif @major < other.major
+        -1
+      elsif other.minor < @minor
+        1
+      elsif @minor < other.minor
+        -1
+      elsif other.patch < @patch
+        1
+      elsif @patch < other.patch
+        -1
+      else
+        0
+      end
+    end
+
+    def to_s
+      if valid?
+        "%d.%d.%d" % [@major, @minor, @patch]
+      else
+        "Unknown"
+      end
+    end
+
+    def valid?
+      @major >= 0 && @minor >= 0 && @patch >= 0 && @major + @minor + @patch > 0
+    end
+  end
+end

data/lib/bringit/wrapper.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+module Bringit
+  # This class encapsulates all git related functionality for convenience.
+  class Wrapper
+    extend ::Bringit::Cloning::ClassMethods
+    include ::Bringit::Committing
+    include ::Bringit::Pulling
+
+    class ::Bringit::Error < ::StandardError; end
+    class ::Bringit::InvalidRefName < ::Bringit::Error; end
+
+    attr_reader :bringit
+    delegate :bare?, :branches, :branch_count, :branch_exists?, :branch_names,
+              :commit_count, :diff, :find_commits, :empty?, :ls_files,
+              :rugged, :tag_names, :tags, to: :bringit
+
+    def self.create(path)
+      raise Error, "Path #{path} already exists." if Pathname.new(path).exist?
+      FileUtils.mkdir_p(File.dirname(path))
+      Rugged::Repository.init_at(path.to_s, :bare)
+      new(path)
+    end
+
+    def self.destroy(path)
+      new(path.to_s).bringit.repo_exists? && FileUtils.rm_rf(path)
+    end
+
+    def initialize(path)
+      @bringit = Bringit::Repository.new(path.to_s)
+    end
+
+    def repo_exists?
+      bringit.repo_exists?
+    rescue Bringit::Repository::NoRepository
+      false
+    end
+
+    def path
+      Pathname.new(bringit.
+                    instance_variable_get(:@attributes).
+                    instance_variable_get(:@path))
+    end
+
+    # Query for a blob
+    def blob(ref, path)
+      Bringit::Blob.find(bringit, ref, path)
+    end
+
+    # Query for a tree
+    def tree(ref, path)
+      Bringit::Tree.where(bringit, ref, path)
+    end
+
+    def commit(ref)
+      Bringit::Commit.find(bringit, ref)
+    end
+
+    # Query for a tree
+    def path_exists?(ref, path)
+      !blob(ref, path).nil? || tree(ref, path).any?
+    end
+
+    def branch_sha(name)
+      bringit.find_branch(name)&.dereferenced_target&.sha
+    end
+
+    def default_branch
+      bringit.discover_default_branch
+    end
+
+    def default_branch=(name)
+      ref = "refs/heads/#{name}" unless name.start_with?('refs/heads/')
+      rugged.head = ref
+    end
+
+    # Create a branch with name +name+ at the reference +ref+.
+    def create_branch(name, revision)
+      raise_invalid_name_error(name) unless Ref.name_valid?(name)
+      bringit.create_branch(name, revision)
+    end
+
+    def find_branch(name)
+      Bringit::Branch.find(self, name)
+    end
+
+    def rm_branch(name)
+      rugged.branches.delete(name) if find_branch(name)
+    end
+
+    # If +annotation+ is not +nil+, it will cause the creation of an
+    # annotated tag object.  +annotation+ has to contain the following key
+    # value pairs:
+    # :tagger ::
+    #   An optional Hash containing a git signature. Defaults to the signature
+    #   from the configuration if only `:message` is given. Will cause the
+    #   creation of an annotated tag object if present.
+    # :message ::
+    #   An optional string containing the message for the new tag.
+    def create_tag(name, revision, annotation = nil)
+      raise_invalid_name_error(name) unless Ref.name_valid?(name)
+      rugged.tags.create(name, revision, annotation)
+      find_tag(name)
+    rescue Rugged::TagError => error
+      raise Bringit::Repository::InvalidRef, error.message
+    end
+
+    def find_tag(name)
+      Bringit::Tag.find(self, name)
+    end
+
+    def rm_tag(name)
+      rugged.tags.delete(name) if find_tag(name)
+    end
+
+    def diff_from_parent(ref = default_branch, options = {})
+      Commit.find(bringit, ref).diffs(options)
+    end
+
+    def log(options)
+      result = bringit.log(options)
+      return result if options[:only_commit_sha]
+      result.map do |commit|
+        Bringit::Commit.new(commit, bringit)
+      end
+    end
+
+    protected
+
+    def raise_invalid_name_error(name)
+      url = 'https://git-scm.com/docs/git-check-ref-format'
+      raise ::Bringit::InvalidRefName,
+        %(Name "#{name}" is invalid. See #{url} for a valid format.)
+    end
+  end
+end

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: bringit
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Ontohub Core Developers
+- Dmitriy Zaporozhets
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-11-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: github-linguist
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: rugged
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.26.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.26.0
+- !ruby/object:Gem::Dependency
+  name: charlock_holmes
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.3
+description: Bringit wrapper around git objects
+email:
+- ontohub-dev-l@ovgu.de
+- dmitriy.zaporozhets@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/bringit.rb
+- lib/bringit/attributes.rb
+- lib/bringit/blame.rb
+- lib/bringit/blob.rb
+- lib/bringit/blob_snippet.rb
+- lib/bringit/branch.rb
+- lib/bringit/cloning.rb
+- lib/bringit/commit.rb
+- lib/bringit/commit_stats.rb
+- lib/bringit/committing.rb
+- lib/bringit/committing/merge.rb
+- lib/bringit/compare.rb
+- lib/bringit/diff.rb
+- lib/bringit/diff_collection.rb
+- lib/bringit/encoding_helper.rb
+- lib/bringit/hook.rb
+- lib/bringit/index.rb
+- lib/bringit/path_helper.rb
+- lib/bringit/popen.rb
+- lib/bringit/pulling.rb
+- lib/bringit/ref.rb
+- lib/bringit/repository.rb
+- lib/bringit/rev_list.rb
+- lib/bringit/tag.rb
+- lib/bringit/tree.rb
+- lib/bringit/util.rb
+- lib/bringit/version.rb
+- lib/bringit/version_info.rb
+- lib/bringit/wrapper.rb
+homepage: https://github.com/ontohub/bringit
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: Bringit library
+test_files: []