comparison 0.1.100 → 0.2.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +34 -33
- data/app/helpers/comparison/application_helper.rb +3 -6
- data/config/locales/en.yml +5 -5
- data/lib/comparison/comparator.rb +36 -20
- data/lib/comparison/engine.rb +0 -4
- data/lib/comparison/presenter.rb +62 -64
- data/lib/comparison/version.rb +1 -1
- metadata +20 -6
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: b1789756840509d6bfc178a7fce308b15e8097b8321362f36d2ceba7970862c0
|
4
|
+
data.tar.gz: cfd348911fee4ae30d3857985017d290dadb3f89af2e826b086b84a0c46c180e
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: ce42dd5c8370367bdca1c66fa40277515b80c352c6db76222b4f0d5a9f8e40581a56d04396075802f86bbd4a41043167c719bb4d9406272e9d0ddd67792e43d9
|
7
|
+
data.tar.gz: f1d697351b7f16e05fc3b5394c5f22c70fac9f5e6db17cf5898cdd4adef82ecb8e4d83b3bbfd5fac113daa2f558f8ce83d3e5417b29c288d8c821cb4da325d70
|
data/README.md
CHANGED
@@ -1,4 +1,4 @@
|
|
1
|
-
# [![Gem Version](https://badge.fury.io/rb/comparison.svg)](https://badge.fury.io/rb/comparison)
|
1
|
+
# [![Gem Version](https://badge.fury.io/rb/comparison.svg)](https://badge.fury.io/rb/comparison)
|
2
2
|
|
3
3
|
# Comparison
|
4
4
|
|
@@ -10,46 +10,36 @@ color-coded to indicate positive or negative growth. This plugin provides
|
|
10
10
|
helpers that abstract the logic of deciding what to show into a handful of
|
11
11
|
simple methods and leveraging I18n.
|
12
12
|
|
13
|
-
## Upgrade Notes
|
14
|
-
|
15
|
-
This gem has been getting a facelift, and this has resulted in some changes
|
16
|
-
from the old behavior.
|
17
|
-
|
18
|
-
`Comparison::Presenter#classes` has been renamed to
|
19
|
-
`Comparison::Presenter#dom_classes`, and `Comparison::Presenter#css` has been
|
20
|
-
renamed to `Comparison::Presenter#style`. The old method names continue to
|
21
|
-
work, but they will emit deprecation warnings.
|
22
|
-
|
23
|
-
The I18n keys used by the above methods have been similarly renamed, but the
|
24
|
-
methods will continue to fall back on the old keys. Going forward, use
|
25
|
-
`comparison.dom_classes` instead of `comparison.classes` and `comparison.style`
|
26
|
-
instead of `comparison.css`.
|
27
|
-
|
28
13
|
## Usage
|
29
14
|
|
30
|
-
The library has three components: the
|
31
|
-
actual math, the Presenter class for decorating the
|
32
|
-
view-friendly output, and a helper module for using the
|
15
|
+
The library has three components: the `Comparator` class for performing the
|
16
|
+
actual math, the `Presenter` class for decorating the comparator with
|
17
|
+
view-friendly output, and a helper module for using the presenter with the
|
33
18
|
view.
|
34
19
|
|
35
|
-
`#compare` helper takes the two numbers to be compared and yields the
|
36
|
-
|
20
|
+
The `#compare` helper takes the two numbers to be compared and yields the
|
21
|
+
presenter to a block.
|
37
22
|
|
38
|
-
`#
|
39
|
-
literally `
|
23
|
+
`#difference_as_currency` provides the difference between the two numbers,
|
24
|
+
literally `value - other`, formatted as currency. Formatting is handled by
|
25
|
+
`ActiveSupport::NumberHelper#number_to_currency`.
|
40
26
|
|
41
27
|
`#percentage` provides the percentage difference between the two numbers. Under
|
42
|
-
the hood it uses `
|
43
|
-
|
28
|
+
the hood it uses `ActiveSupport#NumberHelper#number_to_percentage` to format
|
29
|
+
the percentage. Options are passed through to that method.
|
30
|
+
|
31
|
+
`#unsigned_percentage` returns the absolute value of the percentage. Use this
|
32
|
+
if you prefer to use other cues, such as colors or icons, to indicate positive
|
33
|
+
or negative changes.
|
44
34
|
|
45
35
|
`#arrow` returns an HTML character entity for an arrow (up, down, or, for no
|
46
36
|
change, an empty string).
|
47
37
|
|
48
38
|
```erb
|
49
|
-
<%= compare
|
50
|
-
<td><%= number_to_currency
|
51
|
-
<td><%= number_to_currency
|
52
|
-
<td><%= cmp.
|
39
|
+
<%= compare value, other do |cmp| %>
|
40
|
+
<td><%= number_to_currency value %></td>
|
41
|
+
<td><%= number_to_currency other %></td>
|
42
|
+
<td><%= cmp.difference_as_currency %></td>
|
53
43
|
<td>
|
54
44
|
<%= cmp.arrow %>
|
55
45
|
<%= cmp.percentage precision: 1 %>
|
@@ -80,7 +70,7 @@ en:
|
|
80
70
|
positive: 'comparison positive'
|
81
71
|
negative: 'comparison negative'
|
82
72
|
nochange: 'comparison nochange'
|
83
|
-
|
73
|
+
inline_style:
|
84
74
|
positive: 'color: #3c763d; background-color: #dff0d8;'
|
85
75
|
negative: 'color: #a94442; background-color: #f2dede;'
|
86
76
|
nochange: 'color: #777777;'
|
@@ -92,8 +82,14 @@ en:
|
|
92
82
|
positive_html: '↑'
|
93
83
|
negative_html: '↓'
|
94
84
|
nochange_html: ''
|
85
|
+
infinity_html: '∞'
|
95
86
|
```
|
96
87
|
|
88
|
+
If the `dom_classes` keys are not present, translation falls back on `classes`.
|
89
|
+
If the `inline_style` keys are not present, translation falls back on `style`
|
90
|
+
and `css`. In both cases, those fallback keys are deprecated. Expect support
|
91
|
+
for those keys to eventually be dropped.
|
92
|
+
|
97
93
|
## Installation
|
98
94
|
|
99
95
|
Add this line to your application's Gemfile:
|
@@ -107,9 +103,14 @@ And then execute:
|
|
107
103
|
$ bundle
|
108
104
|
```
|
109
105
|
|
110
|
-
|
111
|
-
|
112
|
-
|
106
|
+
Include the Comparison helpers by adding the following to your
|
107
|
+
application\_helper.rb:
|
108
|
+
|
109
|
+
```ruby
|
110
|
+
# app/helpers/application_helper.rb
|
111
|
+
module ApplicationHelper
|
112
|
+
include Comparison::ApplicationHelper
|
113
|
+
end
|
113
114
|
```
|
114
115
|
|
115
116
|
## Contributing
|
@@ -3,16 +3,13 @@
|
|
3
3
|
module Comparison
|
4
4
|
module ApplicationHelper # :nodoc:
|
5
5
|
##
|
6
|
-
# Returns a Presenter for a Comparator for +
|
6
|
+
# Returns a Presenter for a Comparator for +value+ and +other+.
|
7
7
|
#
|
8
8
|
# If a block is given, the Presenter is yielded to the block.
|
9
|
-
|
10
|
-
|
11
|
-
def compare(m, n)
|
12
|
-
comparison = Presenter.new Comparator.new m, n
|
9
|
+
def compare(value, other)
|
10
|
+
comparison = Presenter.new Comparator.new value, other
|
13
11
|
yield comparison if block_given?
|
14
12
|
comparison
|
15
13
|
end
|
16
|
-
# rubocop:enable Naming/UncommunicativeMethodParamName
|
17
14
|
end
|
18
15
|
end
|
data/config/locales/en.yml
CHANGED
@@ -1,6 +1,6 @@
|
|
1
1
|
en:
|
2
2
|
comparison:
|
3
|
-
#
|
3
|
+
# dom_classes:
|
4
4
|
# positive: 'comparison positive'
|
5
5
|
# negative: 'comparison negative'
|
6
6
|
# nochange: 'comparison nochange'
|
@@ -10,10 +10,10 @@ en:
|
|
10
10
|
# negative_html: '<span class="glyphicon glyphicon-arrow-down"></span>'
|
11
11
|
# nochange_html: '<span class="glyphicon glyphicon-minus"></span>'
|
12
12
|
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
13
|
+
inline_style:
|
14
|
+
positive: ''
|
15
|
+
negative: ''
|
16
|
+
nochange: ''
|
17
17
|
|
18
18
|
arrows:
|
19
19
|
positive_html: '↑'
|
@@ -10,40 +10,56 @@ module Comparison
|
|
10
10
|
class Comparator
|
11
11
|
extend Forwardable
|
12
12
|
|
13
|
+
attr_reader :value, :other
|
14
|
+
|
13
15
|
##
|
14
|
-
# Instantiates a new Comparator to compare two numbers, +
|
16
|
+
# Instantiates a new Comparator to compare two numbers, +value+ and +other+.
|
15
17
|
#
|
16
18
|
# Both numbers will be converted to instances of `BigDecimal`.
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
@m = m.to_d
|
21
|
-
@n = n.to_d
|
19
|
+
def initialize(value, other)
|
20
|
+
@value = value.to_d
|
21
|
+
@other = other.to_d
|
22
22
|
end
|
23
|
-
# rubocop:enable Naming/UncommunicativeMethodParamName
|
24
|
-
|
25
|
-
attr_reader :m, :n
|
26
23
|
|
27
|
-
delegate %i[
|
24
|
+
delegate %i[negative? positive? zero? nonzero?] => :difference
|
25
|
+
delegate %i[infinite? nan?] => :change
|
28
26
|
|
29
27
|
##
|
30
|
-
# Returns the difference between +@
|
28
|
+
# Returns the difference between +@value+ and +@other+.
|
29
|
+
def difference
|
30
|
+
value - other
|
31
|
+
end
|
32
|
+
|
31
33
|
def absolute
|
32
|
-
|
34
|
+
Kernel.warn "DEPRECATION WARNING: use #difference instead of #absolute (called from #{caller(1..1).first})"
|
35
|
+
difference
|
33
36
|
end
|
34
37
|
|
35
|
-
|
38
|
+
##
|
39
|
+
# Returns the relative change of +@value+ from +@other+.
|
40
|
+
def change
|
41
|
+
difference / other.abs
|
42
|
+
end
|
36
43
|
|
37
44
|
##
|
38
|
-
# Returns the
|
45
|
+
# Returns the relative change of +@value+ from +@other+ as a percentage.
|
46
|
+
def percentage
|
47
|
+
change * 100
|
48
|
+
end
|
49
|
+
|
39
50
|
def relative
|
40
|
-
|
41
|
-
|
42
|
-
else
|
43
|
-
(m / n - 1) * 100
|
44
|
-
end
|
51
|
+
Kernel.warn "DEPRECATION WARNING: use #percentage instead of #relative (called from #{caller(1..1).first})"
|
52
|
+
change
|
45
53
|
end
|
46
54
|
|
47
|
-
|
55
|
+
def m
|
56
|
+
Kernel.warn "DEPRECATION WARNING: use #value instead of #m (called from #{caller(1..1).first})"
|
57
|
+
value
|
58
|
+
end
|
59
|
+
|
60
|
+
def n
|
61
|
+
Kernel.warn "DEPRECATION WARNING: use #other instead of #n (called from #{caller(1..1).first})"
|
62
|
+
other
|
63
|
+
end
|
48
64
|
end
|
49
65
|
end
|
data/lib/comparison/engine.rb
CHANGED
data/lib/comparison/presenter.rb
CHANGED
@@ -9,39 +9,62 @@ module Comparison
|
|
9
9
|
class Presenter < DelegateClass(Comparator)
|
10
10
|
include ActionView::Helpers::TranslationHelper
|
11
11
|
|
12
|
-
ARROWS = {
|
13
|
-
|
14
|
-
# TODO: This shouldn't necessarily return a currency representation.
|
12
|
+
ARROWS = { positive: '↑', negative: '↓', nochange: '' }.freeze
|
15
13
|
|
16
14
|
##
|
17
|
-
# Returns Comparator#
|
18
|
-
def
|
15
|
+
# Returns Comparator#difference formatted as currency.
|
16
|
+
def difference_as_currency(**options)
|
19
17
|
if positive?
|
20
|
-
number_to_currency
|
18
|
+
number_to_currency __getobj__.difference, format: '+%u%n', **options
|
21
19
|
else
|
22
|
-
number_to_currency
|
20
|
+
number_to_currency __getobj__.difference, **options
|
23
21
|
end
|
24
22
|
end
|
25
23
|
|
26
24
|
##
|
27
|
-
#
|
25
|
+
# Deprecated alias for `#difference_as_currency`.
|
26
|
+
#
|
27
|
+
# In a future release, this method will be changed to delegate directly
|
28
|
+
# `Comparator#difference`.
|
29
|
+
def difference(...)
|
30
|
+
Kernel.warn 'DEPRECATION WARNING: use #difference_as_currency instead of #difference' \
|
31
|
+
" (called from #{caller(3..3).first})"
|
32
|
+
difference_as_currency(...)
|
33
|
+
end
|
34
|
+
|
35
|
+
##
|
36
|
+
# Returns Comparator#change formatted as a percentage.
|
37
|
+
#
|
38
|
+
# If the change evaluates to Infinity or -Infinity, the I18n translaation
|
39
|
+
# for infinity is returned. If no translation is defined, `nil` is
|
40
|
+
# returned.
|
28
41
|
#
|
29
|
-
# If the
|
30
|
-
# returned. If it evaluates to NaN, 0 is returned.
|
42
|
+
# If the change evaluates to NaN, it is returned as 0.
|
31
43
|
def percentage(**options)
|
32
44
|
if nan? || zero?
|
33
45
|
number_to_percentage 0, **options
|
34
46
|
elsif infinite?
|
35
|
-
|
36
|
-
nil
|
47
|
+
t 'comparison.infinity_html', default: nil
|
37
48
|
elsif positive?
|
38
|
-
number_to_percentage
|
49
|
+
number_to_percentage __getobj__.percentage, format: '+%n%', **options
|
39
50
|
else
|
40
|
-
number_to_percentage
|
51
|
+
number_to_percentage __getobj__.percentage, **options
|
41
52
|
end
|
42
53
|
end
|
43
54
|
|
44
|
-
|
55
|
+
##
|
56
|
+
# Returns the absolute value of Comparator#change formatted as a percentage.
|
57
|
+
#
|
58
|
+
# See `#percentage` for additional information on special return scenarios.
|
59
|
+
#
|
60
|
+
# Use this if you are relying on other cues (colors and/or icons) to
|
61
|
+
# indicate positive or negative values.
|
62
|
+
def unsigned_percentage(**options)
|
63
|
+
return percentage(**options) if nan? || infinite?
|
64
|
+
|
65
|
+
number_to_percentage __getobj__.percentage.abs, **options
|
66
|
+
end
|
67
|
+
|
45
68
|
##
|
46
69
|
# Returns the I18n translation for `comparison.icons`. (See also #arrow.)
|
47
70
|
#
|
@@ -62,15 +85,9 @@ module Comparison
|
|
62
85
|
# negative_html: '<span class="glyphicon glyphicon-arrow-down"></span>'
|
63
86
|
# nochange_html: '<span class="glyphicon glyphicon-minus"></span>'
|
64
87
|
#
|
65
|
-
# rubocop:enable Metrics/LineLength
|
66
88
|
def icon
|
67
|
-
|
68
|
-
|
69
|
-
elsif negative?
|
70
|
-
t 'comparison.icons.negative_html'
|
71
|
-
else
|
72
|
-
t 'comparison.icons.nochange_html'
|
73
|
-
end
|
89
|
+
key, = expand_i18n_keys 'icons', suffix: '_html'
|
90
|
+
t key
|
74
91
|
end
|
75
92
|
|
76
93
|
##
|
@@ -104,13 +121,8 @@ module Comparison
|
|
104
121
|
# #icons is meant to be used from full-featured view contexts. As such,
|
105
122
|
# #icons is the one to use to generate HTML tags.
|
106
123
|
def arrow
|
107
|
-
|
108
|
-
|
109
|
-
elsif negative?
|
110
|
-
t 'comparison.arrows.negative_html', default: ARROWS[:down]
|
111
|
-
else
|
112
|
-
t 'comparison.arrows.nochange_html', default: ARROWS[:none]
|
113
|
-
end
|
124
|
+
key, = expand_i18n_keys 'arrows', suffix: '_html'
|
125
|
+
t key, default: ARROWS[description.to_sym]
|
114
126
|
end
|
115
127
|
|
116
128
|
##
|
@@ -142,27 +154,17 @@ module Comparison
|
|
142
154
|
# # => "<span class=\"comparison positive\">+10%</span>"
|
143
155
|
#
|
144
156
|
# If you need to work with inline styles instead of CSS classes, see the
|
145
|
-
# `#
|
157
|
+
# `#inline_style` method.
|
146
158
|
def dom_classes
|
147
|
-
|
148
|
-
|
149
|
-
default: %i[comparison.classes.positive]
|
150
|
-
elsif negative?
|
151
|
-
t 'comparison.dom_classes.negative',
|
152
|
-
default: %i[comparison.classes.negative]
|
153
|
-
else
|
154
|
-
t 'comparison.dom_classes.nochange',
|
155
|
-
default: %i[comparison.classes.nochange]
|
156
|
-
end
|
159
|
+
key, *deprecated_keys = expand_i18n_keys(%w[dom_classes classes])
|
160
|
+
t key, default: deprecated_keys
|
157
161
|
end
|
158
162
|
|
159
163
|
def classes
|
160
|
-
Kernel.warn
|
161
|
-
"use #dom_classes instead: #{caller(3..3).first}"
|
164
|
+
Kernel.warn "DEPRECATION WARNING: use #dom_classes instead of #classes (called from #{caller(3..3).first})"
|
162
165
|
dom_classes
|
163
166
|
end
|
164
167
|
|
165
|
-
# rubocop:disable Metrics/LineLength
|
166
168
|
##
|
167
169
|
# Returns the I18n translation for `comparison.style`.
|
168
170
|
#
|
@@ -171,30 +173,28 @@ module Comparison
|
|
171
173
|
#
|
172
174
|
# en:
|
173
175
|
# comparison:
|
174
|
-
#
|
176
|
+
# inline_style:
|
175
177
|
# positive: 'color: #3c763d; background-color: #dff0d8;'
|
176
178
|
# negative: 'color: #a94442; background-color: #f2dede;'
|
177
179
|
# nochange: 'color: #777777;'
|
178
180
|
#
|
179
|
-
# content_tag :span, cmp.difference, style: cmp.
|
181
|
+
# content_tag :span, cmp.difference, style: cmp.inline_style
|
180
182
|
# # => "<span style=\"color: #3c763d; background-color: #dff0d8;\">+10%</span>"
|
181
183
|
#
|
182
184
|
# In general, it's probably preferable to use `#dom_classes` in conjunction
|
183
185
|
# with CSS style rules defined separate CSS files, but this isn't always
|
184
186
|
# possible.
|
185
187
|
#
|
186
|
-
|
187
|
-
|
188
|
-
|
189
|
-
|
190
|
-
|
191
|
-
|
192
|
-
|
193
|
-
|
194
|
-
|
195
|
-
|
196
|
-
default: [:'comparison.css.nochange', '']
|
197
|
-
end
|
188
|
+
def inline_style
|
189
|
+
key, *deprecated_keys = expand_i18n_keys(%w[inline_style style css])
|
190
|
+
t key, default: [*deprecated_keys, '']
|
191
|
+
end
|
192
|
+
|
193
|
+
alias style inline_style
|
194
|
+
|
195
|
+
def css
|
196
|
+
Kernel.warn "DEPRECATION WARNING: use #inline_style instead of #css (called from #{caller(3..3).first})"
|
197
|
+
inline_style
|
198
198
|
end
|
199
199
|
|
200
200
|
##
|
@@ -210,12 +210,6 @@ module Comparison
|
|
210
210
|
end
|
211
211
|
end
|
212
212
|
|
213
|
-
def css
|
214
|
-
Kernel.warn '[DEPRECATION WARNING] #css is deprecated: ' \
|
215
|
-
"use #style instead: #{caller(3..3).first}"
|
216
|
-
style
|
217
|
-
end
|
218
|
-
|
219
213
|
private
|
220
214
|
|
221
215
|
def number_to_percentage(value, **options)
|
@@ -226,5 +220,9 @@ module Comparison
|
|
226
220
|
def number_to_currency(*args)
|
227
221
|
ActiveSupport::NumberHelper.number_to_currency(*args)
|
228
222
|
end
|
223
|
+
|
224
|
+
def expand_i18n_keys(names, suffix: nil)
|
225
|
+
Array(names).map { |name| :"comparison.#{name}.#{description}#{suffix}" }
|
226
|
+
end
|
229
227
|
end
|
230
228
|
end
|
data/lib/comparison/version.rb
CHANGED
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: comparison
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.2.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- John Parker
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2022-05-01 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: rails
|
@@ -19,7 +19,7 @@ dependencies:
|
|
19
19
|
version: '4.0'
|
20
20
|
- - "<"
|
21
21
|
- !ruby/object:Gem::Version
|
22
|
-
version: '
|
22
|
+
version: '7.0'
|
23
23
|
type: :runtime
|
24
24
|
prerelease: false
|
25
25
|
version_requirements: !ruby/object:Gem::Requirement
|
@@ -29,7 +29,7 @@ dependencies:
|
|
29
29
|
version: '4.0'
|
30
30
|
- - "<"
|
31
31
|
- !ruby/object:Gem::Version
|
32
|
-
version: '
|
32
|
+
version: '7.0'
|
33
33
|
- !ruby/object:Gem::Dependency
|
34
34
|
name: minitest-focus
|
35
35
|
requirement: !ruby/object:Gem::Requirement
|
@@ -44,6 +44,20 @@ dependencies:
|
|
44
44
|
- - ">="
|
45
45
|
- !ruby/object:Gem::Version
|
46
46
|
version: '0'
|
47
|
+
- !ruby/object:Gem::Dependency
|
48
|
+
name: mocha
|
49
|
+
requirement: !ruby/object:Gem::Requirement
|
50
|
+
requirements:
|
51
|
+
- - ">="
|
52
|
+
- !ruby/object:Gem::Version
|
53
|
+
version: '0'
|
54
|
+
type: :development
|
55
|
+
prerelease: false
|
56
|
+
version_requirements: !ruby/object:Gem::Requirement
|
57
|
+
requirements:
|
58
|
+
- - ">="
|
59
|
+
- !ruby/object:Gem::Version
|
60
|
+
version: '0'
|
47
61
|
- !ruby/object:Gem::Dependency
|
48
62
|
name: pry
|
49
63
|
requirement: !ruby/object:Gem::Requirement
|
@@ -101,14 +115,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
101
115
|
requirements:
|
102
116
|
- - ">="
|
103
117
|
- !ruby/object:Gem::Version
|
104
|
-
version: '2.
|
118
|
+
version: '2.7'
|
105
119
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
106
120
|
requirements:
|
107
121
|
- - ">="
|
108
122
|
- !ruby/object:Gem::Version
|
109
123
|
version: '0'
|
110
124
|
requirements: []
|
111
|
-
rubygems_version: 3.
|
125
|
+
rubygems_version: 3.3.12
|
112
126
|
signing_key:
|
113
127
|
specification_version: 4
|
114
128
|
summary: Helpers for displaying details of comparing two numbers.
|