ff-ruby-server-sdk 0.0.2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 817b19ae2d914cd44f1cda5e8dea8eb019fa0cf8e367d71fd56990dc8150efdf
-  data.tar.gz: '088dd7868cb6c17ad2633082f6592e07642b54ea9897a34a3074ca0a2108afae'
+  metadata.gz: aafd2726a023b297ce97c582bc0270092f8795064c7bd16dd6096d2a5690681d
+  data.tar.gz: 00a0f190db82bdfb225eb7fd8546865ef6d399c2bcc835da436e1b807c90f1ae
 SHA512:
-  metadata.gz: c0549f021ca93e1b6cd0e913370caa69b43dc4247a86e4e8e288259124482903a7316e7bd489afedcbb2d42317107c3300d961567a8ad6cf7552b69f98572ec8
-  data.tar.gz: aa76f04ad606997faa49d4c61506ba86198e15cb9f61356ff76d6fa11332077eeb525640ff5bd2336dd554b113993b89d2da21d8434cd7610e562a5a122625b9
+  metadata.gz: e839a0f6b68c3e576730a62d836b74b622e50cabb07927fb6cebb1aaee5d9849788c603bf16a96e361d9e8fb25b8b34a71a28c13bf168a68f11b1fc5313484f4
+  data.tar.gz: f65a9e15ccc5f80ac924a4801c58f671cd63f1be24e95875e665af3b787af07cd35cb05e173bd66807ffac7331a83e00ffa30d5b83903deca3b4322608c19f16

data/.run/build.sh.run.xml

@@ -0,0 +1,17 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="build.sh" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/build.sh" />
+    <option name="SCRIPT_OPTIONS" value="" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$/scripts" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="true" />
+    <option name="INTERPRETER_PATH" value="/bin/zsh" />
+    <option name="INTERPRETER_OPTIONS" value="" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>

data/.run/install.sh.run.xml

@@ -0,0 +1,17 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="install.sh" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/install.sh" />
+    <option name="SCRIPT_OPTIONS" value="" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$/scripts" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="true" />
+    <option name="INTERPRETER_PATH" value="/bin/zsh" />
+    <option name="INTERPRETER_OPTIONS" value="" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>

data/.run/openapi.sh.run.xml

@@ -0,0 +1,17 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="openapi.sh" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/openapi.sh" />
+    <option name="SCRIPT_OPTIONS" value="" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$/scripts" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="true" />
+    <option name="INTERPRETER_PATH" value="/bin/zsh" />
+    <option name="INTERPRETER_OPTIONS" value="" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>

data/.run/publish.sh.run.xml

@@ -0,0 +1,17 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="publish.sh" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/publish.sh" />
+    <option name="SCRIPT_OPTIONS" value="" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$/scripts" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="true" />
+    <option name="INTERPRETER_PATH" value="/bin/zsh" />
+    <option name="INTERPRETER_OPTIONS" value="" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>

data/.run/sdk_test.rb.run.xml

@@ -1,5 +1,5 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="sdk_test.rb" type="TestUnitRunConfigurationType" factoryName="Test::Unit/Shoulda/Minitest" nameIsGenerated="true">
+  <configuration default="false" name="SDK test" type="TestUnitRunConfigurationType" factoryName="Test::Unit/Shoulda/Minitest">
     <module name="ff-ruby-server-sdk" />
     <predefined_log_file enabled="true" id="RUBY_TESTUNIT" />
     <RTEST_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-Ilib:test" />
@@ -19,8 +19,8 @@
     </EXTENSION>
     <EXTENSION ID="org.jetbrains.plugins.ruby.rails.run.RailsRunConfigurationExtension" SCRATCH_USE_RAILS_RUNNER="false" />
     <RTEST_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="" />
-    <RTEST_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/test/ff/ruby/server/sdk_test.rb" />
-    <RTEST_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPTS_PATHS" VALUE="$MODULE_DIR$/test/ff/ruby/server/sdk_test.rb" />
+    <RTEST_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/test/ff/ruby/server/sdk/sdk_test.rb" />
+    <RTEST_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPTS_PATHS" VALUE="$MODULE_DIR$/test/ff/ruby/server/sdk/sdk_test.rb" />
     <RTEST_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="" />
     <RTEST_RUN_CONFIG_SETTINGS_ID NAME="TEST_METHOD_NAME" VALUE="" />
     <RTEST_RUN_CONFIG_SETTINGS_ID NAME="TEST_TEST_TYPE" VALUE="CUSTOM_SET_OF_FILES" />

data/.run/unpublish.sh.run.xml

@@ -0,0 +1,17 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="unpublish.sh" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/unpublish.sh" />
+    <option name="SCRIPT_OPTIONS" value="" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$/scripts" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="true" />
+    <option name="INTERPRETER_PATH" value="/bin/zsh" />
+    <option name="INTERPRETER_OPTIONS" value="" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>

data/CHANGELOG.md

@@ -1,5 +1,5 @@
 ## [Unreleased]
 
-## [0.0.1] - 2021-11-16
+## [0.0.1, 0.0.2] - 2021-11-16
 
 - Initial release

data/Gemfile

@@ -2,11 +2,28 @@
 
 source "https://rubygems.org"
 
-# Specify your gem's dependencies in ff-ruby-server-sdk.gemspec
 gemspec
 
 gem "rake", "~> 13.0"
-
 gem "minitest", "~> 5.0"
-
 gem "standard", "~> 1.3"
+
+# OpenAPI:
+gem "openapi_client", "~> 1.0.0"
+
+# Caching support:
+gem "pp"
+gem "rufus-scheduler"
+gem "libcache"
+gem "jwt"
+gem "moneta"
+
+# SSE support:
+gem "rest-client"
+gem "sse-client"
+
+# Concurrency support:
+gem "concurrent-ruby", require: "concurrent"
+
+# Evaluator dependencies:
+gem "murmurhash3"

data/README.md

@@ -1,14 +1,162 @@
-Before you Begin
+Harness CF Ruby Server SDK
+========================
 
-Harness Feature Flags (FF) is a feature management solution that enables users to change the software’s functionality, without deploying new code. FF uses feature flags to hide code or behaviours without having to ship new versions of the software. A feature flag is like a powerful if statement.
+## Overview
 
-For more information, see https://harness.io/products/feature-flags/
+-------------------------
+[Harness](https://www.harness.io/) is a feature management platform that helps teams to build better software and to
+test features quicker.
 
-To read more, see https://ngdocs.harness.io/category/vjolt35atg-feature-flags
+-------------------------
 
-To sign up, https://app.harness.io/auth/#/signup/
+## Setup
+
+Add the following snippet to your project's `Gemfile` file:
+
+```
+gem "ff-ruby-server-sdk"
+```
+
+## Cloning the SDK repository
+
+In order to clone SDK repository properly perform cloning like in the following example:
+
+```
+git clone --recurse-submodules git@github.com:harness/ff-ruby-server-sdk.git
+```
+
+After dependency has been added, the SDK elements, primarily `CfClient` should be accessible in the main application.
+
+## Initialization
+
+`CfClient` is a base class that provides all features of the SDK.
+
+We can instantiate by calling the `instance` method or by using public
+constructor (making multiple instances).
+
+```ruby
+require 'ff/ruby/server/sdk/api/config'
+require 'ff/ruby/server/sdk/dto/target'
+require 'ff/ruby/server/sdk/api/cf_client'
+require 'ff/ruby/server/sdk/api/config_builder'
+
+client = CfClient.instance
+
+key = "YOUR_API_KEY_GOES_HERE"
+
+logger = Logger.new(STDOUT)
+
+# Or saving logs into the filesystem with daily rotation:
+# logger = Logger.new("example.log", "daily")
+
+config = ConfigBuilder.new
+                      .logger(logger)
+                      .build
+
+client.init(key, config)
+
+config.logger.debug 'We will wait for the initialization'
+
+client.wait_for_initialization
+
+config.logger.debug 'Initialization is complete'
+
+target = Target.new("YOUR_TARGET_NAME")
+```
+
+`target` represents the desired target for which we want features to be evaluated.
+
+`"YOUR_API_KEY"` is an authentication key, needed for access to Harness services.
+
+**Your Harness SDK is now initialized. Congratulations!**
+
+### Public API Methods ###
+
+The Public API exposes a few methods that you can utilize:
+
+Instantiate, initialize and close when done:
+
+* `def initialize(api_key = nil, config = nil, connector = nil)`
+* `def init(api_key = nil, config = nil, connector = nil)`
+* `def wait_for_initialization`
+* `def close`
+
+Evaluations:
+
+* `def bool_variation(identifier, target, default_value)`
+* `def string_variation(identifier, target, default_value)`
+* `def number_variation(identifier, target, default_value)`
+* `def json_variation(identifier, target, default_value)`
+
+## Fetch evaluation's value
+
+It is possible to fetch a value for a given evaluation. Evaluation is performed based on a different type. In case there
+is no evaluation with provided id, the default value is returned.
+
+Use the appropriate method to fetch the desired Evaluation of a certain type.
+
+### Bool variation
+
+```
+bool_result = client.bool_variation(bool_flag, target, false)  
+```
+
+### Number variation
+
+```
+number_result = client.number_variation(number_flag, target, -1)  
+```
+
+### String variation
+
+```
+string_result = client.string_variation(string_flag, target, "unavailable !!!")  
+```
+
+### JSON variation
+
+```
+json_result = client.json_variation(json_flag, target, JSON.parse("{}"))
+```
+
+## Using feature flags metrics
+
+Metrics API endpoint can be changed like this (if ever needed):
+
+```
+config = ConfigBuilder.new
+                      .event_url("SOME_ENDPOINT_URL")
+                      .build
+```
+
+Otherwise, the default metrics endpoint URL will be used.
+
+## Connector
+
+This is a new feature that allows you to create or use other connectors.
+Connector is just a proxy to your data. Currently supported connectors:
+
+* Harness (the default implementation)
+
+```
+connector = YourConnectorImplementation.new
+
+client.init(
+
+  key,
+  config,
+  connector
+)
+```
+
+## Shutting down the SDK
+
+To avoid potential memory leak, when SDK is no longer needed
+(when the app is closed, for example), a caller should call the `close` method:
+
+```
+client.close
+```
 
 
-# Harness FFM Server-side SDK for Ruby
 
-Tbd.