configly-ruby 0.0.2 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c22fd1c7b4856a9ad62ae8a870a40bbe447431c365a9a717faa512919e2fdce1
-  data.tar.gz: 1f1ea045a27b1dc8a5895b0d5f08054bfe0e9fdf15aae1c9759b21a3243ac0d6
+  metadata.gz: a42b4285e7b42e00601a87e46cfb8680f07762ad577ae26ab840aeecefa57d1a
+  data.tar.gz: 96d5942a380b62128d30fac438dff07bfa47746ea85668926c6ab735eeec770c
 SHA512:
-  metadata.gz: 13beb93697288800ff73e9d14f870c3c5071e82aaaae93ed72dbb0d21270e122040ba8f1fa025bff32317e5754500539cd6d4a5c04dcd37c3c2cb250f3976d00
-  data.tar.gz: 39050f72a4cc0a5705a705a92616f316d20945d5e6becf91057c8e2b9935e1a731271680c546399c8589e0c08fe23fff0797fc1f15963ad95e429d79aabf055d
+  metadata.gz: b4f4fd9e7fb133c3ba13376929c06bd64a09c8e707347ddb325887ebb4d4161de3952af67b47edba1d0239401c1758a2c379980e29a2dec73dab0615a265210e
+  data.tar.gz: e0be4959d0af7c1bd59aa2d1030190cfaa4d798c9d2982f8badc0180f8b924cddee7d0fc892dfcefad0302968bfcce444b213fff253e525dee34383eed41b2e0

data/README.md

@@ -1,8 +1,8 @@
-# Configly React Library
+# Configly Ruby Library
 > The Ruby library for [Configly](https://www.config.ly): the modern config/static data key/value store.
 
-![npm](https://img.shields.io/npm/v/configly-react)
-![GitHub](https://img.shields.io/github/license/configly/react)
+![npm](https://img.shields.io/gem/v/configly-ruby)
+![GitHub](https://img.shields.io/github/license/configly/ruby)
 
 Table of Contents
 =================
@@ -38,13 +38,74 @@ read more about the benefits at [Configly](config.ly).
 
 - API to fetch Strings, JSON Blobs (arrays and objects), Booleans, and Numbers from the Configly backend
 - [Web interface](https://www.config.ly/config) for modifying these values without having to deploy code (we call our beloved web interface _the Configulator_).
-- High availability, high-throughput, low-latency backend.
+  - High availability, high-throughput, low-latency backend.
 - Smart caching on the client libraries to minimize server requests.
 - Client libraries available in an expanding amount of languages.
 
+### Concepts/ Data Model
+- A Configly account contains a set of Configs.
+- A Config is a key-value pair along with associated metadata (like TTL).
+- The keys are strings.
+- The values are one of the following types:
+
+#### Types
+
+| Type    |  notes   | Example(s)|
+|---------|----------|----------|
+| string  |          | "I <3 Configly!" |
+| number  | Can be integers or decimal; _be aware some clients require you to specify which when fetching_  | 31337, 1.618 |
+| boolean | only true or false | true, false |
+| jsonBlob | A [JSON5](https://json5.org/) (more relaxed JSON) array or object. | ``` ["one", 5, true]```, ```{"text": "Buy now!", color: "#0F0"}``` |
+
+##### More `jsonBlob` examples
+You can make arbitrarily complex JSON structures -- _as long_ as the top level is
+an object or array. This is incredibly powerful as you can send a host of data
+with a single _config_:
+
+
+A more complex array for a store inventory. Note that because we're using JSON5, quotes
+are optional for single words.
+```js
+[
+  "Simple T-shirt",
+  "Basic hoodie",
+  {
+    item: "Complex T-shirt",
+    sizes: ['S', 'M', 'L'],
+    price_us_cents: [1099, 1499, 1599],
+  }
+]
+```
+
+And a more complex object showing how you can internationalize and set style:
+```js
+{
+  "welcome_message": {
+    copy: {
+      'en': 'Welcome!',
+      'es': "¡Bienvenidos!",
+    }, style: {
+      color: '#0F0',
+      fontWeight: '700',
+    }
+  },
+  "buy_button" : {
+    copy: {
+      'en': 'Buy',
+      'es': "Comprar",
+    }, style: {
+      backgroundColor: "#F00",
+      border: "border-radius 10px",
+    }
+  }
+}
+```
+
 ## Getting Started
 
-### Get your API Key
+In four easy steps!
+
+### 1. Get your API Key
 
 You'll need a [Configly](https://www.config.ly) account. Registration is lightning quick&mdash;you can register via
 visiting [https://www.config.ly/signup](https://www.config.ly/signup).
@@ -52,30 +113,115 @@ visiting [https://www.config.ly/signup](https://www.config.ly/signup).
 After signing up, you can grab your API Key from [https://www.config.ly/register](https://www.config.ly/register).
 You'll need your API Key to setup the API below.
 
-### Library installation
+### 2. Create your first Config
+From [https://www.config.ly/config](https://www.config.ly/config), create a new Config via the "Add" button:
+![image](https://user-images.githubusercontent.com/184923/98487495-3b42ca80-21f1-11eb-9bfc-bfd429733362.png)
+
+Consider creating a simple `JSON Object or Array` Config called `greetings` and give it the value of:
+`['hello', 'hola', '你好', 'नमस्ते']`:
+
+[https://www.config.ly/config](https://www.config.ly/config) should look like this:
+
+![image](https://user-images.githubusercontent.com/184923/98494454-09d6f880-220b-11eb-9ef7-36709ddc129f.png)
 
+Be sure to save via clicking 'Send to Clients'. Now, we'll write client code to fetch this key.
+
+### 3. Install the client library
+
+If you're using bundler, add the following line to your project's `Gemfile`:
+```sh
+gem 'configly-ruby', '~> 0.0.5'
+```
+
+Or, if you're using the Gem directly from your application, you can run:
 ```sh
 gem install configly-ruby
 ```
 
 You will need to set the `CONFIGLY_API_KEY` environment variable.
 
-If you want to use the optional websocket library, you can set:
-```
-CONFIGLY_KEYS_TO_PRELOAD=test1,test2,test3 (these are the keys you want to use)
-CONFIGLY_USE_WS=true
+### 4. Fetch the Config
+In a Rails controller, add the following code
+```ruby
+def get
+   begin
+      key = Configly::Client.get(params[:key])
+      render plain: key
+   rescue Configly::KeyError
+      render :status => 404
+   end
+end
 ```
 
+Map the route, and then request it in your browser with the `key` params (e.g. `http://localhost:3000/configly?key=test1234`). 
+
+Try changing some values on [https://www.config.ly/config](https://www.config.ly/config) to confirm that
+the client is getting the updates.
+
+Congratulations you have Configly working end-to-end! Now, feel free to use Configly with all your projects!
+
+## Configuring this library to use websockets
+Coming soon...
+
 ## Usage
+> The golden rule of Configly library use is: **do NOT** assign the result of a `get()`
+to a long-lived variable; in order to check for new values from the server, you must call `get()`.
+
+The package needs to be configured with your account's API key, which is available in the
+[Configly Configulator](https://config.ly/config)
+
+```
+// This value is stored on the Config.ly servers.
+store_catalog:
+{
+   has_sale: true,
+   discount: 0.8,
+   items: ['T Shirt', 'Hoodie', 'Ferrari'],
+   price: [ 100, 250,  200000],
+}
+```
 
-To fetch a key, use the following command:
+On the Ruby client:
 
 ```ruby
-Configly::Client.get(KEY)
+begin
+   catalog = Configly::Client.get(KEY)
+   items = catalog['items']
+   prices = catalog['prices']
+
+   items.each_with_index do |item, index|
+      Rails.logger.debug("#{item}: #{prices[index]} USD")
+   end
+rescue Configly::KeyError
+   Rails.logger.error("Something went wrong")
+end
 ```
 
-If the key doesn't exist (or if you are using the websockets client and it hasn't been prefetched), this will rais a `Configly::KeyError`
+Note: If the key doesn't exist, this will raise a `Configly::KeyError`
+
+Here is an example with feature flags. 
+// These values are stored on the Config.ly server
+```
+feature1_enabled: true
+feature2_enabled: false
+```
+
+On the ruby client:
+
+```ruby
+begin
+  if Configly::Client.get('feature1_enabled')
+    # Logic for feature 1
+  end
+
+  if Configly::Client.get('feature2_enabled')
+    # Logic for feature 2
+  end
+rescue Configly::KeyError
+   Rails.logger.error("Something went wrong")
+end
+```
 
 ## License
 
-This repository is published under the [MIT](LICENSE.md) license.
+This repository is published under the [MIT](LICENSE.md) license.

data/configly-ruby.gemspec

@@ -3,8 +3,8 @@ require_relative 'lib/configly/version'
 
 Gem::Specification.new do |s|
   s.name        = 'configly-ruby'
-  s.version     = '0.0.2'
-  s.date        = '2020-11-15'
+  s.version     = '0.0.7'
+  s.date        = '2020-11-16'
   s.summary     = "Configly"
   s.description = "Configly SDK gem"
   s.authors     = ["Dana Levine"]

data/lib/configly/client.rb

@@ -8,7 +8,7 @@ CONFIGLY_VALUE_URL = '/api/v1/value'
 module Configly
     class Client
         @keys = {}
-        @caches = {}
+        @ttl_expirations = {}
         @use_ws = false
         def self.init
             @use_ws = true
@@ -31,7 +31,7 @@ module Configly
         end
 
         def self.load_initial_data
-            @keys = fetch(get_keys_to_preload)
+            fetch(get_keys_to_preload, false)
         end
 
         def self.start_web_socket_client
@@ -62,21 +62,38 @@ module Configly
             end
         end
 
-        def self.fetch(keys)
-            uri = URI("https://#{CONFIGLY_SERVER}#{CONFIGLY_VALUE_URL}?#{generate_qs(keys)}")
-            loaded_keys = {}
-            Net::HTTP.start(uri.host, uri.port, :use_ssl => true) do |http|
-                request = Net::HTTP::Get.new uri
-                request.basic_auth get_api_key, ''
-                response = http.request request
-                print "\n#{response.code}\n"
-                print "\n#{response.body}\n"
-                data = JSON.parse(response.body)['data']
-                data.keys.each do |key|
-                    loaded_keys[key] = data[key]['value']
+        def self.fetch(keys, use_ttls)
+            current_time = Time.now.to_i
+
+            # If we aren't using the TTLs, fetch all keys
+            if !use_ttls
+                keys_to_fetch = keys
+            else
+                # Otherwise, fetch the keys that are unfetched or expired
+                keys_to_fetch = []
+                keys.each do |key|
+                    if !@ttl_expirations.has_key?(key) || @ttl_expirations[key] < current_time
+                        keys_to_fetch << key
+                    end
+                end
+            end
+
+            # Only actually execute the request if there are keys to fetch
+            if keys_to_fetch.length > 0
+                uri = URI("https://#{CONFIGLY_SERVER}#{CONFIGLY_VALUE_URL}?#{generate_qs(keys_to_fetch)}")
+
+                Net::HTTP.start(uri.host, uri.port, :use_ssl => true) do |http|
+                    request = Net::HTTP::Get.new uri
+                    request.basic_auth get_api_key, ''
+                    response = http.request request
+                    data = JSON.parse(response.body)['data']
+                    data.keys.each do |key|
+                        # Set the key and the expiration
+                        @keys[key] = data[key]['value']
+                        @ttl_expirations[key] = current_time + data[key]['ttl']
+                    end
                 end
             end
-            return loaded_keys
         end
 
         def self.get(key)
@@ -87,9 +104,9 @@ module Configly
                     raise KeyError.new(key)
                 end
             else
-                loaded_keys = fetch([key])
-                if loaded_keys.has_key? key
-                    return[key]
+                fetch([key], true)
+                if @keys.has_key? key
+                    return @keys[key]
                 else
                     raise KeyError.new(key)
                 end

data/lib/configly/version.rb

@@ -1,3 +1,3 @@
 module Configly
-  VERSION = "0.1.0"
+  VERSION = "0.0.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: configly-ruby
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.7
 platform: ruby
 authors:
 - Dana Levine
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-11-15 00:00:00.000000000 Z
+date: 2020-11-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faye-websocket