tracking_number 2.4.0 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c0ef2fa722ce7a2d9cc6cfaac9c5510ef7ac79074ba4e227f9554b8157da2ee
-  data.tar.gz: 3a5f46d4dc5027e8bf68c4f7cf0756851e284d29b499c38d4c264b57ebc61fc4
+  metadata.gz: 75fcefe87240b40ddf1bd16c155f13f93f46b9cbe96b343fb9b480875dd82ef6
+  data.tar.gz: f7ff78fe0acdc1a65ae6ddc63fe6e975ee4481c05e8d934b5fc8f09b1d2990ae
 SHA512:
-  metadata.gz: 404a19a4f9847ade5581c5ff7c0cf950fde208d773f81f6882715d44b4395f94fc505538d46b718ad0c7fbfcdf152e512619ca86372dc1021a524ab2614cd898
-  data.tar.gz: c4fbe1cf3637fea233106008bc31c1b555a63ea7e04588f08446d00a5d6dd3948daf744e078a74c6e96d7f257c51986fa8712db5f3b9e1e742e0ea9d61a6c63c
+  metadata.gz: e4d70982f20080077fff3be398bc0f99baabd1d67c8a579e2253735a532dbfe0d1bc38edb91df9e28f873ce1683ba26177a447c26d0503fa1c5fc2047f156a0e
+  data.tar.gz: 1b22b16347f3ed186f7f539dc4bfc1a32ff07719faaf1cebc5a0983ced2139db4436303ab3405d4ad9b62081bdd0b632e769dc3822a1f7a5d47709e2832ca8f1

data/.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: [jkeen]
+buy_me_a_coffee: jeffkeen

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 tracking_number changelog
 
+# [2.5.0](https://github.com/jkeen/tracking_number/compare/v2.4.0...v2.5.0) (2026-08-13)
+
+
+### Features
+
+* update to tracking_number_data 1.12, which includes support for Canpar, Purolator, Spee-Dee, YunExpress, and an updated FedEx matcher ([ca67edf](https://github.com/jkeen/tracking_number/commit/ca67edf0eaeab33171008bf115e96bdcf55c0d4b))
+
 # [2.4.0](https://github.com/jkeen/tracking_number/compare/v2.3.0...v2.4.0) (2025-08-21)
 
 

data/README.md

@@ -2,21 +2,15 @@
 [![Gem Version](https://badge.fury.io/rb/tracking_number.svg)](https://badge.fury.io/rb/tracking_number)
 [![Gem](https://img.shields.io/gem/dt/tracking_number.svg)]()
 
-> Hey there tracking number enthusiast! I don't use this project in any production capacity, and really never have. I am not a tracking number expert, and I don't have inside connections to a shipping company—I'm just a guy that once tried to make a package tracking app and this gem is all that survived. When I have absolutely nothing to do it's kinda fun to tinker with, but time has become more and more of a precious resource. Anyway, maintaining this is thankless work, and if this project has been useful for you I sure would appreciate a cup or two of coffee slid my way as a token of appreciation. A PR would also be nice. 
-> 
-> <a href="https://www.buymeacoffee.com/jeffkeen" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: auto !important;width: 150px !important;" ></a>
-
-## Tracking Number (v1.x)
+## Tracking Number
 
 This gem identifies valid tracking numbers and can tell you a little bit about the shipment just from the number—there's quite a bit of info tucked away into those numbers, it turns out.
 
-It detects tracking numbers from UPS, FedEx, DHL, USPS, OnTrac, Amazon Logistics, and 160+ countries national postal services (S10 standard).
+It detects tracking numbers from USPS, UPS, FedEx, Amazon, DHL, OnTrac, LaserShip, Canada Post, DPD, Purolator, Old Dominion Freight Line, Spee-Dee Delivery, Canpar, YunExpress, Landmark Global, GOFO Express, and any carrier using the S10 international standard.
 
 This gem does not do tracking. That is left up to you.
 
-#### New in 1.0
-
-Starting with the 1.0 release the specifications for detecting tracking numbers have been moved into a separate repository ([tracking_number_data](http://github.com/jkeen/tracking_number_data)) that this gem relies on. I did this so a) we can have a single place to document all tracking number types and it can be more of a crowdsourced effort, and b) so clients can be written in other languages easier.
+All the matching data is kept in [tracking_number_data](https://github.com/jkeen/tracking_number_data) and displayed in full on [trackingnumber.fyi](https://trackingnumber.fyi).
 
 ## Usage
 

data/lib/data/couriers/canadapost.json

@@ -9,8 +9,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
-          "odds_multiplier": 1
+          "odds_multiplier": 1,
+          "reverse": false
         }
       },
       "tracking_url": "https://www.canadapost-postescanada.ca/track-reperage/en#/search?searchFor=%s",

data/lib/data/couriers/canpar.json

@@ -0,0 +1,29 @@
+{
+  "name": "Canpar",
+  "courier_code": "canpar",
+  "tracking_numbers": [
+    {
+      "name": "Canpar (22)",
+      "id": "canpar_22",
+      "regex": "\\s*(?<SerialNumber>[CDKLSUXZ]\\s*([0-9]\\s*){21})\\s*",
+      "validation": {},
+      "tracking_url": "https://www.canpar.com/en/track/tracking.jsp?reference=%s&locale=en",
+      "test_numbers": {
+        "valid": [
+          "D576002440000001718010",
+          "D576002440000001428004",
+          "D576002440000002496001",
+          "L576002440000000001004",
+          "L576002440000000004001",
+          "S576002440000000004001",
+          "S576002440000000025001"
+        ],
+        "invalid": [
+          "1576002440000002510003",
+          "D57600244000000251000",
+          "M576002440000002510003"
+        ]
+      }
+    }
+  ]
+}

data/lib/data/couriers/dhl.json

@@ -8,7 +8,8 @@
       "regex": "\\s*(?<SerialNumber>([0-9]\\s*){9,10})(?<CheckDigit>([0-9]\\s*))",
       "validation": {
         "checksum": {
-          "name": "mod7"
+          "name": "mod7",
+          "modulo": 7
         }
       },
       "tracking_url": "http://www.dhl.com/en/express/tracking.html?brand=DHL&AWB=%s",
@@ -106,6 +107,7 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
           "odds_multiplier": 1,
           "reverse": true

data/lib/data/couriers/dpd.json

@@ -17,7 +17,9 @@
       ],
       "validation": {
         "checksum": {
-          "name": "mod_37_36"
+          "name": "mod_37_36",
+          "modulo": 36,
+          "alphabet": "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"
         }
       },
       "tracking_url": "https://www.dpdgroup.com/nl/mydpd/my-parcels/track?lang=en&parcelNumber=%s",
@@ -323,7 +325,9 @@
       ],
       "validation": {
         "checksum": {
-          "name": "mod_37_36"
+          "name": "mod_37_36",
+          "modulo": 36,
+          "alphabet": "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"
         }
       },
       "tracking_url": "https://www.dpdgroup.com/nl/mydpd/my-parcels/track?lang=en&parcelNumber=%s",

data/lib/data/couriers/fedex.json

@@ -45,8 +45,7 @@
       "name": "FedEx Express (34)",
       "id": "fedex_34",
       "regex": [
-        "\\s*1\\s*0\\s*[0-9]\\s*[0-9]\\s*[0-9]\\s*",
-        "([0-9]\\s*){10}",
+        "\\s*[0-8]\\s*([0-9]\\s*){14}",
         "(?<DestinationZip>([0-9]\\s*){5})",
         "(?<SerialNumber>([0-9]\\s*){13})",
         "(?<CheckDigit>[0-9]\\s*)"
@@ -81,7 +80,11 @@
           "1001901781990001000300617767839437",
           " 1 0 0 1 9 0 1 7 8 1 9 9 0 0 0 1 0 0 0 3 0 0 6 1 7 7 6 7 8 3 9 4 3 7 ",
           "1002297871540001000300790695517286",
-          "1027590111820004833500785458233610"
+          "1027590111820004833500785458233610",
+          "1195266473930007521100871079919940",
+          "1 1 9 52 6 64739 3000 75211 00 8710 799 199 40",
+          "1195271874060007521100871140316925",
+          "1195583874210007521100871140316936"
         ],
         "invalid": [
           "1001901781990001000300617767839438"
@@ -92,6 +95,9 @@
       "name": "FedEx SmartPost",
       "id": "fedex_smartpost",
       "description": "Shipped by FedEx, Delivered by USPS",
+      "glossary": {
+        "ApplicationIdentifier": { "description": "Always 92 here, the code for a parcel handed to USPS for delivery." }
+      },
       "regex": [
         "\\s*(?:",
         "(?:(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5}))?",
@@ -125,8 +131,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
-          "odds_multiplier": 1
+          "odds_multiplier": 1,
+          "reverse": false
         },
         "serial_number_format": {
           "prepend_if": {
@@ -159,8 +167,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 1,
-          "odds_multiplier": 3
+          "odds_multiplier": 3,
+          "reverse": false
         }
       },
       "tracking_url": "https://www.fedex.com/apps/fedextrack/?tracknumbers=%s",
@@ -184,8 +194,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
-          "odds_multiplier": 1
+          "odds_multiplier": 1,
+          "reverse": false
         }
       },
       "test_numbers": {
@@ -225,6 +237,10 @@
     {
       "name": "FedEx Ground 96 (22)",
       "id": "fedex_ground_96",
+      "glossary": {
+        "ApplicationIdentifier": { "description": "Always 96, marking a ground shipping label." },
+        "SCNC": { "description": "FedEx Ground uses 11, 12 and 13." }
+      },
       "regex": [
         "\\s*(?<ApplicationIdentifier>9\\s*6\\s*)",
         "(?<SCNC>([0-9]\\s*){2})",
@@ -235,8 +251,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 1,
-          "odds_multiplier": 3
+          "odds_multiplier": 3,
+          "reverse": false
         }
       },
       "tracking_url": "https://www.fedex.com/apps/fedextrack/?tracknumbers=%s",
@@ -253,6 +271,10 @@
     {
       "name": "FedEx Ground GSN",
       "id": "fedex_ground_gsn",
+      "glossary": {
+        "ApplicationIdentifier": { "description": "Always 96, marking a ground shipping label." },
+        "SCNC": { "description": "FedEx Ground uses 11, 12 and 13." }
+      },
       "regex": [
         "\\s*(?<ApplicationIdentifier>9\\s*6\\s*)",
         "(?<SCNC>([0-9]\\s*){2})",

data/lib/data/couriers/gofo.json

@@ -0,0 +1,24 @@
+{
+  "name": "GOFO Express",
+  "courier_code": "gofo",
+  "tracking_numbers": [
+    {
+      "name": "GOFO Express (US)",
+      "id": "gofo_us",
+      "regex": [
+        "\\s*G\\s*F\\s*U\\s*S\\s*(?<SerialNumber>([0-9]\\s*){14})\\s*"
+      ],
+      "tracking_url": "https://www.gofoexpress.com/tracking.html?searchID=%s",
+      "validation": {},
+      "test_numbers": {
+        "valid": [
+          "GFUS01011884214464",
+          "GFUS01011884214272"
+        ],
+        "invalid": [
+          "GFUS0101188421446"
+        ]
+      }
+    }
+  ]
+}

data/lib/data/couriers/lasership.json

@@ -79,6 +79,27 @@
           "1LS7119013618127-2"
         ]
       }
+    },
+    {
+      "name": "LaserShip 1LSCX (15)",
+      "id": "lasership_1lscx",
+      "regex": [
+        "\\s*1\\s*L\\s*S\\s*",
+        "\\s*C\\s*X\\s*",
+        "(?<SerialNumber>",
+        "([0-9A-Z]\\s*){10}",
+        ")"
+      ],
+      "validation": {},
+      "test_numbers": {
+        "valid": [
+          "1LS CX VE00 58631Y",
+          "1LSCXVE005BUEFX"
+        ],
+        "invalid": [
+          "1LSCZVE0058631Y"
+        ]
+      }
     }
   ]
 }

data/lib/data/couriers/old_dominion.json

@@ -13,7 +13,8 @@
       ],
       "validation": {
         "checksum": {
-          "name": "luhn"
+          "name": "luhn",
+          "modulo": 10
         }
       },
       "tracking_url": "https://www.odfl.com/us/en/tools/trace-track-ltl-freight/trace.html?proNumbers=%s",
@@ -43,7 +44,8 @@
       ],
       "validation": {
         "checksum": {
-          "name": "luhn"
+          "name": "luhn",
+          "modulo": 10
         }
       },
       "tracking_url": "https://www.odfl.com/us/en/tools/trace-track-ltl-freight/trace.html?proNumbers=%s",

data/lib/data/couriers/ontrac.json

@@ -9,8 +9,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 1,
-          "odds_multiplier": 2
+          "odds_multiplier": 2,
+          "reverse": false
         },
         "serial_number_format": {
           "prepend_if": {
@@ -42,8 +44,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 1,
-          "odds_multiplier": 2
+          "odds_multiplier": 2,
+          "reverse": false
         },
         "serial_number_format": {
           "prepend_if": {

data/lib/data/couriers/purolator.json

@@ -0,0 +1,50 @@
+{
+  "name": "Purolator",
+  "courier_code": "purolator",
+  "tracking_numbers": [
+    {
+      "name": "Purolator (12)",
+      "id": "purolator_numeric",
+      "regex": "\\s*(?<SerialNumber>[0-5]\\s*([0-9]\\s*){10})(?<CheckDigit>[0-9])\\s*",
+      "validation": {
+        "checksum": {
+          "name": "luhn"
+        }
+      },
+      "tracking_url": "https://www.purolator.com/en/shipping/tracker?searchValue=%s",
+      "test_numbers": {
+        "valid": [
+          "320595463938",
+          "320606146993",
+          "287809468872",
+          "320610804900",
+          "331426749957",
+          "331434972567"
+        ],
+        "invalid": [
+          "320595463939",
+          "287809468875"
+        ]
+      }
+    },
+    {
+      "name": "Purolator (alpha + 9)",
+      "id": "purolator_alpha",
+      "regex": "\\s*(?<SerialNumber>([A-Z]\\s*){3}([0-9]\\s*){9})\\s*",
+      "validation": {},
+      "tracking_url": "https://www.purolator.com/en/shipping/tracker?searchValue=%s",
+      "test_numbers": {
+        "valid": [
+          "KYV009956937",
+          "CGK002986959",
+          "JFV247545960",
+          "TLR000083964"
+        ],
+        "invalid": [
+          "KY009956937",
+          "331426749957"
+        ]
+      }
+    }
+  ]
+}

data/lib/data/couriers/s10.json

@@ -7,7 +7,9 @@
       "name": "S10",
       "validation": {
         "checksum": {
-          "name": "s10"
+          "name": "s10",
+          "weightings": [8, 6, 4, 2, 3, 5, 9, 7],
+          "modulo": 11
         },
         "additional": {
           "exists": [
@@ -17,6 +19,11 @@
       },
       "regex": "\\s*(?<ServiceType>([A-Z]\\s*){2})(?<SerialNumber>([0-9]\\s*){8})(?<CheckDigit>([0-9]\\s*))(?<CountryCode>([A-Z]\\s*){2})",
       "tracking_url": null,
+      "glossary": {
+        "ServiceType": { "description": "Two letters for the class of postal service, the first of which identifies the service and the second the variant." },
+        "SerialNumber": { "description": "Eight digits assigned by the issuing postal service." },
+        "CountryCode": { "description": "Two letters for the country whose postal service issued the number, following ISO 3166." }
+      },
       "test_numbers": {
         "valid": [
           "RB123456785GB",

data/lib/data/couriers/speedee.json

@@ -0,0 +1,26 @@
+{
+  "name": "Spee-Dee Delivery",
+  "courier_code": "speedee",
+  "tracking_numbers": [
+    {
+      "name": "Spee-Dee (20)",
+      "id": "speedee",
+      "regex": "\\s*S\\s*P\\s*(?<SerialNumber>([0-9]\\s*){18})\\s*",
+      "validation": {},
+      "tracking_url": "https://www.speedeedelivery.com/track/?tracking=%s",
+      "test_numbers": {
+        "valid": [
+          "SP029692510000920746",
+          "SP029692510000901479",
+          "SP029692510000688332",
+          "SP029692510000279301",
+          "SP029692450001607639"
+        ],
+        "invalid": [
+          "029692510000920746",
+          "SX029692510000920746"
+        ]
+      }
+    }
+  ]
+}

data/lib/data/couriers/ups.json

@@ -15,8 +15,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 1,
-          "odds_multiplier": 2
+          "odds_multiplier": 2,
+          "reverse": false
         }
       },
       "tracking_url": "https://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=%s",
@@ -146,8 +148,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 1,
-          "odds_multiplier": 2
+          "odds_multiplier": 2,
+          "reverse": false
         }
       },
       "additional": [

data/lib/data/couriers/usps.json

@@ -18,8 +18,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
-          "odds_multiplier": 1
+          "odds_multiplier": 1,
+          "reverse": false
         }
       },
       "test_numbers": {
@@ -74,6 +76,7 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
           "odds_multiplier": 1,
           "reverse": true
@@ -131,6 +134,9 @@
       "name": "USPS 34v2",
       "id": "usps_32V2",
       "description": "variation on 34 digit USPS IMpd numbers",
+      "glossary": {
+        "ApplicationIdentifier": { "description": "92 through 95, saying which USPS service and mailer ID scheme the rest belongs to." }
+      },
       "regex": [
         "\\s*(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5})",
         "(?<RoutingNumber>([0-9]\\s*){4})",
@@ -144,8 +150,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
-          "odds_multiplier": 1
+          "odds_multiplier": 1,
+          "reverse": false
         }
       },
       "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=%s",
@@ -164,6 +172,9 @@
       "name": "USPS 91",
       "id": "usps_91",
       "description": "USPS now calls this the IMpd barcode format",
+      "glossary": {
+        "ApplicationIdentifier": { "description": "91 through 95, saying which USPS service and mailer ID scheme the rest belongs to." }
+      },
       "regex": [
         "\\s*(?:(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5}))?",
         "(?<SerialNumber>",
@@ -178,8 +189,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
-          "odds_multiplier": 1
+          "odds_multiplier": 1,
+          "reverse": false
         },
         "serial_number_format": {
           "prepend_if": {

data/lib/data/couriers/yunexpress.json

@@ -0,0 +1,25 @@
+{
+  "name": "YunExpress",
+  "courier_code": "yunexpress",
+  "tracking_numbers": [
+    {
+      "name": "YunExpress",
+      "id": "yunexpress",
+      "tracking_url": "https://www.yuntrack.com/parcelTracking?id=%s",
+      "regex": [
+        "\\s*Y\\s*T\\s*(?<SerialNumber>([0-9]\\s*){16})\\s*"
+      ],
+      "validation": {},
+      "test_numbers": {
+        "valid": [
+          "YT2229521272164446",
+          "YT2229521272164447",
+          " Y T 2 2 2 9 5 2 1 2 7 2 1 6 4 4 4 7 "
+        ],
+        "invalid": [
+          "YT123456789012345"
+        ]
+      }
+    }
+  ]
+}

data/lib/tracking_number/version.rb

@@ -1,3 +1,3 @@
 module TrackingNumber
-  VERSION = "2.4.0"
+  VERSION = "2.5.0"
 end

data/package.json

@@ -38,31 +38,7 @@
               "release": "minor"
             },
             {
-              "type": "build",
-              "release": "patch"
-            },
-            {
-              "type": "ci",
-              "release": "patch"
-            },
-            {
-              "type": "chore",
-              "release": "patch"
-            },
-            {
-              "type": "docs",
-              "release": "patch"
-            },
-            {
-              "type": "refactor",
-              "release": "patch"
-            },
-            {
-              "type": "style",
-              "release": "patch"
-            },
-            {
-              "type": "test",
+              "type": "fix",
               "release": "patch"
             }
           ],

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tracking_number
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.5.0
 platform: ruby
 authors:
 - Jeff Keen
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-21 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -146,6 +146,7 @@ extra_rdoc_files:
 - LICENSE.txt
 files:
 - ".document"
+- ".github/FUNDING.yml"
 - ".github/dependabot.yml"
 - ".github/workflows/release.yml"
 - ".github/workflows/ruby.yml"
@@ -160,16 +161,21 @@ files:
 - bin/console
 - lib/data/couriers/amazon.json
 - lib/data/couriers/canadapost.json
+- lib/data/couriers/canpar.json
 - lib/data/couriers/dhl.json
 - lib/data/couriers/dpd.json
 - lib/data/couriers/fedex.json
+- lib/data/couriers/gofo.json
 - lib/data/couriers/landmark.json
 - lib/data/couriers/lasership.json
 - lib/data/couriers/old_dominion.json
 - lib/data/couriers/ontrac.json
+- lib/data/couriers/purolator.json
 - lib/data/couriers/s10.json
+- lib/data/couriers/speedee.json
 - lib/data/couriers/ups.json
 - lib/data/couriers/usps.json
+- lib/data/couriers/yunexpress.json
 - lib/tracking_number.rb
 - lib/tracking_number/active_model_validator.rb
 - lib/tracking_number/base.rb