tracking_number 0.10.5 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. checksums.yaml +5 -5
  2. data/.github/FUNDING.yml +2 -0
  3. data/.github/dependabot.yml +22 -0
  4. data/.github/workflows/release.yml +36 -0
  5. data/.github/workflows/ruby.yml +35 -0
  6. data/.gitmodules +3 -0
  7. data/.tool-versions +1 -0
  8. data/CHANGELOG.md +318 -0
  9. data/Gemfile +4 -2
  10. data/README.md +112 -15
  11. data/Rakefile +4 -1
  12. data/bin/console +14 -0
  13. data/lib/data/couriers/amazon.json +45 -0
  14. data/lib/data/couriers/canadapost.json +33 -0
  15. data/lib/data/couriers/canpar.json +29 -0
  16. data/lib/data/couriers/dhl.json +97 -0
  17. data/lib/data/couriers/dpd.json +345 -0
  18. data/lib/data/couriers/fedex.json +291 -0
  19. data/lib/data/couriers/gofo.json +24 -0
  20. data/lib/data/couriers/landmark.json +26 -0
  21. data/lib/data/couriers/lasership.json +105 -0
  22. data/lib/data/couriers/old_dominion.json +65 -0
  23. data/lib/data/couriers/ontrac.json +74 -0
  24. data/lib/data/couriers/purolator.json +50 -0
  25. data/lib/data/couriers/s10.json +1443 -0
  26. data/lib/data/couriers/speedee.json +26 -0
  27. data/lib/data/couriers/ups.json +197 -0
  28. data/lib/data/couriers/usps.json +272 -0
  29. data/lib/data/couriers/yodel.json +29 -0
  30. data/lib/data/couriers/yunexpress.json +25 -0
  31. data/lib/tracking_number/active_model_validator.rb +1 -1
  32. data/lib/tracking_number/base.rb +291 -22
  33. data/lib/tracking_number/checksum_validations.rb +119 -0
  34. data/lib/tracking_number/info.rb +26 -0
  35. data/lib/tracking_number/loader.rb +82 -0
  36. data/lib/tracking_number/partnership.rb +7 -0
  37. data/lib/tracking_number/unknown.rb +45 -0
  38. data/lib/tracking_number/version.rb +1 -1
  39. data/lib/tracking_number.rb +69 -17
  40. data/package.json +77 -0
  41. data/test/partnership_test.rb +71 -0
  42. data/test/renamed_types_test.rb +44 -0
  43. data/test/test_helper.rb +14 -7
  44. data/test/tracking_number_meta_test.rb +145 -0
  45. data/test/tracking_number_test.rb +191 -0
  46. data/tracking_number.gemspec +53 -22
  47. data/yarn.lock +3425 -0
  48. metadata +131 -46
  49. data/.travis.yml +0 -12
  50. data/VERSION +0 -1
  51. data/lib/tracking_number/dhl.rb +0 -34
  52. data/lib/tracking_number/fedex.rb +0 -156
  53. data/lib/tracking_number/ontrac.rb +0 -34
  54. data/lib/tracking_number/ups.rb +0 -108
  55. data/lib/tracking_number/usps.rb +0 -166
  56. data/test/dhl_tracking_number_test.rb +0 -35
  57. data/test/fedex_tracking_number_test.rb +0 -75
  58. data/test/ontrac_tracking_number_test.rb +0 -24
  59. data/test/ups_tracking_number_test.rb +0 -36
  60. data/test/usps_tracking_number_test.rb +0 -73
@@ -1,166 +0,0 @@
1
- module TrackingNumber
2
- class USPS < Base
3
- def carrier
4
- :usps
5
- end
6
- end
7
-
8
- class USPS91 < USPS
9
- SEARCH_PATTERN = [/(\b(?:420\s*\d{5})?9\s*[1-5]\s*(?:(?:(?:[0-9]\s*){20}\b)|(?:(?:[0-9]\s*){24}\b)))/, /(\b([0-9]\s*){20}\b)/]
10
- VERIFY_PATTERN = /^(?:420\d{5})?(9[1-5](?:[0-9]{19}|[0-9]{23}))([0-9])$/
11
-
12
- # Sometimes these numbers will appear without the leading 91, 93, or 94, though, so we need to account for that case
13
-
14
- def decode
15
- # Application ID: 91, 93, 94 or 95
16
- # Service Code: 2 Digits
17
- # Mailer Id: 8 Digits
18
- # Package Id: 9 Digits
19
- # Checksum: 1 Digit
20
-
21
- base_tracking_number = self.tracking_number.to_s.gsub(/^420\d{5}/, '')
22
-
23
- {:application_id => base_tracking_number.to_s.slice(0...2),
24
- :service_code => base_tracking_number.to_s.slice(2...4),
25
- :mailer_id => base_tracking_number.to_s.slice(4...12),
26
- :package_identifier => base_tracking_number.to_s.slice(12...21),
27
- :check_digit => base_tracking_number.slice(21...22)
28
- }
29
- end
30
-
31
- def matches
32
- if self.tracking_number =~ /^(420\d{5})?9[1-5]/
33
- self.tracking_number.scan(VERIFY_PATTERN).flatten
34
- else
35
- "91#{self.tracking_number}".scan(VERIFY_PATTERN).flatten
36
- end
37
- end
38
-
39
- def valid_checksum?
40
- if self.tracking_number =~ /^(420\d{5})?9[1-5]/
41
- return true if weighted_usps_checksum_valid?(tracking_number)
42
- else
43
- if weighted_usps_checksum_valid?("91#{self.tracking_number}")
44
- # set the tracking number to the 91 format if it passes this test
45
- self.tracking_number = "91#{self.tracking_number}"
46
- return true
47
- end
48
- end
49
- end
50
-
51
- private
52
-
53
- def weighted_usps_checksum_valid?(sequence)
54
- chars = sequence.gsub(/^420\d{5}/, '').chars.to_a
55
- check_digit = chars.pop
56
-
57
- total = 0
58
- chars.reverse.each_with_index do |c, i|
59
- x = c.to_i
60
- x *= 3 if i.even?
61
-
62
- total += x
63
- end
64
-
65
- check = total % 10
66
- check = 10 - check unless (check.zero?)
67
- return true if check == check_digit.to_i
68
- end
69
- end
70
-
71
- class USPS20 < USPS
72
- # http://www.usps.com/cpim/ftp/pubs/pub109.pdf (Publication 109. Extra Services Technical Guide, pg. 19)
73
- # http://www.usps.com/cpim/ftp/pubs/pub91.pdf (Publication 91. Confirmation Services Technical Guide pg. 38)
74
-
75
- SEARCH_PATTERN = /(\b([0-9]\s*){20,20}\b)/
76
- VERIFY_PATTERN = /^([0-9]{2,2})([0-9]{9,9})([0-9]{8,8})([0-9])$/
77
-
78
- def matches
79
- self.tracking_number.scan(VERIFY_PATTERN).flatten
80
- end
81
-
82
- def decode
83
- {:service_code => self.tracking_number.to_s.slice(0...2),
84
- :mailer_id => self.tracking_number.to_s.slice(2...11),
85
- :package_identifier => self.tracking_number.to_s.slice(11...19),
86
- :check_digit => self.tracking_number.slice(19...20)
87
- }
88
- end
89
-
90
- def service_type
91
- case decode[:service_code]
92
- when "71"
93
- "Certified Mail"
94
- when "73"
95
- "Insured Mail"
96
- when "77"
97
- "Registered Mail"
98
- when "81"
99
- "Return Receipt for Merchandise"
100
- end
101
- end
102
-
103
- def valid_checksum?
104
- chars = tracking_number.chars.to_a
105
- check_digit = chars.pop
106
-
107
- total = 0
108
- chars.reverse.each_with_index do |c, i|
109
- x = c.to_i
110
- x *= 3 if i.even?
111
- total += x
112
- end
113
-
114
- check = total % 10
115
- check = 10 - check unless (check.zero?)
116
- return true if check == check_digit.to_i
117
- end
118
- end
119
-
120
- class USPS13 < USPS
121
- SEARCH_PATTERN = /(\b([A-Z]\s*){2,2}([0-9]\s*){9,9}([A-Z]\s*){2,2}\b)/
122
- VERIFY_PATTERN = /^([A-Z]{2,2})([0-9]{9,9})([A-Z]{2,2})$/
123
-
124
- def matches
125
- self.tracking_number.scan(VERIFY_PATTERN).flatten
126
- end
127
-
128
- def valid_checksum?
129
- sequence = tracking_number.scan(/[0-9]+/).flatten.join
130
- chars = sequence.chars.to_a
131
- check_digit = chars.pop.to_i
132
-
133
- sum = 0
134
- chars.zip([8,6,4,2,3,5,9,7]).each do |pair|
135
- sum += (pair[0].to_i * pair[1].to_i)
136
- end
137
-
138
- remainder = sum % 11
139
- check = case remainder
140
- when 1
141
- 0
142
- when 0
143
- 5
144
- else
145
- 11 - remainder
146
- end
147
-
148
- return check == check_digit
149
- end
150
- end
151
-
152
- class USPSTest < USPS
153
- # USPS Test Number From Easypost. IE: 9499 9071 2345 6123 4567 81
154
- SEARCH_PATTERN = /(\b([0-9]\s*){22,22}\b)/
155
- VERIFY_PATTERN = SEARCH_PATTERN
156
-
157
- def matches
158
- self.tracking_number.scan(VERIFY_PATTERN).flatten
159
- end
160
-
161
- def valid_checksum?
162
- sequence = tracking_number.scan(/[0-9]+/).flatten.join
163
- return sequence == "9499907123456123456781"
164
- end
165
- end
166
- end
@@ -1,35 +0,0 @@
1
- require 'test_helper'
2
-
3
- class DHLTrackingNumberTest < Minitest::Test
4
- context "DHLExpressAir tracking number" do
5
- ["73891051146"].each do |valid_number|
6
- should "return dhl for #{valid_number}" do
7
- should_be_valid_number(valid_number, TrackingNumber::DHLExpressAir, :dhl)
8
- end
9
-
10
- should "fail on check digit changes on #{valid_number}" do
11
- should_fail_on_check_digit_changes(valid_number)
12
- end
13
-
14
- should "detect #{valid_number} regardless of spacing" do
15
- should_detect_number_variants(valid_number, TrackingNumber::DHLExpressAir)
16
- end
17
- end
18
- end
19
-
20
- context "DHLExpress tracking numbers" do
21
- ["3318810025", "8487135506", "3318810036", "3318810014"].each do |valid_number|
22
- should "return dhl for #{valid_number}" do
23
- should_be_valid_number(valid_number, TrackingNumber::DHLExpress, :dhl)
24
- end
25
-
26
- should "fail on check digit changes on #{valid_number}" do
27
- should_fail_on_check_digit_changes(valid_number)
28
- end
29
-
30
- should "detect #{valid_number} regardless of spacing" do
31
- should_detect_number_variants(valid_number, TrackingNumber::DHLExpress)
32
- end
33
- end
34
- end
35
- end
@@ -1,75 +0,0 @@
1
- require 'test_helper'
2
-
3
- class FedExTrackingNumberTest < Minitest::Test
4
- context "a FedEx tracking number" do
5
- ["986578788855", "477179081230", "799531274483", "790535312317", "974367662710"].each do |valid_number|
6
- should "return fedex express for #{valid_number}" do
7
- should_be_valid_number(valid_number, TrackingNumber::FedExExpress, :fedex)
8
- end
9
-
10
- should "fail on check digit changes on #{valid_number}" do
11
- should_fail_on_check_digit_changes(valid_number)
12
- end
13
-
14
- should "detect #{valid_number} regardless of spacing" do
15
- should_detect_number_variants(valid_number, TrackingNumber::FedExExpress)
16
- end
17
- end
18
-
19
- ["9611020987654312345672"].each do |valid_number|
20
- should "return fedex 96 for #{valid_number}" do
21
- should_be_valid_number(valid_number, TrackingNumber::FedExGround96, :fedex)
22
- end
23
-
24
- should "fail on check digit changes on #{valid_number}" do
25
- should_fail_on_check_digit_changes(valid_number)
26
- end
27
-
28
- should "detect #{valid_number} regardless of spacing" do
29
- should_detect_number_variants(valid_number, TrackingNumber::FedExGround96)
30
- end
31
- end
32
-
33
- ["0414 4176 0228 964", "5682 8361 0012 000", "5682 8361 0012 734"].each do |valid_number|
34
- should "return fedex ground for #{valid_number}" do
35
- should_be_valid_number(valid_number, TrackingNumber::FedExGround, :fedex)
36
- end
37
-
38
- should "fail on check digit changes on #{valid_number}" do
39
- should_fail_on_check_digit_changes(valid_number)
40
- end
41
-
42
- should "detect #{valid_number} regardless of spacing" do
43
- should_detect_number_variants(valid_number, TrackingNumber::FedExGround)
44
- end
45
- end
46
-
47
- ["00 0123 4500 0000 0027"].each do |valid_number|
48
- should "return fedex sscc18 for #{valid_number}" do
49
- should_be_valid_number(valid_number, TrackingNumber::FedExGround18, :fedex)
50
- end
51
-
52
- should "fail on check digit changes on #{valid_number}" do
53
- should_fail_on_check_digit_changes(valid_number)
54
- end
55
-
56
- should "detect #{valid_number} regardless of spacing" do
57
- should_detect_number_variants(valid_number, TrackingNumber::FedExGround18)
58
- end
59
- end
60
-
61
- ['61299998820821171811', '9261292700768711948021'].each do |valid_number|
62
- should "return fedex smart post for #{valid_number}" do
63
- should_be_valid_number(valid_number, TrackingNumber::FedExSmartPost, :fedex)
64
- end
65
-
66
- should "fail on check digit changes on #{valid_number}" do
67
- should_fail_on_check_digit_changes(valid_number)
68
- end
69
-
70
- should "detect #{valid_number} regardless of spacing" do
71
- should_detect_number_variants(valid_number, TrackingNumber::FedExSmartPost)
72
- end
73
- end
74
- end
75
- end
@@ -1,24 +0,0 @@
1
- require 'test_helper'
2
-
3
- class OnTracTrackingNumberTest < Minitest::Test
4
- context "an OnTrac tracking number" do
5
- ["C11031500001879", "C10999911320231"].each do |valid_number|
6
- should "return ontrac for #{valid_number}" do
7
- should_be_valid_number(valid_number, TrackingNumber::OnTrac, :ontrac)
8
- end
9
-
10
- should "fail on check digit changes on #{valid_number}" do
11
- should_fail_on_check_digit_changes(valid_number)
12
- end
13
-
14
- should "detect #{valid_number} regardless of spacing" do
15
- should_detect_number_variants(valid_number, TrackingNumber::OnTrac)
16
- end
17
- end
18
-
19
- should "not detect an invalid number" do
20
- results = TrackingNumber::OnTrac.search("C10999911320230")
21
- assert_equal 0, results.size
22
- end
23
- end
24
- end
@@ -1,36 +0,0 @@
1
- require 'test_helper'
2
-
3
- class UPSTrackingNumberTest < Minitest::Test
4
- context "a UPS tracking number" do
5
- ["1Z5R89390357567127", "1Z879E930346834440", "1Z410E7W0392751591", "1Z8V92A70367203024"].each do |valid_number|
6
- should "return ups with valid number #{valid_number}" do
7
- should_be_valid_number(valid_number, TrackingNumber::UPS, :ups)
8
- end
9
-
10
- should "fail on check digit changes on #{valid_number}" do
11
- should_fail_on_check_digit_changes(valid_number)
12
- end
13
-
14
- should "detect #{valid_number} regardless of spacing" do
15
- should_detect_number_variants(valid_number, TrackingNumber::UPS)
16
- end
17
- end
18
- end
19
-
20
- context "a UPS test tracking number" do
21
- ["EZ1000000001", "EZ2000000002", "EZ3000000003", "EZ4000000004", "EZ5000000005", "EZ6000000006", "EZ7000000007"].each do |valid_number|
22
- should "return test for #{valid_number}" do
23
- should_be_valid_number(valid_number, TrackingNumber::UPSTest, :ups)
24
- end
25
-
26
- should "fail on check digit changes on #{valid_number}" do
27
- should_fail_on_check_digit_changes(valid_number)
28
- end
29
- end
30
-
31
- should "not detect an invalid number" do
32
- results = TrackingNumber::UPSTest.search("C10999911320230")
33
- assert_equal 0, results.size
34
- end
35
- end
36
- end
@@ -1,73 +0,0 @@
1
- require 'test_helper'
2
-
3
- class USPSTrackingNumberTest < Minitest::Test
4
- context "a USPS tracking number" do
5
- ["9101 1234 5678 9000 0000 13", "7196 9010 7560 0307 7385", "9400 1112 0108 0805 4830 16", "9505 5110 6960 5048 6006 24", "9361 2898 7870 0317 6337 95"].each do |valid_number|
6
- should "return usps with valid 22 digit number: #{valid_number}" do
7
- should_be_valid_number(valid_number, TrackingNumber::USPS91, :usps)
8
- end
9
-
10
- should "fail on check digit changes on #{valid_number}" do
11
- should_fail_on_check_digit_changes(valid_number)
12
- end
13
-
14
- should "detect #{valid_number} regardless of spacing" do
15
- should_detect_number_variants(valid_number, TrackingNumber::USPS91)
16
- end
17
- end
18
-
19
- ["0307 1790 0005 2348 3741"].each do |valid_number|
20
- should "return usps with valid 20 digit number: #{valid_number}" do
21
- should_be_valid_number(valid_number, TrackingNumber::USPS20, :usps)
22
- end
23
-
24
- should "fail on check digit changes on #{valid_number}" do
25
- should_fail_on_check_digit_changes(valid_number)
26
- end
27
-
28
- should "detect #{valid_number} regardless of spacing" do
29
- should_detect_number_variants(valid_number, TrackingNumber::USPS20)
30
- end
31
- end
32
-
33
- ["RB123456785US"].each do |valid_number|
34
- should "return usps with valid 13 character number #{valid_number}" do
35
- should_be_valid_number(valid_number, TrackingNumber::USPS13, :usps)
36
- end
37
-
38
- should "fail on check digit changes on #{valid_number}" do
39
- should_fail_on_check_digit_changes(valid_number)
40
- end
41
-
42
- should "detect #{valid_number} regardless of spacing" do
43
- should_detect_number_variants(valid_number, TrackingNumber::USPS13)
44
- end
45
- end
46
-
47
- ["420221539101026837331000039521"].each do |valid_number|
48
- should "return usps with valid 30 digit number: #{valid_number}" do
49
- should_be_valid_number(valid_number, TrackingNumber::USPS91, :usps)
50
- end
51
-
52
- should "fail on check digit changes on #{valid_number}" do
53
- should_fail_on_check_digit_changes(valid_number)
54
- end
55
- end
56
-
57
- ["92748931507708513018050063"].each do |valid_number|
58
- should "return usps with valid 26 digit number: #{valid_number}" do
59
- should_be_valid_number(valid_number, TrackingNumber::USPS91, :usps)
60
- end
61
-
62
- should "fail on check digit changes on #{valid_number}" do
63
- should_fail_on_check_digit_changes(valid_number)
64
- end
65
- end
66
-
67
- ["9499907123456123456781", "94999 07123 45612 34567 81"].each do |valid_number|
68
- should "return usps with test 22 digit number: #{valid_number}" do
69
- should_be_valid_number(valid_number, TrackingNumber::USPSTest, :usps)
70
- end
71
- end
72
- end
73
- end