lifen-fhir 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 59562c836fd00fe186bd7a80c426c9a04de67450
+  data.tar.gz: cdd6c4a303f5af5d9649c0bf2945ed30c0d1758f
+SHA512:
+  metadata.gz: d892166f3d655146c8eea87e9368608e4706795f93cbef9103151bfef799e28a1f68eb218a62f96380485385974f96c7155b76d8b5b336605d72ebc9de5958ff
+  data.tar.gz: faa32a8f504e12a7eb5191803094458b709a1428dc1c76350ed5b6d853fdcb75585423b25448e0288dc7539f60c91ad10ec621d921a3c9f6ee140e80e528fd7d

data/.gitignore

@@ -0,0 +1,17 @@
+.DS_Store
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.ruby-version

@@ -0,0 +1 @@
+2.4.1

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+0.1.0
+-----
+
+- Lifen is on FHIR !

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,74 @@
+PATH
+  remote: .
+  specs:
+    lifen-fhir (0.1.0)
+      faraday (>= 0.9)
+      inflecto
+      virtus (>= 1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.5.1)
+      public_suffix (~> 2.0, >= 2.0.2)
+    awesome_print (1.7.0)
+    axiom-types (0.1.1)
+      descendants_tracker (~> 0.0.4)
+      ice_nine (~> 0.11.0)
+      thread_safe (~> 0.3, >= 0.3.1)
+    coercible (1.0.0)
+      descendants_tracker (~> 0.0.1)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.3)
+    equalizer (0.0.11)
+    faraday (0.12.1)
+      multipart-post (>= 1.2, < 3)
+    hashdiff (0.3.4)
+    ice_nine (0.11.2)
+    inflecto (0.0.2)
+    multipart-post (2.0.0)
+    public_suffix (2.0.5)
+    rake (10.5.0)
+    rspec (3.6.0)
+      rspec-core (~> 3.6.0)
+      rspec-expectations (~> 3.6.0)
+      rspec-mocks (~> 3.6.0)
+    rspec-core (3.6.0)
+      rspec-support (~> 3.6.0)
+    rspec-expectations (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-mocks (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-support (3.6.0)
+    safe_yaml (1.0.4)
+    thread_safe (0.3.6)
+    vcr (3.0.3)
+    virtus (1.0.5)
+      axiom-types (~> 0.1)
+      coercible (~> 1.0)
+      descendants_tracker (~> 0.0, >= 0.0.3)
+      equalizer (~> 0.0, >= 0.0.9)
+    webmock (1.24.6)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  awesome_print
+  bundler (~> 1.12)
+  lifen-fhir!
+  rake (~> 10.5)
+  rspec (~> 3.5)
+  vcr (~> 3.0)
+  webmock (~> 1.24)
+
+BUNDLED WITH
+   1.14.6

data/License.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2017 Honestica
+
+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,131 @@
+# Lifen
+
+Lifen is a Ruby client for [Lifen](http://developers.lifen.fr/) FHIR API (over JSON).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'lifen-fhir'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install lifen-fhir
+
+## Usage
+
+### Configuration
+
+Lifen can be configured (ideally inside an initializer) like so:
+
+```ruby
+Lifen.configure do |config|
+  config.site                      = "https://demo.lifen.fr/"
+  config.application_access_token  = "application_access_token"
+
+  # optionnal
+  config.proxy_url                 = "http://my.proxy.fr/"
+end
+```
+
+Optionnal configuration:
+
+- `proxy_url`: enables you to route all your requests via a proxy
+
+### Internal
+
+#### Managing a Binary
+
+```ruby
+binary = Lifen::Binary.new(uuid: "b7c7dae671b93e951ce6a4f530736276")
+binary.download
+```
+
+### Communication Request
+
+```ruby
+sender = Lifen::Practitioner.find_by_rpps("899900018483")
+
+recipient = Lifen::Practitioner.find_by_rpps("899900018484")
+channel = recipient.channels.first
+
+binary = Lifen::Binary.new(uuid: "b7c7dae671b93e951ce6a4f530736276")
+
+communication_request = Lifen::CommunicationRequest.new(sender: sender, recipient: recipient, channel: channel, binary: binary, patient: patient, category: category)
+
+communication_request.send
+
+```
+
+#### Communication Request with multiple recipients
+
+```ruby
+sender = Lifen::Practitioner.find_by_rpps("899900018483")
+
+recipient = Lifen::Practitioner.find_by_rpps("899900018484")
+medium = Lifen::Medium(uuid: recipient.channels.first.uuid)
+
+other_recipient = Lifen::Practitioner.find_by_rpps("899900018484")
+other_medium = Lifen::Medium(uuid: other_recipient.channels.first.uuid)
+
+binary = Lifen::Binary.new(uuid: "b7c7dae671b93e951ce6a4f530736276")
+
+communication_request_request = Lifen::CommunicationRequest.new(sender: sender, recipients: [recipient, other_recipient], medium: [medium, other_medium], binary: binary, patient: patient, category: category)
+
+communication_request_request.send
+
+```
+
+#### Custom Channels management
+
+```ruby
+recipient = Lifen::Practitioner.new(uuid: "valid-user-uuid")
+
+# To create a new mailing address channel
+channel = recipient.create_address(type: "address", lines: ["39 rue Aboukir"], city: "Paris", postal_code: "75002", country: "France")
+
+# To create a new telecom channel fax
+channel = recipient.create_telecom(type: "telecom", system: "fax", value: "+33102030405")
+```
+
+## Deploying to Rubygems
+
+Once the new version is validated, the deployment follows those steps :
+
+1. update `lib/lifen/version.rb`
+2. run `bundle install` to update `Gemfile.lock`
+3. update `CHANGELOG.md` with the additional features of the new version
+4. commit changes to Github
+5. build the gem using `gem build lifen-fhir.gemspec`
+6. publish the gem using `gem publish lifen-fhir-X.X.X.gem`
+7. run `bundle update lifen` in related projects :)
+
+## License
+
+The MIT License (MIT)
+
+Copyright (c) 2016-2017 Honestica
+
+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/lib/lifen.rb

@@ -0,0 +1,29 @@
+module Lifen
+
+  require 'virtus'
+  require 'faraday'
+  require 'inflecto'
+  require 'base64'
+
+  require "lifen/version"
+
+  require 'lifen/error'
+  require 'lifen/client'
+  require 'lifen/user_authenticated_client'
+  require 'lifen/app_authenticated_client'
+  require 'lifen/configuration'
+  require 'lifen/base'
+  
+  require 'lifen/channel'
+  require 'lifen/practitioner'
+  require 'lifen/category'
+  require 'lifen/medium'
+  require 'lifen/attachment'
+  require 'lifen/binary'
+  require 'lifen/patient'
+  require 'lifen/content_string'
+  require 'lifen/communication_request'
+
+  Virtus.finalize
+
+end

data/lib/lifen/app_authenticated_client.rb

@@ -0,0 +1,37 @@
+module Lifen
+  class AppAuthenticatedClient < Client
+
+    private
+
+      def handle_errors(response, params)
+        super(response, params)
+
+        case response.status
+        when 400
+          raise Error, "Error 400, Unknown error, #{response_error(response, params)}"
+        when 401
+          raise InvalidSecretTokenError, "Error 401, Invalid app bearer, #{response_error(response, params)}"
+        when 403
+          raise UserAlreadyExistingError, "Error 403, User already existing, #{response_error(response, params)}"
+        when 404
+          raise Error, "Error 404, Page not found, #{response_error(response, params)}"
+        when 422
+          json = JSON.parse response.body
+
+          diagnostic = json["issue"][0]["diagnostics"]
+
+          raise Error, "Error 422, Unprocessable Entity, Diagnostic: '#{diagnostic}', #{response_error(response, params)}"
+        end
+
+      end
+
+      def response_error(response, params)
+        "App Client, #{super(response, params)}"
+      end
+
+      def bearer
+        Lifen.configuration.application_access_token
+      end
+
+  end
+end

data/lib/lifen/attachment.rb

@@ -0,0 +1,26 @@
+module Lifen
+
+  class Attachment < Base
+
+    attribute :title, String
+    attribute :path, String
+    attribute :content_type, String
+
+    def fhir_payload
+      {
+        contentAttachment: {
+          data: base_64_encoded_content,
+          title: title,
+          contentType: "{#{content_type}}"
+        }
+      }
+    end
+
+    private
+
+      def base_64_encoded_content
+        Base64.encode64(File.open(path, "rb").read)
+      end
+
+  end
+end

data/lib/lifen/base.rb

@@ -0,0 +1,7 @@
+module Lifen
+  class Base
+
+    include Virtus.model
+
+  end
+end

data/lib/lifen/binary.rb

@@ -0,0 +1,31 @@
+
+module Lifen
+
+  class Binary < Base
+
+    attribute :uuid, String
+
+    def fhir_payload
+      {
+        contentReference: {
+          reference: reference
+        }
+      }
+    end
+
+    def download
+      application_client.get("fhir/#{reference}", { accept: "application/pdf" })
+    end
+
+    private
+
+      def application_client
+        @application_client ||= AppAuthenticatedClient.new
+      end
+
+      def reference
+        "Binary/#{uuid}"
+      end
+
+  end
+end

data/lib/lifen/category.rb

@@ -0,0 +1,26 @@
+module Lifen
+  class Category < Base
+
+    CODES = ["MEDICAL_REPORT", "MESSAGE", "MEDICATION_ORDER", "REFERRAL_REQUEST", "OTHER"]
+
+    attribute :code, String, default: "MEDICAL_REPORT"
+
+    def fhir_payload
+      raise Lifen::Error, "Invalid category: code must be in the authorized values" if !valid?
+
+      {
+        coding: [
+           {
+              system: "http://honestica.com/fhir/communication/category",
+              code: code
+           }
+        ]
+      }
+    end
+
+    def valid?
+      CODES.include? code
+    end
+
+  end
+end

data/lib/lifen/channel.rb

@@ -0,0 +1,31 @@
+module Lifen
+  class Channel < Base
+
+    attribute :uuid, String
+    attribute :type, String
+    attribute :value, String
+
+    def fhir_payload(user)
+      raise Lifen::Error, "Invalid channel: an UUID is required" if !valid?
+
+      {
+        id: user.uuid,
+        resourceType: "Practitioner",
+        type => [
+          {
+            id: uuid
+          }
+        ]
+      }
+    end
+
+    def valid?
+      uuid and uuid.length != 0
+    end
+
+    def self.from_json(json, type = nil)
+      new(uuid: json["id"], type: type, value: json["value"] || "#{Array(json["line"]).join(", ")}, #{json["postalCode"]} #{json["city"]}")
+    end
+
+  end
+end