Module: Rubyists::Linear::CLI::WhatFor

Included in:
SubCommands
Defined in:
lib/linear/cli/what_for.rb

Overview

Module for the _for methods

Instance Method Summary collapse

Instance Method Details

#ask_for_projects(projects, search: true) ⇒ Object 



70
71
72
73
74
75
 
# File 'lib/linear/cli/what_for.rb', line 70

def ask_for_projects(projects, search: true)
  prompt.warn("No project found matching #{search}.") if search
  return projects.first if projects.size == 1

  prompt.select('Project:', projects.to_h { |p| [p.name, p] })
end

#ask_or_edit(thing, question) ⇒ Object

Raises:



48
49
50
51
52
53
54
55
56
57
58
 
# File 'lib/linear/cli/what_for.rb', line 48

def ask_or_edit(thing, question)
  return thing if thing && thing != '-'

  answer = prompt.ask("#{question}: ('-' to open an editor)", default: '-')
  return answer unless answer == '-'

  answer = editor_for [question.downcase, '.md']
  raise SmellsBad, "No content provided for #{question}" if answer.empty?

  answer
end

#cancelled_state_for(thingy) ⇒ Object 



32
33
34
35
36
37
38
 
# File 'lib/linear/cli/what_for.rb', line 32

def cancelled_state_for(thingy)
  states = thingy.cancelled_states
  return states.first if states.size == 1

  selection = prompt.select('Choose a cancelled state', states.to_h { |s| [s.name, s.id] })
  Rubyists::Linear::WorkflowState.find selection
end

#comment_for(issue, comment) ⇒ Object 



17
18
19
 
# File 'lib/linear/cli/what_for.rb', line 17

def comment_for(issue, comment)
  ask_or_edit comment, "Comment for #{issue.identifier} - #{issue.title}"
end

#completed_state_for(thingy) ⇒ Object 



40
41
42
43
44
45
46
 
# File 'lib/linear/cli/what_for.rb', line 40

def completed_state_for(thingy)
  states = thingy.completed_states
  return states.first if states.size == 1

  selection = prompt.select('Choose a completed state', states.to_h { |s| [s.name, s.id] })
  Rubyists::Linear::WorkflowState.find selection
end

#description_for(description = nil) ⇒ Object 



60
61
62
 
# File 'lib/linear/cli/what_for.rb', line 60

def description_for(description = nil)
  ask_or_edit description, 'Description'
end

#editor_for(prefix) ⇒ Object 



8
9
10
11
12
13
14
15
 
# File 'lib/linear/cli/what_for.rb', line 8

def editor_for(prefix)
  file = Tempfile.open(prefix, Rubyists::Linear.tmpdir)
  TTY::Editor.open(file.path)
  file.close
  File.readlines(file.path).map(&:chomp).join('\\n')
ensure
  file&.close
end

#labels_for(team, labels = nil) ⇒ Object 



135
136
137
138
139
 
# File 'lib/linear/cli/what_for.rb', line 135

def labels_for(team, labels = nil)
  return Rubyists::Linear::Label.find_all_by_name(labels.map(&:strip)) if labels

  prompt.multi_select('Labels:', team.labels.to_h { |t| [t.name, t] })
end

#pr_description_for(issue) ⇒ Object 



104
105
106
107
108
109
110
111
112
113
114
115
116
 
# File 'lib/linear/cli/what_for.rb', line 104

def pr_description_for(issue)
  tmpfile = Tempfile.new([issue.identifier, '.md'], Rubyists::Linear.tmpdir)
  # TODO: Look up templates
  proposed = "# Context\n\n#{issue.description}\n\n## Issue\n\n#{issue.identifier}\n\n# Solution\n\n# Testing\n\n# Notes\n\n" # rubocop:disable Layout/LineLength
  tmpfile.write(proposed) && tmpfile.close
  desc = TTY::Editor.open(tmpfile.path)
  return tmpfile if desc

  File.open(tmpfile.path, 'w+') do |file|
    file.puts prompt.ask("Description for PR for #{issue.identifier} - #{issue.title}", default: proposed)
  end
  tmpfile
end

#pr_scope_for(title) ⇒ Object 



125
126
127
128
129
130
131
132
133
 
# File 'lib/linear/cli/what_for.rb', line 125

def pr_scope_for(title)
  proposed_scope = title.match(/^\w+\(([^\)]+)\)/)
  return proposed_scope[1].downcase if proposed_scope

  scope = prompt.ask('What is the scope of this PR?', default: 'none')
  return nil if scope.empty? && scope == 'none'

  scope
end

#pr_title_for(issue) ⇒ Object 



95
96
97
98
99
100
101
102
 
# File 'lib/linear/cli/what_for.rb', line 95

def pr_title_for(issue)
  proposed = [pr_type_for(issue)]
  proposed_scope = pr_scope_for(issue.title)
  proposed << "(#{proposed_scope})" if proposed_scope
  summary = issue.title.sub(/(?:#{ALLOWED_PR_TYPES})(\([^)]+\))? /, '')
  proposed << ": #{issue.identifier} - #{summary}"
  prompt.ask("Title for PR for #{issue.identifier} - #{summary}", default: proposed.join)
end

#pr_type_for(issue) ⇒ Object 



118
119
120
121
122
123
 
# File 'lib/linear/cli/what_for.rb', line 118

def pr_type_for(issue)
  proposed_type = issue.title.match(/^(#{ALLOWED_PR_TYPES})/i)
  return proposed_type[1].downcase if proposed_type

  prompt.select('What type of PR is this?', %w[fix feature chore refactor test docs style ci perf security])
end

#project_for(team, project = nil) ⇒ Object

rubocop:disable Metrics/AbcSize



81
82
83
84
85
86
87
88
89
90
91
92
93
 
# File 'lib/linear/cli/what_for.rb', line 81

def project_for(team, project = nil) # rubocop:disable Metrics/AbcSize
  projects = team.projects
  return nil if projects.empty?

  possibles = project ? project_scores(projects, project) : []
  return ask_for_projects(projects, search: project) if possibles.empty?

  first = possibles.first
  return first if first.match_score?(project) == 100

  selections = possibles + (projects - possibles)
  prompt.select('Project:', selections.to_h { |p| [p.name, p] }) if possibles.size.positive?
end

#project_scores(projects, search_term) ⇒ Object 



77
78
79
 
# File 'lib/linear/cli/what_for.rb', line 77

def project_scores(projects, search_term)
  projects.select { |p| p.match_score?(search_term).positive? }.sort_by { |p| p.match_score?(search_term) }
end

#reason_for(reason = nil, four: nil) ⇒ Object 



27
28
29
30
 
# File 'lib/linear/cli/what_for.rb', line 27

def reason_for(reason = nil, four: nil)
  question = four ? "Reason for #{TTY::Markdown.parse(four)}" : 'Reason'
  ask_or_edit reason, question
end

#team_for(key = nil) ⇒ Object 



21
22
23
24
25
 
# File 'lib/linear/cli/what_for.rb', line 21

def team_for(key = nil)
  return Rubyists::Linear::Team.find(key) if key

  ask_for_team
end

#title_for(title = nil) ⇒ Object 



64
65
66
67
68
 
# File 'lib/linear/cli/what_for.rb', line 64

def title_for(title = nil)
  return title if title

  prompt.ask('Title:')
end