configdirector-server-sdk 0.1.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 +7 -0
- data/.yardopts +2 -0
- data/CHANGELOG.md +254 -0
- data/LICENSE +21 -0
- data/README.md +230 -0
- data/lib/configdirector/client_hooks.rb +46 -0
- data/lib/configdirector/config_director_client.rb +322 -0
- data/lib/configdirector/config_evaluated_event.rb +10 -0
- data/lib/configdirector/config_evaluation.rb +51 -0
- data/lib/configdirector/config_state.rb +39 -0
- data/lib/configdirector/configs_updated_event.rb +23 -0
- data/lib/configdirector/connection_error_event.rb +11 -0
- data/lib/configdirector/connection_options.rb +60 -0
- data/lib/configdirector/context.rb +53 -0
- data/lib/configdirector/errors.rb +29 -0
- data/lib/configdirector/internal/client/client_connection.rb +119 -0
- data/lib/configdirector/internal/client/client_factory.rb +104 -0
- data/lib/configdirector/internal/client/client_options_validation.rb +53 -0
- data/lib/configdirector/internal/client/config_read.rb +31 -0
- data/lib/configdirector/internal/client/config_reader.rb +55 -0
- data/lib/configdirector/internal/client/connection_intake.rb +59 -0
- data/lib/configdirector/internal/client/connection_options_validation.rb +94 -0
- data/lib/configdirector/internal/client/context_admission.rb +48 -0
- data/lib/configdirector/internal/client/context_attributes.rb +78 -0
- data/lib/configdirector/internal/client/context_kind.rb +24 -0
- data/lib/configdirector/internal/client/evaluated_read.rb +9 -0
- data/lib/configdirector/internal/client/event_handlers.rb +114 -0
- data/lib/configdirector/internal/client/event_tracking.rb +39 -0
- data/lib/configdirector/internal/client/live_client_connections.rb +58 -0
- data/lib/configdirector/internal/client/number_of_seconds.rb +21 -0
- data/lib/configdirector/internal/client/registrations.rb +43 -0
- data/lib/configdirector/internal/client/restart_in_forked_processes.rb +25 -0
- data/lib/configdirector/internal/client/served_configs.rb +83 -0
- data/lib/configdirector/internal/client/serving_state.rb +102 -0
- data/lib/configdirector/internal/client/watches.rb +51 -0
- data/lib/configdirector/internal/client/what_follows_a_fork.rb +24 -0
- data/lib/configdirector/internal/connection/condition_parser.rb +74 -0
- data/lib/configdirector/internal/connection/config_definition.rb +37 -0
- data/lib/configdirector/internal/connection/http_session.rb +15 -0
- data/lib/configdirector/internal/connection/in_memory_connection.rb +134 -0
- data/lib/configdirector/internal/connection/json_post_request.rb +24 -0
- data/lib/configdirector/internal/connection/not_a_server_sdk_payload.rb +9 -0
- data/lib/configdirector/internal/connection/offline_mode_connection.rb +96 -0
- data/lib/configdirector/internal/connection/offline_values_file.rb +49 -0
- data/lib/configdirector/internal/connection/payloads_delivered_in_turn.rb +46 -0
- data/lib/configdirector/internal/connection/polling_interval.rb +21 -0
- data/lib/configdirector/internal/connection/request_deadline.rb +45 -0
- data/lib/configdirector/internal/connection/retry_after_header.rb +24 -0
- data/lib/configdirector/internal/connection/server_sdk_payload.rb +37 -0
- data/lib/configdirector/internal/connection/server_sdk_payload_parser.rb +89 -0
- data/lib/configdirector/internal/connection/targeting_rules_parser.rb +70 -0
- data/lib/configdirector/internal/connection/test_client_initializations.rb +111 -0
- data/lib/configdirector/internal/connection/test_client_values.rb +53 -0
- data/lib/configdirector/internal/connection/unreadable_definition.rb +9 -0
- data/lib/configdirector/internal/connection/wire_fields.rb +59 -0
- data/lib/configdirector/internal/evaluation/array_comparison.rb +25 -0
- data/lib/configdirector/internal/evaluation/assigned_percentage.rb +21 -0
- data/lib/configdirector/internal/evaluation/attribute_condition.rb +48 -0
- data/lib/configdirector/internal/evaluation/config_evaluator.rb +29 -0
- data/lib/configdirector/internal/evaluation/datetime_comparison.rb +93 -0
- data/lib/configdirector/internal/evaluation/evaluation_context.rb +17 -0
- data/lib/configdirector/internal/evaluation/number_comparison.rb +119 -0
- data/lib/configdirector/internal/evaluation/rapidhash.rb +124 -0
- data/lib/configdirector/internal/evaluation/rollout_share.rb +9 -0
- data/lib/configdirector/internal/evaluation/rule.rb +70 -0
- data/lib/configdirector/internal/evaluation/scalar_text.rb +70 -0
- data/lib/configdirector/internal/evaluation/segment.rb +17 -0
- data/lib/configdirector/internal/evaluation/segment_condition.rb +26 -0
- data/lib/configdirector/internal/evaluation/semver_comparison.rb +49 -0
- data/lib/configdirector/internal/evaluation/served_value.rb +9 -0
- data/lib/configdirector/internal/evaluation/share.rb +9 -0
- data/lib/configdirector/internal/evaluation/targeting_rules.rb +18 -0
- data/lib/configdirector/internal/evaluation/text_comparison.rb +32 -0
- data/lib/configdirector/internal/evaluation/trait_pointer.rb +42 -0
- data/lib/configdirector/internal/evaluation.rb +21 -0
- data/lib/configdirector/internal/identity/sdk_identity.rb +39 -0
- data/lib/configdirector/internal/identity/wrapper.rb +48 -0
- data/lib/configdirector/internal/logging/client_log.rb +37 -0
- data/lib/configdirector/internal/logging/default_logger.rb +34 -0
- data/lib/configdirector/internal/polling/poll_answer.rb +111 -0
- data/lib/configdirector/internal/polling/poll_request.rb +106 -0
- data/lib/configdirector/internal/polling/poll_timing.rb +25 -0
- data/lib/configdirector/internal/polling/polling_endpoint.rb +36 -0
- data/lib/configdirector/internal/polling/polling_mode_connection.rb +53 -0
- data/lib/configdirector/internal/polling/polling_session.rb +99 -0
- data/lib/configdirector/internal/polling/polling_transport.rb +74 -0
- data/lib/configdirector/internal/polling/refusal_detail.rb +36 -0
- data/lib/configdirector/internal/server_sent_events/event_stream_limit_exceeded.rb +9 -0
- data/lib/configdirector/internal/server_sent_events/event_stream_parser.rb +95 -0
- data/lib/configdirector/internal/server_sent_events/server_sent_event.rb +9 -0
- data/lib/configdirector/internal/stoppable_thread.rb +69 -0
- data/lib/configdirector/internal/streaming/heartbeats.rb +51 -0
- data/lib/configdirector/internal/streaming/reconnecting_stream.rb +82 -0
- data/lib/configdirector/internal/streaming/reconnection_delay.rb +29 -0
- data/lib/configdirector/internal/streaming/stream_connection.rb +86 -0
- data/lib/configdirector/internal/streaming/stream_end.rb +69 -0
- data/lib/configdirector/internal/streaming/stream_endpoint.rb +43 -0
- data/lib/configdirector/internal/streaming/stream_timing.rb +33 -0
- data/lib/configdirector/internal/streaming/streaming_mode_connection.rb +60 -0
- data/lib/configdirector/internal/streaming/streaming_transport.rb +42 -0
- data/lib/configdirector/internal/telemetry/aggregated_wire_entries.rb +26 -0
- data/lib/configdirector/internal/telemetry/collected_telemetry.rb +98 -0
- data/lib/configdirector/internal/telemetry/compact_json_text.rb +64 -0
- data/lib/configdirector/internal/telemetry/discarded_telemetry.rb +31 -0
- data/lib/configdirector/internal/telemetry/event_reporter.rb +47 -0
- data/lib/configdirector/internal/telemetry/invalid_context_submissions.rb +76 -0
- data/lib/configdirector/internal/telemetry/report_answer.rb +31 -0
- data/lib/configdirector/internal/telemetry/report_schedule.rb +66 -0
- data/lib/configdirector/internal/telemetry/report_timing.rb +20 -0
- data/lib/configdirector/internal/telemetry/reported_context.rb +28 -0
- data/lib/configdirector/internal/telemetry/reported_details.rb +71 -0
- data/lib/configdirector/internal/telemetry/reported_evaluation.rb +82 -0
- data/lib/configdirector/internal/telemetry/reported_telemetry.rb +127 -0
- data/lib/configdirector/internal/telemetry/reported_text.rb +13 -0
- data/lib/configdirector/internal/telemetry/reported_time.rb +13 -0
- data/lib/configdirector/internal/telemetry/reported_value.rb +35 -0
- data/lib/configdirector/internal/telemetry/telemetry_endpoint.rb +54 -0
- data/lib/configdirector/internal/telemetry/telemetry_report.rb +50 -0
- data/lib/configdirector/internal/telemetry/test_client_telemetry.rb +37 -0
- data/lib/configdirector/internal/telemetry/tracked_event_admission.rb +72 -0
- data/lib/configdirector/internal/telemetry/tracked_event_entry.rb +27 -0
- data/lib/configdirector/internal/telemetry/tracked_event_queue.rb +47 -0
- data/lib/configdirector/internal/telemetry/tracked_event_warning.rb +28 -0
- data/lib/configdirector/internal/telemetry/value_id.rb +23 -0
- data/lib/configdirector/internal/telemetry/written_json.rb +9 -0
- data/lib/configdirector/internal/unchangeable_copy.rb +38 -0
- data/lib/configdirector/internal/value/encoded_native_value.rb +45 -0
- data/lib/configdirector/internal/value/hash_keys.rb +34 -0
- data/lib/configdirector/internal/value/in_code_default_value.rb +33 -0
- data/lib/configdirector/internal/value/json_contents.rb +81 -0
- data/lib/configdirector/internal/value/json_position.rb +27 -0
- data/lib/configdirector/internal/value/native_values.rb +41 -0
- data/lib/configdirector/internal/value/parsed_json.rb +79 -0
- data/lib/configdirector/internal/value/plain_decimal_text.rb +36 -0
- data/lib/configdirector/internal/value/served_text.rb +76 -0
- data/lib/configdirector/internal/value/typed_value.rb +9 -0
- data/lib/configdirector/internal/value/unservable_value.rb +9 -0
- data/lib/configdirector/internal/value/utf8_text.rb +19 -0
- data/lib/configdirector/internal.rb +9 -0
- data/lib/configdirector/metadata.rb +26 -0
- data/lib/configdirector/subscription.rb +34 -0
- data/lib/configdirector/telemetry_options.rb +28 -0
- data/lib/configdirector/testing/test_client.rb +122 -0
- data/lib/configdirector/testing/tracked_event.rb +46 -0
- data/lib/configdirector/testing.rb +44 -0
- data/lib/configdirector/variation.rb +21 -0
- data/lib/configdirector/version.rb +7 -0
- data/lib/configdirector-server-sdk.rb +3 -0
- data/lib/configdirector.rb +164 -0
- data/sig/configdirector/internal/client.rbs +518 -0
- data/sig/configdirector/internal/connection.rbs +389 -0
- data/sig/configdirector/internal/evaluation.rbs +364 -0
- data/sig/configdirector/internal/identity.rbs +51 -0
- data/sig/configdirector/internal/logging.rbs +33 -0
- data/sig/configdirector/internal/polling.rbs +240 -0
- data/sig/configdirector/internal/server_sent_events.rbs +51 -0
- data/sig/configdirector/internal/streaming.rbs +266 -0
- data/sig/configdirector/internal/telemetry.rbs +556 -0
- data/sig/configdirector/internal/value.rbs +159 -0
- data/sig/configdirector/testing.rbs +70 -0
- data/sig/configdirector.rbs +465 -0
- metadata +231 -0
|
@@ -0,0 +1,364 @@
|
|
|
1
|
+
module ConfigDirector
|
|
2
|
+
module Internal
|
|
3
|
+
module Evaluation
|
|
4
|
+
type json_value = String | Integer | Float | bool | nil | Array[json_value] | Hash[String, json_value]
|
|
5
|
+
|
|
6
|
+
type segments = Hash[String, Segment]
|
|
7
|
+
|
|
8
|
+
type served_by = :matching_rule | :default_targeting_rule | :default_targeting_rule_after_skipped_rollout
|
|
9
|
+
|
|
10
|
+
type fall_through = :not_matched | :rollout_skipped_no_identifier
|
|
11
|
+
|
|
12
|
+
interface _Condition
|
|
13
|
+
def holds_for?: (EvaluationContext context, segments segments) -> bool
|
|
14
|
+
|
|
15
|
+
def uses_any_segment_of?: (Array[String] segment_ids) -> bool
|
|
16
|
+
end
|
|
17
|
+
|
|
18
|
+
class EvaluationContext < Data
|
|
19
|
+
USER_CONTEXT_KIND: String
|
|
20
|
+
|
|
21
|
+
attr_reader identifier: String?
|
|
22
|
+
attr_reader kind: String?
|
|
23
|
+
attr_reader name: String?
|
|
24
|
+
attr_reader traits: Hash[String, json_value]
|
|
25
|
+
attr_reader app_name: String?
|
|
26
|
+
attr_reader app_version: String?
|
|
27
|
+
|
|
28
|
+
def self.new: (
|
|
29
|
+
identifier: String?,
|
|
30
|
+
kind: String?,
|
|
31
|
+
name: String?,
|
|
32
|
+
traits: Hash[String, json_value],
|
|
33
|
+
app_name: String?,
|
|
34
|
+
app_version: String?
|
|
35
|
+
) -> instance
|
|
36
|
+
|
|
37
|
+
def effective_kind: () -> String
|
|
38
|
+
end
|
|
39
|
+
|
|
40
|
+
class AttributeCondition < Data
|
|
41
|
+
attr_reader attribute: String
|
|
42
|
+
attr_reader trait: String?
|
|
43
|
+
attr_reader operator: String
|
|
44
|
+
attr_reader target_type: String
|
|
45
|
+
attr_reader target_values: Array[String]
|
|
46
|
+
|
|
47
|
+
def self.new: (
|
|
48
|
+
attribute: String,
|
|
49
|
+
trait: String?,
|
|
50
|
+
operator: String,
|
|
51
|
+
target_type: String,
|
|
52
|
+
target_values: Array[String]
|
|
53
|
+
) -> instance
|
|
54
|
+
|
|
55
|
+
def holds_for?: (EvaluationContext context, segments _segments) -> bool
|
|
56
|
+
|
|
57
|
+
def uses_any_segment_of?: (Array[String] _segment_ids) -> bool
|
|
58
|
+
|
|
59
|
+
private
|
|
60
|
+
|
|
61
|
+
def trait_of: (EvaluationContext context) -> json_value
|
|
62
|
+
|
|
63
|
+
def value_matches?: (json_value value) -> bool
|
|
64
|
+
end
|
|
65
|
+
|
|
66
|
+
class SegmentCondition < Data
|
|
67
|
+
attr_reader operator: String
|
|
68
|
+
attr_reader segment_id: String
|
|
69
|
+
|
|
70
|
+
def self.new: (operator: String, segment_id: String) -> instance
|
|
71
|
+
|
|
72
|
+
def holds_for?: (EvaluationContext context, segments segments) -> bool
|
|
73
|
+
|
|
74
|
+
def uses_any_segment_of?: (Array[String] segment_ids) -> bool
|
|
75
|
+
end
|
|
76
|
+
|
|
77
|
+
class Segment < Data
|
|
78
|
+
attr_reader condition_groups: Array[Array[AttributeCondition]]
|
|
79
|
+
|
|
80
|
+
def self.new: (condition_groups: Array[Array[AttributeCondition]]) -> instance
|
|
81
|
+
|
|
82
|
+
def contains?: (EvaluationContext context) -> bool
|
|
83
|
+
end
|
|
84
|
+
|
|
85
|
+
class Share < Data
|
|
86
|
+
attr_reader id: String
|
|
87
|
+
attr_reader percentage: Float
|
|
88
|
+
attr_reader value: String?
|
|
89
|
+
attr_reader value_id: String?
|
|
90
|
+
attr_reader variation_id: String?
|
|
91
|
+
|
|
92
|
+
def self.new: (
|
|
93
|
+
id: String,
|
|
94
|
+
percentage: Float,
|
|
95
|
+
value: String?,
|
|
96
|
+
value_id: String?,
|
|
97
|
+
variation_id: String?
|
|
98
|
+
) -> instance
|
|
99
|
+
end
|
|
100
|
+
|
|
101
|
+
class RolloutShare < Data
|
|
102
|
+
attr_reader rule_id: String
|
|
103
|
+
attr_reader share_id: String
|
|
104
|
+
|
|
105
|
+
def self.new: (rule_id: String, share_id: String) -> instance
|
|
106
|
+
end
|
|
107
|
+
|
|
108
|
+
class ServedValue < Data
|
|
109
|
+
attr_reader value: String
|
|
110
|
+
attr_reader value_id: String?
|
|
111
|
+
attr_reader variation_id: String?
|
|
112
|
+
attr_reader rollout_share: RolloutShare?
|
|
113
|
+
attr_reader served_by: served_by
|
|
114
|
+
|
|
115
|
+
def self.new: (
|
|
116
|
+
value: String,
|
|
117
|
+
value_id: String?,
|
|
118
|
+
variation_id: String?,
|
|
119
|
+
rollout_share: RolloutShare?,
|
|
120
|
+
served_by: served_by
|
|
121
|
+
) -> instance
|
|
122
|
+
end
|
|
123
|
+
|
|
124
|
+
class Rule < Data
|
|
125
|
+
attr_reader id: String
|
|
126
|
+
attr_reader order: Integer?
|
|
127
|
+
attr_reader type: String
|
|
128
|
+
attr_reader target: String
|
|
129
|
+
attr_reader value: String?
|
|
130
|
+
attr_reader value_id: String?
|
|
131
|
+
attr_reader variation_id: String?
|
|
132
|
+
attr_reader conditions: Array[_Condition]
|
|
133
|
+
attr_reader shares: Array[Share]?
|
|
134
|
+
|
|
135
|
+
def self.new: (
|
|
136
|
+
id: String,
|
|
137
|
+
order: Integer?,
|
|
138
|
+
type: String,
|
|
139
|
+
target: String,
|
|
140
|
+
value: String?,
|
|
141
|
+
value_id: String?,
|
|
142
|
+
variation_id: String?,
|
|
143
|
+
conditions: Array[_Condition],
|
|
144
|
+
shares: Array[Share]?
|
|
145
|
+
) -> instance
|
|
146
|
+
|
|
147
|
+
def serve: (String config_id, EvaluationContext context, segments segments) -> (ServedValue | fall_through)
|
|
148
|
+
|
|
149
|
+
def uses_any_segment_of?: (Array[String] segment_ids) -> bool
|
|
150
|
+
|
|
151
|
+
private
|
|
152
|
+
|
|
153
|
+
def serve_when_every_condition_holds: (
|
|
154
|
+
String config_id,
|
|
155
|
+
EvaluationContext context,
|
|
156
|
+
segments segments
|
|
157
|
+
) -> (ServedValue | fall_through)
|
|
158
|
+
|
|
159
|
+
def serve_value: () -> (ServedValue | fall_through)
|
|
160
|
+
|
|
161
|
+
def serve_from_rollout: (String config_id, EvaluationContext context) -> (ServedValue | fall_through)
|
|
162
|
+
|
|
163
|
+
def share_covering: (Array[Share] rollout_shares, Float assigned_percentage) -> Share?
|
|
164
|
+
|
|
165
|
+
def serve_share: (Share share, String share_value) -> ServedValue
|
|
166
|
+
end
|
|
167
|
+
|
|
168
|
+
class TargetingRules < Data
|
|
169
|
+
attr_reader default_value: String
|
|
170
|
+
attr_reader default_value_id: String?
|
|
171
|
+
attr_reader default_variation_id: String?
|
|
172
|
+
attr_reader rules: Array[Rule]
|
|
173
|
+
|
|
174
|
+
def self.new: (
|
|
175
|
+
default_value: String,
|
|
176
|
+
default_value_id: String?,
|
|
177
|
+
default_variation_id: String?,
|
|
178
|
+
rules: Array[Rule]
|
|
179
|
+
) -> instance
|
|
180
|
+
|
|
181
|
+
def default_targeting_rule_value: (a_rollout_was_skipped: bool) -> ServedValue
|
|
182
|
+
end
|
|
183
|
+
|
|
184
|
+
module ConfigEvaluator
|
|
185
|
+
def self.evaluate: (
|
|
186
|
+
String config_id,
|
|
187
|
+
TargetingRules targeting_rules,
|
|
188
|
+
EvaluationContext context,
|
|
189
|
+
segments segments
|
|
190
|
+
) -> ServedValue
|
|
191
|
+
|
|
192
|
+
private def self.in_evaluation_order: (Array[Rule] rules) -> Array[Rule]
|
|
193
|
+
end
|
|
194
|
+
|
|
195
|
+
module ScalarText
|
|
196
|
+
LAST_POINT_POSITION_SPELLED_OUT: Integer
|
|
197
|
+
FIRST_POINT_POSITION_SPELLED_OUT: Integer
|
|
198
|
+
|
|
199
|
+
def self.of: (json_value value) -> String?
|
|
200
|
+
|
|
201
|
+
private def self.of_float: (Float number) -> String
|
|
202
|
+
|
|
203
|
+
private def self.of_positive_float: (Float number) -> String
|
|
204
|
+
|
|
205
|
+
private def self.shortest_digits_and_point_position: (Float number) -> [String, Integer]
|
|
206
|
+
|
|
207
|
+
private def self.leading_zeros_of: (String text) -> String
|
|
208
|
+
|
|
209
|
+
private def self.exponent_form: (String digits, Integer exponent) -> String
|
|
210
|
+
end
|
|
211
|
+
|
|
212
|
+
module TextComparison
|
|
213
|
+
type operator = ^(String text, Array[String] targets) -> bool
|
|
214
|
+
|
|
215
|
+
EQUALS_THE_FIRST_TARGET: operator
|
|
216
|
+
DIFFERS_FROM_THE_FIRST_TARGET: operator
|
|
217
|
+
NEVER_MATCHES: operator
|
|
218
|
+
OPERATORS: Hash[String, operator]
|
|
219
|
+
|
|
220
|
+
def self.matches?: (String text, String operator, Array[String] targets) -> bool
|
|
221
|
+
end
|
|
222
|
+
|
|
223
|
+
module NumberComparison
|
|
224
|
+
class NumberOperator < Data
|
|
225
|
+
attr_reader holds: ^(Float number, Float target) -> bool
|
|
226
|
+
attr_reader holds_for_an_unparseable_value: bool
|
|
227
|
+
|
|
228
|
+
def self.new: (holds: ^(Float number, Float target) -> bool, holds_for_an_unparseable_value: bool) -> instance
|
|
229
|
+
end
|
|
230
|
+
|
|
231
|
+
EQUALS: NumberOperator
|
|
232
|
+
DOES_NOT_EQUAL: NumberOperator
|
|
233
|
+
|
|
234
|
+
type rounding = :overflows | :underflows | :fits
|
|
235
|
+
|
|
236
|
+
OPERATORS: Hash[String, NumberOperator]
|
|
237
|
+
DECIMAL_LITERAL: Regexp
|
|
238
|
+
ROUNDS_TO_INFINITY_FROM: Integer
|
|
239
|
+
ROUNDS_TO_ZERO_UP_TO: Rational
|
|
240
|
+
LARGEST_FLOAT_DECIMAL_EXPONENT: Integer
|
|
241
|
+
SMALLEST_FLOAT_DECIMAL_EXPONENT: Integer
|
|
242
|
+
|
|
243
|
+
def self.matches?: (json_value value, String operator, Array[String] targets) -> bool
|
|
244
|
+
|
|
245
|
+
private def self.finite_number_of: (json_value value) -> Float?
|
|
246
|
+
|
|
247
|
+
def self.finite_number_in: (String text) -> Float?
|
|
248
|
+
|
|
249
|
+
private def self.decimal_parts_of: (String text) -> [String, String, Integer]?
|
|
250
|
+
|
|
251
|
+
private def self.rounding_of: (String significant_digits, Integer power_of_ten) -> rounding
|
|
252
|
+
|
|
253
|
+
private def self.rounding_near_the_largest_float: (String significant_digits, Integer power_of_ten) -> rounding
|
|
254
|
+
|
|
255
|
+
private def self.rounding_near_the_smallest_float: (String significant_digits, Integer power_of_ten) -> rounding
|
|
256
|
+
|
|
257
|
+
private def self.exact_value: (String significant_digits, Integer power_of_ten) -> Numeric
|
|
258
|
+
end
|
|
259
|
+
|
|
260
|
+
module SemverComparison
|
|
261
|
+
type version = [Integer, Integer, Integer]
|
|
262
|
+
|
|
263
|
+
type operator = ^(version? version, Array[String] targets) -> bool
|
|
264
|
+
|
|
265
|
+
VERSION_IN_TEXT: Regexp
|
|
266
|
+
NEVER_MATCHES: operator
|
|
267
|
+
OPERATORS: Hash[String, operator]
|
|
268
|
+
|
|
269
|
+
def self.matches?: (String text, String operator, Array[String] targets) -> bool
|
|
270
|
+
|
|
271
|
+
private def self.version_in: (String text) -> version?
|
|
272
|
+
|
|
273
|
+
private def self.ordering: (version? version, String? target_text) -> Integer?
|
|
274
|
+
|
|
275
|
+
private def self.equals_any?: (version? version, Array[String] targets) -> bool
|
|
276
|
+
end
|
|
277
|
+
|
|
278
|
+
module DatetimeComparison
|
|
279
|
+
ECMASCRIPT_DATE_TIME: Regexp
|
|
280
|
+
DAYS_IN_MONTH_OF_A_COMMON_YEAR: Array[Integer]
|
|
281
|
+
|
|
282
|
+
def self.matches?: (String text, String operator, Array[String] targets) -> bool
|
|
283
|
+
|
|
284
|
+
private def self.milliseconds_since_epoch_of: (String text) -> Integer?
|
|
285
|
+
|
|
286
|
+
private def self.possible_calendar_fields_of: (MatchData match) -> [Integer, Integer, Integer, Integer, Integer, Integer]?
|
|
287
|
+
|
|
288
|
+
private def self.milliseconds_read_as_utc: (
|
|
289
|
+
[Integer, Integer, Integer, Integer, Integer, Integer] calendar_fields,
|
|
290
|
+
String? fraction
|
|
291
|
+
) -> Integer
|
|
292
|
+
|
|
293
|
+
private def self.offset_minutes_of: (String? offset) -> Integer?
|
|
294
|
+
|
|
295
|
+
private def self.possible_date?: (Integer year, Integer month, Integer day) -> bool
|
|
296
|
+
|
|
297
|
+
private def self.possible_time?: (Integer hour, Integer minute, Integer second) -> bool
|
|
298
|
+
|
|
299
|
+
private def self.days_in_month: (Integer year, Integer month) -> Integer
|
|
300
|
+
|
|
301
|
+
private def self.leap_year?: (Integer year) -> bool
|
|
302
|
+
end
|
|
303
|
+
|
|
304
|
+
module ArrayComparison
|
|
305
|
+
def self.matches?: (json_value value, String operator, Array[String] targets) -> bool
|
|
306
|
+
|
|
307
|
+
private def self.contains_any?: (Array[json_value] elements, Array[String] targets) -> bool
|
|
308
|
+
end
|
|
309
|
+
|
|
310
|
+
module TraitPointer
|
|
311
|
+
INVALID_ESCAPE: Regexp
|
|
312
|
+
ESCAPE: Regexp
|
|
313
|
+
DECODED_ESCAPES: Hash[String, String]
|
|
314
|
+
ARRAY_INDEX: Regexp
|
|
315
|
+
|
|
316
|
+
def self.value_at: (String pointer, json_value traits) -> json_value
|
|
317
|
+
|
|
318
|
+
private def self.member_of: (json_value container, String token) -> json_value
|
|
319
|
+
|
|
320
|
+
private def self.element_of: (Array[json_value] elements, String token) -> json_value
|
|
321
|
+
end
|
|
322
|
+
|
|
323
|
+
module Rapidhash
|
|
324
|
+
LOW_64_BITS: Integer
|
|
325
|
+
SECRET: Array[Integer]
|
|
326
|
+
SHORT_MESSAGE_LENGTH: Integer
|
|
327
|
+
BLOCK_LENGTH: Integer
|
|
328
|
+
LANE_COUNT: Integer
|
|
329
|
+
REMAINDER_PAIR_SECRETS: Array[Integer]
|
|
330
|
+
|
|
331
|
+
def self.of: (String message, Integer seed) -> Integer
|
|
332
|
+
|
|
333
|
+
private def self.short_message_words: (String message, Integer length, Integer seed) -> [Integer, Integer, Integer, Integer]
|
|
334
|
+
|
|
335
|
+
private def self.tiny_message_words: (String message, Integer length) -> [Integer, Integer]
|
|
336
|
+
|
|
337
|
+
private def self.long_message_words: (String message, Integer length, Integer seed) -> [Integer, Integer, Integer, Integer]
|
|
338
|
+
|
|
339
|
+
private def self.blocks: (String message, Integer length, Integer seed) -> [Integer, Integer]
|
|
340
|
+
|
|
341
|
+
private def self.mix_block: (String message, Integer offset, Array[Integer] lanes) -> Array[Integer]
|
|
342
|
+
|
|
343
|
+
private def self.remainder_pairs: (String message, Integer offset, Integer length, Integer seed) -> Integer
|
|
344
|
+
|
|
345
|
+
private def self.mix: (Integer multiplicand, Integer multiplier) -> Integer
|
|
346
|
+
|
|
347
|
+
private def self.finish: (Integer first_word, Integer second_word, Integer last_block_length) -> Integer
|
|
348
|
+
|
|
349
|
+
private def self.read64: (String message, Integer offset) -> Integer
|
|
350
|
+
|
|
351
|
+
private def self.read32: (String message, Integer offset) -> Integer
|
|
352
|
+
|
|
353
|
+
private def self.read8: (String message, Integer offset) -> Integer
|
|
354
|
+
end
|
|
355
|
+
|
|
356
|
+
module AssignedPercentage
|
|
357
|
+
SEED: Integer
|
|
358
|
+
REACHABLE_TENTHS_OF_A_PERCENT: Integer
|
|
359
|
+
|
|
360
|
+
def self.of: (String config_id, String identifier, String context_kind) -> Float
|
|
361
|
+
end
|
|
362
|
+
end
|
|
363
|
+
end
|
|
364
|
+
end
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
module ConfigDirector
|
|
2
|
+
module Internal
|
|
3
|
+
module Identity
|
|
4
|
+
class SdkIdentity
|
|
5
|
+
@sdk_name: String
|
|
6
|
+
@sdk_version: String
|
|
7
|
+
|
|
8
|
+
def self.of_the_server_sdk: () -> SdkIdentity
|
|
9
|
+
|
|
10
|
+
def self.of_the_wrapper: (untyped wrapper) -> SdkIdentity
|
|
11
|
+
|
|
12
|
+
private def self.new: (String sdk_name, String sdk_version) -> instance
|
|
13
|
+
|
|
14
|
+
def initialize: (String sdk_name, String sdk_version) -> void
|
|
15
|
+
|
|
16
|
+
def user_agent: () -> String
|
|
17
|
+
|
|
18
|
+
def meta_context_of_an_application_with: (Metadata metadata) -> Hash[Symbol, String]
|
|
19
|
+
end
|
|
20
|
+
|
|
21
|
+
class Wrapper
|
|
22
|
+
VERSION_WITHOUT_THE_GEM_OF_THE_WRAPPER: String
|
|
23
|
+
OPENFEATURE_SERVER_PROVIDER: Wrapper
|
|
24
|
+
|
|
25
|
+
@name_of_the_version_constant_of_its_gem: String
|
|
26
|
+
|
|
27
|
+
attr_reader sdk_name: String
|
|
28
|
+
|
|
29
|
+
private def self.new: (String sdk_name, String name_of_the_version_constant_of_its_gem) -> instance
|
|
30
|
+
|
|
31
|
+
def initialize: (String sdk_name, String name_of_the_version_constant_of_its_gem) -> void
|
|
32
|
+
|
|
33
|
+
def create_client: (
|
|
34
|
+
?String? server_sdk_key,
|
|
35
|
+
?metadata: Metadata?,
|
|
36
|
+
?connection: ConnectionOptions?,
|
|
37
|
+
?logger: (_Logger & Object)?,
|
|
38
|
+
?log_level: (Integer | Symbol | String)?,
|
|
39
|
+
?telemetry: TelemetryOptions?,
|
|
40
|
+
?hooks: ClientHooks?
|
|
41
|
+
) -> ConfigDirectorClient
|
|
42
|
+
|
|
43
|
+
def version_of_its_gem: () -> String
|
|
44
|
+
|
|
45
|
+
private
|
|
46
|
+
|
|
47
|
+
def gem_loaded?: () -> bool
|
|
48
|
+
end
|
|
49
|
+
end
|
|
50
|
+
end
|
|
51
|
+
end
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
module ConfigDirector
|
|
2
|
+
module Internal
|
|
3
|
+
module Logging
|
|
4
|
+
module DefaultLogger
|
|
5
|
+
LINE_PREFIX: String
|
|
6
|
+
LINE_FORMAT: ^(String severity, Time time, untyped program_name, untyped message) -> String
|
|
7
|
+
LOGGER_LEVELS: Range[Integer]
|
|
8
|
+
|
|
9
|
+
def self.writing_from: (untyped log_level) -> Logger
|
|
10
|
+
|
|
11
|
+
private def self.invalid: (untyped log_level) -> ConfigDirectorValidationError
|
|
12
|
+
end
|
|
13
|
+
|
|
14
|
+
class ClientLog
|
|
15
|
+
@logger: _Logger
|
|
16
|
+
@line_prefix: String
|
|
17
|
+
@writes_debug_lines: _LogLevelCheck
|
|
18
|
+
|
|
19
|
+
def initialize: (_Logger & Object logger, ?component: String) -> void
|
|
20
|
+
|
|
21
|
+
def debug: () { () -> String } -> void
|
|
22
|
+
|
|
23
|
+
def info: (String line) -> void
|
|
24
|
+
|
|
25
|
+
def warn: (String line) -> void
|
|
26
|
+
|
|
27
|
+
def error: (String line) -> void
|
|
28
|
+
|
|
29
|
+
def ignoring_errors_from: (String source) { () -> untyped } -> void
|
|
30
|
+
end
|
|
31
|
+
end
|
|
32
|
+
end
|
|
33
|
+
end
|
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
module ConfigDirector
|
|
2
|
+
module Internal
|
|
3
|
+
module Polling
|
|
4
|
+
class PollTiming < Data
|
|
5
|
+
attr_reader seconds_between_polls: seconds
|
|
6
|
+
attr_reader seconds_a_poll_may_take: seconds
|
|
7
|
+
attr_reader pause_before_the_next_poll: ^(seconds seconds) -> void
|
|
8
|
+
attr_reader monotonic_seconds: ^() -> Float
|
|
9
|
+
|
|
10
|
+
def self.new: (
|
|
11
|
+
seconds_between_polls: seconds,
|
|
12
|
+
seconds_a_poll_may_take: seconds,
|
|
13
|
+
pause_before_the_next_poll: ^(seconds seconds) -> void,
|
|
14
|
+
monotonic_seconds: ^() -> Float
|
|
15
|
+
) -> instance
|
|
16
|
+
|
|
17
|
+
def self.on_the_clock_of_the_process: (
|
|
18
|
+
seconds_between_polls: seconds,
|
|
19
|
+
seconds_a_poll_may_take: seconds
|
|
20
|
+
) -> PollTiming
|
|
21
|
+
end
|
|
22
|
+
|
|
23
|
+
module RefusalDetail
|
|
24
|
+
MAXIMUM_BYTES: Integer
|
|
25
|
+
|
|
26
|
+
def self.of: (String answer_body, server_sdk_key_to_hide: String) -> String
|
|
27
|
+
|
|
28
|
+
private def self.written_forms_of: (String server_sdk_key) -> Array[String]
|
|
29
|
+
end
|
|
30
|
+
|
|
31
|
+
type poll_answer_kind = :payload
|
|
32
|
+
| :unchanged
|
|
33
|
+
| :unanswered
|
|
34
|
+
| :timed_out
|
|
35
|
+
| :refused
|
|
36
|
+
| :throttled
|
|
37
|
+
| :unreadable
|
|
38
|
+
| :refused_unrecoverably
|
|
39
|
+
|
|
40
|
+
class PollAnswer < Data
|
|
41
|
+
WHAT_FOLLOWS_BY_KIND: Hash[Symbol, Symbol]
|
|
42
|
+
SENT_AGAIN_AT_ONCE_BY_KIND: Hash[Symbol, bool]
|
|
43
|
+
LONGEST_WAIT_THE_SERVER_CAN_ASK_FOR_SECONDS: Integer
|
|
44
|
+
|
|
45
|
+
attr_reader kind: poll_answer_kind
|
|
46
|
+
attr_reader payload_text: String?
|
|
47
|
+
attr_reader timestamp: String?
|
|
48
|
+
attr_reader failure_message: String?
|
|
49
|
+
attr_reader status: Integer?
|
|
50
|
+
attr_reader seconds_named_by_retry_after: seconds?
|
|
51
|
+
|
|
52
|
+
def self.new: (
|
|
53
|
+
kind: poll_answer_kind,
|
|
54
|
+
payload_text: String?,
|
|
55
|
+
timestamp: String?,
|
|
56
|
+
failure_message: String?,
|
|
57
|
+
status: Integer?,
|
|
58
|
+
seconds_named_by_retry_after: seconds?
|
|
59
|
+
) -> instance
|
|
60
|
+
|
|
61
|
+
def self.payload: (String payload_text, timestamp: String?) -> PollAnswer
|
|
62
|
+
|
|
63
|
+
def self.unchanged: () -> PollAnswer
|
|
64
|
+
|
|
65
|
+
def self.unanswered: (String cause) -> PollAnswer
|
|
66
|
+
|
|
67
|
+
def self.timed_out: (String description_of_the_deadline_having_passed) -> PollAnswer
|
|
68
|
+
|
|
69
|
+
def self.refused: (Integer status) -> PollAnswer
|
|
70
|
+
|
|
71
|
+
def self.throttled: (Integer status, seconds? seconds_named_by_retry_after) -> PollAnswer
|
|
72
|
+
|
|
73
|
+
def self.refused_unrecoverably: (Integer status, detail: String) -> PollAnswer
|
|
74
|
+
|
|
75
|
+
def self.unreadable: (String cause) -> PollAnswer
|
|
76
|
+
|
|
77
|
+
private def self.failed: (
|
|
78
|
+
poll_answer_kind kind,
|
|
79
|
+
String failure_message,
|
|
80
|
+
?status: Integer?,
|
|
81
|
+
?seconds_named_by_retry_after: seconds?
|
|
82
|
+
) -> PollAnswer
|
|
83
|
+
|
|
84
|
+
def what_follows: () -> Symbol
|
|
85
|
+
|
|
86
|
+
def sent_again_at_once?: () -> bool
|
|
87
|
+
|
|
88
|
+
def seconds_before_the_next_poll: (seconds seconds_between_polls) -> seconds
|
|
89
|
+
end
|
|
90
|
+
|
|
91
|
+
class PollingEndpoint
|
|
92
|
+
@poll_uri: URI::Generic
|
|
93
|
+
@server_sdk_key: String
|
|
94
|
+
@sdk_identity: Identity::SdkIdentity
|
|
95
|
+
@meta_context: Hash[Symbol, String]
|
|
96
|
+
|
|
97
|
+
def initialize: (
|
|
98
|
+
url: String,
|
|
99
|
+
server_sdk_key: String,
|
|
100
|
+
metadata: Metadata,
|
|
101
|
+
sdk_identity: Identity::SdkIdentity
|
|
102
|
+
) -> void
|
|
103
|
+
|
|
104
|
+
def http_session: () -> Net::HTTP
|
|
105
|
+
|
|
106
|
+
def json_post_of_a_poll: (session_id: String, last_update_timestamp: String?) -> Net::HTTP::Post
|
|
107
|
+
|
|
108
|
+
def refusal_detail_in: (String answer_body) -> String
|
|
109
|
+
end
|
|
110
|
+
|
|
111
|
+
class PollRequest
|
|
112
|
+
MAXIMUM_BODY_MEBIBYTES: Integer
|
|
113
|
+
MAXIMUM_BODY_BYTES: Integer
|
|
114
|
+
PAYLOAD_STATUS: Integer
|
|
115
|
+
SUCCESS_STATUSES: Range[Integer]
|
|
116
|
+
TOO_MANY_REQUESTS_STATUS: Integer
|
|
117
|
+
CLIENT_ERROR_STATUSES: Range[Integer]
|
|
118
|
+
|
|
119
|
+
@endpoint: PollingEndpoint
|
|
120
|
+
@session_id: String
|
|
121
|
+
@last_update_timestamp: String?
|
|
122
|
+
@deadline: Connection::RequestDeadline
|
|
123
|
+
@http_session: Net::HTTP
|
|
124
|
+
@body_text_read: String
|
|
125
|
+
|
|
126
|
+
def initialize: (
|
|
127
|
+
endpoint: PollingEndpoint,
|
|
128
|
+
session_id: String,
|
|
129
|
+
last_update_timestamp: String?,
|
|
130
|
+
deadline: Connection::RequestDeadline
|
|
131
|
+
) -> void
|
|
132
|
+
|
|
133
|
+
def answer: () -> PollAnswer
|
|
134
|
+
|
|
135
|
+
private
|
|
136
|
+
|
|
137
|
+
def response_to_the_post: () -> Net::HTTPResponse
|
|
138
|
+
|
|
139
|
+
def response_read_until_over_the_limit: () -> Net::HTTPResponse
|
|
140
|
+
|
|
141
|
+
def json_post: () -> Net::HTTP::Post
|
|
142
|
+
|
|
143
|
+
def body_text_read_until_over_the_limit: (Net::HTTPResponse response) -> String
|
|
144
|
+
|
|
145
|
+
def answer_in: (Net::HTTPResponse response) -> PollAnswer
|
|
146
|
+
|
|
147
|
+
def answer_holding_the_payload: () -> PollAnswer
|
|
148
|
+
|
|
149
|
+
def retry_after_seconds_in: (Net::HTTPResponse response) -> seconds?
|
|
150
|
+
|
|
151
|
+
def refusal_detail: () -> String
|
|
152
|
+
end
|
|
153
|
+
|
|
154
|
+
class PollingSession
|
|
155
|
+
@endpoint: PollingEndpoint
|
|
156
|
+
@timing: PollTiming
|
|
157
|
+
@log: Logging::ClientLog
|
|
158
|
+
@session_id: String
|
|
159
|
+
@last_update_timestamp: String?
|
|
160
|
+
@seconds_before_the_next_poll: seconds
|
|
161
|
+
|
|
162
|
+
def initialize: (
|
|
163
|
+
endpoint: PollingEndpoint,
|
|
164
|
+
timing: PollTiming,
|
|
165
|
+
log: Logging::ClientLog,
|
|
166
|
+
?last_update_timestamp: String?
|
|
167
|
+
) -> void
|
|
168
|
+
|
|
169
|
+
def poll: (
|
|
170
|
+
report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
|
|
171
|
+
) { (String payload_text) -> void } -> Symbol
|
|
172
|
+
|
|
173
|
+
def session_of_a_forked_process: () -> PollingSession
|
|
174
|
+
|
|
175
|
+
def poll_at_once_and_on_every_interval: (
|
|
176
|
+
report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
|
|
177
|
+
) { (String payload_text) -> void } -> void
|
|
178
|
+
|
|
179
|
+
def poll_on_every_interval: (
|
|
180
|
+
report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
|
|
181
|
+
) { (String payload_text) -> void } -> void
|
|
182
|
+
|
|
183
|
+
private
|
|
184
|
+
|
|
185
|
+
def answer_retried_once_when_unanswered: () -> PollAnswer
|
|
186
|
+
|
|
187
|
+
def answer_before: (Connection::RequestDeadline deadline) -> PollAnswer
|
|
188
|
+
|
|
189
|
+
def deliver: (PollAnswer answer) { (String payload_text) -> void } -> Symbol
|
|
190
|
+
|
|
191
|
+
def log_the_failure_of: (PollAnswer answer) -> void
|
|
192
|
+
|
|
193
|
+
def log_and_report_the_unrecoverable_error_of: (
|
|
194
|
+
PollAnswer answer,
|
|
195
|
+
^(ConfigDirectorConnectionError unrecoverable_error) -> void report_unrecoverable_error
|
|
196
|
+
) -> void
|
|
197
|
+
end
|
|
198
|
+
|
|
199
|
+
class PollingTransport
|
|
200
|
+
SECONDS_CLOSE_WAITS_FOR_THE_THREAD: Integer
|
|
201
|
+
|
|
202
|
+
@session: PollingSession
|
|
203
|
+
@lock: Thread::Mutex
|
|
204
|
+
@closed: bool
|
|
205
|
+
@polling_thread: StoppableThread?
|
|
206
|
+
|
|
207
|
+
def initialize: (endpoint: PollingEndpoint, timing: PollTiming, logger: _Logger & Object) -> void
|
|
208
|
+
|
|
209
|
+
def open: (
|
|
210
|
+
report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
|
|
211
|
+
) { (String payload_text) -> void } -> Symbol
|
|
212
|
+
|
|
213
|
+
def restart_in_a_forked_process: (
|
|
214
|
+
report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
|
|
215
|
+
) { (String payload_text) -> void } -> void
|
|
216
|
+
|
|
217
|
+
def close: () -> void
|
|
218
|
+
|
|
219
|
+
private
|
|
220
|
+
|
|
221
|
+
def poll_on_every_interval_unless_closed: (
|
|
222
|
+
report_unrecoverable_error: ^(ConfigDirectorConnectionError unrecoverable_error) -> void
|
|
223
|
+
) { (String payload_text) -> void } -> void
|
|
224
|
+
|
|
225
|
+
def start_the_polling_thread_unless_closed: () { () -> void } -> void
|
|
226
|
+
end
|
|
227
|
+
|
|
228
|
+
class PollingModeConnection
|
|
229
|
+
include Connection::_Connection
|
|
230
|
+
extend Connection::_ConnectionOfAMode
|
|
231
|
+
|
|
232
|
+
OPENING_BY_WHAT_FOLLOWS_THE_FIRST_POLL: Hash[Symbol, Symbol]
|
|
233
|
+
|
|
234
|
+
@transport: PollingTransport
|
|
235
|
+
|
|
236
|
+
def initialize: (PollingTransport transport) -> void
|
|
237
|
+
end
|
|
238
|
+
end
|
|
239
|
+
end
|
|
240
|
+
end
|