omg-activesupport 8.0.0.alpha1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (289) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +86 -0
  3. data/MIT-LICENSE +20 -0
  4. data/README.rdoc +40 -0
  5. data/lib/active_support/actionable_error.rb +50 -0
  6. data/lib/active_support/all.rb +5 -0
  7. data/lib/active_support/array_inquirer.rb +50 -0
  8. data/lib/active_support/backtrace_cleaner.rb +163 -0
  9. data/lib/active_support/benchmark.rb +21 -0
  10. data/lib/active_support/benchmarkable.rb +53 -0
  11. data/lib/active_support/broadcast_logger.rb +251 -0
  12. data/lib/active_support/builder.rb +8 -0
  13. data/lib/active_support/cache/coder.rb +153 -0
  14. data/lib/active_support/cache/entry.rb +134 -0
  15. data/lib/active_support/cache/file_store.rb +244 -0
  16. data/lib/active_support/cache/mem_cache_store.rb +290 -0
  17. data/lib/active_support/cache/memory_store.rb +262 -0
  18. data/lib/active_support/cache/null_store.rb +62 -0
  19. data/lib/active_support/cache/redis_cache_store.rb +492 -0
  20. data/lib/active_support/cache/serializer_with_fallback.rb +152 -0
  21. data/lib/active_support/cache/strategy/local_cache.rb +201 -0
  22. data/lib/active_support/cache/strategy/local_cache_middleware.rb +45 -0
  23. data/lib/active_support/cache.rb +1104 -0
  24. data/lib/active_support/callbacks.rb +944 -0
  25. data/lib/active_support/class_attribute.rb +26 -0
  26. data/lib/active_support/code_generator.rb +79 -0
  27. data/lib/active_support/concern.rb +217 -0
  28. data/lib/active_support/concurrency/load_interlock_aware_monitor.rb +72 -0
  29. data/lib/active_support/concurrency/null_lock.rb +13 -0
  30. data/lib/active_support/concurrency/share_lock.rb +225 -0
  31. data/lib/active_support/configurable.rb +159 -0
  32. data/lib/active_support/configuration_file.rb +60 -0
  33. data/lib/active_support/core_ext/array/access.rb +100 -0
  34. data/lib/active_support/core_ext/array/conversions.rb +213 -0
  35. data/lib/active_support/core_ext/array/extract.rb +21 -0
  36. data/lib/active_support/core_ext/array/extract_options.rb +31 -0
  37. data/lib/active_support/core_ext/array/grouping.rb +109 -0
  38. data/lib/active_support/core_ext/array/inquiry.rb +19 -0
  39. data/lib/active_support/core_ext/array/wrap.rb +48 -0
  40. data/lib/active_support/core_ext/array.rb +9 -0
  41. data/lib/active_support/core_ext/benchmark.rb +13 -0
  42. data/lib/active_support/core_ext/big_decimal/conversions.rb +14 -0
  43. data/lib/active_support/core_ext/big_decimal.rb +3 -0
  44. data/lib/active_support/core_ext/class/attribute.rb +122 -0
  45. data/lib/active_support/core_ext/class/attribute_accessors.rb +6 -0
  46. data/lib/active_support/core_ext/class/subclasses.rb +24 -0
  47. data/lib/active_support/core_ext/class.rb +4 -0
  48. data/lib/active_support/core_ext/date/acts_like.rb +10 -0
  49. data/lib/active_support/core_ext/date/blank.rb +18 -0
  50. data/lib/active_support/core_ext/date/calculations.rb +161 -0
  51. data/lib/active_support/core_ext/date/conversions.rb +98 -0
  52. data/lib/active_support/core_ext/date/zones.rb +8 -0
  53. data/lib/active_support/core_ext/date.rb +7 -0
  54. data/lib/active_support/core_ext/date_and_time/calculations.rb +374 -0
  55. data/lib/active_support/core_ext/date_and_time/compatibility.rb +58 -0
  56. data/lib/active_support/core_ext/date_and_time/zones.rb +40 -0
  57. data/lib/active_support/core_ext/date_time/acts_like.rb +16 -0
  58. data/lib/active_support/core_ext/date_time/blank.rb +18 -0
  59. data/lib/active_support/core_ext/date_time/calculations.rb +215 -0
  60. data/lib/active_support/core_ext/date_time/compatibility.rb +18 -0
  61. data/lib/active_support/core_ext/date_time/conversions.rb +106 -0
  62. data/lib/active_support/core_ext/date_time.rb +7 -0
  63. data/lib/active_support/core_ext/digest/uuid.rb +76 -0
  64. data/lib/active_support/core_ext/digest.rb +3 -0
  65. data/lib/active_support/core_ext/enumerable.rb +267 -0
  66. data/lib/active_support/core_ext/erb/util.rb +201 -0
  67. data/lib/active_support/core_ext/file/atomic.rb +72 -0
  68. data/lib/active_support/core_ext/file.rb +3 -0
  69. data/lib/active_support/core_ext/hash/conversions.rb +262 -0
  70. data/lib/active_support/core_ext/hash/deep_merge.rb +42 -0
  71. data/lib/active_support/core_ext/hash/deep_transform_values.rb +46 -0
  72. data/lib/active_support/core_ext/hash/except.rb +12 -0
  73. data/lib/active_support/core_ext/hash/indifferent_access.rb +24 -0
  74. data/lib/active_support/core_ext/hash/keys.rb +143 -0
  75. data/lib/active_support/core_ext/hash/reverse_merge.rb +25 -0
  76. data/lib/active_support/core_ext/hash/slice.rb +27 -0
  77. data/lib/active_support/core_ext/hash.rb +10 -0
  78. data/lib/active_support/core_ext/integer/inflections.rb +31 -0
  79. data/lib/active_support/core_ext/integer/multiple.rb +12 -0
  80. data/lib/active_support/core_ext/integer/time.rb +22 -0
  81. data/lib/active_support/core_ext/integer.rb +5 -0
  82. data/lib/active_support/core_ext/kernel/concern.rb +14 -0
  83. data/lib/active_support/core_ext/kernel/reporting.rb +45 -0
  84. data/lib/active_support/core_ext/kernel/singleton_class.rb +8 -0
  85. data/lib/active_support/core_ext/kernel.rb +5 -0
  86. data/lib/active_support/core_ext/load_error.rb +9 -0
  87. data/lib/active_support/core_ext/module/aliasing.rb +31 -0
  88. data/lib/active_support/core_ext/module/anonymous.rb +30 -0
  89. data/lib/active_support/core_ext/module/attr_internal.rb +49 -0
  90. data/lib/active_support/core_ext/module/attribute_accessors.rb +214 -0
  91. data/lib/active_support/core_ext/module/attribute_accessors_per_thread.rb +175 -0
  92. data/lib/active_support/core_ext/module/concerning.rb +140 -0
  93. data/lib/active_support/core_ext/module/delegation.rb +225 -0
  94. data/lib/active_support/core_ext/module/deprecation.rb +25 -0
  95. data/lib/active_support/core_ext/module/introspection.rb +62 -0
  96. data/lib/active_support/core_ext/module/redefine_method.rb +40 -0
  97. data/lib/active_support/core_ext/module/remove_method.rb +17 -0
  98. data/lib/active_support/core_ext/module.rb +13 -0
  99. data/lib/active_support/core_ext/name_error.rb +59 -0
  100. data/lib/active_support/core_ext/numeric/bytes.rb +75 -0
  101. data/lib/active_support/core_ext/numeric/conversions.rb +145 -0
  102. data/lib/active_support/core_ext/numeric/time.rb +66 -0
  103. data/lib/active_support/core_ext/numeric.rb +5 -0
  104. data/lib/active_support/core_ext/object/acts_like.rb +45 -0
  105. data/lib/active_support/core_ext/object/blank.rb +199 -0
  106. data/lib/active_support/core_ext/object/conversions.rb +6 -0
  107. data/lib/active_support/core_ext/object/deep_dup.rb +71 -0
  108. data/lib/active_support/core_ext/object/duplicable.rb +69 -0
  109. data/lib/active_support/core_ext/object/inclusion.rb +37 -0
  110. data/lib/active_support/core_ext/object/instance_variables.rb +32 -0
  111. data/lib/active_support/core_ext/object/json.rb +260 -0
  112. data/lib/active_support/core_ext/object/to_param.rb +3 -0
  113. data/lib/active_support/core_ext/object/to_query.rb +87 -0
  114. data/lib/active_support/core_ext/object/try.rb +158 -0
  115. data/lib/active_support/core_ext/object/with.rb +46 -0
  116. data/lib/active_support/core_ext/object/with_options.rb +101 -0
  117. data/lib/active_support/core_ext/object.rb +17 -0
  118. data/lib/active_support/core_ext/pathname/blank.rb +20 -0
  119. data/lib/active_support/core_ext/pathname/existence.rb +23 -0
  120. data/lib/active_support/core_ext/pathname.rb +4 -0
  121. data/lib/active_support/core_ext/range/compare_range.rb +57 -0
  122. data/lib/active_support/core_ext/range/conversions.rb +62 -0
  123. data/lib/active_support/core_ext/range/each.rb +24 -0
  124. data/lib/active_support/core_ext/range/overlap.rb +40 -0
  125. data/lib/active_support/core_ext/range.rb +6 -0
  126. data/lib/active_support/core_ext/regexp.rb +14 -0
  127. data/lib/active_support/core_ext/securerandom.rb +41 -0
  128. data/lib/active_support/core_ext/string/access.rb +95 -0
  129. data/lib/active_support/core_ext/string/behavior.rb +8 -0
  130. data/lib/active_support/core_ext/string/conversions.rb +60 -0
  131. data/lib/active_support/core_ext/string/exclude.rb +13 -0
  132. data/lib/active_support/core_ext/string/filters.rb +151 -0
  133. data/lib/active_support/core_ext/string/indent.rb +45 -0
  134. data/lib/active_support/core_ext/string/inflections.rb +300 -0
  135. data/lib/active_support/core_ext/string/inquiry.rb +16 -0
  136. data/lib/active_support/core_ext/string/multibyte.rb +58 -0
  137. data/lib/active_support/core_ext/string/output_safety.rb +228 -0
  138. data/lib/active_support/core_ext/string/starts_ends_with.rb +6 -0
  139. data/lib/active_support/core_ext/string/strip.rb +27 -0
  140. data/lib/active_support/core_ext/string/zones.rb +16 -0
  141. data/lib/active_support/core_ext/string.rb +15 -0
  142. data/lib/active_support/core_ext/symbol/starts_ends_with.rb +6 -0
  143. data/lib/active_support/core_ext/symbol.rb +3 -0
  144. data/lib/active_support/core_ext/thread/backtrace/location.rb +12 -0
  145. data/lib/active_support/core_ext/time/acts_like.rb +10 -0
  146. data/lib/active_support/core_ext/time/calculations.rb +386 -0
  147. data/lib/active_support/core_ext/time/compatibility.rb +32 -0
  148. data/lib/active_support/core_ext/time/conversions.rb +75 -0
  149. data/lib/active_support/core_ext/time/zones.rb +97 -0
  150. data/lib/active_support/core_ext/time.rb +7 -0
  151. data/lib/active_support/core_ext.rb +5 -0
  152. data/lib/active_support/current_attributes/test_helper.rb +13 -0
  153. data/lib/active_support/current_attributes.rb +233 -0
  154. data/lib/active_support/deep_mergeable.rb +53 -0
  155. data/lib/active_support/delegation.rb +202 -0
  156. data/lib/active_support/dependencies/autoload.rb +72 -0
  157. data/lib/active_support/dependencies/interlock.rb +49 -0
  158. data/lib/active_support/dependencies/require_dependency.rb +28 -0
  159. data/lib/active_support/dependencies.rb +98 -0
  160. data/lib/active_support/deprecation/behaviors.rb +148 -0
  161. data/lib/active_support/deprecation/constant_accessor.rb +74 -0
  162. data/lib/active_support/deprecation/deprecators.rb +104 -0
  163. data/lib/active_support/deprecation/disallowed.rb +54 -0
  164. data/lib/active_support/deprecation/method_wrappers.rb +68 -0
  165. data/lib/active_support/deprecation/proxy_wrappers.rb +189 -0
  166. data/lib/active_support/deprecation/reporting.rb +179 -0
  167. data/lib/active_support/deprecation.rb +81 -0
  168. data/lib/active_support/deprecator.rb +7 -0
  169. data/lib/active_support/descendants_tracker.rb +112 -0
  170. data/lib/active_support/digest.rb +22 -0
  171. data/lib/active_support/duration/iso8601_parser.rb +123 -0
  172. data/lib/active_support/duration/iso8601_serializer.rb +64 -0
  173. data/lib/active_support/duration.rb +520 -0
  174. data/lib/active_support/encrypted_configuration.rb +126 -0
  175. data/lib/active_support/encrypted_file.rb +133 -0
  176. data/lib/active_support/environment_inquirer.rb +40 -0
  177. data/lib/active_support/error_reporter/test_helper.rb +15 -0
  178. data/lib/active_support/error_reporter.rb +265 -0
  179. data/lib/active_support/evented_file_update_checker.rb +182 -0
  180. data/lib/active_support/execution_context/test_helper.rb +13 -0
  181. data/lib/active_support/execution_context.rb +53 -0
  182. data/lib/active_support/execution_wrapper.rb +150 -0
  183. data/lib/active_support/executor/test_helper.rb +7 -0
  184. data/lib/active_support/executor.rb +8 -0
  185. data/lib/active_support/file_update_checker.rb +164 -0
  186. data/lib/active_support/fork_tracker.rb +43 -0
  187. data/lib/active_support/gem_version.rb +17 -0
  188. data/lib/active_support/gzip.rb +40 -0
  189. data/lib/active_support/hash_with_indifferent_access.rb +445 -0
  190. data/lib/active_support/html_safe_translation.rb +56 -0
  191. data/lib/active_support/i18n.rb +17 -0
  192. data/lib/active_support/i18n_railtie.rb +138 -0
  193. data/lib/active_support/inflections.rb +72 -0
  194. data/lib/active_support/inflector/inflections.rb +273 -0
  195. data/lib/active_support/inflector/methods.rb +387 -0
  196. data/lib/active_support/inflector/transliterate.rb +149 -0
  197. data/lib/active_support/inflector.rb +9 -0
  198. data/lib/active_support/isolated_execution_state.rb +75 -0
  199. data/lib/active_support/json/decoding.rb +76 -0
  200. data/lib/active_support/json/encoding.rb +120 -0
  201. data/lib/active_support/json.rb +4 -0
  202. data/lib/active_support/key_generator.rb +66 -0
  203. data/lib/active_support/lazy_load_hooks.rb +107 -0
  204. data/lib/active_support/locale/en.rb +33 -0
  205. data/lib/active_support/locale/en.yml +141 -0
  206. data/lib/active_support/log_subscriber/test_helper.rb +106 -0
  207. data/lib/active_support/log_subscriber.rb +192 -0
  208. data/lib/active_support/logger.rb +55 -0
  209. data/lib/active_support/logger_silence.rb +21 -0
  210. data/lib/active_support/logger_thread_safe_level.rb +47 -0
  211. data/lib/active_support/message_encryptor.rb +374 -0
  212. data/lib/active_support/message_encryptors.rb +141 -0
  213. data/lib/active_support/message_pack/cache_serializer.rb +23 -0
  214. data/lib/active_support/message_pack/extensions.rb +305 -0
  215. data/lib/active_support/message_pack/serializer.rb +63 -0
  216. data/lib/active_support/message_pack.rb +50 -0
  217. data/lib/active_support/message_verifier.rb +368 -0
  218. data/lib/active_support/message_verifiers.rb +135 -0
  219. data/lib/active_support/messages/codec.rb +65 -0
  220. data/lib/active_support/messages/metadata.rb +146 -0
  221. data/lib/active_support/messages/rotation_configuration.rb +23 -0
  222. data/lib/active_support/messages/rotation_coordinator.rb +93 -0
  223. data/lib/active_support/messages/rotator.rb +59 -0
  224. data/lib/active_support/messages/serializer_with_fallback.rb +158 -0
  225. data/lib/active_support/multibyte/chars.rb +178 -0
  226. data/lib/active_support/multibyte/unicode.rb +42 -0
  227. data/lib/active_support/multibyte.rb +23 -0
  228. data/lib/active_support/notifications/fanout.rb +446 -0
  229. data/lib/active_support/notifications/instrumenter.rb +240 -0
  230. data/lib/active_support/notifications.rb +281 -0
  231. data/lib/active_support/number_helper/number_converter.rb +190 -0
  232. data/lib/active_support/number_helper/number_to_currency_converter.rb +46 -0
  233. data/lib/active_support/number_helper/number_to_delimited_converter.rb +30 -0
  234. data/lib/active_support/number_helper/number_to_human_converter.rb +69 -0
  235. data/lib/active_support/number_helper/number_to_human_size_converter.rb +60 -0
  236. data/lib/active_support/number_helper/number_to_percentage_converter.rb +16 -0
  237. data/lib/active_support/number_helper/number_to_phone_converter.rb +60 -0
  238. data/lib/active_support/number_helper/number_to_rounded_converter.rb +59 -0
  239. data/lib/active_support/number_helper/rounding_helper.rb +46 -0
  240. data/lib/active_support/number_helper.rb +479 -0
  241. data/lib/active_support/option_merger.rb +38 -0
  242. data/lib/active_support/ordered_hash.rb +50 -0
  243. data/lib/active_support/ordered_options.rb +147 -0
  244. data/lib/active_support/parameter_filter.rb +157 -0
  245. data/lib/active_support/proxy_object.rb +20 -0
  246. data/lib/active_support/rails.rb +26 -0
  247. data/lib/active_support/railtie.rb +161 -0
  248. data/lib/active_support/reloader.rb +138 -0
  249. data/lib/active_support/rescuable.rb +176 -0
  250. data/lib/active_support/secure_compare_rotator.rb +58 -0
  251. data/lib/active_support/security_utils.rb +38 -0
  252. data/lib/active_support/string_inquirer.rb +35 -0
  253. data/lib/active_support/subscriber.rb +146 -0
  254. data/lib/active_support/syntax_error_proxy.rb +60 -0
  255. data/lib/active_support/tagged_logging.rb +152 -0
  256. data/lib/active_support/test_case.rb +304 -0
  257. data/lib/active_support/testing/assertions.rb +332 -0
  258. data/lib/active_support/testing/autorun.rb +5 -0
  259. data/lib/active_support/testing/constant_lookup.rb +51 -0
  260. data/lib/active_support/testing/constant_stubbing.rb +54 -0
  261. data/lib/active_support/testing/declarative.rb +28 -0
  262. data/lib/active_support/testing/deprecation.rb +82 -0
  263. data/lib/active_support/testing/error_reporter_assertions.rb +107 -0
  264. data/lib/active_support/testing/file_fixtures.rb +38 -0
  265. data/lib/active_support/testing/isolation.rb +121 -0
  266. data/lib/active_support/testing/method_call_assertions.rb +69 -0
  267. data/lib/active_support/testing/parallelization/server.rb +85 -0
  268. data/lib/active_support/testing/parallelization/worker.rb +103 -0
  269. data/lib/active_support/testing/parallelization.rb +55 -0
  270. data/lib/active_support/testing/parallelize_executor.rb +81 -0
  271. data/lib/active_support/testing/setup_and_teardown.rb +57 -0
  272. data/lib/active_support/testing/stream.rb +41 -0
  273. data/lib/active_support/testing/strict_warnings.rb +43 -0
  274. data/lib/active_support/testing/tagged_logging.rb +27 -0
  275. data/lib/active_support/testing/tests_without_assertions.rb +19 -0
  276. data/lib/active_support/testing/time_helpers.rb +269 -0
  277. data/lib/active_support/time.rb +20 -0
  278. data/lib/active_support/time_with_zone.rb +609 -0
  279. data/lib/active_support/values/time_zone.rb +614 -0
  280. data/lib/active_support/version.rb +10 -0
  281. data/lib/active_support/xml_mini/jdom.rb +175 -0
  282. data/lib/active_support/xml_mini/libxml.rb +80 -0
  283. data/lib/active_support/xml_mini/libxmlsax.rb +83 -0
  284. data/lib/active_support/xml_mini/nokogiri.rb +83 -0
  285. data/lib/active_support/xml_mini/nokogirisax.rb +86 -0
  286. data/lib/active_support/xml_mini/rexml.rb +137 -0
  287. data/lib/active_support/xml_mini.rb +211 -0
  288. data/lib/active_support.rb +144 -0
  289. metadata +526 -0
@@ -0,0 +1,225 @@
1
+ # frozen_string_literal: true
2
+
3
+ class Module
4
+ require "active_support/delegation"
5
+ DelegationError = ActiveSupport::DelegationError # :nodoc:
6
+
7
+ # Provides a +delegate+ class method to easily expose contained objects'
8
+ # public methods as your own.
9
+ #
10
+ # ==== Options
11
+ # * <tt>:to</tt> - Specifies the target object name as a symbol or string
12
+ # * <tt>:prefix</tt> - Prefixes the new method with the target name or a custom prefix
13
+ # * <tt>:allow_nil</tt> - If set to true, prevents a +ActiveSupport::DelegationError+
14
+ # from being raised
15
+ # * <tt>:private</tt> - If set to true, changes method visibility to private
16
+ #
17
+ # The macro receives one or more method names (specified as symbols or
18
+ # strings) and the name of the target object via the <tt>:to</tt> option
19
+ # (also a symbol or string).
20
+ #
21
+ # Delegation is particularly useful with Active Record associations:
22
+ #
23
+ # class Greeter < ActiveRecord::Base
24
+ # def hello
25
+ # 'hello'
26
+ # end
27
+ #
28
+ # def goodbye
29
+ # 'goodbye'
30
+ # end
31
+ # end
32
+ #
33
+ # class Foo < ActiveRecord::Base
34
+ # belongs_to :greeter
35
+ # delegate :hello, to: :greeter
36
+ # end
37
+ #
38
+ # Foo.new.hello # => "hello"
39
+ # Foo.new.goodbye # => NoMethodError: undefined method `goodbye' for #<Foo:0x1af30c>
40
+ #
41
+ # Multiple delegates to the same target are allowed:
42
+ #
43
+ # class Foo < ActiveRecord::Base
44
+ # belongs_to :greeter
45
+ # delegate :hello, :goodbye, to: :greeter
46
+ # end
47
+ #
48
+ # Foo.new.goodbye # => "goodbye"
49
+ #
50
+ # Methods can be delegated to instance variables, class variables, or constants
51
+ # by providing them as a symbols:
52
+ #
53
+ # class Foo
54
+ # CONSTANT_ARRAY = [0,1,2,3]
55
+ # @@class_array = [4,5,6,7]
56
+ #
57
+ # def initialize
58
+ # @instance_array = [8,9,10,11]
59
+ # end
60
+ # delegate :sum, to: :CONSTANT_ARRAY
61
+ # delegate :min, to: :@@class_array
62
+ # delegate :max, to: :@instance_array
63
+ # end
64
+ #
65
+ # Foo.new.sum # => 6
66
+ # Foo.new.min # => 4
67
+ # Foo.new.max # => 11
68
+ #
69
+ # It's also possible to delegate a method to the class by using +:class+:
70
+ #
71
+ # class Foo
72
+ # def self.hello
73
+ # "world"
74
+ # end
75
+ #
76
+ # delegate :hello, to: :class
77
+ # end
78
+ #
79
+ # Foo.new.hello # => "world"
80
+ #
81
+ # Delegates can optionally be prefixed using the <tt>:prefix</tt> option. If the value
82
+ # is <tt>true</tt>, the delegate methods are prefixed with the name of the object being
83
+ # delegated to.
84
+ #
85
+ # Person = Struct.new(:name, :address)
86
+ #
87
+ # class Invoice < Struct.new(:client)
88
+ # delegate :name, :address, to: :client, prefix: true
89
+ # end
90
+ #
91
+ # john_doe = Person.new('John Doe', 'Vimmersvej 13')
92
+ # invoice = Invoice.new(john_doe)
93
+ # invoice.client_name # => "John Doe"
94
+ # invoice.client_address # => "Vimmersvej 13"
95
+ #
96
+ # It is also possible to supply a custom prefix.
97
+ #
98
+ # class Invoice < Struct.new(:client)
99
+ # delegate :name, :address, to: :client, prefix: :customer
100
+ # end
101
+ #
102
+ # invoice = Invoice.new(john_doe)
103
+ # invoice.customer_name # => 'John Doe'
104
+ # invoice.customer_address # => 'Vimmersvej 13'
105
+ #
106
+ # The delegated methods are public by default.
107
+ # Pass <tt>private: true</tt> to change that.
108
+ #
109
+ # class User < ActiveRecord::Base
110
+ # has_one :profile
111
+ # delegate :first_name, to: :profile
112
+ # delegate :date_of_birth, to: :profile, private: true
113
+ #
114
+ # def age
115
+ # Date.today.year - date_of_birth.year
116
+ # end
117
+ # end
118
+ #
119
+ # User.new.first_name # => "Tomas"
120
+ # User.new.date_of_birth # => NoMethodError: private method `date_of_birth' called for #<User:0x00000008221340>
121
+ # User.new.age # => 2
122
+ #
123
+ # If the target is +nil+ and does not respond to the delegated method a
124
+ # +ActiveSupport::DelegationError+ is raised. If you wish to instead return +nil+,
125
+ # use the <tt>:allow_nil</tt> option.
126
+ #
127
+ # class User < ActiveRecord::Base
128
+ # has_one :profile
129
+ # delegate :age, to: :profile
130
+ # end
131
+ #
132
+ # User.new.age
133
+ # # => ActiveSupport::DelegationError: User#age delegated to profile.age, but profile is nil
134
+ #
135
+ # But if not having a profile yet is fine and should not be an error
136
+ # condition:
137
+ #
138
+ # class User < ActiveRecord::Base
139
+ # has_one :profile
140
+ # delegate :age, to: :profile, allow_nil: true
141
+ # end
142
+ #
143
+ # User.new.age # nil
144
+ #
145
+ # Note that if the target is not +nil+ then the call is attempted regardless of the
146
+ # <tt>:allow_nil</tt> option, and thus an exception is still raised if said object
147
+ # does not respond to the method:
148
+ #
149
+ # class Foo
150
+ # def initialize(bar)
151
+ # @bar = bar
152
+ # end
153
+ #
154
+ # delegate :name, to: :@bar, allow_nil: true
155
+ # end
156
+ #
157
+ # Foo.new("Bar").name # raises NoMethodError: undefined method `name'
158
+ #
159
+ # The target method must be public, otherwise it will raise +NoMethodError+.
160
+ def delegate(*methods, to: nil, prefix: nil, allow_nil: nil, private: nil)
161
+ ::ActiveSupport::Delegation.generate(
162
+ self,
163
+ methods,
164
+ location: caller_locations(1, 1).first,
165
+ to: to,
166
+ prefix: prefix,
167
+ allow_nil: allow_nil,
168
+ private: private,
169
+ )
170
+ end
171
+
172
+ # When building decorators, a common pattern may emerge:
173
+ #
174
+ # class Partition
175
+ # def initialize(event)
176
+ # @event = event
177
+ # end
178
+ #
179
+ # def person
180
+ # detail.person || creator
181
+ # end
182
+ #
183
+ # private
184
+ # def respond_to_missing?(name, include_private = false)
185
+ # @event.respond_to?(name, include_private)
186
+ # end
187
+ #
188
+ # def method_missing(method, *args, &block)
189
+ # @event.send(method, *args, &block)
190
+ # end
191
+ # end
192
+ #
193
+ # With <tt>Module#delegate_missing_to</tt>, the above is condensed to:
194
+ #
195
+ # class Partition
196
+ # delegate_missing_to :@event
197
+ #
198
+ # def initialize(event)
199
+ # @event = event
200
+ # end
201
+ #
202
+ # def person
203
+ # detail.person || creator
204
+ # end
205
+ # end
206
+ #
207
+ # The target can be anything callable within the object, e.g. instance
208
+ # variables, methods, constants, etc.
209
+ #
210
+ # The delegated method must be public on the target, otherwise it will
211
+ # raise +ActiveSupport::DelegationError+. If you wish to instead return +nil+,
212
+ # use the <tt>:allow_nil</tt> option.
213
+ #
214
+ # The <tt>marshal_dump</tt> and <tt>_dump</tt> methods are exempt from
215
+ # delegation due to possible interference when calling
216
+ # <tt>Marshal.dump(object)</tt>, should the delegation target method
217
+ # of <tt>object</tt> add or remove instance variables.
218
+ def delegate_missing_to(target, allow_nil: nil)
219
+ ::ActiveSupport::Delegation.generate_method_missing(
220
+ self,
221
+ target,
222
+ allow_nil: allow_nil,
223
+ )
224
+ end
225
+ end
@@ -0,0 +1,25 @@
1
+ # frozen_string_literal: true
2
+
3
+ class Module
4
+ # deprecate :foo, deprecator: MyLib.deprecator
5
+ # deprecate :foo, bar: "warning!", deprecator: MyLib.deprecator
6
+ #
7
+ # A deprecator is typically an instance of ActiveSupport::Deprecation, but you can also pass any object that responds
8
+ # to <tt>deprecation_warning(deprecated_method_name, message, caller_backtrace)</tt> where you can implement your
9
+ # custom warning behavior.
10
+ #
11
+ # class MyLib::Deprecator
12
+ # def deprecation_warning(deprecated_method_name, message, caller_backtrace = nil)
13
+ # message = "#{deprecated_method_name} is deprecated and will be removed from MyLibrary | #{message}"
14
+ # Kernel.warn message
15
+ # end
16
+ # end
17
+ def deprecate(*method_names, deprecator:, **options)
18
+ if deprecator.is_a?(ActiveSupport::Deprecation)
19
+ deprecator.deprecate_methods(self, *method_names, **options)
20
+ elsif deprecator
21
+ # we just need any instance to call deprecate_methods, but the deprecation will be emitted by deprecator
22
+ ActiveSupport.deprecator.deprecate_methods(self, *method_names, **options, deprecator: deprecator)
23
+ end
24
+ end
25
+ end
@@ -0,0 +1,62 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "active_support/inflector"
4
+
5
+ class Module
6
+ # Returns the name of the module containing this one.
7
+ #
8
+ # M::N.module_parent_name # => "M"
9
+ def module_parent_name
10
+ if defined?(@parent_name)
11
+ @parent_name
12
+ else
13
+ parent_name = name =~ /::[^:]+\z/ ? -$` : nil
14
+ @parent_name = parent_name unless frozen?
15
+ parent_name
16
+ end
17
+ end
18
+
19
+ # Returns the module which contains this one according to its name.
20
+ #
21
+ # module M
22
+ # module N
23
+ # end
24
+ # end
25
+ # X = M::N
26
+ #
27
+ # M::N.module_parent # => M
28
+ # X.module_parent # => M
29
+ #
30
+ # The parent of top-level and anonymous modules is Object.
31
+ #
32
+ # M.module_parent # => Object
33
+ # Module.new.module_parent # => Object
34
+ def module_parent
35
+ module_parent_name ? ActiveSupport::Inflector.constantize(module_parent_name) : Object
36
+ end
37
+
38
+ # Returns all the parents of this module according to its name, ordered from
39
+ # nested outwards. The receiver is not contained within the result.
40
+ #
41
+ # module M
42
+ # module N
43
+ # end
44
+ # end
45
+ # X = M::N
46
+ #
47
+ # M.module_parents # => [Object]
48
+ # M::N.module_parents # => [M, Object]
49
+ # X.module_parents # => [M, Object]
50
+ def module_parents
51
+ parents = []
52
+ if module_parent_name
53
+ parts = module_parent_name.split("::")
54
+ until parts.empty?
55
+ parents << ActiveSupport::Inflector.constantize(parts * "::")
56
+ parts.pop
57
+ end
58
+ end
59
+ parents << Object unless parents.include? Object
60
+ parents
61
+ end
62
+ end
@@ -0,0 +1,40 @@
1
+ # frozen_string_literal: true
2
+
3
+ class Module
4
+ # Marks the named method as intended to be redefined, if it exists.
5
+ # Suppresses the Ruby method redefinition warning. Prefer
6
+ # #redefine_method where possible.
7
+ def silence_redefinition_of_method(method)
8
+ if method_defined?(method) || private_method_defined?(method)
9
+ # This suppresses the "method redefined" warning; the self-alias
10
+ # looks odd, but means we don't need to generate a unique name
11
+ alias_method method, method
12
+ end
13
+ end
14
+
15
+ # Replaces the existing method definition, if there is one, with the passed
16
+ # block as its body.
17
+ def redefine_method(method, &block)
18
+ visibility = method_visibility(method)
19
+ silence_redefinition_of_method(method)
20
+ define_method(method, &block)
21
+ send(visibility, method)
22
+ end
23
+
24
+ # Replaces the existing singleton method definition, if there is one, with
25
+ # the passed block as its body.
26
+ def redefine_singleton_method(method, &block)
27
+ singleton_class.redefine_method(method, &block)
28
+ end
29
+
30
+ def method_visibility(method) # :nodoc:
31
+ case
32
+ when private_method_defined?(method)
33
+ :private
34
+ when protected_method_defined?(method)
35
+ :protected
36
+ else
37
+ :public
38
+ end
39
+ end
40
+ end
@@ -0,0 +1,17 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "active_support/core_ext/module/redefine_method"
4
+
5
+ class Module
6
+ # Removes the named method, if it exists.
7
+ def remove_possible_method(method)
8
+ if method_defined?(method) || private_method_defined?(method)
9
+ undef_method(method)
10
+ end
11
+ end
12
+
13
+ # Removes the named singleton method, if it exists.
14
+ def remove_possible_singleton_method(method)
15
+ singleton_class.remove_possible_method(method)
16
+ end
17
+ end
@@ -0,0 +1,13 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "active_support/core_ext/module/aliasing"
4
+ require "active_support/core_ext/module/introspection"
5
+ require "active_support/core_ext/module/anonymous"
6
+ require "active_support/core_ext/module/attribute_accessors"
7
+ require "active_support/core_ext/module/attribute_accessors_per_thread"
8
+ require "active_support/core_ext/module/attr_internal"
9
+ require "active_support/core_ext/module/concerning"
10
+ require "active_support/core_ext/module/delegation"
11
+ require "active_support/core_ext/module/deprecation"
12
+ require "active_support/core_ext/module/redefine_method"
13
+ require "active_support/core_ext/module/remove_method"
@@ -0,0 +1,59 @@
1
+ # frozen_string_literal: true
2
+
3
+ class NameError
4
+ # Extract the name of the missing constant from the exception message.
5
+ #
6
+ # begin
7
+ # HelloWorld
8
+ # rescue NameError => e
9
+ # e.missing_name
10
+ # end
11
+ # # => "HelloWorld"
12
+ def missing_name
13
+ # Since ruby v2.3.0 `did_you_mean` gem is loaded by default.
14
+ # It extends NameError#message with spell corrections which are SLOW.
15
+ # We should use original_message message instead.
16
+ message = respond_to?(:original_message) ? original_message : self.message
17
+ return unless message.start_with?("uninitialized constant ")
18
+
19
+ receiver = begin
20
+ self.receiver
21
+ rescue ArgumentError
22
+ nil
23
+ end
24
+
25
+ if receiver == Object
26
+ name.to_s
27
+ elsif receiver
28
+ "#{real_mod_name(receiver)}::#{self.name}"
29
+ else
30
+ if match = message.match(/((::)?([A-Z]\w*)(::[A-Z]\w*)*)$/)
31
+ match[1]
32
+ end
33
+ end
34
+ end
35
+
36
+ # Was this exception raised because the given name was missing?
37
+ #
38
+ # begin
39
+ # HelloWorld
40
+ # rescue NameError => e
41
+ # e.missing_name?("HelloWorld")
42
+ # end
43
+ # # => true
44
+ def missing_name?(name)
45
+ if name.is_a? Symbol
46
+ self.name == name
47
+ else
48
+ missing_name == name.to_s
49
+ end
50
+ end
51
+
52
+ private
53
+ UNBOUND_METHOD_MODULE_NAME = Module.instance_method(:name)
54
+ private_constant :UNBOUND_METHOD_MODULE_NAME
55
+
56
+ def real_mod_name(mod)
57
+ UNBOUND_METHOD_MODULE_NAME.bind_call(mod)
58
+ end
59
+ end
@@ -0,0 +1,75 @@
1
+ # frozen_string_literal: true
2
+
3
+ class Numeric
4
+ KILOBYTE = 1024
5
+ MEGABYTE = KILOBYTE * 1024
6
+ GIGABYTE = MEGABYTE * 1024
7
+ TERABYTE = GIGABYTE * 1024
8
+ PETABYTE = TERABYTE * 1024
9
+ EXABYTE = PETABYTE * 1024
10
+ ZETTABYTE = EXABYTE * 1024
11
+
12
+ # Enables the use of byte calculations and declarations, like 45.bytes + 2.6.megabytes
13
+ #
14
+ # 2.bytes # => 2
15
+ def bytes
16
+ self
17
+ end
18
+ alias :byte :bytes
19
+
20
+ # Returns the number of bytes equivalent to the kilobytes provided.
21
+ #
22
+ # 2.kilobytes # => 2048
23
+ def kilobytes
24
+ self * KILOBYTE
25
+ end
26
+ alias :kilobyte :kilobytes
27
+
28
+ # Returns the number of bytes equivalent to the megabytes provided.
29
+ #
30
+ # 2.megabytes # => 2_097_152
31
+ def megabytes
32
+ self * MEGABYTE
33
+ end
34
+ alias :megabyte :megabytes
35
+
36
+ # Returns the number of bytes equivalent to the gigabytes provided.
37
+ #
38
+ # 2.gigabytes # => 2_147_483_648
39
+ def gigabytes
40
+ self * GIGABYTE
41
+ end
42
+ alias :gigabyte :gigabytes
43
+
44
+ # Returns the number of bytes equivalent to the terabytes provided.
45
+ #
46
+ # 2.terabytes # => 2_199_023_255_552
47
+ def terabytes
48
+ self * TERABYTE
49
+ end
50
+ alias :terabyte :terabytes
51
+
52
+ # Returns the number of bytes equivalent to the petabytes provided.
53
+ #
54
+ # 2.petabytes # => 2_251_799_813_685_248
55
+ def petabytes
56
+ self * PETABYTE
57
+ end
58
+ alias :petabyte :petabytes
59
+
60
+ # Returns the number of bytes equivalent to the exabytes provided.
61
+ #
62
+ # 2.exabytes # => 2_305_843_009_213_693_952
63
+ def exabytes
64
+ self * EXABYTE
65
+ end
66
+ alias :exabyte :exabytes
67
+
68
+ # Returns the number of bytes equivalent to the zettabytes provided.
69
+ #
70
+ # 2.zettabytes # => 2_361_183_241_434_822_606_848
71
+ def zettabytes
72
+ self * ZETTABYTE
73
+ end
74
+ alias :zettabyte :zettabytes
75
+ end
@@ -0,0 +1,145 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "active_support/core_ext/big_decimal/conversions"
4
+ require "active_support/number_helper"
5
+
6
+ module ActiveSupport
7
+ module NumericWithFormat
8
+ # \Numeric With Format
9
+ #
10
+ # Provides options for converting numbers into formatted strings.
11
+ # Options are provided for phone numbers, currency, percentage,
12
+ # precision, positional notation, file size, and pretty printing.
13
+ #
14
+ # This method is aliased to <tt>to_formatted_s</tt>.
15
+ #
16
+ # ==== Options
17
+ #
18
+ # For details on which formats use which options, see ActiveSupport::NumberHelper
19
+ #
20
+ # ==== Examples
21
+ #
22
+ # Phone Numbers:
23
+ # 5551234.to_fs(:phone) # => "555-1234"
24
+ # 1235551234.to_fs(:phone) # => "123-555-1234"
25
+ # 1235551234.to_fs(:phone, area_code: true) # => "(123) 555-1234"
26
+ # 1235551234.to_fs(:phone, delimiter: ' ') # => "123 555 1234"
27
+ # 1235551234.to_fs(:phone, area_code: true, extension: 555) # => "(123) 555-1234 x 555"
28
+ # 1235551234.to_fs(:phone, country_code: 1) # => "+1-123-555-1234"
29
+ # 1235551234.to_fs(:phone, country_code: 1, extension: 1343, delimiter: '.')
30
+ # # => "+1.123.555.1234 x 1343"
31
+ #
32
+ # Currency:
33
+ # 1234567890.50.to_fs(:currency) # => "$1,234,567,890.50"
34
+ # 1234567890.506.to_fs(:currency) # => "$1,234,567,890.51"
35
+ # 1234567890.506.to_fs(:currency, precision: 3) # => "$1,234,567,890.506"
36
+ # 1234567890.506.to_fs(:currency, round_mode: :down) # => "$1,234,567,890.50"
37
+ # 1234567890.506.to_fs(:currency, locale: :fr) # => "1 234 567 890,51 €"
38
+ # -1234567890.50.to_fs(:currency, negative_format: '(%u%n)')
39
+ # # => "($1,234,567,890.50)"
40
+ # 1234567890.50.to_fs(:currency, unit: '&pound;', separator: ',', delimiter: '')
41
+ # # => "&pound;1234567890,50"
42
+ # 1234567890.50.to_fs(:currency, unit: '&pound;', separator: ',', delimiter: '', format: '%n %u')
43
+ # # => "1234567890,50 &pound;"
44
+ #
45
+ # Percentage:
46
+ # 100.to_fs(:percentage) # => "100.000%"
47
+ # 100.to_fs(:percentage, precision: 0) # => "100%"
48
+ # 1000.to_fs(:percentage, delimiter: '.', separator: ',') # => "1.000,000%"
49
+ # 302.24398923423.to_fs(:percentage, precision: 5) # => "302.24399%"
50
+ # 302.24398923423.to_fs(:percentage, round_mode: :down) # => "302.243%"
51
+ # 1000.to_fs(:percentage, locale: :fr) # => "1 000,000%"
52
+ # 100.to_fs(:percentage, format: '%n %') # => "100.000 %"
53
+ #
54
+ # Delimited:
55
+ # 12345678.to_fs(:delimited) # => "12,345,678"
56
+ # 12345678.05.to_fs(:delimited) # => "12,345,678.05"
57
+ # 12345678.to_fs(:delimited, delimiter: '.') # => "12.345.678"
58
+ # 12345678.to_fs(:delimited, delimiter: ',') # => "12,345,678"
59
+ # 12345678.05.to_fs(:delimited, separator: ' ') # => "12,345,678 05"
60
+ # 12345678.05.to_fs(:delimited, locale: :fr) # => "12 345 678,05"
61
+ # 98765432.98.to_fs(:delimited, delimiter: ' ', separator: ',')
62
+ # # => "98 765 432,98"
63
+ #
64
+ # Rounded:
65
+ # 111.2345.to_fs(:rounded) # => "111.235"
66
+ # 111.2345.to_fs(:rounded, precision: 2) # => "111.23"
67
+ # 111.2345.to_fs(:rounded, precision: 2, round_mode: :up) # => "111.24"
68
+ # 13.to_fs(:rounded, precision: 5) # => "13.00000"
69
+ # 389.32314.to_fs(:rounded, precision: 0) # => "389"
70
+ # 111.2345.to_fs(:rounded, significant: true) # => "111"
71
+ # 111.2345.to_fs(:rounded, precision: 1, significant: true) # => "100"
72
+ # 13.to_fs(:rounded, precision: 5, significant: true) # => "13.000"
73
+ # 111.234.to_fs(:rounded, locale: :fr) # => "111,234"
74
+ # 13.to_fs(:rounded, precision: 5, significant: true, strip_insignificant_zeros: true)
75
+ # # => "13"
76
+ # 389.32314.to_fs(:rounded, precision: 4, significant: true) # => "389.3"
77
+ # 1111.2345.to_fs(:rounded, precision: 2, separator: ',', delimiter: '.')
78
+ # # => "1.111,23"
79
+ #
80
+ # Human-friendly size in Bytes:
81
+ # 123.to_fs(:human_size) # => "123 Bytes"
82
+ # 1234.to_fs(:human_size) # => "1.21 KB"
83
+ # 12345.to_fs(:human_size) # => "12.1 KB"
84
+ # 1234567.to_fs(:human_size) # => "1.18 MB"
85
+ # 1234567890.to_fs(:human_size) # => "1.15 GB"
86
+ # 1234567890123.to_fs(:human_size) # => "1.12 TB"
87
+ # 1234567890123456.to_fs(:human_size) # => "1.1 PB"
88
+ # 1234567890123456789.to_fs(:human_size) # => "1.07 EB"
89
+ # 1234567.to_fs(:human_size, precision: 2) # => "1.2 MB"
90
+ # 1234567.to_fs(:human_size, precision: 2, round_mode: :up) # => "1.3 MB"
91
+ # 483989.to_fs(:human_size, precision: 2) # => "470 KB"
92
+ # 1234567.to_fs(:human_size, precision: 2, separator: ',') # => "1,2 MB"
93
+ # 1234567890123.to_fs(:human_size, precision: 5) # => "1.1228 TB"
94
+ # 524288000.to_fs(:human_size, precision: 5) # => "500 MB"
95
+ #
96
+ # Human-friendly format:
97
+ # 123.to_fs(:human) # => "123"
98
+ # 1234.to_fs(:human) # => "1.23 Thousand"
99
+ # 12345.to_fs(:human) # => "12.3 Thousand"
100
+ # 1234567.to_fs(:human) # => "1.23 Million"
101
+ # 1234567890.to_fs(:human) # => "1.23 Billion"
102
+ # 1234567890123.to_fs(:human) # => "1.23 Trillion"
103
+ # 1234567890123456.to_fs(:human) # => "1.23 Quadrillion"
104
+ # 1234567890123456789.to_fs(:human) # => "1230 Quadrillion"
105
+ # 489939.to_fs(:human, precision: 2) # => "490 Thousand"
106
+ # 489939.to_fs(:human, precision: 2, round_mode: :down) # => "480 Thousand"
107
+ # 489939.to_fs(:human, precision: 4) # => "489.9 Thousand"
108
+ # 1234567.to_fs(:human, precision: 4,
109
+ # significant: false) # => "1.2346 Million"
110
+ # 1234567.to_fs(:human, precision: 1,
111
+ # separator: ',',
112
+ # significant: false) # => "1,2 Million"
113
+ def to_fs(format = nil, options = nil)
114
+ return to_s if format.nil?
115
+
116
+ case format
117
+ when Integer, String
118
+ to_s(format)
119
+ when :phone
120
+ ActiveSupport::NumberHelper.number_to_phone(self, options || {})
121
+ when :currency
122
+ ActiveSupport::NumberHelper.number_to_currency(self, options || {})
123
+ when :percentage
124
+ ActiveSupport::NumberHelper.number_to_percentage(self, options || {})
125
+ when :delimited
126
+ ActiveSupport::NumberHelper.number_to_delimited(self, options || {})
127
+ when :rounded
128
+ ActiveSupport::NumberHelper.number_to_rounded(self, options || {})
129
+ when :human
130
+ ActiveSupport::NumberHelper.number_to_human(self, options || {})
131
+ when :human_size
132
+ ActiveSupport::NumberHelper.number_to_human_size(self, options || {})
133
+ when Symbol
134
+ to_s
135
+ else
136
+ to_s(format)
137
+ end
138
+ end
139
+ alias_method :to_formatted_s, :to_fs
140
+ end
141
+ end
142
+
143
+ Integer.include ActiveSupport::NumericWithFormat
144
+ Float.include ActiveSupport::NumericWithFormat
145
+ BigDecimal.include ActiveSupport::NumericWithFormat