confeature 0.1.1 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/confeature/internal/evaluator.rb +7 -7
- data/lib/confeature/internal/override_eval.rb +9 -3
- data/lib/confeature/internal/provider_evaluation.rb +64 -0
- data/lib/confeature/internal/provider_user.rb +19 -0
- data/lib/confeature/snapshot.rb +23 -20
- data/lib/confeature/version.rb +1 -1
- metadata +7 -7
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 57fa6c073285f7f43ad8a9e6f199dfa7482531d5b78e029ebd2061ca1843e9d2
|
|
4
|
+
data.tar.gz: ec65482ac991726d70bd1c3f9c57a191558ccc298dd92f78ccf5de17b394b09a
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: b11dde30f59288c34034559132c71f96c77e4ff17de3508b70d28ecf53f53e4846f31077d21f86c023417f23037ebb64fa6d40040110812a9b3eb8454ab20976
|
|
7
|
+
data.tar.gz: 4a1a975b930eae3c9e0d6176c0862300f8b3ab376288257050ac9276502458662e8282c58abaa88b904afbe54e8158ae56450bb4858c2f8559c22a0d08e109c9
|
|
@@ -10,6 +10,7 @@ require_relative "segments"
|
|
|
10
10
|
require_relative "prerequisites"
|
|
11
11
|
require_relative "eval_log"
|
|
12
12
|
require_relative "eval_logger"
|
|
13
|
+
require_relative "provider_user"
|
|
13
14
|
|
|
14
15
|
module Confeature
|
|
15
16
|
module Internal
|
|
@@ -414,12 +415,8 @@ module Confeature
|
|
|
414
415
|
end
|
|
415
416
|
|
|
416
417
|
attr_name = ctx.setting["a"]
|
|
417
|
-
if attr_name.nil?
|
|
418
|
-
|
|
419
|
-
attr_value = user_identifier(ctx.user)
|
|
420
|
-
else
|
|
421
|
-
attr_value = get_user_attribute(ctx.user, attr_name)
|
|
422
|
-
end
|
|
418
|
+
attr_name = IDENTIFIER_ATTRIBUTE if attr_name.nil?
|
|
419
|
+
attr_value = get_user_attribute(ctx.user, attr_name)
|
|
423
420
|
if attr_value.nil?
|
|
424
421
|
ctx.state.eval_error ||= missing_user_attribute_error(attr_name)
|
|
425
422
|
ctx.log.user_object_attribute_is_missing_for_percentage(ctx.key, attr_name)
|
|
@@ -855,7 +852,10 @@ module Confeature
|
|
|
855
852
|
|
|
856
853
|
def user_identifier(user)
|
|
857
854
|
id = user.identifier
|
|
858
|
-
|
|
855
|
+
case user
|
|
856
|
+
when ProviderUser then id
|
|
857
|
+
else id.nil? ? "" : id
|
|
858
|
+
end
|
|
859
859
|
end
|
|
860
860
|
|
|
861
861
|
def boolean?(value)
|
|
@@ -31,6 +31,12 @@ module Confeature
|
|
|
31
31
|
module_function
|
|
32
32
|
|
|
33
33
|
def evaluate_sync(flag_overrides, key, default_value)
|
|
34
|
+
outcome = evaluate_sync_details(flag_overrides, key, default_value)
|
|
35
|
+
outcome.pop if outcome.length > 2
|
|
36
|
+
outcome
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
def evaluate_sync_details(flag_overrides, key, default_value)
|
|
34
40
|
# Branch 1: no overrides configured → caller falls through.
|
|
35
41
|
return [false, nil] if flag_overrides.nil?
|
|
36
42
|
|
|
@@ -51,11 +57,11 @@ module Confeature
|
|
|
51
57
|
|
|
52
58
|
# Branch 4: key absent → return default.
|
|
53
59
|
raw = overrides_map[key]
|
|
54
|
-
return [true, default_value] if raw.nil?
|
|
60
|
+
return [true, default_value, "KEY_NOT_FOUND"] if raw.nil?
|
|
55
61
|
|
|
56
62
|
# Branch 5: override slot empty → return default.
|
|
57
63
|
candidate = raw.picked
|
|
58
|
-
return [true, default_value] if candidate.nil?
|
|
64
|
+
return [true, default_value, "MALFORMED_VALUE"] if candidate.nil?
|
|
59
65
|
|
|
60
66
|
# Branch 6: TYPE_MISMATCH — primitive types diverge → return default.
|
|
61
67
|
# A `nil` default_value intentionally bypasses the check (matches
|
|
@@ -66,7 +72,7 @@ module Confeature
|
|
|
66
72
|
# mismatch.
|
|
67
73
|
if !default_value.nil? && !boolean_kind_match?(candidate, default_value) &&
|
|
68
74
|
candidate.class != default_value.class
|
|
69
|
-
return [true, default_value]
|
|
75
|
+
return [true, default_value, "TYPE_MISMATCH"]
|
|
70
76
|
end
|
|
71
77
|
|
|
72
78
|
# Branch 7: happy path — typed override value.
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
|
|
5
|
+
require_relative "../evaluation_details"
|
|
6
|
+
require_relative "evaluator"
|
|
7
|
+
require_relative "override_eval"
|
|
8
|
+
require_relative "provider_user"
|
|
9
|
+
|
|
10
|
+
module Confeature
|
|
11
|
+
module Internal
|
|
12
|
+
module ProviderEvaluation
|
|
13
|
+
FLAG_TYPES = {
|
|
14
|
+
boolean: [TrueClass, FalseClass].freeze,
|
|
15
|
+
string: [String].freeze,
|
|
16
|
+
integer: [Integer].freeze,
|
|
17
|
+
float: [Float].freeze,
|
|
18
|
+
number: [Integer, Float].freeze
|
|
19
|
+
}.freeze
|
|
20
|
+
|
|
21
|
+
module_function
|
|
22
|
+
|
|
23
|
+
def evaluate(client, key, fallback, flag_type:, **attributes)
|
|
24
|
+
return EvaluationDetails.from_error(key, fallback, error: "TYPE_MISMATCH") unless FLAG_TYPES.key?(flag_type)
|
|
25
|
+
|
|
26
|
+
client.get_value_details(key, fallback, ProviderUser.new(flag_type: flag_type, **attributes))
|
|
27
|
+
rescue StandardError
|
|
28
|
+
# Exceptions can include caller context or transport data.
|
|
29
|
+
EvaluationDetails.from_error(key, fallback, error: "EVAL_EXCEPTION")
|
|
30
|
+
end
|
|
31
|
+
|
|
32
|
+
def resolve(key, fallback, user, config:, local_overrides:)
|
|
33
|
+
# Let the native evaluator determine the stored type from one read.
|
|
34
|
+
# OpenFeature's number method accepts both numeric types independently
|
|
35
|
+
# of the type of its fallback.
|
|
36
|
+
result =
|
|
37
|
+
if local_overrides.nil?
|
|
38
|
+
Evaluator.evaluate(config, key, nil, user)
|
|
39
|
+
else
|
|
40
|
+
resolve_override(local_overrides, key, user)
|
|
41
|
+
end
|
|
42
|
+
error = result.error || type_error(result.value, user.flag_type)
|
|
43
|
+
return result if error.nil?
|
|
44
|
+
|
|
45
|
+
Evaluator::EvaluationResult.new(value: fallback, error: error)
|
|
46
|
+
end
|
|
47
|
+
|
|
48
|
+
def resolve_override(overrides, key, user)
|
|
49
|
+
found, result = OverrideEval.evaluate_full_config_override_details_sync(overrides, key, nil, user)
|
|
50
|
+
return result if found
|
|
51
|
+
|
|
52
|
+
matched, value, error = OverrideEval.evaluate_sync_details(overrides, key, nil)
|
|
53
|
+
Evaluator::EvaluationResult.new(value: value, error: matched ? error : "NO_CONFIG")
|
|
54
|
+
end
|
|
55
|
+
|
|
56
|
+
def type_error(value, flag_type)
|
|
57
|
+
return "TYPE_MISMATCH" unless FLAG_TYPES.fetch(flag_type).any? { |type| value.is_a?(type) }
|
|
58
|
+
return "MALFORMED_VALUE" if value.is_a?(Float) && !value.finite?
|
|
59
|
+
|
|
60
|
+
nil
|
|
61
|
+
end
|
|
62
|
+
end
|
|
63
|
+
end
|
|
64
|
+
end
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
|
|
5
|
+
require_relative "../user"
|
|
6
|
+
|
|
7
|
+
module Confeature
|
|
8
|
+
module Internal
|
|
9
|
+
# The companion supplies its own targeting context on every evaluation.
|
|
10
|
+
class ProviderUser < User
|
|
11
|
+
attr_reader :flag_type
|
|
12
|
+
|
|
13
|
+
def initialize(flag_type:, **attributes)
|
|
14
|
+
@flag_type = flag_type
|
|
15
|
+
super(**attributes)
|
|
16
|
+
end
|
|
17
|
+
end
|
|
18
|
+
end
|
|
19
|
+
end
|
data/lib/confeature/snapshot.rb
CHANGED
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
require_relative "evaluation_details"
|
|
6
6
|
require_relative "internal/evaluator"
|
|
7
7
|
require_relative "internal/override_eval"
|
|
8
|
+
require_relative "internal/provider_evaluation"
|
|
8
9
|
|
|
9
10
|
module Confeature
|
|
10
11
|
# Immutable view of the last-fetched config + a reference to overrides.
|
|
@@ -72,10 +73,28 @@ module Confeature
|
|
|
72
73
|
# `EvaluationResult.error` string propagates verbatim into the
|
|
73
74
|
# envelope's `error` field.
|
|
74
75
|
def get_value_details(key, default, user = nil)
|
|
75
|
-
|
|
76
|
-
|
|
76
|
+
case user
|
|
77
|
+
when Internal::ProviderUser
|
|
78
|
+
provider_details(key, default, user)
|
|
79
|
+
else
|
|
80
|
+
effective_user = user || @default_user
|
|
81
|
+
return local_only_details(key, default, effective_user) if local_only?
|
|
82
|
+
|
|
83
|
+
result = Internal::Evaluator.evaluate(@config, key, default, effective_user)
|
|
84
|
+
details_from_result(key, result, effective_user)
|
|
85
|
+
end
|
|
86
|
+
end
|
|
87
|
+
|
|
88
|
+
private
|
|
89
|
+
|
|
90
|
+
def provider_details(key, default, user)
|
|
91
|
+
result = Internal::ProviderEvaluation.resolve(
|
|
92
|
+
key, default, user, config: @config, local_overrides: (local_only? ? @flag_overrides : nil)
|
|
93
|
+
)
|
|
94
|
+
details_from_result(key, result, nil)
|
|
95
|
+
end
|
|
77
96
|
|
|
78
|
-
|
|
97
|
+
def details_from_result(key, result, effective_user)
|
|
79
98
|
matched_rule = result.matched_targeting_rule && TargetingRule.new(result.matched_targeting_rule)
|
|
80
99
|
matched_option = result.matched_percentage_option && PercentageOption.new(result.matched_percentage_option)
|
|
81
100
|
EvaluationDetails.new(
|
|
@@ -91,8 +110,6 @@ module Confeature
|
|
|
91
110
|
)
|
|
92
111
|
end
|
|
93
112
|
|
|
94
|
-
private
|
|
95
|
-
|
|
96
113
|
def local_only?
|
|
97
114
|
return false if @flag_overrides.nil?
|
|
98
115
|
|
|
@@ -108,21 +125,7 @@ module Confeature
|
|
|
108
125
|
found_full, result = Internal::OverrideEval.evaluate_full_config_override_details_sync(
|
|
109
126
|
@flag_overrides, key, default, effective_user
|
|
110
127
|
)
|
|
111
|
-
if found_full
|
|
112
|
-
matched_rule = result.matched_targeting_rule && TargetingRule.new(result.matched_targeting_rule)
|
|
113
|
-
matched_option = result.matched_percentage_option && PercentageOption.new(result.matched_percentage_option)
|
|
114
|
-
return EvaluationDetails.new(
|
|
115
|
-
key: key,
|
|
116
|
-
value: result.value,
|
|
117
|
-
variation_id: result.variation_id,
|
|
118
|
-
user: effective_user,
|
|
119
|
-
is_default_value: !result.error.nil?,
|
|
120
|
-
error: result.error,
|
|
121
|
-
fetch_time: @fetch_time,
|
|
122
|
-
matched_targeting_rule: matched_rule,
|
|
123
|
-
matched_percentage_option: matched_option
|
|
124
|
-
)
|
|
125
|
-
end
|
|
128
|
+
return details_from_result(key, result, effective_user) if found_full
|
|
126
129
|
|
|
127
130
|
found, value = Internal::OverrideEval.evaluate_sync(@flag_overrides, key, default)
|
|
128
131
|
data_source = @flag_overrides.data_source
|
data/lib/confeature/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: confeature
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.2.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- MakerLabs
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2026-11-
|
|
11
|
+
date: 2026-11-22 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: base64
|
|
@@ -39,11 +39,9 @@ dependencies:
|
|
|
39
39
|
- !ruby/object:Gem::Version
|
|
40
40
|
version: '1.6'
|
|
41
41
|
description: |
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
modes, same flag-override semantics as `configcat`. Migrate by renaming the
|
|
46
|
-
gem and swapping the SDK key.
|
|
42
|
+
The `confeature` gem is the MIT-licensed Ruby SDK for Confeature's
|
|
43
|
+
feature-flag service. It supports ConfigCat-style evaluation, polling
|
|
44
|
+
and flag overrides.
|
|
47
45
|
email:
|
|
48
46
|
executables: []
|
|
49
47
|
extensions: []
|
|
@@ -66,6 +64,8 @@ files:
|
|
|
66
64
|
- lib/confeature/internal/override_eval.rb
|
|
67
65
|
- lib/confeature/internal/poll_service.rb
|
|
68
66
|
- lib/confeature/internal/prerequisites.rb
|
|
67
|
+
- lib/confeature/internal/provider_evaluation.rb
|
|
68
|
+
- lib/confeature/internal/provider_user.rb
|
|
69
69
|
- lib/confeature/internal/sdk_key.rb
|
|
70
70
|
- lib/confeature/internal/segments.rb
|
|
71
71
|
- lib/confeature/internal/semver.rb
|