Module: SauceWhisk

Defined in:
lib/sauce_whisk.rb,
lib/sauce_whisk/info.rb,
lib/sauce_whisk/jobs.rb,
lib/sauce_whisk/assets.rb,
lib/sauce_whisk/storage.rb,
lib/sauce_whisk/tunnels.rb,
lib/sauce_whisk/version.rb,
lib/sauce_whisk/accounts.rb,
lib/sauce_whisk/rest_request_builder.rb

Defined Under Namespace

Modules: RestRequestBuilder Classes: Account, AccountError, Accounts, Asset, Assets, InvalidAccountError, Job, JobNotComplete, Jobs, Sauce, Storage, SubAccount, SubAccountCreationError, Tunnel, Tunnels

Constant Summary collapse

VERSION = 
"0.2.2"

Class Method Summary collapse

Class Method Details

.access_key=(access_key) ⇒ Object 



33
34
35
 
# File 'lib/sauce_whisk.rb', line 33

def self.access_key= access_key
  @access_key = access_key
end

.asset_fetch_retries ⇒ Object 



53
54
55
56
57
58
59
60
61
62
 
# File 'lib/sauce_whisk.rb', line 53

def self.asset_fetch_retries
  if @asset_fetch_retries
    return @asset_fetch_retries
  end

  retries = self.load_first_found(:asset_fetch_retries)

  return retries.to_i if retries
  return 1
end

.asset_fetch_retries=(retries) ⇒ Object 



49
50
51
 
# File 'lib/sauce_whisk.rb', line 49

def self.asset_fetch_retries=(retries)
  @asset_fetch_retries = retries
end

.base_url ⇒ Object 



16
17
18
19
20
21
22
23
24
25
26
27
 
# File 'lib/sauce_whisk.rb', line 16

def self.base_url
  case data_center
  when :US_WEST
    "https://saucelabs.com/rest/v1"
  when :US_EAST
    "https://us-east-1.saucelabs.com/rest/v1"
  when :EU_VDC
    "https://eu-central-1.saucelabs.com/rest/v1"
  else
    raise ::ArgumentError.new "No Data Center Selected (Which should not happen?)"
  end
end

.data_center ⇒ Object 



79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/sauce_whisk.rb', line 79

def self.data_center
  configured_dc = self.load_first_found(:data_center)
  
  if configured_dc.nil?
    logger.warn "[DEPRECATED] You have not selected a REST API Endpoint - using US by default. This behaviour is deprecated and will be removed in an upcoming version. Please select a data center as described here: https://github.com/saucelabs/sauce_whisk#data-center"
    configured_dc = :US_WEST
  end

  validated_dc = validate_dc configured_dc
  validated_dc
end

.data_center=(dc) ⇒ Object 



91
92
93
 
# File 'lib/sauce_whisk.rb', line 91

def self.data_center= dc
  @data_center = validate_dc dc
end

.from_yml(key) ⇒ Object 



128
129
130
131
 
# File 'lib/sauce_whisk.rb', line 128

def self.from_yml(key)
  @hash_from_yaml ||= self.load_options_from_yaml
  return @hash_from_yaml[key]
end

.load_first_found(key) ⇒ Object 



151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
 
# File 'lib/sauce_whisk.rb', line 151

def self.load_first_found(key)
  value = self.instance_variable_get "@#{key}".to_sym

  unless value
    value = ::Sauce::Config.new[key] if defined? ::Sauce
  end

  value = self.from_yml(key) unless value
  
  unless value
    env_key = "SAUCE_#{key.to_s.upcase}" 
    value = ENV[env_key]
  end
  
  return value
end

.load_options_from_yaml ⇒ Object 



133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
 
# File 'lib/sauce_whisk.rb', line 133

def self.load_options_from_yaml
  paths = [
    "ondemand.yml",
    File.join("config", "ondemand.yml"),
    File.expand_path("../../ondemand.yml", __FILE__),
    File.join(File.expand_path("~"), ".sauce", "ondemand.yml")
  ]

  paths.each do |path|
    if File.exists? path
      conf = YAML.load_file(path)
      return conf.inject({}){|memo,(k,v)| memo[k.to_sym] = v; memo}
    end
  end

  return {}
end

.logger ⇒ Object 



117
118
119
 
# File 'lib/sauce_whisk.rb', line 117

def self.logger
  @logger||= default_logger
end

.logger=(logger) ⇒ Object 



113
114
115
 
# File 'lib/sauce_whisk.rb', line 113

def self.logger=(logger)
  @logger = logger
end

.pass_job(job_id) ⇒ Object 



109
110
111
 
# File 'lib/sauce_whisk.rb', line 109

def self.pass_job(job_id)
  Jobs.pass_job job_id
end

.password ⇒ Object 



43
44
45
46
47
 
# File 'lib/sauce_whisk.rb', line 43

def self.password
  configured_key = self.load_first_found(:access_key)
  return configured_key unless configured_key.nil? || configured_key.empty?
  raise ::ArgumentError.new "Couldn't find Access Key in Sauce::Config, yaml file or Environment Variables"
end

.public_link(job_id) ⇒ Object 



121
122
123
124
125
126
 
# File 'lib/sauce_whisk.rb', line 121

def self.public_link(job_id)
  key        = "#{self.username}:#{self.password}"
  auth_token = OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('md5'), key, job_id)

  "https://saucelabs.com/jobs/#{job_id}?auth=#{auth_token}"
end

.rest_retries ⇒ Object 



68
69
70
71
72
73
74
75
76
77
 
# File 'lib/sauce_whisk.rb', line 68

def self.rest_retries
  if @rest_retries
    return @rest_retries
  end

  retries = self.load_first_found(:rest_retries)

  return retries.to_i if retries
  return 1
end

.rest_retries=(retries) ⇒ Object 



64
65
66
 
# File 'lib/sauce_whisk.rb', line 64

def self.rest_retries=(retries)
  @rest_retries = retries
end

.username ⇒ Object 



37
38
39
40
41
 
# File 'lib/sauce_whisk.rb', line 37

def self.username
  configured_username = self.load_first_found(:username)
  return configured_username unless configured_username.nil? || configured_username.empty?
  raise ::ArgumentError.new "Couldn't find Username in Sauce::Config, yaml file or Environment Variables"
end

.username=(username) ⇒ Object 



29
30
31
 
# File 'lib/sauce_whisk.rb', line 29

def self.username= username
  @username = username
end

.validate_dc(dc) ⇒ Object 



95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/sauce_whisk.rb', line 95

def self.validate_dc dc
  dc = :eu_vdc if dc.to_s.upcase.to_sym == :EU
  dc = :us_west if dc.to_s.upcase.to_sym == :US
  dc = :us_west if dc.to_s.upcase.to_sym == :US_VDC

  ucdc = dc.to_s.upcase.to_sym

  if ![:EU_VDC, :US_EAST, :US_WEST].include? ucdc
    raise ::ArgumentError.new("Invalid data center requested: #{ucdc}.  Value values are :EU_VDC, :US_EAST and :US_WEST.")
  end

  @data_center = ucdc
end