class Gergich::Draft

Constants

POSITION_KEYS
SEVERITY_MAP

Attributes

commit[R]

Public Class Methods

new(commit = Commit.new) click to toggle source
# File lib/gergich.rb, line 357
def initialize(commit = Commit.new)
  @commit = commit
end

Public Instance Methods

add_comment(path, position, message, severity) click to toggle source

Public: add an inline comment to the draft

path - the relative file path, e.g. “app/models/user.rb” position - either a Fixnum (line number) or a Hash (range). If a

Hash, must have the following Fixnum properties:
  * start_line
  * start_character
  * end_line
  * end_character

message - the text of the comment severity - “info”|“warn”|“error” - this will automatically prefix

the comment (e.g. "[ERROR] message here"), and the most
severe comment will be used to determine the overall
Code-Review score (0, -1, or -2 respectively)
# File lib/gergich.rb, line 444
def add_comment(path, position, message, severity)
  stripped_path = path.strip

  raise GergichError, "invalid position `#{position}`" unless valid_position?(position)

  position = position.to_json if position.is_a?(Hash)
  raise GergichError, "invalid severity `#{severity}`" unless SEVERITY_MAP.key?(severity)
  raise GergichError, "no message specified" unless message.is_a?(String) && !message.empty?

  db.execute "INSERT INTO comments (path, position, message, severity) VALUES (?, ?, ?, ?)",
             [stripped_path, position, message, severity]
end
add_label(name, score) click to toggle source

Public: add a label to the draft

name - the label name, e.g. “Code-Review” score - the score, e.g. “-1”

You can set add the same label multiple times, but the lowest score for a given label will be used. This also applies to the inferred “Code-Review” score from comments; if it is non-zero, it will trump a higher score set here.

# File lib/gergich.rb, line 413
def add_label(name, score)
  score = score.to_i
  raise GergichError, "invalid score" if score < -2 || score > 1
  raise GergichError, "can't set #{name}" if %w[Verified].include?(name)

  db.execute "INSERT INTO labels (name, score) VALUES (?, ?)",
             [name, score]
end
add_message(message) click to toggle source

Public: add something to the cover message

These messages will appear after the “-1” (or whatever)

# File lib/gergich.rb, line 425
def add_message(message)
  db.execute "INSERT INTO messages (message) VALUES (?)", [message]
end
all_comments() click to toggle source
# File lib/gergich.rb, line 479
def all_comments
  @all_comments ||= begin
    comments = {}

    sql = "SELECT path, position, message, severity FROM comments"
    db.execute(sql).each do |row|
      inline = changed_files.include?(row["path"])
      comments[row["path"]] ||= FileReview.new(row["path"], inline)
      comments[row["path"]].add_comment(row["position"],
                                        row["message"],
                                        row["severity"])
    end

    comments.values
  end
end
changed_files() click to toggle source
# File lib/gergich.rb, line 508
def changed_files
  @changed_files ||= commit.files + ["/COMMIT_MSG"]
end
cover_message_parts() click to toggle source
# File lib/gergich.rb, line 548
def cover_message_parts
  parts = messages
  parts << orphaned_message unless other_comments.empty?
  parts
end
create_db_schema!() click to toggle source
# File lib/gergich.rb, line 382
    def create_db_schema!
      db.execute <<-SQL
        CREATE TABLE comments (
          path VARCHAR,
          position VARCHAR,
          message VARCHAR,
          severity VARCHAR
        );
      SQL
      db.execute <<-SQL
        CREATE TABLE labels (
          name VARCHAR,
          score INTEGER
        );
      SQL
      db.execute <<-SQL
        CREATE TABLE messages (
          message VARCHAR
        );
      SQL
    end
db() click to toggle source
# File lib/gergich.rb, line 367
def db
  @db ||= begin
    require "sqlite3"
    db_exists = File.exist?(db_file)
    db = SQLite3::Database.new(db_file)
    db.results_as_hash = true
    create_db_schema! unless db_exists
    db
  end
end
db_file() click to toggle source
# File lib/gergich.rb, line 361
def db_file
  @db_file ||= File.expand_path(
    "#{ENV.fetch('GERGICH_DB_PATH', '/tmp')}/#{GERGICH_USER}-#{commit.revision_id}.sqlite3"
  )
end
info() click to toggle source
# File lib/gergich.rb, line 512
def info
  @info ||= begin
    comments = inline_comments.map { |file| [file.path, file.to_a] }.to_h

    {
      comments: comments,
      cover_message_parts: cover_message_parts,
      total_comments: all_comments.map(&:count).inject(&:+),
      score: labels[GERGICH_REVIEW_LABEL],
      labels: labels
    }
  end
end
inline_comments() click to toggle source
# File lib/gergich.rb, line 496
def inline_comments
  all_comments.select(&:inline)
end
labels() click to toggle source
# File lib/gergich.rb, line 467
def labels
  @labels ||= begin
    labels = { GERGICH_REVIEW_LABEL => 0 }
    db.execute("SELECT name, MIN(score) AS score FROM labels GROUP BY name").each do |row|
      labels[row["name"]] = row["score"]
    end
    score = min_comment_score
    labels[GERGICH_REVIEW_LABEL] = score if score < [0, labels[GERGICH_REVIEW_LABEL]].min
    labels
  end
end
messages() click to toggle source
# File lib/gergich.rb, line 526
def messages
  db.execute("SELECT message FROM messages").map { |row| row["message"] }
end
min_comment_score() click to toggle source
# File lib/gergich.rb, line 504
def min_comment_score
  all_comments.inject(0) { |acc, elem| [acc, elem.min_score].min }
end
orphaned_message() click to toggle source
# File lib/gergich.rb, line 530
def orphaned_message
  messages = ["NOTE: I couldn't create inline comments for everything. " \
              "Although this isn't technically part of your commit, you " \
              "should still check it out (i.e. side effects or auto-" \
              "generated from stuff you *did* change):"]

  other_comments.each do |file|
    file.comments.each do |position, comments|
      comments.each do |comment|
        line = position.is_a?(Integer) ? position : position["start_line"]
        messages << "#{file.path}:#{line}: #{comment}"
      end
    end
  end

  messages.join("\n\n")
end
other_comments() click to toggle source
# File lib/gergich.rb, line 500
def other_comments
  all_comments.reject(&:inline)
end
reset!() click to toggle source
# File lib/gergich.rb, line 378
def reset!
  FileUtils.rm_f(db_file)
end
valid_position?(position) click to toggle source
# File lib/gergich.rb, line 458
def valid_position?(position)
  (
    position.is_a?(Integer) && position >= 0
  ) || (
    position.is_a?(Hash) && position.keys.sort == POSITION_KEYS &&
    position.values.all? { |v| v.is_a?(Integer) && v >= 0 }
  )
end