# module Repository

### Public Instance Methods

archive_repo(ref) click to toggle source

Archive Project to .tar.gz

Already packed repo archives stored at app_root/tmp/repositories/project_name/project_name-commit-id.tag.gz

    # File app/roles/repository.rb, line 157
    def archive_repo(ref)
      ref = ref || self.root_ref
      commit = self.commit(ref)
      return nil unless commit

      # Build file path
      file_name = self.code + "-" + commit.id.to_s + ".tar.gz"
      storage_path = Rails.root.join("tmp", "repositories", self.code)
      file_path = File.join(storage_path, file_name)

      # Put files into a directory before archiving
      prefix = self.code + "/"

      # Create file if not exists
      unless File.exists?(file_path)
        FileUtils.mkdir_p storage_path
        file = self.repo.archive_to_file(ref, prefix,  file_path)
      end

      file_path
    end

branch_names() click to toggle source

Returns an Array of branch names

    # File app/roles/repository.rb, line 53
    def branch_names
      repo.branches.collect(&:name).sort
    end

branches() click to toggle source

Returns an Array of Branches

    # File app/roles/repository.rb, line 58
    def branches
      repo.branches.sort_by(&:name)
    end

commit(commit_id = nil) click to toggle source

    # File app/roles/repository.rb, line 15
    def commit(commit_id = nil)
      Commit.find_or_first(repo, commit_id, root_ref)
    end

commits(ref, path = nil, limit = nil, offset = nil) click to toggle source

    # File app/roles/repository.rb, line 31
    def commits(ref, path = nil, limit = nil, offset = nil)
      Commit.commits(repo, ref, path, limit, offset)
    end

commits_between(from, to) click to toggle source

    # File app/roles/repository.rb, line 39
    def commits_between(from, to)
      Commit.commits_between(repo, from, to)
    end

commits_since(date) click to toggle source

    # File app/roles/repository.rb, line 27
    def commits_since(date)
      Commit.commits_since(repo, date)
    end

commits_with_refs(n = 20) click to toggle source

    # File app/roles/repository.rb, line 23
    def commits_with_refs(n = 20)
      Commit.commits_with_refs(repo, n)
    end

destroy_repository() click to toggle source

    # File app/roles/repository.rb, line 93
    def destroy_repository
      git_host.remove_repository(self)
    end

discover_default_branch() click to toggle source

Discovers the default branch based on the repository’s available branches

- If no branches are present, returns nil

- If one branch is present, returns its name

- If two or more branches are present, returns the one that has a name matching #root_ref (default_branch or ‘master’ if default_branch is nil)

    # File app/roles/repository.rb, line 128
    def discover_default_branch
      if branch_names.length == 0
        nil
      elsif branch_names.length == 1
        branch_names.first
      else
        branch_names.select { |v| v == root_ref }.first
      end
    end

empty_repo?() click to toggle source

    # File app/roles/repository.rb, line 11
    def empty_repo?
      !repo_exists? || !has_commits?
    end

fresh_commits(n = 10) click to toggle source

    # File app/roles/repository.rb, line 19
    def fresh_commits(n = 10)
      Commit.fresh_commits(repo, n)
    end

has_commits?() click to toggle source

    # File app/roles/repository.rb, line 138
    def has_commits?
      !!commit
    rescue Grit::NoSuchPathError
      false
    end

has_post_receive_file?() click to toggle source

    # File app/roles/repository.rb, line 47
    def has_post_receive_file?
      hook_file = File.join(path_to_repo, 'hooks', 'post-receive')
      File.exists?(hook_file)
    end

heads() click to toggle source

    # File app/roles/repository.rb, line 103
    def heads
      @heads ||= repo.heads
    end

http_url_to_repo() click to toggle source

    # File app/roles/repository.rb, line 183
    def http_url_to_repo
      http_url = [Gitlab.config.url, "/", path, ".git"].join('')
    end

last_commit_for(ref, path = nil) click to toggle source

    # File app/roles/repository.rb, line 35
    def last_commit_for(ref, path = nil)
      commits(ref, path, 1).first
    end

open_branches() click to toggle source

    # File app/roles/repository.rb, line 113
    def open_branches
      if protected_branches.empty?
        self.repo.heads
      else
        pnames = protected_branches.map(&:name)
        self.repo.heads.reject { |h| pnames.include?(h.name) }
      end.sort_by(&:name)
    end

path_to_repo() click to toggle source

    # File app/roles/repository.rb, line 85
    def path_to_repo
      File.join(Gitlab.config.git_base_path, "#{path}.git")
    end

protected_branch?(branch_name) click to toggle source

Check if current branch name is marked as protected in the system

    # File app/roles/repository.rb, line 188
    def protected_branch? branch_name
      protected_branches.map(&:name).include?(branch_name)
    end

ref_names() click to toggle source

Returns an Array of branch and tag names

    # File app/roles/repository.rb, line 73
    def ref_names
      [branch_names + tag_names].flatten
    end

repo() click to toggle source

    # File app/roles/repository.rb, line 77
    def repo
      @repo ||= Grit::Repo.new(path_to_repo)
    end

repo_exists?() click to toggle source

    # File app/roles/repository.rb, line 97
    def repo_exists?
      @repo_exists ||= (repo && !repo.branches.empty?)
    rescue
      @repo_exists = false
    end

root_ref() click to toggle source

    # File app/roles/repository.rb, line 144
    def root_ref
      default_branch || "master"
    end

root_ref?(branch) click to toggle source

    # File app/roles/repository.rb, line 148
    def root_ref?(branch)
      root_ref == branch
    end

satellite() click to toggle source

    # File app/roles/repository.rb, line 43
    def satellite
      @satellite ||= Gitlab::Satellite.new(self)
    end

ssh_url_to_repo() click to toggle source

    # File app/roles/repository.rb, line 179
    def ssh_url_to_repo
      url_to_repo
    end

tag_names() click to toggle source

Returns an Array of tag names

    # File app/roles/repository.rb, line 63
    def tag_names
      repo.tags.collect(&:name).sort.reverse
    end

tags() click to toggle source

Returns an Array of Tags

    # File app/roles/repository.rb, line 68
    def tags
      repo.tags.sort_by(&:name).reverse
    end

tree(fcommit, path = nil) click to toggle source

    # File app/roles/repository.rb, line 107
    def tree(fcommit, path = nil)
      fcommit = commit if fcommit == :head
      tree = fcommit.tree
      path ? (tree / path) : tree
    end

update_repository() click to toggle source

    # File app/roles/repository.rb, line 89
    def update_repository
      git_host.update_repository(self)
    end

url_to_repo() click to toggle source

    # File app/roles/repository.rb, line 81
    def url_to_repo
      git_host.url_to_repo(path)
    end

valid_repo?() click to toggle source

    # File app/roles/repository.rb, line 4
    def valid_repo?
      repo
    rescue
      errors.add(:path, "Invalid repository path")
      false
    end