0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Package tracking done right.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

 Project Readme

Polar Express

Get on board of The Polar Express and let's have a train ride to package tracking!

Discontinued

Hi, due to time restrictions I'm not going to be able to keep updating this. If you happen to actually use it write me an e-mail jojo [at] eljojo [dot] net.

Installation

Add this line to your application's Gemfile:

gem 'polar_express'

And then execute:

$ bundle

Or install it yourself as:

$ gem install polar_express

Usage

@tracker = PolarExpress.new('DHL', '017219678663')
info = @tracker.track!
info.status # => :delivered
info.statuses
# [{:date=>
#    #<DateTime: 2012-12-05T15:52:00+08:00>,
#   :city=>nil,
#   :status=>:shipping_instructions_received,
#   :text=>
#    "The instruction data for this shipment have been provided by the sender to DHL electronically"},
#  {:date=>
#    #<DateTime: 2012-12-06T07:31:00+08:00>,
#   :city=>"Berlin-Friedrichshain",
#   :status=>:in_delivery_vehicle,
#   :text=>"The shipment has been loaded onto the delivery vehicle"},
#  {:date=>
#    #<DateTime: 2012-12-12T15:42:00+08:00>,
#   :city=>nil,
#   :status=>:delivered,
#   :text=>"The recipient has picked up the shipment from the retail outlet"}]

Supported Couriers

  • DHL (Germany)
  • GLS (Germany)
  • Hermes (Germany)

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

What can I help with?

  • improve couriers implementation
  • implement new couriers
  • write more tests
  • documentation. rdoc?
  • discuss about the structure of the gem. is there space for improvement?

Remember

You gotta believe in magic.

Polar Express