Merge pull request #1 from adamstegman/zef

Add ZEF segment

Author: mogox

.gitignore

@@ -27,9 +27,9 @@ build/
 
 # for a library or gem, you might want to ignore these files since the code is
 # intended to run in multiple environments; otherwise, check them in:
-# Gemfile.lock
-# .ruby-version
-# .ruby-gemset
+/Gemfile.lock
+/.ruby-version
+/.ruby-gemset
 
 # unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
 .rvmrc

.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+before_install: gem install bundler
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+rvm:
+  - 2.2.0
+  - 2.1.0
+  - 2.0.0
+  - 1.9.3
+  - ruby-head
+  - jruby-19mode # JRuby in 1.9 mode
+  - rbx

Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ruby-hl7-zef.gemspec
+gemspec
+
+group :test, :development do
+  gem 'rspec', '~> 2.99.0'
+end

README.md

@@ -0,0 +1,38 @@
+# HL7::ZEF
+
+Adds support for the ZEF segment to [`ruby-hl7`](https://github.com/ruby-hl7/ruby-hl7)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ruby-hl7-zef'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ruby-hl7-zef
+
+## Usage
+
+```ruby
+require 'base64'
+
+msg = HL7::Message.parse(hl7_with_zef)
+Array(msg[:ZEF]).each_with_index do |zef, i|
+  File.write("zef-#{i}.pdf", Base64.decode64(zef.embedded_pdf))
+end
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/ruby-hl7-zef/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

lib/hl7/zef.rb

@@ -0,0 +1,9 @@
+module HL7
+  class Message::Segment::ZEF < HL7::Message::Segment
+    weight 8
+    add_field :set_id,        :idx => 1 # ZEF-1 "Sequence Number", 1~9999
+    add_field :embedded_pdf,  :idx => 2 # ZEF-2
+  end
+end
+
+HL7::Message::Segment::OBX.add_child_type :ZEF

lib/hl7/zef/version.rb

@@ -0,0 +1,5 @@
+module HL7
+  module ZEF
+    VERSION = "1.0.0"
+  end
+end

lib/ruby-hl7-zef.rb

@@ -0,0 +1,3 @@
+require "ruby-hl7"
+require "hl7/zef"
+require "hl7/zef/version"

ruby-hl7-zef.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hl7/zef/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ruby-hl7-zef"
+  spec.version       = HL7::ZEF::VERSION
+  spec.authors       = ["Enrique Carlos Mogollan"]
+  spec.email         = ["emogollan@gmail.com"]
+  spec.summary       = %q{Provides a custom ZEF segment to the ruby-hl7 gem.}
+  spec.description   = %q{ZEF is a custom segment commonly used to embed PDFs}
+  spec.homepage      = ""
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^spec/}) }
+  spec.test_files    = spec.files.grep(%r{^spec/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "ruby-hl7", "~> 1.1"
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

spec/hl7/zef_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe HL7::Message::Segment::ZEF do
+  let(:zef_segment){
+    %[ZEF|1|embedded-pdf-data]
+  }
+
+  let(:zef){
+    HL7::Message::Segment::ZEF.new( zef_segment )
+  }
+
+  it 'creates a ZEF segment' do
+    expect(zef).to_not be_nil
+  end
+
+  it 'converts the segment to a string' do
+    expect(zef.to_s).to eq zef_segment
+  end
+
+  it 'allows access to a ZEF segment' do
+    expect(zef.set_id).to eq '1'
+    expect(zef.embedded_pdf).to eq('embedded-pdf-data')
+  end
+
+  it 'is a child of OBX' do
+    expect(HL7::Message::Segment::OBX.child_types).to include(:ZEF)
+  end
+end