tmoney 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d045f351f71f8ce98cb40fd3c2c998ef2fc9652d
+  data.tar.gz: 2822634461bfebbc1fbd0181bd2973450ba0d6cb
+SHA512:
+  metadata.gz: d42aa8dbd65995d57a056a06d51a002c6532b2aec1e3b2b714094d71383985d1b0e023d66b09490aac7e63607fef39cb5d1001f6302025522a9ade003dda08b6
+  data.tar.gz: bbceb543b326e2dddcbdd9260bf2cd489a865678532d08c3726f2ffff6309dd0aabdcfb0fabb04ac1c835b570bb39f047f8bcbf15f9d3730fc43dafd1f884528

data/.gitignore

@@ -0,0 +1,2 @@
+*.gem
+Gemfile.lock

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "nokogiri"
+gem "rest-client"
+gem "rspec"

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 buo
+
+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,26 @@
+# tmoney
+
+A simple client for [T-money](https://www.t-money.co.kr/).
+
+## How to use
+
+The following is the example which demonstrates how to use T-money client. To test this code, you need to change `<USERNAME>` and `<PASSWORD>` to your own username and password.
+```ruby
+require 'tmoney'
+
+client = Tmoney::Client.new
+client.connect('<USERNAME>', '<PASSWORD>')
+cards = client.cards
+puts '== My Cards', cards
+puts '== Transactions', cards[0].transactions
+```
+
+It will produce the following output:
+```
+== My Cards
+티머니 0000-0000-0000-0000 2015-09-15
+== Transactions
+2015-09-13 19:25:39 지하철 서울메트로(2호선) 1050
+2015-09-13 20:51:06 택시 택시 3400
+2015-09-15 21:44:55 충전 1호선 서울역 50000
+```

data/lib/tmoney.rb

@@ -0,0 +1,77 @@
+require 'tmoney/card'
+require 'tmoney/version'
+
+require 'rest-client'
+require 'nokogiri'
+
+# Set timezone
+ENV['TZ'] = 'Asia/Seoul'
+
+module Tmoney
+  class Client
+    def request(method, url, params = nil)
+      begin
+        headers = {}
+        unless @cookies.nil? or @cookies.empty?
+          headers[:Cookie] = @cookies
+        end
+        url = "https://www.t-money.co.kr#{url}"
+        resp = RestClient::Request.execute(:method => method, :url => url, :payload => params, :headers => headers)
+      rescue RestClient::ExceptionWithResponse => err
+        case err.response.code
+        when 200
+          resp = err.response
+        else
+          raise err
+        end
+      end
+      resp
+    end
+
+    # 로그인
+    def connect(username, password)
+      params = {
+        :logOut => 'N',
+        :indlMbrsId => username,
+        :mbrsPwd => password
+      }
+      resp = request(:post, '/ncs/pct/lgncent/ReadMbrsLgn.dev', params)
+
+      # A string for use in the Cookie header, like “name1=value2; name2=value2”.
+      @cookies = resp.cookie_jar.cookies.join('; ')
+    end
+
+    # 등록된 카드 현황
+    def cards
+      resp = request(:get, '/ncs/pct/mtmn/ReadRgtCardPrcn.dev?logOut=N')
+      doc = Nokogiri::HTML(resp.body)
+      results = []
+      doc.css('.tb_mylist table tbody tr').each do |tr|
+        card = Card.new
+        card.client = self
+
+        # 카드 구분
+        card.type = tr.css('td:nth-child(1)').text.strip
+
+        # 카드 번호. `####-####-####-####` 형태.
+        card.no = tr.css('td:nth-child(2)').text.strip
+
+        # 카드 등록일. `YYYY-MM-DD` 형태.
+        card.regdate = tr.css('td:nth-child(3)').text.strip
+
+        # 등록 서비스
+        # `어`: 어린이 요금 적용
+        # `청`: 청소년 요금 적용
+        # `소`: 소득공제
+        # `현`: 현금영수증
+        # `마`: 마일리지
+        # `분`: 분실/도난
+        card.services = tr.css('td:nth-child(4) span').text.strip.split(//)
+
+        results << card
+      end
+
+      results
+    end
+  end
+end

data/lib/tmoney/card.rb

@@ -0,0 +1,75 @@
+require 'tmoney/transaction'
+
+module Tmoney
+  class Card
+    attr_accessor :type, :no, :regdate, :services
+
+    def client=(client)
+      @client = client
+    end
+
+    # 사용 내역 조회
+    # - 조회기간은 조회신청일(0일) 기준 D-367일 부터 D-2일 까지 가능합니다.
+    # - 사용내역 조회는 홈페이지에 등록된 카드만 제공되며, 카드 등록 이후 내역부터 조회 가능합니다.
+    # - 유패스카드 전환 회원의 사용내역은 2014년 10월 15일 이후부터 조회가 가능합니다.
+    # - 티머니 카드가 아닌 신용카드 및 타사 선불카드의 이용내역은 제공되지 않습니다.
+    # - 회원가입 이전의 사용내역을 원하시는 경우 [사용내역 신청]메뉴를 이용하시기 바랍니다.
+    # - 회원가입 이전에 할인 등록된 카드는 조회하실 수 없으니 새로 등록을 하시기 바랍니다.
+    def transactions
+      params = {
+        # 분류
+        # 분류에 따라 결과 페이지 형식이 달라지므로 변경하지 않는다.
+        # `ALL`: 전체
+        # `USE`: 사용
+        # `CHG`: 충전
+        # `RY` : 환불
+        :inqrDvs => 'ALL',
+
+        # 거래내역 조회 본인 동의 여부
+        # 본인은 조회 하고자 하는 해당 카드가 본인의 소유임을 확인하며, 조회된 거래내역 및 기록이
+        # 제 3자 에게 유출됨으로 인하여 발생하게 되는 모든 문제에 대하여는 그 책임이 본인에게 있음을
+        # 확인 합니다.
+        :agrmYn => 'Y',
+
+        # 카드 번호
+        :srcPrcrNo => @no.gsub(/-/, ''),
+
+        # 조회 기간
+        # `1`: 최근 1주
+        # `2`: 최근 1개월
+        # `3`: 최근 3개월
+        # `4`: 최근 6개월
+        # `5`: 최근 1년
+        :srcChcDiv => 5,
+
+        # 조회 시작 일자. `YYYY-MM-DD` 형태
+        :srcSttDt => @regdate,
+
+        # 조회 종료 일자. `YYYY-MM-DD` 형태
+        :srcEdDt => Time.new.strftime('%Y-%m-%d')
+      }
+      resp = @client.request(:post, '/ncs/pct/mtmn/ReadTrprInqr.dev', params)
+
+      doc = Nokogiri::HTML(resp.body)
+
+      results = []
+      doc.css('#protable tbody tr').each do |tr|
+        t = Transaction.new
+
+        t.datetime = Time.parse(tr.css('td:nth-child(1)').text.strip)
+        t.category = tr.css('td:nth-child(2)').text.strip
+        t.payee = tr.css('td:nth-child(3)').text.strip
+        t.amount = tr.css('td:nth-child(4)').text.gsub(/[,원]/, '').strip.to_i
+
+        results << t
+      end
+
+      # Sort transactions in ascending order (old to new).
+      results.reverse
+    end
+
+    def to_s
+      "#{@type} #{@no} #{@regdate} #{@services.join(',')}"
+    end
+  end
+end

data/lib/tmoney/transaction.rb

@@ -0,0 +1,9 @@
+module Tmoney
+  class Transaction
+    attr_accessor :datetime, :category, :payee, :amount
+
+    def to_s
+      "#{@datetime.strftime('%Y-%m-%d %H:%M:%S')} #{@category} #{@payee} #{@amount}"
+    end
+  end
+end

data/lib/tmoney/version.rb

@@ -0,0 +1,3 @@
+module Tmoney
+  VERSION = "0.1.1"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+RSpec.configure do |config|
+end

data/spec/tmoney_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+require 'tmoney'
+
+describe Tmoney::Client do
+end

data/tmoney.gemspec

@@ -0,0 +1,17 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'tmoney/version'
+
+Gem::Specification.new do |gem|
+  gem.name        = 'tmoney'
+  gem.version     = Tmoney::VERSION
+  gem.authors     = ['buo']
+  gem.email       = ['buo@users.noreply.github.com']
+  gem.summary     = 'A simple client for T-Money'
+  gem.description = 'A simple client for T-Money (https://www.t-money.co.kr/)'
+  gem.homepage    = 'https://github.com/buo/tmoney'
+  gem.license     = 'MIT'
+
+  gem.files       = `git ls-files`.split($/)
+  gem.require_paths = ['lib']
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: tmoney
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- buo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-15 00:00:00.000000000 Z
+dependencies: []
+description: A simple client for T-Money (https://www.t-money.co.kr/)
+email:
+- buo@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- lib/tmoney.rb
+- lib/tmoney/card.rb
+- lib/tmoney/transaction.rb
+- lib/tmoney/version.rb
+- spec/spec_helper.rb
+- spec/tmoney_spec.rb
+- tmoney.gemspec
+homepage: https://github.com/buo/tmoney
+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.0.14
+signing_key: 
+specification_version: 4
+summary: A simple client for T-Money
+test_files: []