flipper 0.22.1 → 0.28.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (137) hide show
  1. checksums.yaml +4 -4
  2. data/.codeclimate.yml +1 -0
  3. data/.github/dependabot.yml +6 -0
  4. data/.github/workflows/ci.yml +26 -15
  5. data/.github/workflows/examples.yml +21 -15
  6. data/.rspec +1 -0
  7. data/.tool-versions +1 -0
  8. data/Changelog.md +144 -4
  9. data/Dockerfile +1 -1
  10. data/Gemfile +9 -6
  11. data/README.md +15 -67
  12. data/Rakefile +4 -2
  13. data/benchmark/enabled_ips.rb +10 -0
  14. data/benchmark/enabled_multiple_actors_ips.rb +20 -0
  15. data/benchmark/enabled_profile.rb +20 -0
  16. data/benchmark/instrumentation_ips.rb +21 -0
  17. data/benchmark/typecast_ips.rb +19 -0
  18. data/docs/README.md +1 -0
  19. data/docs/images/banner.jpg +0 -0
  20. data/examples/api/basic.ru +3 -4
  21. data/examples/api/custom_memoized.ru +3 -4
  22. data/examples/api/memoized.ru +3 -4
  23. data/examples/dsl.rb +3 -3
  24. data/examples/enabled_for_actor.rb +4 -2
  25. data/examples/instrumentation.rb +1 -0
  26. data/examples/instrumentation_last_accessed_at.rb +1 -0
  27. data/flipper.gemspec +2 -2
  28. data/lib/flipper/actor.rb +4 -0
  29. data/lib/flipper/adapter.rb +23 -7
  30. data/lib/flipper/adapters/dual_write.rb +10 -16
  31. data/lib/flipper/adapters/failover.rb +83 -0
  32. data/lib/flipper/adapters/failsafe.rb +76 -0
  33. data/lib/flipper/adapters/http/client.rb +18 -12
  34. data/lib/flipper/adapters/http/error.rb +19 -1
  35. data/lib/flipper/adapters/http.rb +14 -4
  36. data/lib/flipper/adapters/instrumented.rb +25 -2
  37. data/lib/flipper/adapters/memoizable.rb +27 -18
  38. data/lib/flipper/adapters/memory.rb +56 -39
  39. data/lib/flipper/adapters/operation_logger.rb +16 -3
  40. data/lib/flipper/adapters/poll/poller.rb +2 -0
  41. data/lib/flipper/adapters/poll.rb +39 -0
  42. data/lib/flipper/adapters/pstore.rb +2 -5
  43. data/lib/flipper/adapters/sync/interval_synchronizer.rb +1 -6
  44. data/lib/flipper/adapters/sync.rb +9 -15
  45. data/lib/flipper/dsl.rb +9 -11
  46. data/lib/flipper/errors.rb +3 -20
  47. data/lib/flipper/export.rb +26 -0
  48. data/lib/flipper/exporter.rb +17 -0
  49. data/lib/flipper/exporters/json/export.rb +32 -0
  50. data/lib/flipper/exporters/json/v1.rb +33 -0
  51. data/lib/flipper/feature.rb +32 -26
  52. data/lib/flipper/feature_check_context.rb +10 -6
  53. data/lib/flipper/gate.rb +12 -11
  54. data/lib/flipper/gate_values.rb +0 -16
  55. data/lib/flipper/gates/actor.rb +10 -17
  56. data/lib/flipper/gates/boolean.rb +1 -1
  57. data/lib/flipper/gates/group.rb +5 -7
  58. data/lib/flipper/gates/percentage_of_actors.rb +10 -13
  59. data/lib/flipper/gates/percentage_of_time.rb +1 -2
  60. data/lib/flipper/identifier.rb +2 -2
  61. data/lib/flipper/instrumentation/log_subscriber.rb +7 -3
  62. data/lib/flipper/instrumentation/subscriber.rb +8 -1
  63. data/lib/flipper/instrumenters/memory.rb +6 -2
  64. data/lib/flipper/metadata.rb +1 -1
  65. data/lib/flipper/middleware/memoizer.rb +2 -12
  66. data/lib/flipper/poller.rb +117 -0
  67. data/lib/flipper/railtie.rb +23 -22
  68. data/lib/flipper/spec/shared_adapter_specs.rb +23 -0
  69. data/lib/flipper/test/shared_adapter_test.rb +24 -0
  70. data/lib/flipper/typecast.rb +28 -15
  71. data/lib/flipper/types/actor.rb +19 -13
  72. data/lib/flipper/types/group.rb +12 -5
  73. data/lib/flipper/version.rb +1 -1
  74. data/lib/flipper.rb +6 -4
  75. data/spec/fixtures/flipper_pstore_1679087600.json +46 -0
  76. data/spec/flipper/actor_spec.rb +10 -2
  77. data/spec/flipper/adapter_spec.rb +29 -4
  78. data/spec/flipper/adapters/dual_write_spec.rb +0 -2
  79. data/spec/flipper/adapters/failover_spec.rb +129 -0
  80. data/spec/flipper/adapters/failsafe_spec.rb +58 -0
  81. data/spec/flipper/adapters/http_spec.rb +64 -6
  82. data/spec/flipper/adapters/instrumented_spec.rb +28 -12
  83. data/spec/flipper/adapters/memoizable_spec.rb +30 -12
  84. data/spec/flipper/adapters/memory_spec.rb +3 -4
  85. data/spec/flipper/adapters/operation_logger_spec.rb +29 -12
  86. data/spec/flipper/adapters/pstore_spec.rb +0 -2
  87. data/spec/flipper/adapters/read_only_spec.rb +0 -1
  88. data/spec/flipper/adapters/sync/feature_synchronizer_spec.rb +0 -1
  89. data/spec/flipper/adapters/sync/interval_synchronizer_spec.rb +4 -5
  90. data/spec/flipper/adapters/sync/synchronizer_spec.rb +0 -1
  91. data/spec/flipper/adapters/sync_spec.rb +0 -2
  92. data/spec/flipper/configuration_spec.rb +0 -1
  93. data/spec/flipper/dsl_spec.rb +38 -12
  94. data/spec/flipper/export_spec.rb +13 -0
  95. data/spec/flipper/exporter_spec.rb +16 -0
  96. data/spec/flipper/exporters/json/export_spec.rb +60 -0
  97. data/spec/flipper/exporters/json/v1_spec.rb +33 -0
  98. data/spec/flipper/feature_check_context_spec.rb +17 -19
  99. data/spec/flipper/feature_spec.rb +76 -33
  100. data/spec/flipper/gate_spec.rb +0 -2
  101. data/spec/flipper/gate_values_spec.rb +2 -34
  102. data/spec/flipper/gates/actor_spec.rb +0 -2
  103. data/spec/flipper/gates/boolean_spec.rb +1 -3
  104. data/spec/flipper/gates/group_spec.rb +2 -5
  105. data/spec/flipper/gates/percentage_of_actors_spec.rb +61 -7
  106. data/spec/flipper/gates/percentage_of_time_spec.rb +2 -4
  107. data/spec/flipper/identifier_spec.rb +0 -1
  108. data/spec/flipper/instrumentation/log_subscriber_spec.rb +15 -6
  109. data/spec/flipper/instrumentation/statsd_subscriber_spec.rb +10 -1
  110. data/spec/flipper/instrumenters/memory_spec.rb +18 -1
  111. data/spec/flipper/instrumenters/noop_spec.rb +14 -8
  112. data/spec/flipper/middleware/memoizer_spec.rb +0 -23
  113. data/spec/flipper/middleware/setup_env_spec.rb +0 -2
  114. data/spec/flipper/poller_spec.rb +47 -0
  115. data/spec/flipper/railtie_spec.rb +73 -33
  116. data/spec/flipper/registry_spec.rb +0 -1
  117. data/spec/flipper/typecast_spec.rb +82 -4
  118. data/spec/flipper/types/actor_spec.rb +45 -46
  119. data/spec/flipper/types/boolean_spec.rb +0 -1
  120. data/spec/flipper/types/group_spec.rb +2 -3
  121. data/spec/flipper/types/percentage_of_actors_spec.rb +0 -1
  122. data/spec/flipper/types/percentage_of_time_spec.rb +0 -1
  123. data/spec/flipper/types/percentage_spec.rb +0 -1
  124. data/spec/flipper_integration_spec.rb +62 -51
  125. data/spec/flipper_spec.rb +7 -2
  126. data/spec/{helper.rb → spec_helper.rb} +4 -2
  127. data/spec/support/skippable.rb +18 -0
  128. data/spec/support/spec_helpers.rb +2 -6
  129. metadata +61 -19
  130. data/docs/Adapters.md +0 -124
  131. data/docs/Caveats.md +0 -4
  132. data/docs/Gates.md +0 -167
  133. data/docs/Instrumentation.md +0 -27
  134. data/docs/Optimization.md +0 -137
  135. data/docs/api/README.md +0 -884
  136. data/docs/http/README.md +0 -36
  137. data/docs/read-only/README.md +0 -24
data/docs/http/README.md DELETED
@@ -1,36 +0,0 @@
1
- # Flipper Http
2
-
3
- HTTP adapter for use with the [Flipper Api](https://github.com/jnunemaker/flipper/blob/master/docs/api/README.md).
4
-
5
- Given you have [mounted](https://github.com/jnunemaker/flipper/blob/master/docs/api/README.md#user-content-usage) the Flipper Api on an application, you can use the HTTP adapter to interact with Flipper just like any other adapter, and internally it will handle all the http requests for you. This means that you can have the application exposing the API store your Flipper data, but interact with it from other Ruby apps.
6
-
7
- Initialize the HTTP adapter with a configuration Hash.
8
- ```ruby
9
- require 'flipper/adapters/http'
10
-
11
- Flipper.configure do |config|
12
- config.adapter do
13
- Flipper::Adapters::Http.new({
14
- url: 'http://app.com/mount-point', # required
15
- headers: { 'X-Custom-Header' => 'foo' },
16
- basic_auth_username: 'user123',
17
- basic_auth_password: 'password123'
18
- read_timeout: 5,
19
- open_timeout: 2,
20
- })
21
- end
22
- end
23
- ```
24
-
25
- **Required keys**:
26
- * url: String url where [Flipper Api](https://github.com/jnunemaker/flipper/blob/master/docs/api/README.md) is mounted.
27
-
28
- **Optional keys**:
29
- *These will affect every request the adapter makes. For example, send basic auth credentials with every request.*
30
-
31
- * headers: HTTP headers.
32
- * basic_auth_username: Basic Auth username.
33
- * basic_auth_password: Basic Auth password.
34
- * read_timeout: [number in seconds](https://docs.ruby-lang.org/en/2.3.0/Net/HTTP.html#attribute-i-read_timeout).
35
- * open_timeout: [number in seconds](https://docs.ruby-lang.org/en/2.3.0/Net/HTTP.html#attribute-i-open_timeout).
36
- * debug_output: Set an output stream for debugging (e.g. `debug_output: $stderr`). The output stream is passed on to [Net::HTTP#set_debug_output](https://ruby-doc.org/stdlib-2.4.1/libdoc/net/http/rdoc/Net/HTTP.html#method-i-set_debug_output).
@@ -1,24 +0,0 @@
1
- # Flipper read-only
2
-
3
- A [read-only](https://github.com/jnunemaker/flipper/blob/master/lib/flipper/adapters/read_only.rb) adapter for [Flipper](https://github.com/jnunemaker/flipper).
4
-
5
- Use this adapter to wrap another adapter and raise an exception for any writes.
6
-
7
- Any attempted write raises `Flipper::Adapters::ReadOnly::WriteAttempted` with message `'write attempted while in read only mode'`
8
-
9
- ## Usage
10
-
11
- ```ruby
12
- # example wrapping memory adapter
13
- require 'flipper/adapters/read_only'
14
-
15
- Flipper.configure do |config|
16
- config.adapter do
17
- Flipper::Adapters::ReadOnly.new(Flipper::Adapters::Memory.new)
18
- end
19
- end
20
-
21
- # Enabling a feature
22
- > Flipper[:dashboard_panel].enable
23
- => Flipper::Adapters::ReadOnly::WriteAttempted: write attempted while in read only mode
24
- ```