pokitdok-ruby 0.2.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9b98345c45efe8a25ddc256e9d307c345b340c20
+  data.tar.gz: f69095d7412c999eed38f5a95cbf6c11a0f9ca51
+SHA512:
+  metadata.gz: 8eb6c6ae134c48789095fd59585dbb8087faa8fd05db0715c6a11ffc7dd27ffbc8db94f90649f3ed77fc3992dfbbddc63b630b30abf73362fd1bbe379af5b0a9
+  data.tar.gz: be9f03e159860c775b92bb20314c0a2477d24dc0108cff00d8978a017712106e9311bcdb4216ef17b378bf78385532974a1bce38e8d91cb6d088d93cdcea0de1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 2.1.1
+  - 2.0.0
+  - 1.9.3
+  - jruby-19mode # JRuby in 1.9 mode
+  - rbx-2.1.1
+  

data/Gemfile

@@ -0,0 +1,21 @@
+source 'http://rubygems.org'
+gem 'oauth2', '~> 0.9', require: 'oauth2'
+gem 'multipart-post', '~> 2.0'
+
+group :development do
+	gem 'bundler', '~> 1.0'
+	gem 'minitest', '~> 5.3'
+	gem 'mocha', '~> 1.0'
+	gem 'simplecov', '~> 0.8'
+	gem 'rubocop', '~> 0.20'
+	gem 'rdoc', '~> 4.1'
+	gem 'jeweler', '~> 2.0'
+	gem 'ansi', '~> 1.4'
+	gem 'minitest-reporters', '~> 1.0'
+	gem 'vcr', '~> 2.9'
+	gem 'webmock', '~> 1.17'
+	gem 'guard', '~> 2.6'
+	gem 'guard-minitest', '~> 2.2'
+	gem 'terminal-notifier-guard', '~> 1.5'
+	gem 'guard-rubocop', '~> 1.0'
+end

data/Gemfile.lock

@@ -0,0 +1,140 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.6)
+    ansi (1.4.3)
+    ast (2.0.0)
+    builder (3.2.2)
+    celluloid (0.15.2)
+      timers (~> 1.1.0)
+    coderay (1.1.0)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    docile (1.1.3)
+    faraday (0.9.0)
+      multipart-post (>= 1.2, < 3)
+    ffi (1.9.3)
+    formatador (0.2.5)
+    git (1.2.6)
+    github_api (0.11.3)
+      addressable (~> 2.3)
+      descendants_tracker (~> 0.0.1)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 1.2)
+      multi_json (>= 1.7.5, < 2.0)
+      nokogiri (~> 1.6.0)
+      oauth2
+    guard (2.6.1)
+      formatador (>= 0.2.4)
+      listen (~> 2.7)
+      lumberjack (~> 1.0)
+      pry (>= 0.9.12)
+      thor (>= 0.18.1)
+    guard-minitest (2.3.0)
+      guard (~> 2.0)
+      minitest (>= 3.0)
+    guard-rubocop (1.1.0)
+      guard (~> 2.0)
+      rubocop (~> 0.20)
+    hashie (3.0.0)
+    highline (1.6.21)
+    jeweler (2.0.1)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (1.0.0)
+    listen (2.7.6)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.6)
+    metaclass (0.0.4)
+    method_source (0.8.2)
+    mini_portile (0.6.0)
+    minitest (5.3.4)
+    minitest-reporters (1.0.4)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    mocha (1.1.0)
+      metaclass (~> 0.0.1)
+    multi_json (1.10.1)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.2.1)
+      mini_portile (= 0.6.0)
+    oauth2 (0.9.4)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    parser (2.1.9)
+      ast (>= 1.1, < 3.0)
+      slop (~> 3.4, >= 3.4.5)
+    powerpack (0.0.9)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rack (1.5.2)
+    rainbow (2.0.0)
+    rake (10.3.2)
+    rb-fsevent (0.9.4)
+    rb-inotify (0.9.4)
+      ffi (>= 0.5.0)
+    rdoc (4.1.1)
+      json (~> 1.4)
+    rubocop (0.23.0)
+      json (>= 1.7.7, < 2)
+      parser (~> 2.1.9)
+      powerpack (~> 0.0.6)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.4)
+    ruby-progressbar (1.5.1)
+    safe_yaml (1.0.3)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    slop (3.5.0)
+    terminal-notifier-guard (1.5.3)
+    thor (0.19.1)
+    thread_safe (0.3.4)
+    timers (1.1.0)
+    vcr (2.9.2)
+    webmock (1.18.0)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  ansi (~> 1.4)
+  bundler (~> 1.0)
+  guard (~> 2.6)
+  guard-minitest (~> 2.2)
+  guard-rubocop (~> 1.0)
+  jeweler (~> 2.0)
+  minitest (~> 5.3)
+  minitest-reporters (~> 1.0)
+  mocha (~> 1.0)
+  multipart-post (~> 2.0)
+  oauth2 (~> 0.9)
+  rdoc (~> 4.1)
+  rubocop (~> 0.20)
+  simplecov (~> 0.8)
+  terminal-notifier-guard (~> 1.5)
+  vcr (~> 2.9)
+  webmock (~> 1.17)

data/Guardfile

@@ -0,0 +1,18 @@
+# Guardfile for pokitdok-ruby
+
+guard :minitest do
+  # with Minitest::Unit
+  watch(%r{^test/(.*)\/?test_(.*)\.rb$})
+  watch(%r{^lib/(.*/)?([^/]+)\.rb$})     { |m| "test/#{m[1]}test_#{m[2]}.rb" }
+  watch(%r{^test/test_helper\.rb$})      { 'test' }
+
+  # with Minitest::Spec
+  watch(%r{^spec/(.*)_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})         { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^spec/spec_helper\.rb$}) { 'spec' }
+end
+
+guard :rubocop do
+  watch(%r{.+\.rb$})
+  watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 PokitDok, Inc.
+
+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,80 @@
+[![Build Status](https://travis-ci.org/pokitdok/pokitdok-ruby.svg?branch=master)](https://travis-ci.org/pokitdok/pokitdok-ruby)
+[![Gem Version](https://badge.fury.io/rb/pokitdok-ruby.svg)](http://badge.fury.io/rb/pokitdok-ruby)
+
+pokitdok-ruby
+=============
+
+PokitDok Platform API Client for Ruby
+
+## Resources
+* [Read the PokitDok API docs][apidocs]
+* [View Source on GitHub][code]
+* [Report Issues on GitHub][issues]
+
+[apidocs]: https://platform.pokitdok.com/dashboard#/documentation
+[code]: https://github.com/PokitDok/pokitdok-ruby
+[issues]: https://github.com/PokitDok/pokitdok-ruby/issues
+
+## Installation
+    gem install pokitdok-ruby
+
+## Quick Start
+```ruby
+require 'pokitdok'
+pd = PokitDok::PokitDok.new("your_client_id", "your_client_secret")
+
+# Retrieve provider information by NPI
+pd.providers(npi: '1467560003')
+
+# Search providers by name (individuals)
+pd.providers(first_name: 'JEROME', last_name: 'AYA-AY')
+
+# Search providers by name (organizations)
+pd.providers(name: 'Qliance')
+
+# Search providers by location and/or specialty
+pd.providers(zipcode: '29307', radius: '10mi')
+pd.providers(zipcode: '29307', radius: '10mi', specialty: 'RHEUMATOLOGY')
+
+# Eligibility
+params = {
+  trading_partner_id: 'MOCKPAYER',
+  member_id: 'W34237875729',
+  provider_id: '1467560003',
+  provider_name: 'AYA-AY',
+  provider_first_name: 'JEROME',
+  provider_type: 'Person',
+  member_name: 'JOHN DOE',
+  member_birth_date: '05-21-1975',
+  service_types: ['Health Benefit Plan Coverage']
+}
+
+pd.eligibility(params)
+
+# Retrieve an index of activities
+pd.activities 
+
+# Check on a specific activity
+pd.activities(activity_id: '5362b5a064da150ef6f2526c')
+
+# Check on a batch of activities
+pd.activities(parent_id: '537cd4b240b35755f5128d5c')
+
+# Upload an EDI file
+pd.files('trading_partner_id', 'path/to/a_file.edi')
+              
+```
+
+## Supported Ruby Versions
+This library aims to support and is tested against these Ruby versions:
+
+* Ruby 1.9.3-p545
+* Ruby 2.0.0-p451
+* Ruby 2.1.1
+
+You may have luck with other interpreters - let us know how it goes.
+
+## License
+Copyright (c) 2014 PokitDok Inc. See [LICENSE][] for details.
+
+[license]: LICENSE.txt

data/Rakefile

@@ -0,0 +1,59 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts 'Run `bundle install` to install missing gems'
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  gem.name = 'pokitdok-ruby'
+  gem.homepage = 'http://github.com/pokitdok/pokitdok-ruby'
+  gem.license = 'MIT'
+  gem.summary = %Q(Gem for easy access to the PokitDok Platform APIs)
+  gem.description = %Q(Gem for easy access to the PokitDok Platform APIs.)
+  gem.email = 'john.riney@pokitdok.com'
+  gem.authors = ['John Riney']
+end
+
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.verbose = true
+end
+
+desc 'Code coverage detail'
+task :simplecov do
+  ENV['COVERAGE'] = 'true'
+  Rake::Task['spec'].execute
+end
+
+task default: :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  @version = File.exist?('VERSION') ? File.read('VERSION') : ''
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = 'pokitdok-ruby #{@version}'
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.main = 'README.md'
+end
+
+require 'rubocop/rake_task'
+desc 'Run RuboCop on the lib and test directory'
+RuboCop::RakeTask.new(:rubocop) do |task|
+  task.patterns = %w( 'lib/**/*.rb' 'test/**/*.rb' )
+  task.formatters = %w( 'offenses' 'progress' )
+  task.fail_on_error = false
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.3

data/lib/pokitdok.rb

@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2014, All Rights Reserved, PokitDok, Inc.
+# https://www.pokitdok.com
+#
+# Please see the LICENSE.txt file for more information.
+# All other rights reserved.
+#
+
+require 'rubygems'
+require 'bundler/setup'
+require 'base64'
+require 'json'
+require 'oauth2'
+require 'net/http/post/multipart'
+
+module PokitDok
+  # PokitDok API client implementation for Ruby.
+  class PokitDok
+    POKITDOK_URL_BASE = 'https://platform.pokitdok.com' # :nodoc:
+
+    attr_reader :client # :nodoc:
+    attr_reader :token  # :nodoc:
+
+    # Connect to the PokitDok API with the specified Client ID and Client
+    # Secret.
+    #
+    # +client_id+     your client ID, provided by PokitDok
+    #
+    # +client_secret+ your client secret, provided by PokitDok
+    #
+    def initialize(client_id, client_secret)
+      @client_id = client_id
+      @client_secret = client_secret
+
+      @client = OAuth2::Client.new(@client_id, @client_secret,
+                                   site: api_url, token_url: '/oauth2/token')
+      refresh_token
+    end
+
+    # Returns the URL used to communicate with the PokitDok API.
+    def api_url
+      POKITDOK_URL_BASE + '/api/v3'
+    end
+
+    def user_agent
+      "pokitdok-ruby 0.2.1 #{RUBY_DESCRIPTION}"
+    end
+
+    # returns a standard set of headers to be passed along with all requests
+    def headers
+      { 'User-Agent' => user_agent }
+    end
+
+    # Refreshes the client token associated with this PokitDok connection
+    #
+    # FIXME: automatic refresh on expiration
+    def refresh_token
+      @token = client.client_credentials.get_token(
+        headers: { 'Authorization' => 'Basic' })
+    end
+
+    # Invokes the activities endpoint, with an optional Hash of parameters.
+    def activities(params = {})
+      response = @token.get('activities',
+                            headers: headers,
+                            params: params)
+      JSON.parse(response.body)
+    end
+
+    # Invokes the cash prices endpoint, with an optional Hash of parameters.
+    def cash_prices(_params = {})
+      fail NotImplementedError, "The PokitDok API does not currently support
+        this endpoint."
+    end
+
+    # Invokes the claims endpoint, with an optional Hash of parameters.
+    def claims(params = {})
+      response = @token.post('claims/',
+                             headers: headers,
+                             body: params.to_json) do |request|
+        request.headers['Content-Type'] = 'application/json'
+      end
+      JSON.parse(response.body)
+    end
+
+    # Invokes the claims status endpoint, with an optional Hash of parameters.
+    def claim_status(_params = {})
+      fail NotImplementedError, 'The PokitDok API does not currently support
+        this endpoint.'
+    end
+
+    # Invokes the deductible endpoint, with an optional Hash of parameters.
+    def deductible(_params = {})
+      fail NotImplementedError, 'The PokitDok API does not currently support
+        this endpoint.'
+    end
+
+    # Invokes the eligibility endpoint, with an optional Hash of parameters.
+    def eligibility(params = {})
+      response = @token.post('eligibility/',
+                             headers: headers,
+                             body: params.to_json) do |request|
+        request.headers['Content-Type'] = 'application/json'
+      end
+      JSON.parse(response.body)
+    end
+
+    # Invokes the enrollment endpoint, with an optional Hash of parameters.
+    def enrollment(params = {})
+      response = @token.post('enrollment/',
+                             headers: headers,
+                             body: params.to_json) do |request|
+        request.headers['Content-Type'] = 'application/json'
+      end
+      JSON.parse(response.body)
+    end
+
+    # Uploads an EDI file to the files endpoint.
+    # Uses the multipart-post gem, since oauth2 doesn't support multipart.
+    #
+    # +trading_partner_id+ the trading partner to transmit to
+    #
+    # +filename+ the path to the file to transmit
+    #
+    def files(trading_partner_id, filename)
+      url = URI.parse(api_url + '/files/')
+
+      File.open(filename) do |f|
+        req = Net::HTTP::Post::Multipart.new url.path,
+          'file' => UploadIO.new(f, 'application/EDI-X12', filename),
+          'trading_partner_id' => trading_partner_id
+        req['Authorization'] = "Bearer #{@token.token}"
+        req['User-Agent'] = user_agent
+
+        @response = Net::HTTP.start(url.host, url.port) do |http|
+          http.request(req)
+        end
+      end
+
+      JSON.parse(@response.body)
+    end
+
+    # Invokes the insurance prices endpoint, with an optional Hash of
+    # parameters.
+    def insurance_prices(params = {})
+      response = @token.get('prices/insurance',
+                            headers: headers,
+                            params: params)
+      JSON.parse(response.body)
+    end
+
+    # Invokes the payers endpoint, with an optional Hash of parameters.
+    def payers(params = {})
+      response = @token.get('payers', headers: headers, params: params)
+      JSON.parse(response.body)
+    end
+
+    # Invokes the providers endpoint, with an optional Hash of parameters.
+    def providers(params = {})
+      response = @token.get('providers') do |request|
+        request.params = params
+      end
+      JSON.parse(response.body)
+    end
+  end
+end