Module: Octokit::Configurable

Included in:
Octokit, Client, EnterpriseAdminClient, EnterpriseManagementConsoleClient
Defined in:
lib/octokit/configurable.rb

Overview

Configuration options for Client, defaulting to values in Default

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#access_tokenObject

Returns the value of attribute access_token


53
54
55
# File 'lib/octokit/configurable.rb', line 53

def access_token
  @access_token
end

#api_endpointString


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#auto_paginateBoolean


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#bearer_tokenObject

Returns the value of attribute bearer_token


53
54
55
# File 'lib/octokit/configurable.rb', line 53

def bearer_token
  @bearer_token
end

#client_idString

Returns Configure OAuth app key


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#client_secretObject

Returns the value of attribute client_secret


53
54
55
# File 'lib/octokit/configurable.rb', line 53

def client_secret
  @client_secret
end

#connection_optionsHash

Returns Configure connection options for Faraday


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#default_media_typeString

Returns Configure preferred media type (for API versioning, for example)


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#loginString


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#management_console_endpointString


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#management_console_passwordString


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#middlewareFaraday::Builder or Faraday::RackBuilder

Returns Configure middleware for Faraday


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#netrcBoolean


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#netrc_fileString


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#password=(value) ⇒ String (writeonly)


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#per_pageString


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#proxyString

Returns URI for proxy server


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#user_agentString


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

#web_endpointString

Base URL for generated web URLs


53
54
55
56
# File 'lib/octokit/configurable.rb', line 53

attr_accessor :access_token, :auto_paginate, :bearer_token, :client_id,
:client_secret, :default_media_type, :connection_options,
:middleware, :netrc, :netrc_file,
:per_page, :proxy, :user_agent

Class Method Details

.keysArray

List of configurable keys for Octokit::Client


64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
# File 'lib/octokit/configurable.rb', line 64

def keys
  @keys ||= [
    :access_token,
    :api_endpoint,
    :auto_paginate,
    :bearer_token,
    :client_id,
    :client_secret,
    :connection_options,
    :default_media_type,
    :login,
    :management_console_endpoint,
    :management_console_password,
    :middleware,
    :netrc,
    :netrc_file,
    :per_page,
    :password,
    :proxy,
    :user_agent,
    :web_endpoint
  ]
end

Instance Method Details

#configure {|_self| ... } ⇒ Object

Set configuration options using a block

Yields:

  • (_self)

Yield Parameters:


90
91
92
# File 'lib/octokit/configurable.rb', line 90

def configure
  yield self
end

#netrc?Boolean


132
133
134
# File 'lib/octokit/configurable.rb', line 132

def netrc?
  !!@netrc
end

#reset!Object Also known as: setup

Reset configuration options to default values


95
96
97
98
99
100
# File 'lib/octokit/configurable.rb', line 95

def reset!
  Octokit::Configurable.keys.each do |key|
    instance_variable_set(:"@#{key}", Octokit::Default.options[key])
  end
  self
end

#same_options?(opts) ⇒ Boolean

Compares client options to a Hash of requested options


107
108
109
# File 'lib/octokit/configurable.rb', line 107

def same_options?(opts)
  opts.hash == options.hash
end