mintkit 0.0.1 → 0.0.2

data/README.md

@@ -18,7 +18,30 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+Command line: 
+
+``` shell
+mintkit --help
+```
+
+Ruby API: 
+
+```ruby
+client = Mintkit::Client.new(username,password)
+
+# refresh your account
+client.refresh             #refresh the accounts (it doesn't block yet while refreshing)
+
+# dump all accounts and transactions
+puts client.accounts       #print out the accounts
+puts client.transactions   #print out all your transactions
+
+# or use iterators (works for accounts as well)
+client.transactions do |t|
+   puts "#{t[:account]} #{t[:amount]} #{t[:description]} #{t[:date]}"
+end
+
+```
 
 ## Contributing
 

data/bin/mintkit

@@ -0,0 +1,102 @@
+#!/usr/bin/env ruby
+
+require 'mintkit'
+require 'trollop'
+require 'io/console'
+
+
+Signal.trap("PIPE", "EXIT")
+
+############################3
+# Main functions
+#
+
+def refresh(client)
+  client.refresh
+
+  puts "Account is currently refreshing.  It might take a minute or two"
+
+end
+
+def accounts(client)
+  client.accounts do |a|
+    puts "%-10s %10s   %s" % [a[:account_type],a[:value],a[:name][0..27]]
+  end
+
+end
+
+def transactions(client)
+  client.transactions do |t|
+    sign = "-"
+    sign = "" if t[:type] == "credit"
+    puts "%-11s %1s%-9s %s" % [ t[:date].strftime("%-m/%-d/%Y"), sign, t[:amount], t[:description]]
+    #puts "#{t[:date]}  #{t[:amount]}  \t#{t[:description]}" 
+  end
+
+end
+
+#############################3
+# Options, etc
+
+opts = Trollop::options do
+  version Mintkit::VERSION
+  banner <<-EOS
+Mintkit provides a simple interface to Mint.com.  Not affiliated with Mint.com or Intuit.  Your mileage may vary.
+
+Usage:
+  mintkit [options] command
+
+where command is one of:
+  refresh         :refreshes your accounts
+  accounts        :lists your accounts and balances
+  transactions    :lists your transactions
+
+and options are:
+EOS
+
+  opt :username, "Mint.com username", :type => :string
+  opt :password, "Mint.com password", :type => :string
+end
+
+username = opts.username
+password = opts.password
+
+command = ARGV.shift
+args = ARGV.join(' ')
+
+unless command
+  puts "Error: no command specified.  Try \"mintkit --help\""
+  exit
+end
+
+unless username
+  print "Mint.com username: "
+  username = $stdin.gets.chomp
+end
+
+unless password
+  print "Mint.com password: "
+  password = STDIN.noecho(&:gets)
+  print "\n"
+end
+
+
+#############################3
+#
+# create the client and call the appropriate function
+
+
+client = Mintkit::Client.new(username,password)
+
+case 
+when command == 'refresh'
+  refresh(client)
+
+when command == 'accounts'
+  accounts(client)
+
+when command == 'transactions'
+  transactions(client)
+else
+  puts "No such command: #{command}"
+end

data/lib/mintkit/client.rb

@@ -10,14 +10,15 @@ module Mintkit
       @username = username
       @password = password
       @token = nil
+      @agent = Mechanize.new{|a| a.ssl_version, a.verify_mode = 'SSLv3', OpenSSL::SSL::VERIFY_NONE}
+      login
 
     end
 
     # login to my account
     # get all the transactions
     def transactions
-      agent = login
-      raw_transactions = agent.get("https://wwws.mint.com/transactionDownload.event?").body
+      raw_transactions = @agent.get("https://wwws.mint.com/transactionDownload.event?").body
 
       transos = []
 
@@ -38,38 +39,59 @@ module Mintkit
           }
           transos << transaction
 
+        if block_given?
+          yield transaction
+        end
+
         end
 
-        
       end
-      logout(agent)
       transos
       
     end
 
     def accounts
-      agent = login
-      page = agent.get('https://wwws.mint.com/overview.event')
-
+      page = @agent.get('https://wwws.mint.com/overview.event')
 
       requeststring = %q#[{"args":{"types":["BANK","CREDIT","INVESTMENT","LOAN","MORTGAGE","OTHER_PROPERTY","REAL_ESTATE","VEHICLE","UNCLASSIFIED"]},"service":"MintAccountService","task":"getAccountsSortedByBalanceDescending","id":"8675309"}]#
 
-      accounts = JSON.parse(agent.post("https://wwws.mint.com/bundledServiceController.xevent?token=#{@token}",{"input" => requeststring}).body)["response"]["8675309"]["response"]
+      accounts = JSON.parse(@agent.post("https://wwws.mint.com/bundledServiceController.xevent?token=#{@token}",{"input" => requeststring}).body)["response"]["8675309"]["response"]
+
+      accountlist = []
+      accounts.each do |a|
+        account = {
+          :current_balance => a["currentBalance"],
+          :login_status => a["fiLoginUIStatus"],
+          :currency => a["currency"],
+          :id => a["id"],
+          :amount_due => a["dueAmt"],
+          :name => a["name"],
+          :value => a["value"],
+          #:due_date => Date.strptime(a["dueDate"], '%m/%d/%Y'),
+          :last_updated => Time.at(a["lastUpdated"]/1000).to_date,
+          :last_updated_string => a["lastUpdatedInString"],
+          :active => !!a["isActive"],
+          :login_status => a["fiLoginStatus"],
+          :account_type => a["accountType"],
+          :date_added => Time.at(a["addAccountDate"]/1000).to_date
+        }
+
+        if block_given?
+          yield account
+        end
 
-      logout(agent)
- 
-      accounts
+        accountlist << account
+
+      end
+      accountlist
 
     end
 
     # force a refresh on my account
     def refresh
-      agent = login
-      page = agent.get('https://wwws.mint.com/overview.event')
-
-      agent.post("https://wwws.mint.com/refreshFILogins.xevent", {"token"=>@token})
+      page = @agent.get('https://wwws.mint.com/overview.event')
 
-      logout(agent)
+      @agent.post("https://wwws.mint.com/refreshFILogins.xevent", {"token"=>@token})
 
       true
       
@@ -78,19 +100,23 @@ module Mintkit
 
     def login
 
-      agent = Mechanize.new{|a| a.ssl_version, a.verify_mode = 'SSLv3', OpenSSL::SSL::VERIFY_NONE}
-      page = agent.get('https://wwws.mint.com/login.event')
+      page = @agent.get('https://wwws.mint.com/login.event')
       form = page.forms[2]
       form.username = @username
       form.password = @password
-      page = agent.submit(form,form.buttons.first)
-      @token = page.at('input').attributes["value"].value.match(/"token":"([0-9a-zA-Z]*)"/)[1]
-      agent
+      page = @agent.submit(form,form.buttons.first)
+      if page.at('input').attributes["value"]
+        @token = page.at('input').attributes["value"].value.match(/"token":"([0-9a-zA-Z]*)"/)[1]
+        true
+      else
+        false
+      end
+
 
     end
 
-    def logout(agent)
-      agent.get('https://wwws.mint.com/logout.event?task=explicit')
+    def logout
+      @agent.get('https://wwws.mint.com/logout.event?task=explicit')
       true
     end
 

data/lib/mintkit/version.rb

@@ -1,3 +1,3 @@
 module Mintkit
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/mintkit.gemspec

@@ -18,7 +18,8 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "mechanize"
+  spec.add_runtime_dependency "mechanize"
+  spec.add_runtime_dependency "trollop"
 
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "rake"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mintkit
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-06 00:00:00.000000000 Z
+date: 2013-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mechanize
@@ -27,6 +27,22 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -79,7 +95,8 @@ description: Ruby API for mint.com. Not at all affiliated with or endorsed by  m
   mileage may vary.
 email:
 - robscanlon@gmail.com
-executables: []
+executables:
+- mintkit
 extensions: []
 extra_rdoc_files: []
 files:
@@ -88,6 +105,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- bin/mintkit
 - lib/mintkit.rb
 - lib/mintkit/client.rb
 - lib/mintkit/version.rb