omg-activesupport 8.0.0.alpha1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/CHANGELOG.md +86 -0
- data/MIT-LICENSE +20 -0
- data/README.rdoc +40 -0
- data/lib/active_support/actionable_error.rb +50 -0
- data/lib/active_support/all.rb +5 -0
- data/lib/active_support/array_inquirer.rb +50 -0
- data/lib/active_support/backtrace_cleaner.rb +163 -0
- data/lib/active_support/benchmark.rb +21 -0
- data/lib/active_support/benchmarkable.rb +53 -0
- data/lib/active_support/broadcast_logger.rb +251 -0
- data/lib/active_support/builder.rb +8 -0
- data/lib/active_support/cache/coder.rb +153 -0
- data/lib/active_support/cache/entry.rb +134 -0
- data/lib/active_support/cache/file_store.rb +244 -0
- data/lib/active_support/cache/mem_cache_store.rb +290 -0
- data/lib/active_support/cache/memory_store.rb +262 -0
- data/lib/active_support/cache/null_store.rb +62 -0
- data/lib/active_support/cache/redis_cache_store.rb +492 -0
- data/lib/active_support/cache/serializer_with_fallback.rb +152 -0
- data/lib/active_support/cache/strategy/local_cache.rb +201 -0
- data/lib/active_support/cache/strategy/local_cache_middleware.rb +45 -0
- data/lib/active_support/cache.rb +1104 -0
- data/lib/active_support/callbacks.rb +944 -0
- data/lib/active_support/class_attribute.rb +26 -0
- data/lib/active_support/code_generator.rb +79 -0
- data/lib/active_support/concern.rb +217 -0
- data/lib/active_support/concurrency/load_interlock_aware_monitor.rb +72 -0
- data/lib/active_support/concurrency/null_lock.rb +13 -0
- data/lib/active_support/concurrency/share_lock.rb +225 -0
- data/lib/active_support/configurable.rb +159 -0
- data/lib/active_support/configuration_file.rb +60 -0
- data/lib/active_support/core_ext/array/access.rb +100 -0
- data/lib/active_support/core_ext/array/conversions.rb +213 -0
- data/lib/active_support/core_ext/array/extract.rb +21 -0
- data/lib/active_support/core_ext/array/extract_options.rb +31 -0
- data/lib/active_support/core_ext/array/grouping.rb +109 -0
- data/lib/active_support/core_ext/array/inquiry.rb +19 -0
- data/lib/active_support/core_ext/array/wrap.rb +48 -0
- data/lib/active_support/core_ext/array.rb +9 -0
- data/lib/active_support/core_ext/benchmark.rb +13 -0
- data/lib/active_support/core_ext/big_decimal/conversions.rb +14 -0
- data/lib/active_support/core_ext/big_decimal.rb +3 -0
- data/lib/active_support/core_ext/class/attribute.rb +122 -0
- data/lib/active_support/core_ext/class/attribute_accessors.rb +6 -0
- data/lib/active_support/core_ext/class/subclasses.rb +24 -0
- data/lib/active_support/core_ext/class.rb +4 -0
- data/lib/active_support/core_ext/date/acts_like.rb +10 -0
- data/lib/active_support/core_ext/date/blank.rb +18 -0
- data/lib/active_support/core_ext/date/calculations.rb +161 -0
- data/lib/active_support/core_ext/date/conversions.rb +98 -0
- data/lib/active_support/core_ext/date/zones.rb +8 -0
- data/lib/active_support/core_ext/date.rb +7 -0
- data/lib/active_support/core_ext/date_and_time/calculations.rb +374 -0
- data/lib/active_support/core_ext/date_and_time/compatibility.rb +58 -0
- data/lib/active_support/core_ext/date_and_time/zones.rb +40 -0
- data/lib/active_support/core_ext/date_time/acts_like.rb +16 -0
- data/lib/active_support/core_ext/date_time/blank.rb +18 -0
- data/lib/active_support/core_ext/date_time/calculations.rb +215 -0
- data/lib/active_support/core_ext/date_time/compatibility.rb +18 -0
- data/lib/active_support/core_ext/date_time/conversions.rb +106 -0
- data/lib/active_support/core_ext/date_time.rb +7 -0
- data/lib/active_support/core_ext/digest/uuid.rb +76 -0
- data/lib/active_support/core_ext/digest.rb +3 -0
- data/lib/active_support/core_ext/enumerable.rb +267 -0
- data/lib/active_support/core_ext/erb/util.rb +201 -0
- data/lib/active_support/core_ext/file/atomic.rb +72 -0
- data/lib/active_support/core_ext/file.rb +3 -0
- data/lib/active_support/core_ext/hash/conversions.rb +262 -0
- data/lib/active_support/core_ext/hash/deep_merge.rb +42 -0
- data/lib/active_support/core_ext/hash/deep_transform_values.rb +46 -0
- data/lib/active_support/core_ext/hash/except.rb +12 -0
- data/lib/active_support/core_ext/hash/indifferent_access.rb +24 -0
- data/lib/active_support/core_ext/hash/keys.rb +143 -0
- data/lib/active_support/core_ext/hash/reverse_merge.rb +25 -0
- data/lib/active_support/core_ext/hash/slice.rb +27 -0
- data/lib/active_support/core_ext/hash.rb +10 -0
- data/lib/active_support/core_ext/integer/inflections.rb +31 -0
- data/lib/active_support/core_ext/integer/multiple.rb +12 -0
- data/lib/active_support/core_ext/integer/time.rb +22 -0
- data/lib/active_support/core_ext/integer.rb +5 -0
- data/lib/active_support/core_ext/kernel/concern.rb +14 -0
- data/lib/active_support/core_ext/kernel/reporting.rb +45 -0
- data/lib/active_support/core_ext/kernel/singleton_class.rb +8 -0
- data/lib/active_support/core_ext/kernel.rb +5 -0
- data/lib/active_support/core_ext/load_error.rb +9 -0
- data/lib/active_support/core_ext/module/aliasing.rb +31 -0
- data/lib/active_support/core_ext/module/anonymous.rb +30 -0
- data/lib/active_support/core_ext/module/attr_internal.rb +49 -0
- data/lib/active_support/core_ext/module/attribute_accessors.rb +214 -0
- data/lib/active_support/core_ext/module/attribute_accessors_per_thread.rb +175 -0
- data/lib/active_support/core_ext/module/concerning.rb +140 -0
- data/lib/active_support/core_ext/module/delegation.rb +225 -0
- data/lib/active_support/core_ext/module/deprecation.rb +25 -0
- data/lib/active_support/core_ext/module/introspection.rb +62 -0
- data/lib/active_support/core_ext/module/redefine_method.rb +40 -0
- data/lib/active_support/core_ext/module/remove_method.rb +17 -0
- data/lib/active_support/core_ext/module.rb +13 -0
- data/lib/active_support/core_ext/name_error.rb +59 -0
- data/lib/active_support/core_ext/numeric/bytes.rb +75 -0
- data/lib/active_support/core_ext/numeric/conversions.rb +145 -0
- data/lib/active_support/core_ext/numeric/time.rb +66 -0
- data/lib/active_support/core_ext/numeric.rb +5 -0
- data/lib/active_support/core_ext/object/acts_like.rb +45 -0
- data/lib/active_support/core_ext/object/blank.rb +199 -0
- data/lib/active_support/core_ext/object/conversions.rb +6 -0
- data/lib/active_support/core_ext/object/deep_dup.rb +71 -0
- data/lib/active_support/core_ext/object/duplicable.rb +69 -0
- data/lib/active_support/core_ext/object/inclusion.rb +37 -0
- data/lib/active_support/core_ext/object/instance_variables.rb +32 -0
- data/lib/active_support/core_ext/object/json.rb +260 -0
- data/lib/active_support/core_ext/object/to_param.rb +3 -0
- data/lib/active_support/core_ext/object/to_query.rb +87 -0
- data/lib/active_support/core_ext/object/try.rb +158 -0
- data/lib/active_support/core_ext/object/with.rb +46 -0
- data/lib/active_support/core_ext/object/with_options.rb +101 -0
- data/lib/active_support/core_ext/object.rb +17 -0
- data/lib/active_support/core_ext/pathname/blank.rb +20 -0
- data/lib/active_support/core_ext/pathname/existence.rb +23 -0
- data/lib/active_support/core_ext/pathname.rb +4 -0
- data/lib/active_support/core_ext/range/compare_range.rb +57 -0
- data/lib/active_support/core_ext/range/conversions.rb +62 -0
- data/lib/active_support/core_ext/range/each.rb +24 -0
- data/lib/active_support/core_ext/range/overlap.rb +40 -0
- data/lib/active_support/core_ext/range.rb +6 -0
- data/lib/active_support/core_ext/regexp.rb +14 -0
- data/lib/active_support/core_ext/securerandom.rb +41 -0
- data/lib/active_support/core_ext/string/access.rb +95 -0
- data/lib/active_support/core_ext/string/behavior.rb +8 -0
- data/lib/active_support/core_ext/string/conversions.rb +60 -0
- data/lib/active_support/core_ext/string/exclude.rb +13 -0
- data/lib/active_support/core_ext/string/filters.rb +151 -0
- data/lib/active_support/core_ext/string/indent.rb +45 -0
- data/lib/active_support/core_ext/string/inflections.rb +300 -0
- data/lib/active_support/core_ext/string/inquiry.rb +16 -0
- data/lib/active_support/core_ext/string/multibyte.rb +58 -0
- data/lib/active_support/core_ext/string/output_safety.rb +228 -0
- data/lib/active_support/core_ext/string/starts_ends_with.rb +6 -0
- data/lib/active_support/core_ext/string/strip.rb +27 -0
- data/lib/active_support/core_ext/string/zones.rb +16 -0
- data/lib/active_support/core_ext/string.rb +15 -0
- data/lib/active_support/core_ext/symbol/starts_ends_with.rb +6 -0
- data/lib/active_support/core_ext/symbol.rb +3 -0
- data/lib/active_support/core_ext/thread/backtrace/location.rb +12 -0
- data/lib/active_support/core_ext/time/acts_like.rb +10 -0
- data/lib/active_support/core_ext/time/calculations.rb +386 -0
- data/lib/active_support/core_ext/time/compatibility.rb +32 -0
- data/lib/active_support/core_ext/time/conversions.rb +75 -0
- data/lib/active_support/core_ext/time/zones.rb +97 -0
- data/lib/active_support/core_ext/time.rb +7 -0
- data/lib/active_support/core_ext.rb +5 -0
- data/lib/active_support/current_attributes/test_helper.rb +13 -0
- data/lib/active_support/current_attributes.rb +233 -0
- data/lib/active_support/deep_mergeable.rb +53 -0
- data/lib/active_support/delegation.rb +202 -0
- data/lib/active_support/dependencies/autoload.rb +72 -0
- data/lib/active_support/dependencies/interlock.rb +49 -0
- data/lib/active_support/dependencies/require_dependency.rb +28 -0
- data/lib/active_support/dependencies.rb +98 -0
- data/lib/active_support/deprecation/behaviors.rb +148 -0
- data/lib/active_support/deprecation/constant_accessor.rb +74 -0
- data/lib/active_support/deprecation/deprecators.rb +104 -0
- data/lib/active_support/deprecation/disallowed.rb +54 -0
- data/lib/active_support/deprecation/method_wrappers.rb +68 -0
- data/lib/active_support/deprecation/proxy_wrappers.rb +189 -0
- data/lib/active_support/deprecation/reporting.rb +179 -0
- data/lib/active_support/deprecation.rb +81 -0
- data/lib/active_support/deprecator.rb +7 -0
- data/lib/active_support/descendants_tracker.rb +112 -0
- data/lib/active_support/digest.rb +22 -0
- data/lib/active_support/duration/iso8601_parser.rb +123 -0
- data/lib/active_support/duration/iso8601_serializer.rb +64 -0
- data/lib/active_support/duration.rb +520 -0
- data/lib/active_support/encrypted_configuration.rb +126 -0
- data/lib/active_support/encrypted_file.rb +133 -0
- data/lib/active_support/environment_inquirer.rb +40 -0
- data/lib/active_support/error_reporter/test_helper.rb +15 -0
- data/lib/active_support/error_reporter.rb +265 -0
- data/lib/active_support/evented_file_update_checker.rb +182 -0
- data/lib/active_support/execution_context/test_helper.rb +13 -0
- data/lib/active_support/execution_context.rb +53 -0
- data/lib/active_support/execution_wrapper.rb +150 -0
- data/lib/active_support/executor/test_helper.rb +7 -0
- data/lib/active_support/executor.rb +8 -0
- data/lib/active_support/file_update_checker.rb +164 -0
- data/lib/active_support/fork_tracker.rb +43 -0
- data/lib/active_support/gem_version.rb +17 -0
- data/lib/active_support/gzip.rb +40 -0
- data/lib/active_support/hash_with_indifferent_access.rb +445 -0
- data/lib/active_support/html_safe_translation.rb +56 -0
- data/lib/active_support/i18n.rb +17 -0
- data/lib/active_support/i18n_railtie.rb +138 -0
- data/lib/active_support/inflections.rb +72 -0
- data/lib/active_support/inflector/inflections.rb +273 -0
- data/lib/active_support/inflector/methods.rb +387 -0
- data/lib/active_support/inflector/transliterate.rb +149 -0
- data/lib/active_support/inflector.rb +9 -0
- data/lib/active_support/isolated_execution_state.rb +75 -0
- data/lib/active_support/json/decoding.rb +76 -0
- data/lib/active_support/json/encoding.rb +120 -0
- data/lib/active_support/json.rb +4 -0
- data/lib/active_support/key_generator.rb +66 -0
- data/lib/active_support/lazy_load_hooks.rb +107 -0
- data/lib/active_support/locale/en.rb +33 -0
- data/lib/active_support/locale/en.yml +141 -0
- data/lib/active_support/log_subscriber/test_helper.rb +106 -0
- data/lib/active_support/log_subscriber.rb +192 -0
- data/lib/active_support/logger.rb +55 -0
- data/lib/active_support/logger_silence.rb +21 -0
- data/lib/active_support/logger_thread_safe_level.rb +47 -0
- data/lib/active_support/message_encryptor.rb +374 -0
- data/lib/active_support/message_encryptors.rb +141 -0
- data/lib/active_support/message_pack/cache_serializer.rb +23 -0
- data/lib/active_support/message_pack/extensions.rb +305 -0
- data/lib/active_support/message_pack/serializer.rb +63 -0
- data/lib/active_support/message_pack.rb +50 -0
- data/lib/active_support/message_verifier.rb +368 -0
- data/lib/active_support/message_verifiers.rb +135 -0
- data/lib/active_support/messages/codec.rb +65 -0
- data/lib/active_support/messages/metadata.rb +146 -0
- data/lib/active_support/messages/rotation_configuration.rb +23 -0
- data/lib/active_support/messages/rotation_coordinator.rb +93 -0
- data/lib/active_support/messages/rotator.rb +59 -0
- data/lib/active_support/messages/serializer_with_fallback.rb +158 -0
- data/lib/active_support/multibyte/chars.rb +178 -0
- data/lib/active_support/multibyte/unicode.rb +42 -0
- data/lib/active_support/multibyte.rb +23 -0
- data/lib/active_support/notifications/fanout.rb +446 -0
- data/lib/active_support/notifications/instrumenter.rb +240 -0
- data/lib/active_support/notifications.rb +281 -0
- data/lib/active_support/number_helper/number_converter.rb +190 -0
- data/lib/active_support/number_helper/number_to_currency_converter.rb +46 -0
- data/lib/active_support/number_helper/number_to_delimited_converter.rb +30 -0
- data/lib/active_support/number_helper/number_to_human_converter.rb +69 -0
- data/lib/active_support/number_helper/number_to_human_size_converter.rb +60 -0
- data/lib/active_support/number_helper/number_to_percentage_converter.rb +16 -0
- data/lib/active_support/number_helper/number_to_phone_converter.rb +60 -0
- data/lib/active_support/number_helper/number_to_rounded_converter.rb +59 -0
- data/lib/active_support/number_helper/rounding_helper.rb +46 -0
- data/lib/active_support/number_helper.rb +479 -0
- data/lib/active_support/option_merger.rb +38 -0
- data/lib/active_support/ordered_hash.rb +50 -0
- data/lib/active_support/ordered_options.rb +147 -0
- data/lib/active_support/parameter_filter.rb +157 -0
- data/lib/active_support/proxy_object.rb +20 -0
- data/lib/active_support/rails.rb +26 -0
- data/lib/active_support/railtie.rb +161 -0
- data/lib/active_support/reloader.rb +138 -0
- data/lib/active_support/rescuable.rb +176 -0
- data/lib/active_support/secure_compare_rotator.rb +58 -0
- data/lib/active_support/security_utils.rb +38 -0
- data/lib/active_support/string_inquirer.rb +35 -0
- data/lib/active_support/subscriber.rb +146 -0
- data/lib/active_support/syntax_error_proxy.rb +60 -0
- data/lib/active_support/tagged_logging.rb +152 -0
- data/lib/active_support/test_case.rb +304 -0
- data/lib/active_support/testing/assertions.rb +332 -0
- data/lib/active_support/testing/autorun.rb +5 -0
- data/lib/active_support/testing/constant_lookup.rb +51 -0
- data/lib/active_support/testing/constant_stubbing.rb +54 -0
- data/lib/active_support/testing/declarative.rb +28 -0
- data/lib/active_support/testing/deprecation.rb +82 -0
- data/lib/active_support/testing/error_reporter_assertions.rb +107 -0
- data/lib/active_support/testing/file_fixtures.rb +38 -0
- data/lib/active_support/testing/isolation.rb +121 -0
- data/lib/active_support/testing/method_call_assertions.rb +69 -0
- data/lib/active_support/testing/parallelization/server.rb +85 -0
- data/lib/active_support/testing/parallelization/worker.rb +103 -0
- data/lib/active_support/testing/parallelization.rb +55 -0
- data/lib/active_support/testing/parallelize_executor.rb +81 -0
- data/lib/active_support/testing/setup_and_teardown.rb +57 -0
- data/lib/active_support/testing/stream.rb +41 -0
- data/lib/active_support/testing/strict_warnings.rb +43 -0
- data/lib/active_support/testing/tagged_logging.rb +27 -0
- data/lib/active_support/testing/tests_without_assertions.rb +19 -0
- data/lib/active_support/testing/time_helpers.rb +269 -0
- data/lib/active_support/time.rb +20 -0
- data/lib/active_support/time_with_zone.rb +609 -0
- data/lib/active_support/values/time_zone.rb +614 -0
- data/lib/active_support/version.rb +10 -0
- data/lib/active_support/xml_mini/jdom.rb +175 -0
- data/lib/active_support/xml_mini/libxml.rb +80 -0
- data/lib/active_support/xml_mini/libxmlsax.rb +83 -0
- data/lib/active_support/xml_mini/nokogiri.rb +83 -0
- data/lib/active_support/xml_mini/nokogirisax.rb +86 -0
- data/lib/active_support/xml_mini/rexml.rb +137 -0
- data/lib/active_support/xml_mini.rb +211 -0
- data/lib/active_support.rb +144 -0
- 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: '£', separator: ',', delimiter: '')
|
41
|
+
# # => "£1234567890,50"
|
42
|
+
# 1234567890.50.to_fs(:currency, unit: '£', separator: ',', delimiter: '', format: '%n %u')
|
43
|
+
# # => "1234567890,50 £"
|
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
|