presto_api 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c5713fb98d88b077aa5848a8a2dd51ddde039d3d
+  data.tar.gz: 03044d222c4672a4016350234be80b8d6efb78c1
+SHA512:
+  metadata.gz: 639eb8efdb1b13d527edc04dd9c564d380e967c4735a74f22f15bad92455d5f1aa195e69f3e095728c5be6c39d935014d50c471eb5f9257b60d0504e3884c789
+  data.tar.gz: f570924bb8a1b37a7d8088e57060d32fb8fe42397c1850ea00cf6b5f5908e05096b8ecdf566d847ea9562b4aa33f646b630b7551e6928da0280a367b0cf518c9

data/.gitignore

@@ -0,0 +1,6 @@
+.config
+InstalledFiles
+pkg
+*.gem
+.bundle
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 JP Simard
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,49 @@
+# The Presto Gem
+
+Gem for interacting with [Presto cards](http://prestocard.ca). Currently supports the following features:
+
+* Registered and unregistered cards (i.e. username/passwords or card numbers)
+* Card Status
+	* Status
+	* Balance
+* User Information
+	* First Name
+	* Last Name
+	* Address 1
+	* Address 2
+	* City
+	* Province
+	* Country
+	* Postal Code
+	* Phone Number
+	* Email
+	* Security Question
+	* Security Answer
+* Transaction History
+	* Date
+	* Service Provider
+	* Location
+	* Type
+	* Amount
+	* Balance
+	* Loyalty Month
+	* Loyalty Trip
+	* Loyalty Step
+	* Loyalty Discount
+
+## Usage
+
+```ruby
+require 'presto_api'
+
+status = PrestoAPI::Client.new.card_status_with_number('XXXXXXXXXXXXXXXXX')
+puts status.balance
+```
+
+## License
+
+MIT Licensed.
+
+## Notice
+
+Please respect the Presto website's [Terms and Conditions](https://www.prestocard.ca/en-US/Pages/ContentPages/Terms.aspx).

data/Rakefile

@@ -0,0 +1,21 @@
+require "bundler/setup"
+Bundler::GemHelper.install_tasks
+
+require 'spec/rake/spectask'
+
+Spec::Rake::SpecTask.new("spec") do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts = ['--color']
+end
+
+Spec::Rake::SpecTask.new("rcov_spec") do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts = ['--color']
+  t.rcov = true
+  t.rcov_opts = ['--exclude', '^spec,/gems/']
+end
+
+task :test => :spec
+
+desc "Run specs as default activity"
+task :default => :spec

data/lib/presto_api/version.rb

@@ -0,0 +1,3 @@
+module PrestoAPI
+  VERSION = "0.0.1"
+end

data/lib/presto_api.rb

@@ -0,0 +1,179 @@
+require 'rubygems'
+require 'mechanize'
+
+module PrestoAPI
+  class Base
+    def to_json
+      hash = {}
+      self.instance_variables.each do |var|
+        # Remove @ symbol from var name
+        key = var.to_s[1..-1]
+        hash[key] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+
+    def from_json! string
+      JSON.load(string).each do |var, val|
+        self.instance_variable_set var, val
+      end
+    end
+  end
+
+  class CardStatus < Base
+    attr_accessor :balance, :status
+  end
+
+  class User < Base
+    attr_accessor :first_name,
+      :last_name,
+      :address,
+      :apt,
+      :city,
+      :province,
+      :country,
+      :postal_code,
+      :phone_number,
+      :email,
+      :security_question,
+      :security_answer
+  end
+
+  class Transaction < Base
+    attr_accessor :date,
+      :service_provider,
+      :location,
+      :type,
+      :amount,
+      :balance,
+      :loyalty_month,
+      :loyalty_trip,
+      :loyalty_step,
+      :loyalty_discount
+  end
+
+  class Client
+    def user_with_username_password(username, password)
+      login_with_username_password(username, password)
+      user_from_page(agent.get('https://www.prestocard.ca/en-US/Pages/TransactionalPages/ViewUpdateRegistration.aspx'))
+    end
+
+    def transaction_history_with_username_password(username, password)
+      login_with_username_password(username, password)
+      transaction_history_from_page(agent.get('https://www.prestocard.ca/en-US/Pages/TransactionalPages/TransactionHistory.aspx'))
+    end
+
+    def card_status_with_username_password(username, password)
+      card_status_from_page(login_with_username_password(username, password))
+    end
+
+    def card_status_with_number(card_number)
+      card_status_from_page(login_with_card_number(card_number))
+    end
+
+    private
+
+    def login_with_username_password(username, password)
+      # Fill out the registered login form
+      field_hash = {
+        'ctl00$SPWebPartManager1$AccountLoginWebpartControl$ctl00$webpartRegisteredUserLogin$ctl00$textboxRegisteredLogin' => username,
+        'ctl00$SPWebPartManager1$AccountLoginWebpartControl$ctl00$webpartRegisteredUserLogin$ctl00$textboxPassword' => password
+      }
+      button_name = 'ctl00$SPWebPartManager1$AccountLoginWebpartControl$ctl00$webpartRegisteredUserLogin$ctl00$buttonSubmit'
+      submit_form(login_page.forms.first, field_hash, button_name)
+    end
+
+    def login_with_card_number(card_number)
+      # Fill out the anonymous login form
+      field_hash = {
+        'ctl00$SPWebPartManager1$AccountLoginWebpartControl$ctl00$webpartAnonymousUserLogin$ctl00$textboxAnonymousLogin' => card_number
+      }
+      button_name = 'ctl00$SPWebPartManager1$AccountLoginWebpartControl$ctl00$webpartAnonymousUserLogin$ctl00$buttonSubmit'
+      submit_form(login_page.forms.first, field_hash, button_name)
+    end
+
+    def login_page
+      @login_page ||= agent.get('https://www.prestocard.ca/en-US/Pages/TransactionalPages/AccountLogin.aspx')
+    end
+
+    def submit_form(form, field_hash, button_name)
+      field_hash.each do |key, value|
+        form.field_with(:name => key).value = value
+      end
+      button = form.button_with(:name => button_name)
+      agent.submit(form, button)
+    end
+
+    def card_status_from_page(page)
+      balance = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_AFMSCardSummaryWebpart_ctl00_wizardCardSummary_labelDisplayBalance"]/text()[last()]').last
+      status = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_AFMSCardSummaryWebpart_ctl00_wizardCardSummary_labelDisplayCardStatus"]/text()[last()]').last
+      if !balance || !status
+        puts 'Try logging in with username/password instead of just the card number'
+        return nil
+      end
+      card_status = CardStatus.new
+      card_status.status = status.content
+      card_status.balance = balance.content
+      card_status
+    end
+
+    def user_from_page(page)
+      first_name = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelFirstNameOutput"]/text()[last()]').last
+      last_name = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelLastNameOutput"]/text()[last()]').last
+      address = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelStreetAddress1Output"]/text()[last()]').last
+      apt = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelStreetAddress1Output"]/text()[last()]').last
+      city = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelCityOutput"]/text()[last()]').last
+      province = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelProvinceOutput"]/text()[last()]').last
+      country = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelCountryOutput"]/text()[last()]').last
+      postal_code = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelPostalCodeOutput"]/text()[last()]').last
+      phone_number = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelPrimaryTelephoneNumberOutput"]/text()[last()]').last
+      email = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_labelEmailAddressOutput"]/text()[last()]').last
+      security_question = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_webPartSecurityDetails_ctl00_labelSecurityQuestionOutput"]/text()[last()]').last
+      security_answer = page.parser.xpath('//span[@id="ctl00_SPWebPartManager1_updateRegistrationWebPart_ctl00_WizardViewUpdateProfile_webPartSecurityDetails_ctl00_labelSecurityResponseOutput"]/text()[last()]').last
+
+      if !first_name
+        puts 'There is no user information assigned to this account'
+        return nil
+      end
+
+      user = User.new
+      user.first_name = first_name.content || ''
+      user.last_name = last_name.content || ''
+      user.address = address.content || ''
+      user.apt = apt.content || ''
+      user.city = city.content || ''
+      user.province = province.content || ''
+      user.country = country.content || ''
+      user.postal_code = postal_code.content || ''
+      user.phone_number = phone_number.content || ''
+      user.email = email.content || ''
+      user.security_question = security_question.content || ''
+      user.security_answer = security_answer.content || ''
+      user
+    end
+
+    def transaction_history_from_page(page)
+      number_of_items = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']").children.count
+      transaction_history = []
+      for i in 2..number_of_items
+        transaction = Transaction.new
+        transaction.date = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[1]").last.content
+        transaction.service_provider = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[2]").last.content
+        transaction.location = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[3]").last.content
+        transaction.type = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[4]").last.content
+        transaction.amount = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[5]").last.content
+        transaction.balance = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[6]").last.content
+        transaction.loyalty_month = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[7]").last.content
+        transaction.loyalty_trip = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[8]").last.content
+        transaction.loyalty_step = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[9]").last.content
+        transaction.loyalty_discount = page.parser.xpath("//table[@id='ctl00_SPWebPartManager1_CheckTransactionHistoryWebPartControl_ctl00_ViewTransactionHistory_gridTransactionHistory']/tr[#{i}]/td[10]").last.content
+        transaction_history.push transaction
+      end
+      transaction_history
+    end
+
+    def agent
+      @agent ||= Mechanize.new
+    end
+  end
+end

data/presto_api.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "presto_api/version"
+
+Gem::Specification.new do |s|
+  s.name        = "presto_api"
+  s.version     = PrestoAPI::VERSION
+  s.licenses    = ['MIT']
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['JP Simard']
+  s.email       = ["jp@jpsim.com"]
+  s.homepage    = "https://github.com/jpsim/presto-gem"
+  s.summary     = "Gem for interacting with Presto cards."
+  s.description = "Gem for interacting with Presto cards, using mechanize."
+
+  s.files         = `git ls-files`.split("\n")
+  s.require_paths = ["lib"]
+  
+  s.add_dependency "mechanize", "2.7.3"
+
+  s.add_development_dependency "rake", '~> 0'
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: presto_api
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- JP Simard
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mechanize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.7.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.7.3
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Gem for interacting with Presto cards, using mechanize.
+email:
+- jp@jpsim.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/presto_api.rb
+- lib/presto_api/version.rb
+- presto_api.gemspec
+homepage: https://github.com/jpsim/presto-gem
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Gem for interacting with Presto cards.
+test_files: []