im_contacts 1.2.7

data/lib/contacts/hotmail.rb

@@ -0,0 +1,125 @@
+class Contacts
+  class Hotmail < Base
+    URL                 = "https://login.live.com/login.srf?id=2"
+    OLD_CONTACT_LIST_URL = "http://%s/cgi-bin/addresses"
+    NEW_CONTACT_LIST_URL = "http://%s/mail/GetContacts.aspx"
+    CONTACT_LIST_URL = "http://mpeople.live.com/default.aspx?pg=0"
+    COMPOSE_URL         = "http://%s/cgi-bin/compose?"
+    PROTOCOL_ERROR      = "Hotmail has changed its protocols, please upgrade this library first. If that does not work, report this error at http://rubyforge.org/forum/?group_id=2693"
+    PWDPAD = "IfYouAreReadingThisYouHaveTooMuchFreeTime"
+    MAX_HTTP_THREADS    = 8
+
+    def real_connect
+      data, resp, cookies, forward = get(URL)
+      old_url = URL
+      until forward.nil?
+        data, resp, cookies, forward, old_url = get(forward, cookies, old_url) + [forward]
+      end
+
+      postdata =  "PPSX=%s&PwdPad=%s&login=%s&passwd=%s&LoginOptions=2&PPFT=%s" % [
+        CGI.escape(data.split("><").grep(/PPSX/).first[/=\S+$/][2..-3]),
+        PWDPAD[0...(PWDPAD.length-@password.length)],
+        CGI.escape(login),
+        CGI.escape(password),
+        CGI.escape(data.split("><").grep(/PPFT/).first[/=\S+$/][2..-3])
+      ]
+
+      form_url = data.split("><").grep(/form/).first.split[5][8..-2]
+      data, resp, cookies, forward = post(form_url, postdata, cookies)
+
+      old_url = form_url
+      until cookies =~ /; PPAuth=/ || forward.nil?
+        data, resp, cookies, forward, old_url = get(forward, cookies, old_url) + [forward]
+      end
+
+      if data.index("The e-mail address or password is incorrect")
+        raise AuthenticationError, "Username and password do not match"
+      elsif data != ""
+        raise AuthenticationError, "Required field must not be blank"
+      elsif cookies == ""
+        raise ConnectionError, PROTOCOL_ERROR
+      end
+
+      data, resp, cookies, forward = get("http://mail.live.com/mail", cookies)
+      until forward.nil?
+        data, resp, cookies, forward, old_url = get(forward, cookies, old_url) + [forward]
+      end
+
+      @domain = URI.parse(old_url).host
+      @cookies = cookies
+    rescue AuthenticationError => m
+      if @attempt == 1
+        retry
+      else
+        raise m
+      end
+    end
+
+    def contacts(options = {})
+      if connected?
+        url = URI.parse(contact_list_url)
+        data, resp, cookies, forward = get( contact_list_url, @cookies )
+
+        if resp.code_type != Net::HTTPOK
+          raise ConnectionError, self.class.const_get(:PROTOCOL_ERROR)
+        end
+
+        @contacts = []
+        build_contacts = []
+        go = true
+        index = 0
+
+        while(go) do
+          go = false
+          url = URI.parse(get_contact_list_url(index))
+          http = open_http(url)
+          resp, data = http.get(get_contact_list_url(index), "Cookie" => @cookies)
+
+          email_match_text_beginning = Regexp.escape("http://m.mail.live.com/?rru=compose&amp;to=")
+          email_match_text_end = Regexp.escape("&amp;")
+
+          raw_html = resp.body.split("
+").grep(/(?:e|dn)lk[0-9]+/)
+          raw_html.inject(-1) do |memo, row|
+            c_info = row.match(/(e|dn)lk([0-9])+/)
+
+            # Same contact, or different?
+            build_contacts << [] if memo != c_info[2]
+
+            # Grab info
+            case c_info[1]
+              when "e" # Email
+                build_contacts.last[1] = row.match(/#{email_match_text_beginning}(.*)#{email_match_text_end}/)[1]
+              when "dn" # Name
+                build_contacts.last[0] = row.match(/<a[^>]*>(.+)<\/a>/)[1]
+            end
+
+            # Set memo to contact id
+            c_info[2]
+          end
+
+          go = resp.body.include?("ContactList_next")
+          index += 1
+        end
+
+        build_contacts.each do |contact|
+          unless contact[1].nil?
+            # Only return contacts with email addresses
+            contact[1] = CGI::unescape(contact[1])
+            @contacts << contact
+          end
+        end
+
+        return @contacts
+      end
+    end
+
+    def get_contact_list_url(index)
+      "http://mpeople.live.com/default.aspx?pg=#{index}"
+    end
+
+    private
+
+    TYPES[:hotmail] = Hotmail
+  end
+end

data/lib/contacts/json_picker.rb

@@ -0,0 +1,16 @@
+if !Object.const_defined?('ActiveSupport')
+  require 'json'
+end
+
+class Contacts
+  def self.parse_json( string )
+    if Object.const_defined?('ActiveSupport') and
+       ActiveSupport.const_defined?('JSON')
+      ActiveSupport::JSON.decode( string )
+    elsif Object.const_defined?('JSON')
+      JSON.parse( string )
+    else
+      raise 'Contacts requires JSON or Rails (with ActiveSupport::JSON)'
+    end
+  end
+end

data/lib/contacts/net_ease.rb

@@ -0,0 +1,117 @@
+class Contacts
+  class NetEase < Base
+  	URL = "http://www.163.com"
+    LOGIN_URL = "https://reg.163.com/logins.jsp"
+    LoginData = {
+    	:url2 => {
+    		:wy163 => 'http://mail.163.com/errorpage/err_163.htm',
+		  	:wy126 => 'http://mail.126.com/errorpage/err_126.htm',
+				:yeah => 'http://mail.yeah.net/errorpage/err_yeah.htm'
+    	},
+    	:url => {
+    		:wy163 => 'http://entry.mail.163.com/coremail/fcg/ntesdoor2?lightweight=1&verifycookie=1&language=-1&style=-1&username=%s',
+    		:wy126 => 'http://entry.mail.126.com/cgi/ntesdoor?hid=10010102&lightweight=1&verifycookie=1&language=0&style=-1&username=%s',
+    		:yeah => 'http://entry.mail.yeah.net/cgi/ntesdoor?lightweight=1&verifycookie=1&style=-1&username=%s'
+    	},
+    	:product => {
+    		:wy163 => 'mail163',
+    		:wy126 => 'mail126',
+    		:yeah => 'mailyeah'
+    	}
+    }
+    ENTER_MAIL_URL = {
+    	:wy163 => "http://entry.mail.163.com/coremail/fcg/ntesdoor2?lightweight=1&verifycookie=1&language=-1&style=-1&username=%s",
+    	:wy126 => "http://entry.mail.126.com/cgi/ntesdoor?hid=10010102&lightweight=1&verifycookie=1&language=0&style=-1&username=%s",
+    	:yeah => "http://entry.mail.yeah.net/cgi/ntesdoor?lightweight=1&verifycookie=1&style=-1&username=%s"
+    }
+
+		CONTACT_LIST_URL = "%ss?sid=%s&func=global:sequential"
+		PROTOCOL_ERROR = "netease has changed its protocols, please upgrade this library first. you can also contact kamechb@gmail.com"
+
+    def initialize(login, password, options={})
+			@mail_type = get_mail_type(login)
+			super(login,password,options)
+    end
+
+    def real_connect
+			login_for_cookies
+			enter_mail_server
+    end
+
+    def contacts
+    	return @contacts if @contacts
+      if connected?
+				url = URI.parse(CONTACT_LIST_URL % [@mail_server,@sid])
+				http = open_http(url)
+				postdata = '<?xml version="1.0"?><object><array name="items"><object><string name="func">pab:searchContacts</string><object name="var"><array name="order"><object><string name="field">FN</string><boolean name="ignoreCase">true</boolean></object></array></object></object><object><string name="func">user:getSignatures</string></object><object><string name="func">pab:getAllGroups</string></object></array></object>'
+				set_header = {"Cookie" => @cookies,'Accept' => 'text/javascript','Content-Type' => 'application/xml; charset=UTF-8'}
+				resp, data = http.post("#{url.path}?#{url.query}",postdata,set_header)
+				if resp.code_type != Net::HTTPOK
+          raise ConnectionError, self.class.const_get(:PROTOCOL_ERROR)
+        end
+				parse(data)
+      end
+    end
+
+    private
+
+    def get_mail_type(username)
+    	if username.include?("@126.com")
+    		:wy126
+    	elsif username.include?("@163.com")
+    		:wy163
+    	elsif username.include?("@yeah.net")
+    		:yeah
+    	else
+    		raise MailServerError, "there are only three mail servers that 126.com, 163.com and yeah.net. please add domain after username"
+    	end
+    end
+
+    def parse(data)
+    	json_data = Contacts.parse_json(data)
+    	json_data['var'][0]['var'].map{|contactor|
+    		[contactor['FN'],contactor['EMAIL;PREF']]
+    	}
+    end
+
+    def login_for_cookies
+    	data = {
+	      :type => '1',
+				:url => LoginData[:url][@mail_type],
+				:username => @login,
+				:password => @password,
+				:selType => '-1',
+				:remUser => '1',
+				:secure => 'on',
+				:verifycookie => '1',
+				:style => '-1',
+				:product => LoginData[:product][@mail_type],
+				:savelogin => '',
+				:url2 => LoginData[:url2][@mail_type]
+      }
+      postdata = data.to_query_string
+      #login and get cookie
+      data, resp, cookies, forward = post(LOGIN_URL,postdata)
+      @cookies = cookies
+      if data.index(LoginData[:url2][@mail_type])
+      	raise AuthenticationError, "Username or password error"
+      end
+    end
+
+    def enter_mail_server
+			#get mail server and sid
+			enter_mail_url = ENTER_MAIL_URL[@mail_type] % @login
+			data, resp, cookies, forward = get(enter_mail_url,@cookies)
+			location = resp['Location']
+			data_reg = /<a.*?(http.*?)main.jsp\?sid=(.*?)\">/
+			location_reg = /(http.*?)main.jsp\?sid=(.*)/
+			unless data.match(data_reg) || location.match(location_reg)
+				raise ConnectionError, self.class.const_get(:PROTOCOL_ERROR)
+			end
+			@cookies = cookies
+			@mail_server = $1
+			@sid = $2
+    end
+    TYPES[:net_ease] = NetEase
+  end
+end

data/lib/contacts/plaxo.rb

@@ -0,0 +1,130 @@
+require 'rexml/document'
+
+class Contacts
+  class Plaxo < Base
+    URL                 = "http://www.plaxo.com/"
+    LOGIN_URL           = "https://www.plaxo.com/signin"
+    ADDRESS_BOOK_URL    = "http://www.plaxo.com/po3/?module=ab&operation=viewFull&mode=normal"
+    CONTACT_LIST_URL    = "http://www.plaxo.com/axis/soap/contact?_action=getContacts&_format=xml"
+    PROTOCOL_ERROR      = "Plaxo has changed its protocols, please upgrade this library first. If that does not work, dive into the code and submit a patch at http://github.com/cardmagic/contacts"
+    
+    def real_connect
+      
+    end # real_connect
+    
+    def contacts
+      getdata = "&authInfo.authByEmail.email=%s" % CGI.escape(login)
+      getdata += "&authInfo.authByEmail.password=%s" % CGI.escape(password)
+      data, resp, cookies, forward = get(CONTACT_LIST_URL + getdata)
+      
+      if resp.code_type != Net::HTTPOK
+        raise ConnectionError, PROTOCOL_ERROR
+      end
+      
+      parse data
+    end # contacts
+    
+  private
+    def parse(data, options={})
+      doc = REXML::Document.new(data)
+      code = doc.elements['//response/code'].text
+      
+      if code == '401'
+        raise AuthenticationError, "Username and password do not match"
+      elsif code == '200'
+        @contacts = []
+        doc.elements.each('//contact') do |cont|
+          name = if cont.elements['fullName']
+            cont.elements['fullName'].text
+          elsif cont.elements['displayName']
+            cont.elements['displayName'].text
+          end
+          email = if cont.elements['email1']
+            cont.elements['email1'].text
+          end
+          if name || email
+            @contacts << [name, email]
+          end
+        end
+        @contacts
+      else
+        raise ConnectionError, PROTOCOL_ERROR
+      end
+      
+    end # parse
+
+  end # Plaxo
+  
+  TYPES[:plaxo] = Plaxo
+  
+end # Contacts
+
+
+# sample contacts responses
+=begin
+Bad email
+=========
+<?xml version="1.0" encoding="utf-8" ?>
+<ns1:GetContactsResponse xmlns:ns1="Plaxo">
+  <response>
+    <code>401</code>
+    <subCode>1</subCode>
+    <message>User not found.</message>
+  </response>
+</ns1:GetContactsResponse>
+
+
+Bad password
+============
+<?xml version="1.0" encoding="utf-8" ?>
+<ns1:GetContactsResponse xmlns:ns1="Plaxo">
+  <response>
+    <code>401</code>
+    <subCode>4</subCode>
+    <message>Bad password or security token.</message>
+  </response>
+</ns1:GetContactsResponse>
+
+
+Success
+=======
+<?xml version="1.0" encoding="utf-8" ?>
+<ns1:GetContactsResponse xmlns:ns1="Plaxo">
+
+  <response>
+    <code>200</code>
+    <message>OK</message>
+    <userId>77311236242</userId>
+  </response>
+  
+  <contacts>
+
+    <contact>
+      <itemId>61312569</itemId>
+      <displayName>Joe Blow1</displayName>
+      <fullName>Joe Blow1</fullName>
+      <firstName>Joe</firstName>
+      <lastName>Blow1</lastName>
+      <homeEmail1>joeblow1@mailinator.com</homeEmail1>
+      <email1>joeblow1@mailinator.com</email1>
+      <folderId>5291351</folderId>
+    </contact>
+    
+    <contact>
+      <itemId>61313159</itemId>
+      <displayName>Joe Blow2</displayName>
+      <fullName>Joe Blow2</fullName>
+      <firstName>Joe</firstName>
+      <lastName>Blow2</lastName>
+      <homeEmail1>joeblow2@mailinator.com</homeEmail1>
+      <email1>joeblow2@mailinator.com</email1>
+      <folderId>5291351</folderId>
+    </contact>
+    
+  </contacts>
+  
+  <totalCount>2</totalCount>
+  <editCounter>3</editCounter>
+  
+</ns1:GetContactsResponse>
+=end

data/lib/contacts/sina.rb

@@ -0,0 +1,91 @@
+class Contacts
+  class Sina < Base
+  	URL = "http://mail.sina.com.cn"
+    LOGIN_URL = {
+    	:sina_cn => "https://mail.sina.com.cn/cgi-bin/cnlogin.php",
+    	:sina_com => "https://mail.sina.com.cn/cgi-bin/login.php"
+    }
+		LOGIN_COOKIE = {
+			:sina_cn => "sina_cn_mail_id=nonobo_t; sina_cn_mail_recid=true",
+			:sina_com => "sina_free_mail_id=fangs2; sina_free_mail_recid=true; sina_free_mail_ltype=uid; sina_vip_mail_recid=false"
+		}
+		DOMAIN = {
+			:sina_cn => 'sina.cn',
+			:sina_com => 'sina.com'
+		}
+		PROTOCOL_ERROR = "sina has changed its protocols, please upgrade this library first. you can also contact kamechb@gmail.com"
+
+    def initialize(login, password, options={})
+			@mail_type = get_mail_type(login)
+			super(login,password,options)
+    end
+
+    def real_connect
+			login_for_cookies
+			redirect_for_location
+    end
+
+    def contacts
+			return @contacts if @contacts
+      if connected?
+      	data, resp, cookies, forward = get(@mail_url,@cookies)
+      	if resp.code_type != Net::HTTPOK
+          raise ConnectionError, self.class.const_get(:PROTOCOL_ERROR)
+        end
+        parse(data)
+      end
+    end
+
+    private
+
+    def get_mail_type(username)
+    	if username.include?("@sina.com")
+    		:sina_com
+    	elsif username.include?("@sina.cn")
+    		:sina_cn
+    	else
+    		raise MailServerError, "there are only two mail servers that sina.com and sina.cn. please add domain after username"
+    	end
+    end
+
+    def parse(data)
+			data =~ /conf.*?contacts:.*?(\{.*?\}),\s*groups:/m
+			contacts = $1.gsub("&quot;",'')
+			contacts = ActiveSupport::JSON.decode(contacts)
+			contacts['contact'].map{|contactor|
+				[contactor['name'],contactor['email']]
+			}
+    end
+
+    def login_for_cookies
+    	data = {
+    		:domain => DOMAIN[@mail_type],
+				:logintype => 'uid',
+				:u => @login,
+				:psw => @password,
+				:savelogin => 'on',
+				:sshchk => 'on',
+				:ssl => 'on'
+    	}
+    	data, resp, cookies, forward = post(LOGIN_URL[@mail_type],data.to_query_string,LOGIN_COOKIE[@mail_type])
+    	login_faile_flag = %r{form.*?action.*?http.*?mail.sina.com.cn/cgi-bin/.*?login.php}m
+    	if data.match(login_faile_flag)
+    		raise AuthenticationError, "Username or password error"
+    	end
+    	data.match(/URL=(http:\/\/.*?)'>/)
+			@redirect_url = $1
+			@mail_server = @redirect_url.match(/(http:\/\/.*\..*?)\//)
+			@cookies = cookies
+    end
+
+    def redirect_for_location
+    	data, resp, cookies, forward = get(@redirect_url,@cookies)
+    	location = resp['Location']
+    	@mail_url = location.index("http://") ? location : "#{@mail_server}#{location}"
+    	@cookies = cookies
+    end
+
+    TYPES[:sina] = Sina
+  end
+
+end

data/lib/contacts/sohu.rb

@@ -0,0 +1,59 @@
+class Contacts
+  class Sohu < Base
+  	URL = "http://mail.sohu.com"
+  	DOMAIN = "sohu.com"
+    LOGIN_URL = "https://passport.sohu.com/sso/login.jsp"
+    LOGIN_COOKIE = "IPLOC=CN3301; SUV=1008301317090277"
+		MAIL_URL = "http://mail.sohu.com/bapp/81/main"
+		PROTOCOL_ERROR = "sohu has changed its protocols, please upgrade this library first. you can also contact kamechb@gmail.com"
+
+    def real_connect
+    	login_for_cookies
+    end
+
+    def contacts
+			return @contacts if @contacts
+      if connected?
+      	data, resp, cookies, forward = get(MAIL_URL,@cookies)
+      	if resp.code_type != Net::HTTPOK
+          raise ConnectionError, self.class.const_get(:PROTOCOL_ERROR)
+        end
+        parse(data)
+      end
+    end
+
+    private
+
+
+    def parse(data)
+			data.match(/ADDRESSES.*?'(\{.*?\})';/m)
+			contacts = ActiveSupport::JSON.decode($1)
+			contacts['contact'].map{|contactor|
+				[contactor['nickname'],contactor['email']]
+			}
+    end
+
+		def login_for_cookies
+			data = {
+				:userid => @login,
+				:password => @password,
+				:appid => '1000',
+				:persistentcookie => '0',
+				:s => '1283173792650',
+				:b => '2',
+				:w => '1280',
+				:pwdtype => '0',
+				:v => '26'
+			}
+			data, resp, cookies, forward = get("#{LOGIN_URL}?#{data.to_query_string}",LOGIN_COOKIE)
+			login_faile_flag = %r{login_status.*?error}
+			if data.match(login_faile_flag)
+				raise AuthenticationError, "Username or password error"
+			end
+			@cookies = cookies
+		end
+
+    TYPES[:sohu] = Sohu
+  end
+
+end

data/lib/contacts/yahoo.rb

@@ -0,0 +1,103 @@
+class Contacts
+  class Yahoo < Base
+    URL                 = "http://mail.yahoo.com/"
+    LOGIN_URL           = "https://login.yahoo.com/config/login"
+    ADDRESS_BOOK_URL    = "http://address.mail.yahoo.com/?.rand=430244936"
+    CONTACT_LIST_URL    = "http://address.mail.yahoo.com/?_src=&_crumb=crumb&sortfield=3&bucket=1&scroll=1&VPC=social_list&.r=time"
+    PROTOCOL_ERROR      = "Yahoo has changed its protocols, please upgrade this library first. If that does not work, dive into the code and submit a patch at http://github.com/cardmagic/contacts"
+    
+    def real_connect      
+      postdata =  ".tries=2&.src=ym&.md5=&.hash=&.js=&.last=&promo=&.intl=us&.bypass="
+      postdata += "&.partner=&.u=4eo6isd23l8r3&.v=0&.challenge=gsMsEcoZP7km3N3NeI4mX"
+      postdata += "kGB7zMV&.yplus=&.emailCode=&pkg=&stepid=&.ev=&hasMsgr=1&.chkP=Y&."
+      postdata += "done=#{CGI.escape(URL)}&login=#{CGI.escape(login)}&passwd=#{CGI.escape(password)}"
+      
+      data, resp, cookies, forward = post(LOGIN_URL, postdata)
+      
+      if data.index("Invalid ID or password") || data.index("This ID is not yet taken")
+        raise AuthenticationError, "Username and password do not match"
+      elsif data.index("Sign in") && data.index("to Yahoo!")
+        raise AuthenticationError, "Required field must not be blank"
+      elsif !data.match(/uncompressed\/chunked/)
+        raise ConnectionError, PROTOCOL_ERROR
+      elsif cookies == ""
+        raise ConnectionError, PROTOCOL_ERROR
+      end
+      
+      data, resp, cookies, forward = get(forward, cookies, LOGIN_URL)
+      
+      if resp.code_type != Net::HTTPOK
+        raise ConnectionError, PROTOCOL_ERROR
+      end
+      
+      @cookies = cookies
+    end
+    
+    def contacts       
+      return @contacts if @contacts
+      if connected?
+        # first, get the addressbook site with the new crumb parameter
+        url = URI.parse(address_book_url)
+        http = open_http(url)
+        resp, data = http.get("#{url.path}?#{url.query}",
+          "Cookie" => @cookies
+        )
+
+        if resp.code_type != Net::HTTPOK
+          raise ConnectionError, self.class.const_get(:PROTOCOL_ERROR)
+        end
+
+        crumb = data.to_s[/dotCrumb:   '(.*?)'/][13...-1]
+
+        # now proceed with the new ".crumb" parameter to get the csv data
+        url = URI.parse(contact_list_url.sub("_crumb=crumb","_crumb=#{crumb}").sub("time", Time.now.to_f.to_s.sub(".","")[0...-2]))
+        http = open_http(url)
+        resp, more_data = http.get("#{url.path}?#{url.query}",
+          "Cookie" => @cookies,
+          "X-Requested-With" => "XMLHttpRequest",
+          "Referer" => address_book_url
+        )
+
+        if resp.code_type != Net::HTTPOK
+        raise ConnectionError, self.class.const_get(:PROTOCOL_ERROR)
+        end
+        
+        if more_data =~ /"TotalABContacts":(\d+)/
+          total = $1.to_i
+          ((total / 50.0).ceil).times do |i|
+            # now proceed with the new ".crumb" parameter to get the csv data
+            url = URI.parse(contact_list_url.sub("bucket=1","bucket=#{i}").sub("_crumb=crumb","_crumb=#{crumb}").sub("time", Time.now.to_f.to_s.sub(".","")[0...-2]))
+            http = open_http(url)
+            resp, more_data = http.get("#{url.path}?#{url.query}",
+              "Cookie" => @cookies,
+              "X-Requested-With" => "XMLHttpRequest",
+              "Referer" => address_book_url
+            )
+
+            if resp.code_type != Net::HTTPOK
+            raise ConnectionError, self.class.const_get(:PROTOCOL_ERROR)
+            end
+
+            parse more_data
+          end
+        end
+        
+        @contacts
+      end
+    end
+
+  private
+    
+    def parse(data, options={})
+      @contacts ||= []
+      @contacts += Contacts.parse_json(data)["response"]["ResultSet"]["Contacts"].to_a.select{|contact|!contact["email"].to_s.empty?}.map do |contact|
+        name = contact["contactName"].split(",")
+        [[name.pop, name.join(",")].join(" ").strip, contact["email"]]
+      end if data =~ /^\{"response":/
+      @contacts
+    end
+    
+  end
+
+  TYPES[:yahoo] = Yahoo
+end

data/lib/im_contacts.rb

@@ -0,0 +1,17 @@
+$:.unshift(File.dirname(__FILE__)+"/contacts/")
+
+require 'rubygems'
+unless Object.const_defined?('ActiveSupport')
+  require 'active_support'
+end
+require 'base'
+require 'gmail'
+require 'hotmail'
+require 'yahoo'
+require 'plaxo'
+require 'aol'
+require 'net_ease'
+require 'sina'
+require 'sohu'
+require 'json_picker'
+require 'hash_ext'