Class: CopyTunerClient::Configuration

Inherits:
Object
  • Object
show all
Defined in:
lib/copy_tuner_client/configuration.rb

Overview

Used to set up and modify settings for the client.

Constant Summary collapse

OPTIONS =

These options will be present in the Hash returned by #to_hash.

[:api_key, :development_environments, :environment_name, :host,
:http_open_timeout, :http_read_timeout, :client_name, :client_url,
:client_version, :port, :protocol, :proxy_host, :proxy_pass,
:proxy_port, :proxy_user, :secure, :polling_delay, :sync_interval,
:sync_interval_staging, :sync_ignore_path_regex, :logger,
:framework, :middleware, :disable_middleware, :disable_test_translation,
:ca_file, :exclude_key_regexp, :s3_host, :locales].freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Configuration

Instantiated from CopyTunerClient.configure. Sets defaults.



145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
 
# File 'lib/copy_tuner_client/configuration.rb', line 145

def initialize
  self.client_name = 'CopyTuner Client'
  self.client_url = 'https://rubygems.org/gems/copy_tuner_client'
  self.client_version = VERSION
  self.development_environments = %w(development staging)
  self.host = 'copy-tuner.com'
  self.http_open_timeout = 5
  self.http_read_timeout = 5
  self.logger = Logger.new($stdout)
  self.polling_delay = 300
  self.sync_interval = 60
  self.sync_interval_staging = 0
  self.secure = true
  self.test_environments = %w(test cucumber)
  self.s3_host = 'copy-tuner-data-prod.s3.amazonaws.com'
  self.disable_copyray_comment_injection = false

  @applied = false
end

Instance Attribute Details

#api_key ⇒ String

Returns The API key for your project, found on the project edit form.

Returns:

  • (String) —

    The API key for your project, found on the project edit form.



25
26
27
 
# File 'lib/copy_tuner_client/configuration.rb', line 25

def api_key
  @api_key
end

#ca_file ⇒ String

Returns the path to a root certificate file used to verify ssl sessions. Default’s to the root certificate file for copy-tuner.com.

Returns:

  • (String) —

    the path to a root certificate file used to verify ssl sessions. Default’s to the root certificate file for copy-tuner.com.



103
104
105
 
# File 'lib/copy_tuner_client/configuration.rb', line 103

def ca_file
  @ca_file
end

#cache ⇒ Cache

Returns instance used internally to synchronize changes.

Returns:

  • (Cache) —

    instance used internally to synchronize changes.



106
107
108
 
# File 'lib/copy_tuner_client/configuration.rb', line 106

def cache
  @cache
end

#client ⇒ Client

Returns instance used to communicate with a CopyTuner Server.

Returns:

  • (Client) —

    instance used to communicate with a CopyTuner Server.



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

def client
  @client
end

#client_name ⇒ String

Returns The name of the client library being used to send notifications (defaults to CopyTuner Client).

Returns:

  • (String) —

    The name of the client library being used to send notifications (defaults to CopyTuner Client)



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

def client_name
  @client_name
end

#client_url ⇒ String

Returns The url of the client library being used.

Returns:

  • (String) —

    The url of the client library being used



73
74
75
 
# File 'lib/copy_tuner_client/configuration.rb', line 73

def client_url
  @client_url
end

#client_version ⇒ String

Returns The version of the client library being used to send notifications (such as 1.0.2).

Returns:

  • (String) —

    The version of the client library being used to send notifications (such as 1.0.2)



70
71
72
 
# File 'lib/copy_tuner_client/configuration.rb', line 70

def client_version
  @client_version
end

#copyray_js_injection_regexp_for_debug ⇒ Regexp

Returns Copyray js injection pattern for debug.

Returns:

  • (Regexp) —

    Copyray js injection pattern for debug



123
124
125
 
# File 'lib/copy_tuner_client/configuration.rb', line 123

def copyray_js_injection_regexp_for_debug
  @copyray_js_injection_regexp_for_debug
end

#copyray_js_injection_regexp_for_precompiled ⇒ Regexp

Returns Copyray js injection pattern for precompiled.

Returns:

  • (Regexp) —

    Copyray js injection pattern for precompiled



126
127
128
 
# File 'lib/copy_tuner_client/configuration.rb', line 126

def copyray_js_injection_regexp_for_precompiled
  @copyray_js_injection_regexp_for_precompiled
end

#development_environments ⇒ Array<String>

Returns A list of environments in which content should be editable.

Returns:

  • (Array<String>) —

    A list of environments in which content should be editable



55
56
57
 
# File 'lib/copy_tuner_client/configuration.rb', line 55

def development_environments
  @development_environments
end

#disable_copyray_comment_injection ⇒ Boolean

Returns To disable Copyray comment injection, set true.

Returns:

  • (Boolean) —

    To disable Copyray comment injection, set true



129
130
131
 
# File 'lib/copy_tuner_client/configuration.rb', line 129

def disable_copyray_comment_injection
  @disable_copyray_comment_injection
end

#disable_middleware ⇒ Boolean

Returns disable middleware setting.

Returns:

  • (Boolean) —

    disable middleware setting



94
95
96
 
# File 'lib/copy_tuner_client/configuration.rb', line 94

def disable_middleware
  @disable_middleware
end

#disable_test_translation ⇒ Boolean

Returns disable download translation for test enviroment.

Returns:

  • (Boolean) —

    disable download translation for test enviroment



100
101
102
 
# File 'lib/copy_tuner_client/configuration.rb', line 100

def disable_test_translation
  @disable_test_translation
end

#environment_name ⇒ String

Returns The name of the environment the application is running in.

Returns:

  • (String) —

    The name of the environment the application is running in



61
62
63
 
# File 'lib/copy_tuner_client/configuration.rb', line 61

def environment_name
  @environment_name
end

#exclude_key_regexp ⇒ Regexp

Returns Regular expression to exclude keys.

Returns:

  • (Regexp) —

    Regular expression to exclude keys.



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

def exclude_key_regexp
  @exclude_key_regexp
end

#framework ⇒ String, NilClass

Returns The framework notifications are being sent from, if any (such as Rails 2.3.9).

Returns:

  • (String, NilClass) —

    The framework notifications are being sent from, if any (such as Rails 2.3.9)



67
68
69
 
# File 'lib/copy_tuner_client/configuration.rb', line 67

def framework
  @framework
end

#host ⇒ String

Returns The host to connect to (defaults to copy-tuner.com).

Returns:

  • (String) —

    The host to connect to (defaults to copy-tuner.com).



28
29
30
 
# File 'lib/copy_tuner_client/configuration.rb', line 28

def host
  @host
end

#http_open_timeout ⇒ Fixnum

Returns The HTTP open timeout in seconds (defaults to 2).

Returns:

  • (Fixnum) —

    The HTTP open timeout in seconds (defaults to 2).



37
38
39
 
# File 'lib/copy_tuner_client/configuration.rb', line 37

def http_open_timeout
  @http_open_timeout
end

#http_read_timeout ⇒ Fixnum

Returns The HTTP read timeout in seconds (defaults to 5).

Returns:

  • (Fixnum) —

    The HTTP read timeout in seconds (defaults to 5).



40
41
42
 
# File 'lib/copy_tuner_client/configuration.rb', line 40

def http_read_timeout
  @http_read_timeout
end

#inline_translation ⇒ Boolean

Returns To enable inline-translation-mode, set true.

Returns:

  • (Boolean) —

    To enable inline-translation-mode, set true.



114
115
116
 
# File 'lib/copy_tuner_client/configuration.rb', line 114

def inline_translation
  @inline_translation
end

#locales ⇒ Array<Symbol>

Returns Restrict blurb locales to upload.

Returns:

  • (Array<Symbol>) —

    Restrict blurb locales to upload



132
133
134
 
# File 'lib/copy_tuner_client/configuration.rb', line 132

def locales
  @locales
end

#logger ⇒ Logger

Returns Where to log messages. Must respond to same interface as Logger.

Returns:

  • (Logger) —

    Where to log messages. Must respond to same interface as Logger.



88
89
90
 
# File 'lib/copy_tuner_client/configuration.rb', line 88

def logger
  @logger
end

#middleware ⇒ Object

Returns the middleware stack, if any, which should respond to use.

Returns:

  • the middleware stack, if any, which should respond to use



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

def middleware
  @middleware
end

#middleware_position ⇒ Object

OtherMiddleware or OtherMiddleware



97
98
99
 
# File 'lib/copy_tuner_client/configuration.rb', line 97

def middleware_position
  @middleware_position
end

#poller ⇒ Object

Returns the value of attribute poller.



111
112
113
 
# File 'lib/copy_tuner_client/configuration.rb', line 111

def poller
  @poller
end

#polling_delay ⇒ Integer

Returns The time, in seconds, in between each sync to the server. Defaults to 300.

Returns:

  • (Integer) —

    The time, in seconds, in between each sync to the server. Defaults to 300.



76
77
78
 
# File 'lib/copy_tuner_client/configuration.rb', line 76

def polling_delay
  @polling_delay
end

#port ⇒ Fixnum

Returns The port on which your CopyTuner server runs (defaults to 443 for secure connections, 80 for insecure connections).

Returns:

  • (Fixnum) —

    The port on which your CopyTuner server runs (defaults to 443 for secure connections, 80 for insecure connections).



31
32
33
 
# File 'lib/copy_tuner_client/configuration.rb', line 31

def port
  @port
end

#proxy_host ⇒ String, NilClass

Returns The hostname of your proxy server (if using a proxy).

Returns:

  • (String, NilClass) —

    The hostname of your proxy server (if using a proxy)



43
44
45
 
# File 'lib/copy_tuner_client/configuration.rb', line 43

def proxy_host
  @proxy_host
end

#proxy_pass ⇒ String, NilClass

Returns The password to use when logging into your proxy server (if using a proxy).

Returns:

  • (String, NilClass) —

    The password to use when logging into your proxy server (if using a proxy)



52
53
54
 
# File 'lib/copy_tuner_client/configuration.rb', line 52

def proxy_pass
  @proxy_pass
end

#proxy_port ⇒ String, Fixnum

Returns The port of your proxy server (if using a proxy).

Returns:

  • (String, Fixnum) —

    The port of your proxy server (if using a proxy)



46
47
48
 
# File 'lib/copy_tuner_client/configuration.rb', line 46

def proxy_port
  @proxy_port
end

#proxy_user ⇒ String, NilClass

Returns The username to use when logging into your proxy server (if using a proxy).

Returns:

  • (String, NilClass) —

    The username to use when logging into your proxy server (if using a proxy)



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

def proxy_user
  @proxy_user
end

#s3_host ⇒ String

Returns The S3 host to connect to (defaults to copy-tuner-us.s3.amazonaws.com).

Returns:

  • (String) —

    The S3 host to connect to (defaults to copy-tuner-us.s3.amazonaws.com).



120
121
122
 
# File 'lib/copy_tuner_client/configuration.rb', line 120

def s3_host
  @s3_host
end

#secure ⇒ Boolean Also known as: secure?

Returns true for https connections, false for http connections.

Returns:

  • (Boolean) —

    true for https connections, false for http connections.



34
35
36
 
# File 'lib/copy_tuner_client/configuration.rb', line 34

def secure
  @secure
end

#sync_ignore_path_regex ⇒ Regex

Returns Format ignore hook middleware sync.

Returns:

  • (Regex) —

    Format ignore hook middleware sync



85
86
87
 
# File 'lib/copy_tuner_client/configuration.rb', line 85

def sync_ignore_path_regex
  @sync_ignore_path_regex
end

#sync_interval ⇒ Object

Sync interval for Rack Middleware



79
80
81
 
# File 'lib/copy_tuner_client/configuration.rb', line 79

def sync_interval
  @sync_interval
end

#sync_interval_staging ⇒ Integer

Returns The time, in seconds, in between each sync to the server in development. Defaults to 60.

Returns:

  • (Integer) —

    The time, in seconds, in between each sync to the server in development. Defaults to 60.



82
83
84
 
# File 'lib/copy_tuner_client/configuration.rb', line 82

def sync_interval_staging
  @sync_interval_staging
end

#test_environments ⇒ Array<String>

Returns A list of environments in which the server should not be contacted.

Returns:

  • (Array<String>) —

    A list of environments in which the server should not be contacted



58
59
60
 
# File 'lib/copy_tuner_client/configuration.rb', line 58

def test_environments
  @test_environments
end

Instance Method Details

#[](option) ⇒ Object

Allows config options to be read like a hash

Parameters:

  • option (Symbol) —

    Key for a given attribute

Returns:

  • (Object) —

    the given attribute



169
170
171
 
# File 'lib/copy_tuner_client/configuration.rb', line 169

def [](option)
  send(option)
end

#applied? ⇒ Boolean

Determines if the configuration has been applied (internal)

Returns:

  • (Boolean) —

    Returns true if applied, false otherwise.



216
217
218
 
# File 'lib/copy_tuner_client/configuration.rb', line 216

def applied?
  @applied
end

#apply ⇒ Object

Applies the configuration (internal).

Called automatically when CopyTunerClient.configure is called in the application.

This creates the I18nBackend and puts them together.

When #test? returns false, the poller will be started.



227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
 
# File 'lib/copy_tuner_client/configuration.rb', line 227

def apply
  self.locales ||= begin
    if defined?(::Rails)
      self.locales = ::Rails.application.config.i18n.available_locales.presence || Array(::Rails.application.config.i18n.default_locale)
    else
      self.locales = [:en]
    end
  end

  self.client ||= Client.new(to_hash)
  self.cache ||= Cache.new(client, to_hash)
  @poller = Poller.new(cache, to_hash)
  process_guard = ProcessGuard.new(cache, @poller, to_hash)
  I18n.backend = I18nBackend.new(cache)

  if enable_middleware?
    logger.info "Using copytuner sync middleware"
    request_sync_options = {:poller => @poller, :cache => cache, :interval => sync_interval, :ignore_regex => sync_ignore_path_regex}
    if middleware_position.is_a?(Hash) && middleware_position[:before]
      middleware.insert_before middleware_position[:before], RequestSync, request_sync_options
      middleware.insert_before middleware_position[:before], CopyTunerClient::CopyrayMiddleware
    elsif middleware_position.is_a?(Hash) && middleware_position[:after]
      middleware.insert_after middleware_position[:after], RequestSync, request_sync_options
      middleware.insert_after middleware_position[:after], CopyTunerClient::CopyrayMiddleware
    else
      middleware.use RequestSync, request_sync_options
      middleware.use CopyTunerClient::CopyrayMiddleware
    end
  else
    logger.info "[[[Warn]]] Not using copytuner sync middleware" unless middleware
  end

  @applied = true
  logger.info "Client #{VERSION} ready (s3_download)"
  logger.info "Environment Info: #{environment_info}"
  logger.info "Available locales: #{self.locales.join(' ')}"

  unless test?
    process_guard.start
  end

  if test? and !disable_test_translation
    logger.info "Download translation now"
    cache.download
  end
end

#development? ⇒ Boolean

Determines if the content will be editable

Returns:

  • (Boolean) —

    Returns true if in a development environment, false otherwise.



200
201
202
 
# File 'lib/copy_tuner_client/configuration.rb', line 200

def development?
  development_environments.include? environment_name
end

#enable_middleware? ⇒ Boolean

Returns:

  • (Boolean) 


204
205
206
 
# File 'lib/copy_tuner_client/configuration.rb', line 204

def enable_middleware?
  middleware && development? && !disable_middleware
end

#environment_info ⇒ String

For logging/debugging (internal).

Returns:

  • (String) —

    a description of the environment in which this configuration was built.



290
291
292
293
 
# File 'lib/copy_tuner_client/configuration.rb', line 290

def environment_info
  parts = ["Ruby: #{RUBY_VERSION}", framework, "Env: #{environment_name}"]
  parts.compact.map { |part| "[#{part}]" }.join(" ")
end

#merge(hash) ⇒ Hash

Returns a hash of all configurable options merged with hash

Parameters:

  • hash (Hash) —

    A set of configuration options that will take precedence over the defaults

Returns:

  • (Hash) —

    the merged configuration hash



187
188
189
 
# File 'lib/copy_tuner_client/configuration.rb', line 187

def merge(hash)
  to_hash.merge hash
end

#project_url ⇒ String

Returns current project url by api_key.

Returns:

  • (String) —

    current project url by api_key



312
313
314
 
# File 'lib/copy_tuner_client/configuration.rb', line 312

def project_url
  URI::Generic.build(:scheme => self.protocol, :host => self.host, :port => self.port.to_i, :path => "/projects/#{self.api_key}").to_s
end

#protocol ⇒ String

The protocol that should be used when generating URLs to CopyTuner.

Returns:

  • (String) —

    https if #secure? returns true, http otherwise.



280
281
282
283
284
285
286
 
# File 'lib/copy_tuner_client/configuration.rb', line 280

def protocol
  if secure?
    'https'
  else
    'http'
  end
end

#public? ⇒ Boolean

Determines if the published or draft content will be used environment, true otherwise.

Returns:

  • (Boolean) —

    Returns false if in a development or test



194
195
196
 
# File 'lib/copy_tuner_client/configuration.rb', line 194

def public?
  !(development_environments + test_environments).include?(environment_name)
end

#test? ⇒ Boolean

Determines if the content will fetched from the server

Returns:

  • (Boolean) —

    Returns true if in a test environment, false otherwise.



210
211
212
 
# File 'lib/copy_tuner_client/configuration.rb', line 210

def test?
  test_environments.include? environment_name
end

#to_hash ⇒ Hash

Returns a hash of all configurable options

Returns:

  • (Hash) —

    configuration attributes



175
176
177
178
179
180
181
 
# File 'lib/copy_tuner_client/configuration.rb', line 175

def to_hash
  base_options = { :public => public? }

  OPTIONS.inject(base_options) do |hash, option|
    hash.merge option.to_sym => send(option)
  end
end