ordrin 0.1.0

data/bin/ordrindemo.rb

@@ -0,0 +1,323 @@
+#! /usr/bin/env ruby
+require 'date'
+require 'securerandom'
+require 'pp'
+
+begin
+  require 'ordrin'
+rescue LoadError
+  require 'rubygems'
+  begin
+    require 'ordrin'
+  rescue LoadError
+    require_relative '../lib/ordrin'
+  end
+end
+
+module OrdrinDemo
+  #
+  # Global Variables
+  #
+  print "Please input your API key: "
+  STDOUT.flush
+  api_key = gets.chomp
+
+  @@api = Ordrin::APIs.new(api_key, :test)
+
+  # Create an Address object
+  @@address = Ordrin::Data::Address.new('1 Main Street', 'College Station', 'TX', '77840', '(555) 555-5555')
+  @@address_nick = 'addr1'
+
+  # Create a CreditCard object
+  @@first_name = 'Test'
+  @@last_name = 'User'
+  @@credit_card = Ordrin::Data::CreditCard.new("#{@@first_name} #{@@last_name}", '01', (Date.today.year+2).to_s, @@address, '4111111111111111', '123')
+  @@credit_card_nick = 'cc1'
+
+  unique_id = SecureRandom.uuid.to_s.gsub(/-/, '')
+  @@email = "demo+#{unique_id}ruby@ordr.in"
+  @@password = 'password'
+  @@login = Ordrin::Data::UserLogin.new(@@email, @@password)
+  @@alt_first_name = 'Example'
+  @@alt_email = "demo+#{unique_id}rubyalt@ordr.in"
+  @@alt_login = Ordrin::Data::UserLogin.new(@@alt_email, @@password)
+  @@new_password = 'password1'
+
+  #
+  # Restaurant demo functions
+  #
+
+  def OrdrinDemo.delivery_list_immediate_demo()
+    puts "Get a list of restaurants that will deliver if you order now"
+    print "Press enter to execute and see the response"
+    gets
+    delivery_list_immediate = @@api.restaurant.get_delivery_list('ASAP', @@address)
+    PP.pp(delivery_list_immediate)
+    return delivery_list_immediate
+  end
+
+  def OrdrinDemo.delivery_list_future_demo()
+    puts "Get a list of restaurants that will deliver if you order for 12 hours from now"
+    print "Press enter to execute and see the response"
+    gets
+    future_datetime = DateTime.now + 0.5 #A timestamp twelve hours in the future
+    delivery_list_later = @@api.restaurant.get_delivery_list(future_datetime, @@address)
+    PP.pp(delivery_list_later)
+  end
+
+  def OrdrinDemo.delivery_check_demo(restaurant_id)
+    puts "Get whether a particular restaurant will deliver if you order now"
+    print "Press enter to execute and see the response"
+    gets
+    delivery_check = @@api.restaurant.get_delivery_check(restaurant_id, 'ASAP', @@address)
+    PP.pp(delivery_check)
+  end
+
+  def OrdrinDemo.fee_demo(restaurant_id)
+    puts "Get fee and other info for ordering a given amount with a given tip"
+    print "Press enter to execute and see the response"
+    gets
+    subtotal = "$30.00"
+    tip = "$5.00"
+    fee_info = @@api.restaurant.get_fee(restaurant_id, subtotal, tip, 'ASAP', @@address)
+    PP.pp(fee_info)
+  end
+
+  def OrdrinDemo.detail_demo(restaurant_id)
+    puts "Get detailed information about a single restaurant"
+    print "Press enter to execute and see the response"
+    gets
+    restaurant_detail = @@api.restaurant.get_details(restaurant_id)
+    PP.pp(restaurant_detail)
+    return restaurant_detail
+  end
+
+  def OrdrinDemo.find_deliverable_time(restaurant_id)
+    puts "Find a time when this restaurant will deliver"
+    print "Press enter to execute and see the response"
+    gets
+    delivery_check = @@api.restaurant.get_delivery_check(restaurant_id, 'ASAP', @@address)
+    delivery = delivery_check['delivery']
+    if delivery
+      return 'ASAP'
+    end
+    dt = DateTime.now + 1/24.0
+    while not delivery
+      delivery_check = @@api.restaurant.get_delivery_check(restaurant_id, dt, @@address)
+      delivery = delivery_check['delivery']
+      dt += 1/24.0
+    end
+    return dt
+  end    
+  #
+  # User demo functions
+  #
+
+  def OrdrinDemo.get_user_demo()
+    puts "Get information about a user"
+    print "Press enter to execute and see the response"
+    gets
+    user_info = @@api.user.get(@@login)
+    PP.pp(user_info)
+  end
+
+  def OrdrinDemo.create_user_demo()
+    puts "Create a user"
+    print "Press enter to execute and see the response"
+    gets
+    response = @@api.user.create(@@login, @@first_name, @@last_name)
+    PP.pp(response)
+  end
+
+  def OrdrinDemo.update_user_demo()
+    puts "Update a user"
+    print "Press enter to execute and see the response"
+    gets
+    response = @@api.user.update(@@login, @@alt_first_name, @@last_name)
+    PP.pp(response)
+  end
+
+  def OrdrinDemo.get_all_addresses_demo()
+    puts "Get a list of all saved addresses"
+    print "Press enter to execute and see the response"
+    gets
+    address_list = @@api.user.get_all_addresses(@@login)
+    PP.pp(address_list)
+  end
+
+  def OrdrinDemo.get_address_demo()
+    puts "Get an address by nickname"
+    print "Press enter to execute and see the response"
+    gets
+    addr = @@api.user.get_address(@@login, @@address_nick)
+    PP.pp(addr)
+  end
+
+  def OrdrinDemo.set_address_demo()
+    puts "Save an address with a nickname"
+    response = @@api.user.set_address(@@login, @@address_nick, @@address)
+    PP.pp(response)
+  end
+
+  def OrdrinDemo.remove_address_demo()
+    puts "Remove a saved address by nickname"
+    print "Press enter to execute and see the response"
+    gets
+    response = @@api.user.remove_address(@@login, @@address_nick)
+    PP.pp(response)
+  end
+
+  def OrdrinDemo.get_all_credit_cards_demo()
+    puts "Get a list of all saved credit cards"
+    credit_card_list = @@api.user.get_all_credit_cards(@@login)
+    PP.pp(credit_card_list)
+  end
+
+  def OrdrinDemo.get_credit_card_demo()
+    puts "Get a saved credit card by nickname"
+    print "Press enter to execute and see the response"
+    gets
+    credit_card = @@api.user.get_credit_card(@@login, @@credit_card_nick)
+    PP.pp(credit_card)
+  end
+
+  def OrdrinDemo.set_credit_card_demo()
+    puts "Save a credit card with a nickname"
+    print "Press enter to execute and see the response"
+    gets
+    response = @@api.user.set_credit_card(@@login, @@credit_card_nick, @@credit_card)
+    PP.pp(response)
+  end
+
+  def OrdrinDemo.remove_credit_card_demo()
+    puts "Remove a saved credit card by nickname"
+    print "Press enter to execute and see the response"
+    gets
+    response = @@api.user.remove_credit_card(@@login, @@credit_card_nick)
+    PP.pp(response)
+  end
+
+  def OrdrinDemo.get_order_history_demo(login)
+    puts "Get a list of all orders made by this user"
+    print "Press enter to execute and see the response"
+    gets
+    order_list = @@api.user.get_order_history(@@login)
+    PP.pp(order_list)
+  end
+
+  def OrdrinDemo.get_order_detail_demo(oid)
+    puts "Get the details of a particular order made by this user"
+    print "Press enter to execute and see the response"
+    gets
+    order_detail = @@api.user.get_order_detail(@@login, oid)
+    PP.pp(order_detail)
+  end
+
+  def OrdrinDemo.set_password_demo()
+    puts "Set a new password for a user"
+    print "Press enter to execute and see the response"
+    gets
+    response = @@api.user.set_password(@@login, @@new_password)
+    PP.pp(response)
+  end
+  
+  #
+  # Order demo functions
+  #
+
+  def OrdrinDemo.anonymous_order_demo(restaurant_id, tray, date_time)
+    puts "Order food as someone without a user account"
+    print "Press enter to execute and see the response"
+    gets
+    tip = Random.rand(500)/100.0
+    response = @@api.order.order(restaurant_id, tray, tip, date_time, @@first_name, @@last_name, @@address, @@credit_card, @@email)
+    PP.pp(response)
+  end
+
+  def OrdrinDemo.create_user_and_order_demo(restaurant_id, tray, date_time)
+    puts "Order food and create an account"
+    print "Press enter to execute and see the response"
+    gets
+    tip = Random.rand(500)/100.0
+    response = @@api.order.order_create_user(restaurant_id, tray, tip, date_time, @@first_name, @@last_name, @@address, @@credit_card, @@alt_email, @@password)
+    PP.pp(response)
+  end
+
+  def OrdrinDemo.order_with_nicks_demo(restaurant_id, tray, date_time)
+    puts "Order food as a logged in user using previously stored address and credit card"
+    print "Press enter to execute and see the response"
+    gets
+    tip = Random.rand(500)/100.0
+    response = @@api.order.order(restaurant_id, tray, tip, date_time, @@first_name, @@last_name, @@address_nick, @@credit_card_nick, nil, @@login)
+    PP.pp(response)
+    return response
+  end
+
+  def OrdrinDemo.find_item_to_order(item_list)
+    for item in item_list
+      if item['is_orderable']=='1'
+        if item['price'].to_f>=5.00
+          return item['id']
+        end
+      else
+        if item.has_key?('children')
+          item_id = find_item_to_order(item['children'])
+          unless item_id.nil?
+            return item_id
+          end
+        end
+      end
+    end
+    nil
+  end
+  
+
+  #
+  # Main
+  #
+  def OrdrinDemo.run_demo()
+    puts "Run through the entire demo sequence"
+    # Restaurant functions
+    delivery_list = delivery_list_immediate_demo()
+    delivery_list_future_demo()
+    restaurant_id = delivery_list[0]['id']
+    delivery_check_demo(restaurant_id)
+    fee_demo(restaurant_id)
+    detail = detail_demo(restaurant_id)
+
+    # User functions
+    create_user_demo()
+    get_user_demo()
+    update_user_demo()
+    get_user_demo()
+    set_address_demo()
+    get_address_demo()
+    set_credit_card_demo()
+    get_credit_card_demo()
+
+    # Order functions
+    order_date_time = find_deliverable_time(restaurant_id)
+    puts "Ordering food at #{order_date_time}"
+    item_id = find_item_to_order(detail['menu'])
+    item = Ordrin::Data::TrayItem.new(item_id, 10)
+    tray = Ordrin::Data::Tray.new(item)
+    anonymous_order_demo(restaurant_id, tray, order_date_time)
+    order = order_with_nicks_demo(restaurant_id, tray, order_date_time)
+    unless order.nil?
+      get_order_detail_demo(order['refnum'])
+    end
+
+    create_user_and_order_demo(restaurant_id, tray, order_date_time)
+    get_order_history_demo(@@alt_login)
+
+    # Clean up/removing stuff
+    remove_address_demo()
+    get_all_addresses_demo()
+    remove_credit_card_demo()
+    get_all_credit_cards_demo()
+    set_password_demo()
+    #After changing the password I must change the login object to continue to access user info
+  end
+
+  run_demo()
+end

data/lib/ordrin/data.rb

@@ -0,0 +1,148 @@
+require 'digest'
+require_relative 'normalize'
+module Ordrin
+  module Data
+    # Base class for objects that can save any data with the constructor and then
+    # extract it as a dictionary
+    class OrdrinData
+      # Return a dictionary of particular fields to values, determined per subclass
+      def make_dict
+        dict = {}
+        fields.map {|f| dict[f.to_s]=self.send(f) unless self.send(f).nil?}
+        return dict
+      end
+    end
+
+    # Represents a street address
+    class Address < OrdrinData
+
+      attr_reader :addr, :city, :state, :zip, :phone, :addr2, :fields
+      
+      # Store the parts of the address as fields in this object.
+      # Arguments:
+      # addr -- Street address
+      # city -- City
+      # state -- State
+      # zip -- Zip code
+      # phone -- Phone number
+      # addr2 -- Optional second street address line
+      def initialize(addr, city, state, zip, phone, addr2='')
+        @fields = [:addr, :city, :state, :zip, :phone, :addr2]
+        @addr = addr
+        @city = city
+        @state = Normalize.normalize(state, :state)
+        @zip = Normalize.normalize(zip, :zip)
+        @phone = Normalize.normalize(phone, :phone)
+      end
+    end
+
+    # Represents information about a credit card
+    class CreditCard < OrdrinData
+
+      attr_reader :expiry_month, :expiry_year, :number, :cvc, :type, :name, :bill_address, :fields
+
+      # Store the credit card info as fields in this object.
+      # Arguments:
+      # name -- The name (first and last) on the credit card
+      # expiry_month -- The month that the card expires (two digits)
+      # expiry_year -- The year that the card expires (four digits)
+      # bill_address -- The billing address. Should be an Ordrin::Data::Address object
+      # number -- The credit card number
+      # cvc -- The card verification number
+      def initialize(name, expiry_month, expiry_year, bill_address, number, cvc)
+        @fields = [:number, :cvc, :expiry_month, :expiry_year, :expiry,
+                   :bill_addr, :bill_addr2, :bill_city, :bill_state, :bill_zip,
+                   :phone, :name]
+        @expiry_month = Normalize.normalize(expiry_month, :month)
+        @expiry_year = Normalize.normalize(expiry_year, :year)
+        @number, @cvc, @type = Normalize.normalize([number, cvc], :credit_card)
+        @name = name
+        @bill_address = bill_address
+      end
+
+      def bill_addr
+        @bill_address.addr
+      end
+
+      def bill_addr2
+        @bill_address.addr2
+      end
+
+      def bill_city
+        @bill_address.city
+      end
+
+      def bill_state
+        @bill_address.state
+      end
+      
+      def bill_zip
+        @bill_address.zip
+      end
+
+      def phone
+        @bill_address.phone
+      end
+
+      # A combination of the expiry_month and expiry_date
+      def expiry
+        "#{expiry_month}/#{expiry_year}"
+      end
+    end
+
+    #Represents a user's login information
+    class UserLogin < OrdrinData
+      
+      attr_reader :email, :password, :fields
+
+      # Store the email and password in this object. Saves only the hash of the
+      # password, not the password itself
+      # Arguments:
+      # email -- The user's email address
+      # password -- The user's password (in plain text)
+      def initialize(email, password)
+        @fields = [:email, :password]
+        @email = email
+        @password = UserLogin.hash_password(password)
+      end
+
+      def UserLogin.hash_password(password)
+        return Digest::SHA256.new.hexdigest(password)
+      end
+    end
+
+    # Represents a single item in an order
+    class TrayItem
+      
+      # Store the descriptors of an order item in this object.
+      # Arguments:
+      # item_id -- the restaurants's numerial ID for the item
+      # quantity -- the quantity
+      # options -- any number of options to apply to the item
+      def initialize(item_id, quantity, *options)
+        @item_id = Normalize.normalize(item_id, :number)
+        @quantity = Normalize.normalize(quantity, :number)
+        @options = options.map {|opt| Normalize.normalize(opt, :number)}
+      end
+
+      def to_s
+        "#{@item_id}/#{@quantity},#{@options*','}"
+      end
+    end
+
+    # Represents a list of items in an order
+    class Tray
+      
+      # Store the list of items in this object. Each argument should be of type Item
+      # Arguments:
+      # items -- A list of items to be ordered in this tray
+      def initialize(*items)
+        @items = items
+      end
+
+      def to_s
+        return @items*'+'
+      end
+    end
+  end
+end

data/lib/ordrin/errors.rb

@@ -0,0 +1,147 @@
+module Ordrin
+  module Errors
+    # This is the base class for errors specific to this ordrin package
+    class OrdrinError < Exception
+      attr_reader :msg
+
+      def initialize(msg=nil)
+        @msg = msg
+      end
+    end
+
+    # This error encapsulates an API error returned by the server.
+    class ApiError < OrdrinError
+      attr_reader :text
+      def initialize(msg=nil, text=nil)
+        super(msg)
+        @text = text
+      end
+
+      def to_s
+        "ApiError(msg='#{msg}', text='#{text}')"
+      end
+    end
+
+    # This error indicates that the server returned a response that could not be
+    # parsed into JSON
+    class ApiInvalidResponseError < OrdrinError
+      def to_s
+        "ApiInvalidResponseError(msg='#{msg}')"
+      end
+    end
+
+    def Errors.state
+      lambda do |value|
+        ArgumentError.new("State must be a two letter postal code abbreviation: #{value}")
+      end
+    end
+
+    def Errors.money
+      lambda do |value|
+        ArgumentError.new("Money must be dollars.cents: #{value}")
+      end
+    end
+
+    def Errors.zip
+      lambda do |value|
+        ArgumentError.new("Zip code must be exactly 5 digits: #{value}")
+      end
+    end
+
+    def Errors.phone
+      lambda do |value|
+        ArgumentError.new("Phone numbers must have exactly 10 digits: #{value}")
+      end
+    end
+
+    def Errors.number
+      lambda do |value|
+        ArgumentError.new("This value must be only digits: #{value}")
+      end
+    end
+
+    def Errors.month
+      lambda do |value|
+        ArgumentError.new("Months must be two digits: #{value}")
+      end
+    end
+
+    def Errors.year
+      lambda do |value|
+        ArgumentError.new("Years must be four digits: #{value}")
+      end
+    end
+
+    def Errors.cvc
+      lambda do |value|
+        ArgumentError.new("Credit card CVC must be 3 or 4 digits, depending on the card type: #{value}")
+      end
+    end
+
+    def Errors.credit_card
+      lambda do |value|
+        ArgumentError.new("Credit card number must be a valid AmEx, Discover, Mastercard, or Visa card number: #{value}")
+      end
+    end
+
+    def Errors.email
+      lambda do |value|
+        ArgumentError.new("Bad email format: #{value}")
+      end
+    end
+
+    def Errors.normalizer
+      lambda do |value|
+        ArgumentError.new("Unknown validator name: #{value}")
+      end
+    end
+
+    def Errors.nick
+      lambda do |value|
+        ArgumentError.new("Nick names can only have letters, nubmers, dashes, and underscores: #{value}")
+      end
+    end
+
+    def Errors.date_time
+      lambda do |value|
+        ArgumentError.new("date_time must be a datetime.datetime object or the string 'ASAP': #{value}")
+      end
+    end
+
+    def Errors.date
+      lambda do |value|
+        ArgumentError.new("date must be a datetime.datetime or datetime.date object or the string 'ASAP': #{value}")
+      end
+    end
+
+    def Errors.time
+      lambda do |value|
+        ArgumentError.new("time must be a datetime.datetime or datetime.time object: #{value}")
+      end
+    end
+
+    def Errors.url
+      lambda do |value|
+        ArgumentError.new("url must be a proper url: #{value}")
+      end
+    end
+
+    def Errors.method
+      lambda do |value|
+        ArgumentError.new("method must be a word: #{value}")
+      end
+    end
+
+    def Errors.alphanum
+      lambda do |value|
+        ArgumentError.new("This value must be alphanumeric: #{value}")
+      end
+    end
+
+    def Errors.request_method
+      lambda do |value|
+        ApiError.new("Method not a valid HTTP request method: #{value}")
+      end
+    end
+  end
+end

data/lib/ordrin/normalize.rb

@@ -0,0 +1,186 @@
+require_relative 'errors'
+
+module Ordrin
+  module Normalize
+    class Normalizers
+      private
+      def regex(regex, error)
+        lambda do |value|
+          result = value.to_s[regex]
+          if result.nil?
+            raise error[value]
+          else
+            result
+          end
+        end
+      end
+
+      public
+      def phone(phone_number)
+        #strips out everything but digits from the phone number
+        phone = phone_number.to_s.gsub(/\D/, '')
+        if phone.length == 10
+          phone[/^(\d{3})(\d{3})(\d{4})$/]
+          "#{$1}-#{$2}-#{$3}"
+        else
+          raise Errors.phone[phone_number]
+        end
+      end
+
+      def money(money)
+        value = money.to_s.gsub(/,/, '')[/^\$?(\d+(\.\d+)?)$/, 1]
+        if value.nil?
+          raise Errors.money[money]
+        else
+          value
+        end
+      end
+
+      def datetime(date_time)
+        if date_time.to_s.upcase == 'ASAP'
+          'ASAP'
+        else
+          begin
+            date_time.strftime('%m-%d+%H:%M')
+          rescue NoMethodError
+            raise Errors.date_time[date_time]
+          end
+        end
+      end
+
+      def date(date)
+        if date.to_s.upcase == 'ASAP'
+          'ASAP'
+        else
+          begin
+            date.strftime('%m-%d')
+          rescue NoMethodError
+            raise Errors.date[date_time]
+          end
+        end
+      end
+
+      def time(time)
+        if time.to_s.upcase == 'ASAP'
+          'ASAP'
+        else
+          begin
+            time.strftime('%m-%d+%H:%M')
+          rescue NoMethodError
+            raise Errors.time[date_time]
+          end
+        end
+      end
+
+      def url(url)
+        url.to_s[/^(https?:\/\/)[-\w.~]+(:\d+)?(\/[-\w.~]+)*/]
+      end
+
+      def state(state)
+        state = state.to_s[/^[A-Za-z]{2}$/]
+        if state.nil?
+          raise Errors.state[state]
+        else
+          state.upcase
+        end
+      end
+
+      private
+      def cc_type(cc_number)
+        cc_map = {'American Express' => /^3[47]\d{13}$/,
+          'Visa' => /^4\d{12}(?:\d{3})?$/,
+          'Mastercard' => /^5[1-5]\d{14}$/,
+          'Discover' => /^6(?:011|5\d{2})\d{12}$/}
+
+        type = nil
+        cc_map.each {|key, value| type = key unless cc_number[value].nil?}
+        type
+      end
+
+      def luhn_checksum(card_number)
+        digits = card_number.to_s.scan(/./).map(&:to_i)
+        checksum = 0
+        digits.each_index do |index|
+          digit = digits[index]
+          if (digits.length-index)%2==1
+            checksum += digit
+          else
+            checksum += 2 * digit
+          end
+        end
+        checksum % 10
+      end
+
+      def luhn_valid?(card_number)
+        luhn_checksum(card_number) == 0
+      end
+
+      public
+      def credit_card(values)
+        number, cvc = values
+        num = number.to_s.gsub(/\D/, '')
+        unless luhn_valid?(num)
+          raise Errors.credit_card[number]
+        end
+        card_type = cc_type(num)
+        if card_type.nil?
+          raise Errors.credit_card[number]
+        else
+          if card_type=='American Express'
+            cvc_length = 4
+          else
+            cvc_length = 3
+          end
+          if cvc.length == cvc_length and !cvc.to_s[/^\d+$/].nil?
+            [num, cvc, card_type]
+          else
+            raise Errors.cvc[cvc]
+          end
+        end
+      end
+
+      def unchecked(value)
+        value.to_s
+      end
+
+      def name(value)
+        unchecked(value)
+      end
+
+      def zip(zip)
+        regex(/^\d{5}$/, Errors.zip)[zip]
+      end
+
+      def number(num)
+        regex(/^\d+/, Errors.number)[num]
+      end
+
+      def year(year)
+        regex(/^\d{4}$/, Errors.year)[year]
+      end
+
+      def month(mon)
+        regex(/^\d{2}$/, Errors.month)[mon]
+      end
+
+      def email(email)
+        regex(/^[^@\s]+@[^@\s]+\.[a-zA-Z]{2,3}/, Errors.email)[email]
+      end
+
+      def nick(nick)
+        regex(/^[-\w]+/, Errors.nick)[nick]
+      end
+
+      def alphanum(value)
+        regex(/^[a-zA-Z\d]+$/, Errors.alphanum)[value]
+      end
+    end
+
+    @@normalizer = Normalizers.new
+
+    public
+    def Normalize.normalize(value, normalizer)
+      @@normalizer.send(normalizer, value)
+    end
+  end
+end

data/lib/ordrin/order.rb

@@ -0,0 +1,79 @@
+require_relative 'ordrinapi'
+require_relative 'normalize'
+require_relative 'data'
+
+module Ordrin
+  # This class will be used to access the order API. All return values
+  # are documented at http://ordr.in/developers/order
+  class OrderApi < OrdrinApi
+
+    private
+
+    #Put all of the data that needs to be passed to the POST request normalized into a dict.
+    def build_dict(restaurant_id, tray, tip, delivery_date_time, first_name, last_name, address, credit_card, email, login=nil)
+      data = {'restaurant_id' => Normalize.normalize(restaurant_id, :number),
+        'tray' => tray.to_s,
+        'tip' => Normalize.normalize(tip, :money),
+        'delivery_date' => Normalize.normalize(delivery_date_time, :date)}
+      if data['delivery_date'] != 'ASAP'
+        data['delivery_time'] = Normalize.normalize(delivery_date_time, :time)
+      end
+      data['first_name'] = Normalize.normalize(first_name, :name)
+      data['last_name'] = Normalize.normalize(last_name, :name)
+      begin
+        data.merge!(address.make_dict)
+      rescue NoMethodError=>e
+        data['nick'] = Normalize.normalize(address, :nick)
+      end
+      if login.nil?
+        data['em'] = Normalize.normalize(email, :email)
+      end
+      begin
+        credit_card.make_dict.each_pair do |key, value|
+          data["card_#{key}"] = value
+        end
+      rescue NoMethodError=>e
+        data['card_nick'] = Normalize.normalize(credit_card, :nick)
+      end
+      data['type'] = 'res'
+      return data
+    end
+
+    public
+    # Place an order, either anonymously or as a logged in user. At least one
+    # of email and login must be passed. If both are passed, email will be ignored.
+    # Arguments:
+    # restaurant_id -- Ordr.in's restaurant identifier
+    # tray -- A tray of food to order. Should be an ordrin.data.Tray object
+    # tip -- The tip amount
+    # delivery_date_time -- Either 'ASAP' or a datetime object in the future
+    # first_name -- The orderer's first name
+    # last_name -- The orderer's last name
+    # address -- An address object (Ordrin::Data::Address) or the nickname of a saved address
+    # credit_card -- A credit card object (Ordrin::Data::CreditCard) or the nickname of a saved credit card
+    # email -- The email address of an anonymous user
+    # login -- The logged in user's login information. Should be an ordrin.data.UserLogin object
+    def order(restaurant_id, tray, tip, delivery_date_time, first_name, last_name, address, credit_card, email=nil, login=nil)
+      data = build_dict(restaurant_id, tray, tip, delivery_date_time, first_name, last_name, address, credit_card, email, login)
+      return call_api(:post, ['o', restaurant_id], login, data)
+    end
+
+    # Place an order and create a user account
+    # Arguments:
+    # restaurant_id -- Ordr.in's restaurant identifier
+    # tray -- A tray of food to order. Should be an ordrin.data.Tray object
+    # tip -- The tip amount
+    # delivery_date_time -- Either 'ASAP' or a datetime object in the future
+    # first_name -- The orderer's first name
+    # last_name -- The orderer's last name
+    # address -- An address object (Ordrin::Data::Address) or the nickname of a saved address
+    # credit_card -- A credit card object (Ordrin::Data::CreditCard) or the nickname of a saved credit card
+    # email -- The email address of the user
+    # password -- The user's password (in plain text)
+    def order_create_user(restaurant_id, tray, tip, delivery_date_time, first_name, last_name, address, credit_card, email, password)
+      data = build_dict(restaurant_id, tray, tip, delivery_date_time, first_name, last_name, address, credit_card, email)
+      data['pw'] = Data::UserLogin.hash_password(password)
+      return call_api(:post, ['o', restaurant_id], nil, data)
+    end
+  end
+end

data/lib/ordrin/ordrinapi.rb

@@ -0,0 +1,66 @@
+require_relative 'normalize'
+require 'net/http'
+require 'json'
+require 'digest'
+
+module Ordrin
+  # A base object for calling one part of the ordr.in API
+  class OrdrinApi
+
+    attr_reader :base_url
+    
+    # Save the url and key parameters in the object
+    # Arguments:
+    # key -- The developer's API key
+    # base_url -- the url that all API call urls will expand from
+    def initialize(key, base_url)
+      @key = key
+      @base_url = Normalize.normalize(base_url, :url)
+    end
+
+    protected
+
+    # Calls the api at the saved url and returns the return value as Python data structures.
+    # Rethrows any api error as a Ruby exception
+    def call_api(method, arguments, login=nil, data=nil)
+      methods = {:get => Net::HTTP::Get,
+        :post => Net::HTTP::Post,
+        :put => Net::HTTP::Put,
+        :delete => Net::HTTP::Delete}
+      method = methods[method]
+      uri = ('/'+(arguments.collect {|a| URI.encode a.to_s})*'/')
+      full_url = URI.parse(base_url+uri)
+      req = method.new(full_url.request_uri)
+      unless data.nil?
+        req.body = URI.encode_www_form(data)
+      end
+      unless @key.empty?
+        req['X-NAAMA-CLIENT-AUTHENTICATION'] = "id=\"#{@key}\", version=\"1\""
+      end
+      unless login.nil?
+        hash_code = Digest::SHA256.new.hexdigest("#{login.password}#{login.email}#{uri}")
+        req['X-NAAMA-AUTHENTICATION'] = "username=\"#{login.email}\", response=\"#{hash_code}\", version=\"1\""
+      end
+      http = Net::HTTP.new(full_url.host, full_url.port)
+      if full_url.scheme == "https"
+        http.use_ssl = true
+        http.ca_file = File.join(File.dirname(__FILE__), "cacert.pem")
+      end
+      res = http.start {|http| http.request(req)}
+      #error if not OK response
+      res.value
+      result = JSON.parse(res.body)
+      if result.is_a? Hash
+        if result.has_key?('_error') and result['_error']!=0
+          if result.has_key?('text')
+            raise Errors::ApiError.new(result['msg'], result['text'])
+          else
+            raise Errors::ApiError.new(result['msg'])
+          end
+          result
+        end
+      end
+      result
+    end
+  end
+end

data/lib/ordrin/restaurant.rb

@@ -0,0 +1,56 @@
+require_relative 'ordrinapi'
+require_relative 'normalize'
+
+module Ordrin
+  # This object's methods access the ordr.in restaurant API. All return values
+  # are documented at http://ordr.in/developers/restaurant
+  class RestaurantApi < OrdrinApi
+    # Get a list of dicts representing restaurants that will deliver to the
+    # given address at the given time.
+    # Arguments:
+    # date_time -- Either 'ASAP' or a datetime object in the future
+    # address -- the address to deliver to. Should be an Ordrin::Data::Address object
+    def get_delivery_list(date_time, address)
+      dt = Normalize.normalize(date_time, :datetime)
+      return call_api(:get, ['dl', dt, address.zip, address.city, address.addr])
+    end
+
+    # Get data about a given restaurant, including whether it will deliver to
+    # the specified address at the specified time
+    # Arguments:
+    # restaurant_id -- Ordr.in's restaurant identifier
+    # date_time -- Either 'ASAP' or a datetime object in the future
+    # address -- the address to deliver to. Should be an Ordrin::Data::Address object
+    def get_delivery_check(restaurant_id, date_time, address)
+      dt = Normalize.normalize(date_time, :datetime)
+      restauant_id = Normalize.normalize(restaurant_id, :number)
+      return call_api(:get, ['dc', restaurant_id, dt, address.zip, address.city, address.addr])
+    end
+
+    # Get data about a given restaurant, including whether it will deliver to
+    # the specified address at the specified time, and what the fee will be on an
+    # order with the given subtotal and tip
+    # Arguments:
+    # restaurant_id -- Ordr.in's restaurant identifier
+    # subtotal -- the subtotal of the order
+    # tip -- the tip on the order
+    # date_time -- Either 'ASAP' or a datetime object in the future
+    # address -- the address to deliver to. Should be an Ordrin::Data::Address object
+    def get_fee(restaurant_id, subtotal, tip, date_time, address)
+      dt = Normalize.normalize(date_time, :datetime)
+      restaurant_id = Normalize.normalize(restaurant_id, :number)
+      subtotal = Normalize.normalize(subtotal, :money)
+      tip = Normalize.normalize(tip, :money)
+      return call_api(:get, ['fee', restaurant_id, subtotal, tip, dt, address.zip, address.city, address.addr])
+    end
+    
+    # Get details of the given restaurant, including contact information and
+    # the menu
+    # Arguments:
+    # restaurant_id -- Ordr.in's restaurant identifier
+    def get_details(restaurant_id)
+      restaurant_id = Normalize.normalize(restaurant_id, :number)
+      return call_api(:get, ['rd', restaurant_id])
+    end
+  end
+end

data/lib/ordrin/user.rb

@@ -0,0 +1,142 @@
+require_relative 'ordrinapi'
+require_relative 'normalize'
+require_relative 'data'
+
+module Ordrin
+  # This class will be used to access the user API. All return values
+  # are documented at http://ordr.in/developers/user
+  class UserApi < OrdrinApi
+    # Gets account information for the user associated with login
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    def get(login)
+      return call_api(:get, ['u', login.email], login)
+    end
+
+    # Creates account for the user associated with login. Throws a relevant exception
+    # on failure.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    # first_name -- the user's first name
+    # last_name -- the user's last name
+    def create(login, first_name, last_name)
+      data = {'email' => login.email,
+        'first_name' => Normalize.normalize(first_name, :name),
+        'last_name' => Normalize.normalize(last_name, :name),
+        'pw' => login.password}
+      return call_api(:post, ['u', login.email], nil, data)
+    end
+
+    # Updates account for the user associated with login. Throws a relevant exception
+    # on failure.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    # first_name -- the user's first name
+    # last_name -- the user's last name
+    def update(login, first_name, last_name)
+      data = {'email' => login.email,
+        'first_name' => Normalize.normalize(first_name, :name),
+        'last_name' => Normalize.normalize(last_name, :name),
+        'pw' => login.password}
+      return call_api(:post, ['u', login.email], login, data)
+    end
+
+    # Get a list of all saved addresses for the user associated with login.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    def get_all_addresses(login)
+      return call_api(:get, ['u', login.email, 'addrs'], login)
+    end
+    
+    # Get a saved address belonging to the logged in user by nickname.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    # addr_nick -- the nickname of the address to get
+    def get_address(login, addr_nick)
+      return call_api(:get, ['u', login.email, 'addrs', Normalize.normalize(addr_nick, :nick)], login)
+    end
+
+    # Save an address by nickname for the logged in user
+    # Throws a relevant exception on failure
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    # addr_nick -- the nickname of the address to save
+    # address -- the address to save. Should be an Ordrin::Data::Address object
+    def set_address(login, addr_nick, address)
+      return call_api(:put, ['u', login.email, 'addrs', Normalize.normalize(addr_nick, :nick)], login, address.make_dict)
+    end
+
+    # Remove an address, saved by the logged in user, by nickname
+    # Throws a relevant exception on failure.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    # addr_nick -- the nickname of the address to remove
+    def remove_address(login, addr_nick)
+      return call_api(:delete, ['u', login.email, 'addrs', Normalize.normalize(addr_nick, :nick)], login)
+    end
+
+    # Get a list of all saved credit cards for the user associated with login.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    def get_all_credit_cards(login)
+      return call_api(:get, ['u', login.email, 'ccs'], login)
+    end
+
+    # Get a saved credit card belonging to the logged in user by nickname.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    # card_nick -- the nickname of the credit card to get
+    def get_credit_card(login, card_nick)
+      return call_api(:get, ['u', login.email, 'ccs', Normalize.normalize(card_nick, :nick)], login)
+    end
+
+    # Save an credit card by nickname for the logged in user
+    # Throws a relevant exception on failure
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    # card_nick -- the nickname of the credit card to save
+    # credit_card -- the credit card to save. Should be an Ordrin::Data::CreditCard object
+    def set_credit_card(login, card_nick, credit_card)
+      card_nick = Normalize.normalize(card_nick, :nick)
+      data = credit_card.make_dict
+      data.merge!(login.make_dict)
+      data['nick'] = card_nick
+      return call_api(:put, ['u', login.email, 'ccs', card_nick], login, data)
+    end
+
+    # Remove an credit card, saved by the logged in user, by nickname
+    # Throws a relevant exception on failure.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    # card_nick -- the nickname of the credit card to remove
+    def remove_credit_card(login, card_nick)
+      return call_api(:delete, ['u', login.email, 'ccs', Normalize.normalize(card_nick, :nick)], login)
+    end
+
+    # Get a list of previous orders by the logged in user.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    def get_order_history(login)
+      return call_api(:get, ['u', login.email, 'orders'], login)
+    end
+
+    # Get details of a particular previous order by the logged in user.
+    # Arguments:
+    # login -- the user's login information. Should be an Ordrin::Data::UserLogin object
+    # order_id -- The order ID
+    def get_order_detail(login, order_id)
+      return call_api(:get, ['u', login.email, 'orders', Normalize.normalize(order_id, :alphanum)], login)
+    end
+
+    # Change the logged in user's password.
+    # Arguments:
+    # login -- the user's current login information. Should be an Ordrin::Data::UserLogin object
+    # new_password -- the new password (in plain text)
+    def set_password(login, new_password)
+      data = {'email' => login.email,
+        'password' => Data::UserLogin.hash_password(new_password),
+        'previous_password' => login.password}
+      return self.call_api(:put, ['u', login.email, 'password'], login, data)
+    end
+  end
+end

data/lib/ordrin.rb

@@ -0,0 +1,58 @@
+require_relative 'ordrin/restaurant'
+require_relative 'ordrin/user'
+require_relative 'ordrin/order'
+require_relative 'ordrin/data'
+
+module Ordrin
+  class APIs
+    
+    attr_reader :restaurant, :user, :order
+    
+    # Sets up this module to make API calls. The first argument is the developer's
+    # API key. The other three are the URLs corresponding to the three parts of the api.
+    # No API calls will work until this function is called. API objects will only be
+    # instantiated for URLs that are passed in.
+
+    # Arguments:
+    # api_key -- The developer's API key
+    # servers -- How the server URLs should be set. Must be :production, :test, or :custom
+    # restaurant_url -- The base url for the restaurant API. Can only be set if servers==:custom.
+    # user_url -- The base url for the user API. Can only be set if servers==:custom.
+    # order_url -- The base url for the order API. Can only be set if servers==:custom.
+    def initialize(api_key, servers, restaurant_url=nil, user_url=nil, order_url=nil)
+      @api_key = api_key
+      if servers!=:custom
+        unless restaurant_url.nil? and user_url.nil? and order_url.nil?
+          raise ArgumentError.new("Individual URL parameters can only be set if servers is set to :custom")
+        end
+      end
+      if servers==:production
+        restaurant_url = "https://r.ordr.in/"
+        user_url = "https://u.ordr.in/"
+        order_url = "https://o.ordr.in/"
+      elsif servers==:test
+        restaurant_url = "https://r-test.ordr.in/"
+        user_url = "https://u-test.ordr.in/"
+        order_url = "https://o-test.ordr.in/"
+      elsif servers!=:custom
+        raise ArgumentError.new("servers must be set to :production, :test, or :custom")
+      end
+      unless restaurant_url.nil?
+        @restaurant = RestaurantApi.new(api_key, restaurant_url)
+      end
+      unless user_url.nil?
+        @user = UserApi.new(api_key, user_url)
+      end
+      unless order_url.nil?
+        @order = OrderApi.new(api_key, order_url)
+      end
+    end
+
+    def config
+      return {"API key" => api_key,
+        "Restaurant URL" => @restaurant.base_url,
+        "User URL" => @user.base_url,
+        "Order URL" => @order.base_url}
+    end
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: ordrin
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Ordr.in
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.7.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.7.3
+description: Ordrin API wrapper. Used to simplify making calls to the Ordr.in API
+  in Ruby
+email:
+- tech@ordr.in
+executables:
+- ordrindemo.rb
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ordrin.rb
+- lib/ordrin/data.rb
+- lib/ordrin/errors.rb
+- lib/ordrin/normalize.rb
+- lib/ordrin/order.rb
+- lib/ordrin/ordrinapi.rb
+- lib/ordrin/restaurant.rb
+- lib/ordrin/user.rb
+- bin/ordrindemo.rb
+homepage: https://github.com/ordrin/api-ruby
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Ordrin API wrapper
+test_files: []