launchdarkly_api_helper 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f063313104693353f6dd3e18a6ecd69c5142b62eb3f072b08f96b8b51e9175e0
-  data.tar.gz: 1f83a4dc6665e8864605decdb1d265178232785d44cca584488533fe21bd4ce6
+  metadata.gz: b32c8619c0d002bd0974ae86f4172b4caa5733633919373d74956df9016a02f8
+  data.tar.gz: aa4328e4904f808b0588c02ecaf04068cc2a6d6a523500dd56a9acda0d872efd
 SHA512:
-  metadata.gz: e9fadbf1588e1d429f3cf3d1bf9bcccf6b06bda032baa707970a65714321a970e8e5d8f952baa99be5115e4986564c45bbcfcc07034f829637522569e5fd9f15
-  data.tar.gz: b947d46ef24947acba122a57ce2e2c582af6342806e357de59864523ba4b8e78e9d81185dc6f51d4b183621d94b97d206840d020dc5226731db866ef77a25c7a
+  metadata.gz: f411f430c4c844dbb4845d678ab77d0fffbc1a0f34cec14246de70e80d1f8ab787e6e3497678abaf85fb1fea61e3f6a296f7f8892f597864724d40ab13190542
+  data.tar.gz: f851657526a6d3efb998159ef78920882dedfab9f71bdd10597c0db0fe49a3885cdfc5b963ac6e244a32a074ddad0112904ad7199e9f6912f4967b917748f234

data/README.md

@@ -1,4 +1,4 @@
-# LaunchdarklyApiHelper
+# LaunchdarklyApiHelper ![alt_text](https://badge.fury.io/rb/launchdarkly_api_helper.svg)
 
 [LaunchDarklyApiHelper](https://rubygems.org/gems/launchdarkly_api_helper) provides you a way to access your [Launch Darkly](https://apidocs.launchdarkly.com/) account using [API token](https://app.launchdarkly.com/settings/authorization/tokens/new) to view, edit or delete them accordingly.
 
@@ -27,10 +27,11 @@ To perform any operations such as add, remove, replace, move, copy, test you sho
 ```ruby
 parameters:
 access_token (*required): this token will be used to send all requests to LaunchDarkly (string)
-log_file: all logs will be writeen to file 'launchdarkly.log' by default if no file name specified
+project_name: provide project name of your organistaion (NOTE: for most, it should be `default` unless you have made some explicit changes)
+log_file: all logs will be written to file 'launchdarkly.log' by default if no file name specified (string)
 
 # set your LD API token and log file to capture logs
-def ld_access_token(access_token, log_file = 'launchdarkly.log') 
+def ld_access_token(access_token, project_name = 'default', log_file = 'launchdarkly.log') 
   # code ...
 end
 ```
@@ -41,21 +42,21 @@ end
 GET REQUEST
 https://app.launchdarkly.com/api/v2/flags/default/developer_flag_for_regression
 
-parameters:
-env (*required): name of the environment for which you want to get the details (string)
-flag (*required): name of the feature flag for which you want to get the details (string)
-                                             
-Here, 'developer_flag_for_regression' is the feature flag name and default is our Project name - eg. AmitSinghBisht
+Here, 'developer_flag_for_regression' is the feature flag name and `default` is our Project name - eg. AmitSinghBisht
 By default, this returns the configurations for all environments
 You can filter environments with the env query parameter. For example, setting env=staging restricts the returned configurations to just the staging environment
 https://app.launchdarkly.com/api/v2/flags/default/developer_flag_for_regression?env=staging
 
+parameters:
+env (*required): name of the environment for which you want to get the details (string)
+flag (*required): name of the feature flag for which you want to get the details (string)
+
 # this method will give you entire details about a flag for that particular environment
 def ld_fetch_flag_details(env, flag)
   # code ...
 end
 
-@return value (response of feature flag details):
+@return parameter: (response of feature flag details)
 response = "https://app.launchdarkly.com/api/v2/flags/default/#{flag}?env=#{env}" (string)
 ```
 
@@ -66,15 +67,12 @@ parameters:
 env (*required): name of the environment for which you want to get the details (string) 
 flag (*required): name of the feature flag for which you want to get the details (string)
 
-response = https://app.launchdarkly.com/api/v2/flags/default/developer_flag_for_regression?env=staging
-grab the value of the ['environments'][env]['on'] obtained from the above response
-
 # this method will return the status of the flag, whether it is on or off viz set to true or false
 def ld_fetch_flag_toggle_status(env, flag)
   # code ...
 end
 
-@return value (response of feature flag toggle status):
+@return parameter: (response of feature flag toggle status)
 response = "https://app.launchdarkly.com/api/v2/flags/default/#{flag}?env=#{env}"
 response['environments'][env]['on'] (boolean)
 ```
@@ -141,20 +139,20 @@ https://apidocs.launchdarkly.com/tag/Feature-flags#operation/patchFeatureFlag
 PATCH REQUEST
 https://app.launchdarkly.com/api/v2/flags/default/developer_flag_for_regression
 
+Here, 'developer_flag_for_regression' is the flag key and `default` is our Project name - eg. AmitSinghBisht
+You can update any parameter of feature flag using this method
+
 parameters:
 env (*required): name of the environment for which you want to get the details (string)
 flag (*required): name of the feature flag for which you want to get the details (string)
 flag_value: status of the feature flag that you want to set either on (true) or off (false) (boolean)
 
-Here, 'developer_flag_for_regression' is the flag key and default is our Project name - eg. AmitSinghBisht
-You can update any parameter of feature flag using this method
-
 # this method will be used to toggle status of feature flag either on / off for a particular environment
 def ld_toggle_specific_environment(env, flag, flag_value = true)
   # code ...
 end
 
-@return value (response of feature flag toggle status):
+@return parameter: (response of feature flag toggle status)
 response = "https://app.launchdarkly.com/api/v2/flags/default/#{flag}?env=#{env}"
 response['environments'][env]['on'] (boolean)
 ```
@@ -162,8 +160,13 @@ response['environments'][env]['on'] (boolean)
 ```ruby
 Get status of feature flag
 https://apidocs.launchdarkly.com/tag/Feature-flags#operation/patchFeatureFlag
- 
-def ld_toggle_variation_served(env, flag)
+
+parameters:
+env (*required): name of the environment for which you want to get the details (string)
+flag (*required): name of the feature flag for which you want to get the details (string)
+
+# this method will get important parameters from the response
+def flag_variation_served(env, flag)
   # code ...
 end
 
@@ -172,38 +175,131 @@ end
 response = "https://app.launchdarkly.com/api/v2/flags/default/#{flag}?env=#{env}"
 fetch_flag_toggle_status_response: response['environments'][env]['on'] (boolean)
 feature_flag_variation_index_response: response (integer)
-feature_flag_variation_value_response: response['variations'][feature_flag_variation_index_response]['value'] (object)
+feature_flag_variation_value_response: response['variations'][feature_flag_variation_index_response]['value'] (string)
 feature_flag_variation_name_response: response['variations'][feature_flag_variation_index_response]['name'] (string)
 ```
 
 ```ruby
+
+"rules": [
+  {                                   # rules/0
+    "variation": 0,
+    "clauses": [
+      {                               # rules/0/clauses/0
+        "attribute": "groups",
+        "op": "in",
+        "values": ["Top Customers"],
+        "negate": false
+      },
+      {                               # rules/0/clauses/1
+        "attribute": "email",
+        "op": "endsWith",
+        "values": ["gmail.com"],
+        "negate": false
+      }
+    ]
+  },
+  {                                   # rules/1
+    "variation": 1,
+    "clauses": [
+      {                               # rules/1/clauses/0
+        "attribute": "country",
+        "op": "in",
+        "values": [
+          "in",                       # rules/1/clauses/0/values/0
+          "eu"                        # rules/1/clauses/0/values/1
+        ],
+        "negate": false
+      }
+    ]
+  }
+]
+
+parameters:
+env (*required): name of the environment for which you want to get the details (string)
+flag (*required): name of the feature flag for which you want to get the details (string)
+clause_name (*required): name of clause that you want to search for in response
+
+# this method will return the index of rules and clauses by searching for clause_name in response
 def ld_rules_clauses_index(env, flag, clause_name)
   # code ...
 end
+
+@returns: [rule_at_index, clause_at_index]
+@return parameter:
+response = "https://app.launchdarkly.com/api/v2/flags/default/#{flag}?env=#{env}" ['environments'][env]['rules']
+rule_at_index = response[rule_index]  (integer) # index at which rule is found
+clause_at_index = response[rule_index]['clauses'][clause_index]  (integer) # index at which clause is found 
 ```
 
 ```ruby
+parameters:
+env (*required): name of the environment for which you want to get the details (string)
+flag (*required): name of the feature flag for which you want to get the details (string)
+clause_name (*required): name of clause that you want to search for in response
+
+# this method will return values inside a particular clause by searching for clause_name in response
 def ld_get_values_from_clauses(env, flag, clause_name)
   # code ...
 end
+
+@return parameter: values_for_clause_name
+response = "https://app.launchdarkly.com/api/v2/flags/default/#{flag}?env=#{env}" ['environments'][env]['rules']
+values_for_clause_name = response[rule_at_index]['clauses'][clause_at_index]['values'] (string)
 ```
 
 ```ruby
+parameters:
+env (*required): name of the environment for which you want to get the details (string)
+flag (*required): name of the feature flag for which you want to get the details (string)
+clause_name (*required): name of clause that you want to search for in response
+clause_value (*required): value that you want to add to a particular clause (NOTE: it will be appened at zeroth 0th index)
+
+# this method will help you to add a value to a particular clause by searching for clause_name in response
 def ld_add_values_to_clause(env, flag, clause_name, clause_value)
   # code ...
 end
+
+@return parameter: (response of feature flag details)
+response = "https://app.launchdarkly.com/api/v2/flags/default/#{flag}?env=#{env}" (string)
 ```
 
 ```ruby
-def ld__remove_values_from_clause(env, flag, clause_name, clause_value)
+parameters:
+env (*required): name of the environment for which you want to get the details (string)
+flag (*required): name of the feature flag for which you want to get the details (string)
+clause_name (*required): name of clause that you want to search for in response
+clause_value (*required): value that you want to add to a particular clause (NOTE: it will be appened at zeroth 0th index)
+
+# this method will help you to remove a value to a particular clause by searching for clause_name in response
+def ld_remove_values_from_clause(env, flag, clause_name, clause_value)
   # code ...
 end
+
+@return parameter: (response of feature flag details)
+response = "https://app.launchdarkly.com/api/v2/flags/default/#{flag}?env=#{env}" (string)
 ```
 
 ```ruby
+Delete feature flag
+https://apidocs.launchdarkly.com/tag/Feature-flags#operation/deleteFeatureFlag
+
+DELETE REQUEST
+https://app.launchdarkly.com/api/v2/flags/default/developer_flag_for_regression
+
+Here, 'developer_flag_for_regression' is the flag key and default is our Project name - eg. AmitSinghBisht
+You can delete any feature flag using this method
+
+parameters:
+flag (*required): name of the feature flag for which you want to get the details (string)
+
+# this method will delete a feature flag in launchdarkly (NOTE: env resided inside flag which means flag is parent, so deleting a feature flag will delete it from all environment)
 def ld_delete_flag(flag)
   # code ...
 end
+
+@return parameter: (response of feature flag details)
+response = "https://app.launchdarkly.com/api/v2/flags/default/#{flag}?env=#{env}" (string)
 ```
 
 ## Development

data/lib/launchdarkly_api_helper/constants.rb

@@ -1,5 +1,3 @@
-LAUNCH_DARKLY_FLAGS = 'https://app.launchdarkly.com/api/v2/flags/default'.freeze
-LAUNCH_DARKLY_PROJECTS = 'https://app.launchdarkly.com/api/v2/projects/default'.freeze
 REQUEST_CLASSES = {
   get: {
     'method' => Net::HTTP::Get,

data/lib/launchdarkly_api_helper/launchdarkly_api_helper_class.rb

@@ -8,8 +8,12 @@ require_relative 'constants'
 
 # All methods related to launch darkly api are defined here
 class LaunchdarklyApiHelperClass
-  def initialize(access_token, log_file)
+
+  @launch_darkly_flags = 'https://app.launchdarkly.com/api/v2/flags/project_name'
+
+  def initialize(access_token, project_name, log_file)
     @access_token = access_token
+    @launch_darkly_flags.gsub! 'project_name', project_name
     @logger = Logger.new(log_file)
   end
 
@@ -43,7 +47,7 @@ class LaunchdarklyApiHelperClass
   end
 
   def fetch_flag_details(env, flag)
-    request_url = "#{LAUNCH_DARKLY_FLAGS}/#{flag}?env=#{env}"
+    request_url = "#{@launch_darkly_flags}/#{flag}?env=#{env}"
     ld_request(:get, request_url)
   end
 
@@ -53,14 +57,14 @@ class LaunchdarklyApiHelperClass
   end
 
   def create_flag(key, name, description, tags)
-    request_url = LAUNCH_DARKLY_FLAGS
+    request_url = @launch_darkly_flags
     request_body = {}
     request_body.merge!(key: key, name: name, description: description, tags: tags)
     ld_request(:post, request_url, request_body)
   end
 
   def toggle_specific_environment(env, flag, flag_value)
-    request_url = "#{LAUNCH_DARKLY_FLAGS}/#{flag}"
+    request_url = "#{@launch_darkly_flags}/#{flag}"
     request_body = { 'op' => 'replace', 'path' => "/environments/#{env}/on", 'value' => flag_value }
     response_body = ld_request(:patch, request_url, [request_body])
     response_body['environments'][env]['on']
@@ -86,7 +90,7 @@ class LaunchdarklyApiHelperClass
     details_response['variations'][index_response]['name']
   end
 
-  def ld_toggle_variation_served(env, flag)
+  def flag_variation_served(env, flag)
     details_response = fetch_flag_details(env, flag)
     toggle_status_response = fetch_flag_toggle_status(env, flag)
     variation_index_response = feature_flag_variation_index(toggle_status_response, details_response) # ['environments'][env]['fallthrough']['variation']
@@ -130,29 +134,29 @@ class LaunchdarklyApiHelperClass
   end
 
   def get_values_from_clauses(env, flag, clause_name)
-    rule_at_index, clause_at_index = feature_flag_rules_clauses_index(env, flag, clause_name)
+    rule_at_index, clause_at_index = rules_clauses_index(env, flag, clause_name)
     @feature_flag_rules_list[rule_at_index]['clauses'][clause_at_index]['values']
   end
 
   def add_values_to_clause(env, flag, clause_name, clause_value)
-    rule_at_index, clause_at_index = feature_flag_rules_clauses_index(env, flag, clause_name)
-    request_url = "#{LAUNCH_DARKLY_FLAGS}/#{flag}"
+    rule_at_index, clause_at_index = rules_clauses_index(env, flag, clause_name)
+    request_url = "#{@launch_darkly_flags}/#{flag}"
     request_body = { 'op' => 'add', 'path' => "/environments/#{env}/rules/#{rule_at_index}/clauses/#{clause_at_index}/values/0", 'value' => clause_value }
     ld_request(:patch, request_url, [request_body])
   end
 
   def remove_values_from_clause(env, flag, clause_name, clause_value)
-    rule_at_index, clause_at_index = feature_flag_rules_clauses_index(env, flag, clause_name)
+    rule_at_index, clause_at_index = rules_clauses_index(env, flag, clause_name)
     value_at_index = search_value_index(rule_at_index, clause_at_index, clause_value)
     puts "value_index: #{value_at_index}"
-    request_url = "#{LAUNCH_DARKLY_FLAGS}/#{flag}"
+    request_url = "#{@launch_darkly_flags}/#{flag}"
     request_body = { 'op' => 'test', 'path' => "/environments/#{env}/rules/#{rule_at_index}/clauses/#{clause_at_index}/values/#{value_at_index}", 'value' => clause_value },
                    { 'op' => 'remove', 'path' => "/environments/#{env}/rules/#{rule_at_index}/clauses/#{clause_at_index}/values/#{value_at_index}" }
     ld_request(:patch, request_url, request_body)
   end
 
   def delete_flag(flag)
-    request_url = "#{LAUNCH_DARKLY_FLAGS}/#{flag}"
+    request_url = "#{@launch_darkly_flags}/#{flag}"
     ld_request(:delete, request_url)
   end
 end

data/lib/launchdarkly_api_helper/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LaunchdarklyApiHelper
-  VERSION = '0.4.0'
+  VERSION = '0.5.0'
 end

data/lib/launchdarkly_api_helper.rb

@@ -34,8 +34,8 @@ module LaunchdarklyApiHelper
   # == To perform any operations such as add, remove, replace, move, copy, test you should have a working knowledge of JSON Patch
   # https://datatracker.ietf.org/doc/html/rfc6902
 
-  def ld_access_token(access_token, log_file = 'launchdarkly.log')
-    @launchdarkly_helper = LaunchdarklyApiHelperClass.new(access_token, log_file)
+  def ld_access_token(access_token, project_name = 'default', log_file = 'launchdarkly.log')
+    @launchdarkly_helper = LaunchdarklyApiHelperClass.new(access_token, project_name, log_file)
   end
 
   # == Get feature flag
@@ -144,8 +144,8 @@ module LaunchdarklyApiHelper
   #
   # [fetch_flag_toggle_status_response, feature_flag_variation_index_response, feature_flag_variation_value_response, feature_flag_variation_name_response]
 
-  def ld_toggle_variation_served(env, flag)
-    @launchdarkly_helper.ld_toggle_variation_served(env, flag)
+  def ld_flag_variation_served(env, flag)
+    @launchdarkly_helper.flag_variation_served(env, flag)
   end
 
   def ld_rules_clauses_index(env, flag, clause_name)
@@ -160,7 +160,7 @@ module LaunchdarklyApiHelper
     @launchdarkly_helper.add_values_to_clause(env, flag, clause_name, clause_value)
   end
 
-  def ld__remove_values_from_clause(env, flag, clause_name, clause_value)
+  def ld_remove_values_from_clause(env, flag, clause_name, clause_value)
     @launchdarkly_helper.remove_values_from_clause(env, flag, clause_name, clause_value)
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: launchdarkly_api_helper
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - amit-singh-bisht
@@ -33,7 +33,7 @@ metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/amit-singh-bisht/launchdarkly_api_helper_ruby
   source_code_uri: https://github.com/amit-singh-bisht/launchdarkly_api_helper_ruby
-  changelog_uri: https://github.com/amit-singh-bisht/launchdarkly_api_helper_ruby/blob/main/README.md
+  changelog_uri: https://github.com/amit-singh-bisht/launchdarkly_api_helper_ruby/blob/master/README.md
 post_install_message: 
 rdoc_options: []
 require_paths: