EasyManageClient

This client allows you to download compiled dumps in JSON or YAML format, such as translation, configuration etc. on EasyManage server to your project easly.

It is recommended to use at the projects initial stage.

Add this line to your application's Gemfile:

gem 'easy_manage_client'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install easy_manage_client

Client must be configured before use. Configuration fields are as:

Create a file in the config/initializers directory and configure client in this file as below:

# config/initializers/easy_manage_client.rb

EasyManageClient.configure do |config|
  config.root_url = 'https://easymanage.example.com'
  config.auth_token = 'YOUR_SECRET_AUTH_TOKEN'
  config.extension = 'yaml'
  config.download_folder = File.join(Rails.root, 'config', 'translations')
  config.compile_id = 'SPECIAL_COMPILED_VERSION_ID'
end

You can define multiple configurations separated by profile. To do this, you must pass the profile parameter to the configure definition. If the profile name is not pass in the configuration, it defaults to use :default.

In this example, to download dynamicly application settings, profile name specified as settings.

# config/initializers/dynamic_settings.rb

EasyManageClient.configure(:dynamic_settings) do |config|
  config.root_url = 'https://easymanage.example.com'
  config.auth_token = 'YOUR_SECRET_AUTH_TOKEN'
  config.extension = 'json'
  config.download_folder = File.join(Rails.root, 'config', 'settings')
end

Initialize a client object before starting process.

client = EasyManageClient::Downloader.new

To download compiled dump, call the method perform. The client downloads the compiled version to the directory specified in the configuration, in the specified format. In this case, client uses the folder: File.join(Rails.root, 'config', 'translations').

client.perform

In case of an unsuccessful download; perform! can be used instead of perform for error exception. This method creates an EasyManageClient::DownloadProcessFailed exception.

You can pass the profile argument on client initialization to use different configuration.

client = EasyManageClient::Downloader.new(profile: :dynamic_settings)
client.perform

If the download process will be performed only in the Rails initialization, the following method can be used: # config/initializers/easy_manage_client.rb

EasyManageClient.configure(:dummy_profile) do |config|
  config.root_url = 'https://easymanage.example.com'
  config.auth_token = 'YOUR_SECRET_AUTH_TOKEN'
  config.extension = 'yaml'
  config.download_folder = File.join(Rails.root, 'config', 'settings')
end
client = EasyManageClient::Downloader.new(profile: :dummy_profile)
client.perform!

The client has its own rake tasks. This feature can be used in configurations such as CI configurations, Dockerfile etc.

Use rake task to download your compiled dump as below:

rake easy_manage_client:download

Pass profile to rake task via environment variable:

rake easy_manage_client:download EASY_MANAGE_PROFILE=dummy_settings

Bug reports and pull requests are welcome on GitHub at https://github.com/sertangulveren/easy_manage_client.