hustle_and_flow 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2ad538991817d27a8eecc569f8623079cd8da45d
-  data.tar.gz: 855fbfd13d91261bc5353074360f2ca6709735cf
+  metadata.gz: 09c8b0e8909c7e772f202f9c4a8d5d51ef65423b
+  data.tar.gz: 29362f1b7e998396294e1925c69d939ba66dc2a2
 SHA512:
-  metadata.gz: 9f0359c6e32ea999dd46ae83847e708fb93514cd34fd1bd885e16365f33e8ee9d810723ad2408146048bd5eaff245932a9446134bf81b6ca1140d06134c4ee7f
-  data.tar.gz: 74e82c9b0f1064bc6831e4d019f474e07bc7cbc4d4ad0ba32a44bba57aa595f264f03ed20bc39b030b5f5a17e4b3b16532d1d57b6ef7957be515ab735315da2c
+  metadata.gz: 623381f2772547914f6a2c26604542131eeec13d0c82351b0cd17e4bec7ba5c592ea646f0584f9cfb2032bda48ba839bb2f96d59ce435f2c1924f593ce4f95ba
+  data.tar.gz: 2f3f3906195c4043b503ab2939c8cc0625effb86badebf5c781a1cd6e928a5632bd18bb96ca0f1448f6aa062aadfca8c818811bb6d69bb24675b54a121a3e3fd

data/bin/hustle

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'hustle_and_flow/binary/runner'
+
+HustleAndFlow::Binary::Runner.start

data/lib/hustle_and_flow/binary/runner.rb

@@ -0,0 +1,35 @@
+require 'thor'
+require 'hustle_and_flow/commands/start'
+
+module  HustleAndFlow
+module  Binary
+class   Runner < Thor
+  include Thor::Actions
+
+  desc 'start', 'For generating new, or working on existing issues'
+  method_option :create,
+                type:     :boolean,
+                aliases:  '-c',
+                desc:     'Whether or not to create the issue if one cannot be found'
+  method_option :type,
+                type:     :string,
+                aliases:  '-t',
+                desc:     'The type of issue that should be searched for or created (eg feature, bug, chore, etc)'
+  method_option :status,
+                type:     :string,
+                aliases:  '-u',
+                desc:     'When searching for issues, it is the status of the issues you would like to view.'
+  method_option :subject,
+                type:     :string,
+                aliases:  '-s',
+                desc:     'The subject (or title) of the issue which should be searched for or created'
+  method_option :number,
+                type:     :string,
+                aliases:  '-n',
+                desc:     'The number of the issue which should be searched for.'
+  def start
+    Commands::Start.new(io: HustleAndFlow::Io::Shell.new, **options).call
+  end
+end
+end
+end

data/lib/hustle_and_flow/commands/start.rb

@@ -0,0 +1,36 @@
+require 'thor/shell/basic'
+require 'hustle_and_flow/vcs_repository'
+require 'hustle_and_flow/issue_tracker'
+
+module  HustleAndFlow
+module  Commands
+class   Start
+  attr_accessor :repo,
+                :tracker,
+                :me,
+                :io,
+                :issue_data
+
+  def initialize(io:, **args)
+    self.repo       = VcsRepository.new(path: Dir.pwd)
+    self.tracker    = IssueTracker.new(repo: repo)
+    self.me         = repo.user
+    self.io         = io
+    self.issue_data = args.select { |_k, v| v }
+  end
+
+  def call
+    issue   = tracker.start(io:         io,
+                            me:         me,
+                            issue_data: issue_data)
+    _branch = repo.start(io:              io,
+                         number:          issue.number,
+                         title:           issue.title,
+                         branch_template: issue.to_branch_name(version: '*****'))
+  rescue Git::GitExecuteError => e
+    io.say 'There was a problem running a git command.'
+    io.say e.message
+  end
+end
+end
+end

data/lib/hustle_and_flow/errors/unknown_issue_action_error.rb

@@ -0,0 +1,6 @@
+module  HustleAndFlow
+module  Errors
+class   UnknownIssueActionError < RuntimeError
+end
+end
+end

data/lib/hustle_and_flow/formatters/branch_table_formatter.rb

@@ -0,0 +1,81 @@
+module  HustleAndFlow
+module  Formatters
+class   BranchTableFormatter
+  attr_accessor :branches
+
+  def initialize(branches)
+    self.branches = branches
+  end
+
+  def to_ary
+    number = 0
+
+    branches.map do |branch|
+      [
+        {
+          format: number_formatting(branch),
+          value:  number += 1,
+        },
+        {
+          format: current_branch_formatting(branch),
+          value:  branch.current? ? '*' : ' ',
+        },
+        {
+          format: status_formatting(branch),
+          value:  status(branch),
+        },
+        {
+          format: author_formatting(branch),
+          value:  branch.author,
+        },
+        {
+          format: name_formatting(branch),
+          value:  branch.name,
+        },
+      ]
+    end
+  end
+
+  private
+
+  def status(branch)
+    if branch.has_tracking_branch?
+      'T'
+    elsif branch.remote?
+      'R'
+    elsif branch.local?
+      'L'
+    else
+      '?'
+    end
+  end
+
+  def number_formatting(_branch)
+    [:white, :bold]
+  end
+
+  def name_formatting(_branch)
+    [:green, :bold]
+  end
+
+  def author_formatting(_branch)
+    [:white, :bold]
+  end
+
+  def current_branch_formatting(_branch)
+    [:yellow, :bold]
+  end
+
+  def status_formatting(branch)
+    case
+    when branch.has_tracking_branch?
+      [:yellow, :bold]
+    when branch.remote?
+      [:magenta, :bold]
+    when branch.local?
+      [:blue, :bold]
+    end
+  end
+end
+end
+end

data/lib/hustle_and_flow/formatters/issue_detail_formatter.rb

@@ -0,0 +1,74 @@
+require 'hustle_and_flow/utils/string'
+
+module  HustleAndFlow
+module  Formatters
+class   IssueDetailFormatter
+  include HustleAndFlow::Utils::String
+
+  attr_accessor :issue
+
+  def initialize(issue)
+    self.issue = issue
+  end
+
+  def to_hash
+    {
+      header:  {
+        format: issue_header_formatting,
+        value:  issue_header,
+      },
+      divider: {
+        format: issue_divider_formatting,
+        value:  nil,
+      },
+      contact: {
+        format: issue_contact_formatting,
+        value:  issue_contact,
+      },
+      body:    {
+        format: issue_body_formatting,
+        value:  issue.body,
+      },
+    }
+  end
+
+  private
+
+  def issue_number
+    "##{issue.number}"
+  end
+
+  def issue_header
+    category = if issue.category
+                 "#{titleize(issue.category)}: "
+               end
+
+    "#{issue_number} - #{category}#{issue.title}"
+  end
+
+  def issue_header_formatting
+    if issue.closed?
+      [:red, :bold]
+    else
+      [:green, :bold]
+    end
+  end
+
+  def issue_divider_formatting
+    [:black, :bold]
+  end
+
+  def issue_contact
+    "By: #{issue.contact}"
+  end
+
+  def issue_contact_formatting
+    [:blue, :bold]
+  end
+
+  def issue_body_formatting
+    [:white, :bold]
+  end
+end
+end
+end

data/lib/hustle_and_flow/formatters/issue_table_formatter.rb

@@ -0,0 +1,80 @@
+require 'hustle_and_flow/utils/string'
+
+module  HustleAndFlow
+module  Formatters
+class   IssueTableFormatter
+  include HustleAndFlow::Utils::String
+
+  attr_accessor :issues,
+                :title
+
+  def initialize(issues)
+    self.issues = issues
+  end
+
+  def to_ary
+    issues.map do |issue|
+      [
+        {
+          format: number_formatting(issue),
+          value:  "##{issue.number}",
+        },
+        {
+          format: contact_formatting(issue),
+          value:  issue.contact,
+        },
+        {
+          format: category_formatting(issue),
+          value:  titleize(issue.category),
+        },
+        {
+          format: title_formatting(issue),
+          value:  issue.title,
+        },
+      ]
+    end
+  end
+
+  private
+
+  def number_formatting(issue)
+    if issue.closed?
+      [:red]
+    else
+      [:green]
+    end
+  end
+
+  def contact_formatting(_issue)
+    [:white]
+  end
+
+  def category_formatting(issue)
+    case issue.category
+    when 'feature'
+      [:green, :bold]
+    when 'bug'
+      [:red, :bold]
+    when 'refactor'
+      [:yellow, :bold]
+    when 'test'
+      [:cyan, :bold]
+    when 'style'
+      [:magenta, :bold]
+    when 'chore'
+      [:white, :bold]
+    when 'docs'
+      [:blue, :bold]
+    when 'spike'
+      [:white, :bold]
+    else
+      [:white, :bold]
+    end
+  end
+
+  def title_formatting(_issue)
+    [:white]
+  end
+end
+end
+end

data/lib/hustle_and_flow/io/shell.rb

@@ -0,0 +1,102 @@
+require 'thor/shell/color'
+require 'hustle_and_flow/formatters/issue_detail_formatter'
+
+module  HustleAndFlow
+module  Io
+class   Shell < Thor::Shell::Color
+  def correct_issue?(issue)
+    if issue.new?
+      Kernel.system("open #{issue.url}")
+    else
+      stdout.puts
+      print_issue Formatters::IssueDetailFormatter.new(issue).to_hash
+
+      yes?('Does this issue look correct?')
+    end
+  end
+
+  def reassign_issue?(from:)
+    yes?("Do you want to reassign this issue from #{from} to yourself?")
+  end
+
+  def choose_issue
+    stdout.puts
+
+    ask 'Enter the number of the issue you would like to work on:'
+  end
+
+  def choose_branch
+    stdout.puts
+    ask 'Enter the number of the branch you would like to work on:'
+  end
+
+  def print_new_branch_prompt(new_branch_name)
+    stdout.puts
+    say "Entering 'c' creates a new branch named '#{GREEN}#{new_branch_name}#{CLEAR}'"
+  end
+
+  def print_formatted_table(data:, title: nil)
+    data = data.map do |row|
+      row.map do |column|
+        set_color(column[:value], *column[:format])
+      end
+    end
+
+    stdout.puts
+
+    if title
+      stdout.puts title.center(terminal_width)
+      stdout.puts '-' * terminal_width
+    end
+
+    print_table(data, truncate: true)
+  end
+
+  def print_issue(data)
+    data[:header][:format].each do |format|
+      stdout.print lookup_color(format)
+    end
+
+    print_wrapped(data[:header][:value])
+
+    stdout.puts set_color('-' * terminal_width,   *data[:divider][:format])
+    stdout.puts set_color(data[:contact][:value], *data[:contact][:format])
+
+    data[:body][:format].each do |format|
+      stdout.print lookup_color(format)
+    end
+
+    if data[:body][:value]
+      stdout.puts
+      print_wrapped(data[:body][:value])
+    end
+  end
+
+  # To be removed once our PR lands
+  def print_wrapped(message, options = {})
+    indent = options[:indent] || 0
+    width = 80
+    paras = message.split("\n\n")
+
+    paras.map! do |unwrapped|
+      unwrapped.
+      strip.
+      gsub(/\n/, ' ').
+      squeeze(' ').
+      gsub(/.{1,#{width}}(?:\s|\Z)/) do
+        ($& + 5.chr).
+        gsub(/\n\005/, "\n").
+        gsub(/\005/, "\n")
+      end
+    end
+
+    paras.each do |para|
+      para.split("\n").each do |line|
+        stdout.puts line.insert(0, ' ' * indent)
+      end
+      stdout.puts unless para == paras.last
+    end
+  end
+end
+end
+end

data/lib/hustle_and_flow/issue_tracker.rb

@@ -0,0 +1,18 @@
+require 'hustle_and_flow/issue_trackers/github'
+
+module  HustleAndFlow
+class   IssueTracker
+  attr_accessor :adapter
+
+  def initialize(**args)
+    self.adapter = HustleAndFlow::
+                   IssueTrackers::
+                   Github.
+                   new(repo: args[:repo])
+  end
+
+  def method_missing(name, *args)
+    adapter.public_send(name, *args)
+  end
+end
+end

data/lib/hustle_and_flow/issue_trackers/github/issue.rb

@@ -0,0 +1,192 @@
+require 'hustle_and_flow/utils/url_slug'
+require 'hustle_and_flow/errors/unknown_issue_action_error'
+require 'hustle_and_flow/io/shell'
+
+module  HustleAndFlow
+module  IssueTrackers
+class   Github
+class   Issue
+  DEFAULT_CATEGORY_LABELS = %w{feature bug refactor test style chore docs spike}
+  ISSUE_ACTIONS           = %w{closes references fixes}
+
+  attr_accessor :tracker,
+                :io,
+                :data
+
+  def initialize(tracker:, io: nil, data:)
+    self.tracker = tracker
+    self.io      = io || HustleAndFlow::Io::Shell.new
+    self.data    = data
+  end
+
+  def self.create(tracker: nil, io: nil, title:, body: '', **args)
+    new(io:      io,
+        tracker: tracker,
+        data:    tracker.client.create_issue(tracker.repo_name,
+                                             title,
+                                             body,
+                                             **args))
+  end
+
+  def start(me: nil)
+    return unless io.correct_issue?(self)
+
+    reopen.
+    assign_issue? to: me
+  end
+
+  def assign(to:)
+    reassigned_issue_data = client.update_issue(tracker.repo_name,
+                                                number,
+                                                title,
+                                                body,
+                                                assignee: to)
+
+    Issue.new(tracker: tracker,
+              data:    reassigned_issue_data)
+  end
+
+  def category
+    @category ||= labels.find do |label|
+      DEFAULT_CATEGORY_LABELS.include? label
+    end
+  end
+
+  def new?
+    five_minutes_ago = Time.now.utc - (5 * 60)
+
+    five_minutes_ago <= created_at
+  end
+
+  def has_label?(other)
+    labels.include?(other)
+  end
+
+  def has_body?
+    !(body.nil? || body.empty?)
+  end
+
+  def assign_issue?(to:)
+    return self unless needs_reassignment?(assignee_to_assign_to: to)
+
+    assign to: to
+  end
+
+  def closed?
+    status == 'closed'
+  end
+
+  def unassigned?
+    assigned_to? 'unassigned'
+  end
+
+  def assigned_to?(other)
+    assignee == other
+  end
+
+  def match?(type: nil, **args)
+    result     = true
+    conditions = args
+
+    conditions.each do |key, value|
+      result &&= public_send(key) == value
+    end
+
+    type ? (result && has_label?(type)) : result
+  end
+
+  def contact
+    assignee_data[:login] || user_data[:login]
+  end
+
+  def title
+    data[:title]
+  end
+
+  def number
+    data[:number]
+  end
+
+  def body
+    data[:body]
+  end
+
+  def created_at
+    data[:created_at]
+  end
+
+  def url
+    data[:html_url]
+  end
+
+  def status
+    data[:state]
+  end
+
+  def to_branch_name(action:  'closes',
+                     version: 1)
+    branch_name = []
+    branch_name << category
+    branch_name << base_branch_name(action:  action,
+                                    version: version)
+
+    branch_name.compact!
+
+    branch_name.join('/')
+  end
+
+  private
+
+  def reopen
+    reopened_issue_data = client.reopen_issue(tracker.repo_name, number)
+
+    closed? ? Issue.new(tracker: tracker, data: reopened_issue_data) : self
+  end
+
+  def labels
+    return [] unless data[:labels]
+
+    @labels ||= data[:labels].map { |l| l[:name] }
+  end
+
+  def assignee
+    assignee_data[:login] || 'unassigned'
+  end
+
+  def assignee_data
+    data[:assignee] || {}
+  end
+
+  def user_data
+    data[:user] || {}
+  end
+
+  def client
+    tracker.client
+  end
+
+  def needs_reassignment?(assignee_to_assign_to:)
+    unassigned? ||
+    (
+      !assigned_to?(assignee_to_assign_to) &&
+      io.reassign_issue?(from: assignee)
+    )
+  end
+
+  def base_branch_name(action:, version:)
+    fail Errors::UnknownIssueActionError unless ISSUE_ACTIONS.include? action.downcase
+
+    base = []
+    base << Utils::UrlSlug.new(title).to_s
+    base << action if number
+    base << number
+    base << "v#{version}" if version
+
+    base.compact!
+
+    base.join('-').downcase
+  end
+end
+end
+end
+end