Module: Gitx::Github

Included in:
Cli::IntegrateCommand, Cli::ReleaseCommand, Cli::ReviewCommand
Defined in:
lib/gitx/github.rb

Constant Summary collapse

GLOBAL_CONFIG_FILE = 
'~/.config/gitx/github.yml'
REVIEW_CONTEXT = 
'peer_review'
CLIENT_URL = 
'https://github.com/wireframe/gitx'

"  # Pull Request Protips(tm):\n  # * Describe how this change accomplishes the task at hand\n  # * Use GitHub flavored Markdown http://github.github.com/github-flavored-markdown/\n  # * Include links to relevent resources and related tickets\n  # * Attach build artifacts, images, screenshots, screencasts, etc\n  # * Review CONTRIBUTING.md for relevant workflow requirements\n  #\n  # This footer will automatically be stripped from the pull request description\n".dedent

Instance Method Summary collapse

Instance Method Details

#ask_without_echo(message) ⇒ Object 



171
172
173
174
175
 
# File 'lib/gitx/github.rb', line 171

def ask_without_echo(message)
  value = ask(message, echo: false)
  say ''
  value
end

#authorization_token ⇒ String

authorization token used for github API calls the token is cached on the filesystem for future use

Returns:

  • (String) —

    auth token stored in git (current repo, user config or installed global settings)

See Also:



91
92
93
94
95
96
97
98
99
 
# File 'lib/gitx/github.rb', line 91

def authorization_token
  auth_token = ENV['GITX_GITHUB_TOKEN'] || global_config['token']
  auth_token ||= begin
    new_token = create_authorization
    save_global_config('token' => new_token)
    new_token
  end
  auth_token
end

#branch_status(branch) ⇒ Object

Get the current commit status of a branch

See Also:



50
51
52
53
 
# File 'lib/gitx/github.rb', line 50

def branch_status(branch)
  response = github_client.status(github_slug, branch)
  response.state
end

#create_authorization ⇒ Object 



101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
 
# File 'lib/gitx/github.rb', line 101

def create_authorization
  password = ask_without_echo("Github password for #{username}: ")
  client = Octokit::Client.new(login: username, password: password)
  options = {
    scopes: ['repo'],
    note: github_client_name,
    note_url: CLIENT_URL
  }
  two_factor_auth_token = ask_without_echo('Github two factor authorization token (if enabled): ')
  options[:headers] = { 'X-GitHub-OTP' => two_factor_auth_token } if two_factor_auth_token
  response = client.create_authorization(options)
  response.token
rescue Octokit::ClientError => e
  say "Error creating authorization: #{e.message}", :red
  retry
end

#create_pull_request(branch) ⇒ Object

See Also:



62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/gitx/github.rb', line 62

def create_pull_request(branch)
  say 'Creating pull request for '
  say "#{branch} ", :green
  say 'against '
  say "#{config.base_branch} ", :green
  say 'in '
  say github_slug, :green

  title = branch.gsub(/[-_]/, ' ')
  body = pull_request_body(branch)
  github_client.create_pull_request(github_slug, config.base_branch, branch, title, body)
end

#find_or_create_pull_request(branch) ⇒ Object 



22
23
24
25
26
27
28
29
30
31
32
33
34
 
# File 'lib/gitx/github.rb', line 22

def find_or_create_pull_request(branch)
  pull_request = find_pull_request(branch)
  pull_request ||= begin
    checkout_branch(branch)
    execute_command(Gitx::Cli::UpdateCommand, :update)
    pull_request = create_pull_request(branch)
    say 'Created pull request: '
    say pull_request.html_url, :green

    pull_request
  end
  pull_request
end

#find_pull_request(branch) ⇒ Sawyer::Resource

Returns:

  • (Sawyer::Resource) —

    data structure of pull request info if found

  • nil if no pull request found



38
39
40
41
42
43
44
45
46
 
# File 'lib/gitx/github.rb', line 38

def find_pull_request(branch)
  head_reference = "#{github_organization}:#{branch}"
  params = {
    head: head_reference,
    state: 'open'
  }
  pull_requests = github_client.pull_requests(github_slug, params)
  pull_requests.first
end

#github_client ⇒ Object 



123
124
125
 
# File 'lib/gitx/github.rb', line 123

def github_client
  @client ||= Octokit::Client.new(access_token: authorization_token)
end

#github_client_name ⇒ Object 



118
119
120
121
 
# File 'lib/gitx/github.rb', line 118

def github_client_name
  timestamp = Time.now.utc.strftime('%FT%R:%S%z')
  client_name = "The Garage Git eXtensions #{timestamp}"
end

#github_organization ⇒ Object 



145
146
147
 
# File 'lib/gitx/github.rb', line 145

def github_organization
  github_slug.split('/').first
end

#github_slug ⇒ Object

Returns the github slug for the current repository’s remote origin url.

Examples:

git@github.com:socialcast/wireframe/gitx.git #=> wireframe/gitx

https://github.com/wireframe/gitx.git #=> wireframe/gitx

Returns:

  • the github slug for the current repository’s remote origin url.



140
141
142
143
 
# File 'lib/gitx/github.rb', line 140

def github_slug
  remote = repo.config['remote.origin.url']
  remote.to_s.gsub(/\.git$/, '').split(/[:\/]/).last(2).join('/')
end

#global_config ⇒ Object 



153
154
155
156
157
 
# File 'lib/gitx/github.rb', line 153

def global_config
  @config ||= begin
    File.exist?(global_config_file) ? YAML.load_file(global_config_file) : {}
  end
end

#global_config_file ⇒ Object 



149
150
151
 
# File 'lib/gitx/github.rb', line 149

def global_config_file
  File.expand_path(GLOBAL_CONFIG_FILE)
end

#pull_request_body(branch) ⇒ Object 



75
76
77
78
79
80
81
82
83
84
 
# File 'lib/gitx/github.rb', line 75

def pull_request_body(branch)
  changelog = run_cmd("git log #{config.base_branch}...#{branch} --reverse --no-merges --pretty=format:'* %B'")
  description = options[:description]

  description_template = []
  description_template << "#{description}\n" if description
  description_template << changelog

  body = ask_editor(description_template.join("\n"), editor: repo.config['core.editor'], footer: PULL_REQUEST_FOOTER)
end

#save_global_config(options) ⇒ Object 



159
160
161
162
163
164
165
166
167
168
169
 
# File 'lib/gitx/github.rb', line 159

def save_global_config(options)
  config_dir = File.dirname(global_config_file)
  ::FileUtils.mkdir_p(config_dir, mode: 0700) unless File.exist?(config_dir)

  @config = global_config.merge(options)
  File.open(global_config_file, 'a+') do |file|
    file.truncate(0)
    file.write(@config.to_yaml)
  end
  File.chmod(0600, global_config_file)
end

#update_review_status(pull_request, state, description) ⇒ Object

Update build status with peer review status



56
57
58
59
 
# File 'lib/gitx/github.rb', line 56

def update_review_status(pull_request, state, description)
  commit_sha = pull_request.head.sha
  github_client.create_status(github_slug, commit_sha, state, context: REVIEW_CONTEXT, description: description)
end

#username ⇒ String

Returns github username (ex: ‘wireframe’) of the current github.user.

Returns:

  • (String) —

    github username (ex: ‘wireframe’) of the current github.user

Raises:

  • error if github.user is not configured



129
130
131
132
133
 
# File 'lib/gitx/github.rb', line 129

def username
  username = repo.config['github.user']
  fail "Github user not configured.  Run: `git config --global github.user '[email protected]'`" unless username
  username
end