unidata 0.0.1

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Jeremy Israelsen, TotalCareAuto
+
+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,99 @@
+UniData ORM
+===========
+
+A simple ORM for Rocket's UniData database.
+
+Installation
+------------
+
+Add this line to your application's Gemfile:
+
+    gem 'unidata'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install unidata
+
+Usage
+-----
+
+Model definition:
+
+```ruby
+class Product < Unidata::Model
+  self.filename = 'PRODUCT'
+
+  field 1, :name,         String
+  field 2, :description   # type is optional (defaults to String)
+  field 3, :cost,         Float
+  field 4, :available_on, Date
+end
+```
+
+Creating records:
+
+```ruby
+thingamajig = Product.new(
+  :id         => 12345,
+  :name       =>'Thingamajig',
+  :cost       => 125.99,
+  :available  => Date.today
+)
+thingamajig.save
+
+whatsit = Product.new
+whatsit.id = 12346
+whatsit.name = 'Whatsit'
+whatsit.cost = 999.99 
+whatsit.available = Date.today
+whatsit.save
+```
+
+Record retrieval:
+
+```ruby
+product = Product.find(12345)
+```
+
+Checking if a record exists:
+
+```ruby
+Product.exists?(12345)
+```
+
+Contributing
+------------
+
+Pull requests are welcome.  Just make sure to include tests!
+
+To run tests, install some dependencies:
+
+```bash
+bundle install
+```
+
+Then, run tests with:
+
+```bash
+rake spec
+```
+
+Or, If you want to check coverage:
+
+```bash
+COVERAGE=on rake spec
+```
+
+Issues
+------
+
+Please use GitHub's [issue tracker](http://github.com/totalcareauto/unidata/issues).
+
+Authors
+-------
+
+[Jeremy Israelsen](http://github.com/jisraelsen)

data/lib/unidata.rb

@@ -0,0 +1,33 @@
+require 'udjrb'
+require 'time'
+require 'date'
+require 'bigdecimal'
+require 'unidata/extensions'
+require 'unidata/connection'
+require 'unidata/field'
+require 'unidata/model'
+require "unidata/version"
+
+module Unidata
+  class << self
+    attr_reader :connection
+
+    def prepare_connection(config={})
+      @connection = Connection.new(config[:user], config[:password], config[:host], config[:data_dir])
+    end
+
+    def open_connection
+      begin
+        @connection.open
+        yield if block_given?
+      ensure
+        close_connection if block_given?
+      end
+    end
+
+    def close_connection
+      @connection.close
+    end
+  end
+end
+

data/lib/unidata/connection.rb

@@ -0,0 +1,111 @@
+module Unidata
+  class Connection
+    attr_reader :user, :password, :host, :data_dir
+
+    def initialize(user, password, host, data_dir)
+      @user = user
+      @password = password
+      @host = host
+      @data_dir = data_dir
+    end
+
+    def open?
+      !@session.nil? && @session.is_active
+    end
+
+    def open
+      @session = UDJrb::Session.new user, password, host, data_dir
+    end
+
+    def close
+      @session.disconnect if @session
+      @session = nil
+    end
+
+    def exists?(filename, record_id)
+      exists = false
+
+      open_file(filename) do |file|
+        begin
+          file.read_field(record_id, 0)
+          exists = true
+        rescue Java::AsjavaUniobjects::UniFileException
+        end
+      end
+
+      exists
+    end
+
+    def read(filename, record_id)
+      record = nil
+
+      open_file(filename) do |file|
+        begin
+          record = Java::AsjavaUniclientlibs::UniDynArray.new(file.read(record_id))
+        rescue Java::AsjavaUniobjects::UniFileException
+        end
+      end
+
+      record
+    end
+
+    def read_field(filename, record_id, field)
+      value = nil
+
+      open_file(filename) do |file|
+        begin
+          value = file.read_field(record_id, field).to_s
+        rescue Java::AsjavaUniobjects::UniFileException
+        end
+      end
+
+      value
+    end
+
+    def write(filename, record_id, record)
+      record = record.to_unidata unless record.kind_of?(Java::AsjavaUniclientlibs::UniDynArray)
+
+      open_file(filename) do |file|
+        file.write(record_id, record)
+      end
+    end
+
+    def write_field(filename, record_id, value, field)
+      open_file(filename) do |file|
+        file.write_field(record_id, value, field)
+      end
+    end
+
+    def with_record_lock(filename, record_id, lock_flag=1)
+      open_file(filename) do |file|
+        retry_count = 0
+        begin
+          file.lock_record(record_id, lock_flag)
+          yield
+        rescue Java::AsjavaUniobjects::UniFileException
+          # try to obtain a record lock at most 3 times, then give up
+          if retry_count < 2
+            sleep 5
+
+            retry_count += 1
+            retry
+          else
+            raise
+          end
+        ensure
+          file.unlock_record(record_id)
+        end
+      end
+    end
+
+    private
+    def open_file(filename)
+      begin
+        file = @session.open filename
+        yield file
+      ensure
+        file.close
+      end
+    end
+  end
+end

data/lib/unidata/extensions.rb

@@ -0,0 +1,6 @@
+require 'unidata/extensions/big_decimal'
+require 'unidata/extensions/date'
+require 'unidata/extensions/float'
+require 'unidata/extensions/integer'
+require 'unidata/extensions/string'
+require 'unidata/extensions/time'

data/lib/unidata/extensions/big_decimal.rb

@@ -0,0 +1,17 @@
+module Unidata
+  module Extensions
+    module BigDecimal
+      def to_unidata(value)
+        (value * 100).to_i
+      end
+
+      def from_unidata(value)
+        ::BigDecimal.new(value.to_s) / 100
+      end
+    end
+  end
+end
+
+class BigDecimal
+  extend Unidata::Extensions::BigDecimal
+end

data/lib/unidata/extensions/date.rb

@@ -0,0 +1,19 @@
+module Unidata
+  module Extensions
+    module Date
+      PICK_EPOCH = ::Date.parse('1968-01-01')
+
+      def to_unidata(value)
+        (value - PICK_EPOCH).to_i
+      end
+
+      def from_unidata(value)
+        PICK_EPOCH + value.to_i
+      end
+    end
+  end
+end
+
+class Date
+  extend Unidata::Extensions::Date
+end

data/lib/unidata/extensions/float.rb

@@ -0,0 +1,17 @@
+module Unidata
+  module Extensions
+    module Float
+      def to_unidata(value)
+        ::BigDecimal.to_unidata(value)
+      end
+
+      def from_unidata(value)
+        ::BigDecimal.from_unidata(value).to_f
+      end
+    end
+  end
+end
+
+class Float
+  extend Unidata::Extensions::Float
+end

data/lib/unidata/extensions/integer.rb

@@ -0,0 +1,17 @@
+module Unidata
+  module Extensions
+    module Integer
+      def to_unidata(value)
+        value
+      end
+
+      def from_unidata(value)
+        value.to_i
+      end
+    end
+  end
+end
+
+class Integer
+  extend Unidata::Extensions::Integer
+end

data/lib/unidata/extensions/string.rb

@@ -0,0 +1,17 @@
+module Unidata
+  module Extensions
+    module String
+      def to_unidata(value)
+        value.upcase
+      end
+
+      def from_unidata(value)
+        value
+      end
+    end
+  end
+end
+
+class String
+  extend Unidata::Extensions::String
+end

data/lib/unidata/extensions/time.rb

@@ -0,0 +1,17 @@
+module Unidata
+  module Extensions
+    module Time
+      def to_unidata(value)
+        ::Date.to_unidata(value.to_date)
+      end
+
+      def from_unidata(value)
+        ::Date.from_unidata(value).to_time
+      end
+    end
+  end
+end
+
+class Time
+  extend Unidata::Extensions::Time
+end

data/lib/unidata/field.rb

@@ -0,0 +1,19 @@
+module Unidata
+  class Field
+    attr_reader :index, :name, :type, :formatter
+
+    def initialize(index, name, type=String)
+      @index = [*index]
+      @name = name
+      @type = type
+    end
+
+    def to_unidata(value)
+      type.to_unidata(value)
+    end
+
+    def from_unidata(value)
+      type.from_unidata(value)
+    end
+  end
+end

data/lib/unidata/model.rb

@@ -0,0 +1,106 @@
+module Unidata
+  class Model
+    class << self
+      attr_accessor :filename
+
+      def connection
+        Unidata.connection
+      end
+
+      def fields
+        unless @fields
+          @fields = {}
+          field(0, :id)
+        end
+
+        @fields
+      end
+
+      def field?(name)
+        fields.keys.include?(name.to_sym)
+      end
+
+      def field(index, name, type=String)
+        fields[name.to_sym] = Field.new(index, name, type)
+        define_attribute_accessor(name)
+      end
+
+      def to_unidata(instance)
+        record = Java::AsjavaUniclientlibs::UniDynArray.new
+
+        instance.attributes.each do |key, value|
+          next if key == :id
+
+          field = fields[key]
+          record.replace *field.index, field.to_unidata(value)
+        end
+
+        record
+      end
+
+      def from_unidata(record)
+        instance = new
+
+        fields.each do |key, field|
+          next if key == :id
+
+          instance.send(
+            "#{key}=",
+            field.from_unidata(record.extract(*field.index).to_s)
+          )
+        end
+
+        instance
+      end
+
+      def exists?(id)
+        connection.exists?(filename, id)
+      end
+
+      def find(id)
+        record = connection.read(filename, id)
+
+        instance = from_unidata(record)
+        instance.id = id
+        instance
+      end
+
+      private
+      def define_attribute_accessor(attribute_name)
+        class_eval <<-end_eval
+          def #{attribute_name}
+            read_attribute(:#{attribute_name})
+          end
+
+          def #{attribute_name}=(value)
+            write_attribute(:#{attribute_name}, value)
+          end
+        end_eval
+      end
+    end
+
+    attr_reader :attributes
+
+    def initialize(attributes={})
+      @attributes = {}
+      attributes.each do |key,value|
+        next unless self.class.field?(key.to_sym)
+        @attributes[key.to_sym] = value
+      end
+    end
+
+    def save
+      record = self.class.to_unidata(self)
+      self.class.connection.write(self.class.filename, id, record)
+    end
+
+    private
+    def read_attribute(attribute_name)
+      @attributes[attribute_name.to_sym]
+    end
+
+    def write_attribute(attribute_name, value)
+      @attributes[attribute_name.to_sym] = value
+    end
+  end
+end

data/lib/unidata/version.rb

@@ -0,0 +1,3 @@
+module Unidata
+  VERSION = "0.0.1"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+if ENV['COVERAGE']
+  require 'simplecov'
+  SimpleCov.start do
+    add_filter '/spec/'
+  end
+end
+
+require 'rspec'
+require 'unidata'
+
+def package_local_constructor klass,*values
+  constructors = klass.java_class.declared_constructors
+  constructors.each do |c|
+    c.accessible = true
+    begin
+      return c.new_instance(*values).to_java
+    rescue TypeError
+      false
+    end
+  end
+  raise TypeError,"found no matching constructor for " + klass.to_s + "(" + value.class + ")"
+end
+
+RSpec.configure do |config|
+end

data/spec/unidata/connection_spec.rb

@@ -0,0 +1,237 @@
+require 'spec_helper'
+
+describe Unidata::Connection do
+  let(:connection) { Unidata::Connection.new('test', 'secret', 'localhost', 'tmp') }
+
+  describe '#initialize' do
+    it 'captures and assigns arguments' do
+      connection.user.should == 'test'
+      connection.password.should == 'secret'
+      connection.host.should == 'localhost'
+      connection.data_dir.should == 'tmp'
+    end
+  end
+
+  describe '#open?' do
+    context 'with existing active session' do
+      it 'returns true' do
+        UDJrb::Session.stub(:new).and_return(double('UDJrb::Session', :is_active => true))
+        connection.open
+        connection.open?.should == true
+      end
+    end
+
+    context 'with existing inactive session' do
+      it 'returns false' do
+        UDJrb::Session.stub(:new).and_return(double('UDJrb::Session', :is_active => false))
+        connection.open
+        connection.open?.should == false
+      end
+    end
+
+    context 'without existing session' do
+      it 'returns false' do
+        connection.open?.should == false
+      end
+    end
+  end
+
+  describe '#open' do
+    it 'creates a new session with config params' do
+      UDJrb::Session.should_receive(:new).with(connection.user, connection.password, connection.host, connection.data_dir)
+      connection.open
+    end
+  end
+
+  describe '#close' do
+    it 'disconnects the session' do
+      session = double('UDJrb::Session', :disconnect => nil)
+      UDJrb::Session.stub(:new).and_return(session)
+      connection.open
+
+      session.should_receive(:disconnect)
+      connection.close
+    end
+  end
+
+  describe '#exists?' do
+    before(:each) do
+      @file = double('UniFile', :close => nil, :read_field => nil)
+      @session = double('UDJrb::Session', :open => @file)
+
+      UDJrb::Session.stub(:new).and_return(@session)
+      connection.open
+    end
+
+    it 'opens file with filename' do
+      @session.should_receive(:open).with('TEST')
+      connection.exists?('TEST', 123)
+    end
+
+    it 'reads record_id field from file' do
+      @file.should_receive(:read_field).with(123, 0)
+      connection.exists?('TEST', 123)
+    end
+
+    it 'closes file' do
+      @file.should_receive(:close)
+      connection.exists?('TEST', 123)
+    end
+
+    context 'when file has given record_id' do
+      it 'returns true' do
+        @file.stub(:read_field).and_return('123')
+        connection.exists?('TEST', 123).should == true
+      end
+    end
+
+    context 'when file has no given record_id' do
+      it 'returns false' do
+        uni_file_exception = package_local_constructor Java::AsjavaUniobjects::UniFileException
+
+        @file.stub(:read_field).and_raise(uni_file_exception)
+        connection.exists?('TEST', 123).should == false
+      end
+    end
+  end
+
+  describe '#read' do
+    before(:each) do
+      @file = double('UniFile', :close => nil, :read => nil)
+      @session = double('UDJrb::Session', :open => @file)
+
+      UDJrb::Session.stub(:new).and_return(@session)
+      connection.open
+    end
+
+    it 'opens file in session' do
+      @session.should_receive(:open).with('TEST')
+      connection.read('TEST', 123)
+    end
+
+    it 'reads record from file' do
+      @file.should_receive(:read).with(123)
+      connection.read('TEST', 123)
+    end
+
+    it 'closes file' do
+      @file.should_receive(:close)
+      connection.read('TEST', 123)
+    end
+
+    context 'when record exists' do
+      it 'returns record as a Java::AsjavaUniclientlibs::UniDynArray' do
+        @file.stub(:read).and_return('')
+        connection.read('TEST', 123).should be_kind_of(Java::AsjavaUniclientlibs::UniDynArray)
+      end
+    end
+
+    context 'when record does not exist' do
+      it 'returns nil' do
+        uni_file_exception = package_local_constructor Java::AsjavaUniobjects::UniFileException
+
+        @file.stub(:read).and_raise(uni_file_exception)
+        connection.read('TEST', 123).should be_nil
+      end
+    end
+  end
+
+  describe '#read_field' do
+    before(:each) do
+      @file = double('UniFile', :close => nil, :read_field => nil)
+      @session = double('UDJrb::Session', :open => @file)
+
+      UDJrb::Session.stub(:new).and_return(@session)
+      connection.open
+    end
+
+    it 'opens file with filename' do
+      @session.should_receive(:open).with('TEST')
+      connection.read_field('TEST', 123, 5)
+    end
+
+    it 'reads field from file' do
+      @file.should_receive(:read_field).with(123, 5)
+      connection.read_field('TEST', 123, 5)
+    end
+
+    it 'closes file' do
+      @file.should_receive(:close)
+      connection.read_field('TEST', 123, 5)
+    end
+
+    context 'when field exists' do
+      it 'returns value as a String' do
+        @file.stub(:read_field).and_return(43245)
+        connection.read_field('TEST', 123, 5).should == '43245'
+      end
+    end
+
+    context 'when field does not exist' do
+      it 'returns nil' do
+        uni_file_exception = package_local_constructor Java::AsjavaUniobjects::UniFileException
+
+        @file.stub(:read_field).and_raise(uni_file_exception)
+        connection.read_field('TEST', 123, 5).should be_nil
+      end
+    end
+  end
+
+  describe '#write' do
+    before(:each) do
+      @file = double('UniFile', :close => nil, :write => nil)
+      @session = double('UDJrb::Session', :open => @file)
+      @record = Java::AsjavaUniclientlibs::UniDynArray.new
+
+      UDJrb::Session.stub(:new).and_return(@session)
+      connection.open
+    end
+
+    it 'opens file in session' do
+      @session.should_receive(:open).with('TEST')
+      connection.write('TEST', 123, @record)
+    end
+
+    it 'calls to_unidata on record if record not a Java::AsjavaUniclientlibs::UniDynArray' do
+      record = double('Record')
+      record.should_receive(:to_unidata).and_return(Java::AsjavaUniclientlibs::UniDynArray.new)
+
+      connection.write('TEST', 123, record)
+    end
+
+    it 'writes record to file' do
+      @file.should_receive(:write).with(123, @record)
+      connection.write('TEST', 123, @record)
+    end
+
+    it 'closes file' do
+      @file.should_receive(:close)
+      connection.write('TEST', 123, @record)
+    end
+  end
+
+  describe '#write_field' do
+    before(:each) do
+      @file = double('UniFile', :close => nil, :write_field => nil)
+      @session = double('UDJrb::Session', :open => @file)
+
+      UDJrb::Session.stub(:new).and_return(@session)
+      connection.open
+    end
+
+    it 'opens file with filename' do
+      @session.should_receive(:open).with('TEST')
+      connection.write_field('TEST', 123, 'value', 5)
+    end
+
+    it 'writes field to file' do
+      @file.should_receive(:write_field).with(123, 'value', 5)
+      connection.write_field('TEST', 123, 'value', 5)
+    end
+
+    it 'closes file' do
+      @file.should_receive(:close)
+      connection.write_field('TEST', 123, 'value', 5)
+    end
+  end
+end

data/spec/unidata/field_spec.rb

@@ -0,0 +1,113 @@
+require 'spec_helper'
+
+describe Unidata::Field do
+  subject { Unidata::Field }
+
+  describe '#initialize' do
+    it 'captures and assigns arguments' do
+      field = subject.new(1, :date, Date)
+      field.index.should == [1]
+      field.name.should == :date
+      field.type.should == Date
+    end
+
+    it 'accepts multivalued indexes' do
+      field = subject.new([1,2], :name)
+      field.index.should == [1,2]
+    end
+
+    it 'defaults type to String' do
+      field = subject.new(2, :name)
+      field.type.should == String
+    end
+  end
+
+  describe '#to_unidata' do
+    context 'when type is Time' do
+      it 'converts value to pick time' do
+        field = subject.new(1, :created_at, Time)
+        field.to_unidata(Time.parse('2012-04-02 12:34:00')).should == 16163
+      end
+    end
+
+    context 'when type is Date' do
+      it 'converts value to pick time' do
+        field = subject.new(1, :created_on, Date)
+        field.to_unidata(Date.parse('2012-04-03')).should == 16164
+      end
+    end
+
+    context 'when type is String' do
+      it 'upcases value' do
+        field = subject.new(1, :name, String)
+        field.to_unidata('John Doe').should == 'JOHN DOE'
+      end
+    end
+
+    context 'when type is Float' do
+      it 'multiplies value by 100 and converts to an integer' do
+        field = subject.new(1, :price, Float)
+        field.to_unidata(123.32).should == 12332
+      end
+    end
+
+    context 'when type is BigDecimal' do
+      it 'multiplies value by 100 and converts to an integer' do
+        field = subject.new(1, :price, BigDecimal)
+        field.to_unidata(BigDecimal.new('123.32')).should == 12332
+      end
+    end
+
+    context 'when type is Integer' do
+      it 'does nothing' do
+        field = subject.new(1, :age, Integer)
+        field.to_unidata(45).should == 45
+      end
+    end
+  end
+
+  describe '#from_unidata' do
+    context 'when type is Time' do
+      it 'converts value from pick time' do
+        field = subject.new(1, :created_at, Time)
+        field.from_unidata(16163).should == Time.parse('2012-04-02 00:00:00')
+      end
+    end
+
+    context 'when type is Date' do
+      it 'converts value from pick time' do
+        field = subject.new(1, :created_on, Date)
+        field.from_unidata(16164).should == Date.parse('2012-04-03')
+      end
+    end
+
+    context 'when type is String' do
+      it 'does nothing' do
+        field = subject.new(1, :name, String)
+        field.from_unidata('JOHN DOE').should == 'JOHN DOE'
+      end
+    end
+
+    context 'when type is Float' do
+      it 'converts value to Float and divides by 100' do
+        field = subject.new(1, :price, Float)
+        field.from_unidata(12332).should == 123.32
+      end
+    end
+
+    context 'when type is BigDecimal' do
+      it 'converts value to BigDecimal and divides by 100' do
+        field = subject.new(1, :price, BigDecimal)
+        field.from_unidata(12332).should == BigDecimal.new('123.32')
+      end
+    end
+
+    context 'when type is Integer' do
+      it 'converts to an Integer' do
+        field = subject.new(1, :age, Integer)
+        field.from_unidata('45').should == 45
+      end
+    end
+  end
+end
+

data/spec/unidata/model_spec.rb

@@ -0,0 +1,185 @@
+require 'spec_helper'
+
+describe Unidata::Model do
+  subject { Unidata::Model }
+
+  class Record < Unidata::Model
+    self.filename = 'TEST'
+
+    field 1,      :name
+    field 2,      :age,         Integer
+    field 3,      :birth_date,  Date
+    field [4,1],  :employer
+    field [4,2],  :job_title
+    field [4,3],  :salary,      BigDecimal
+  end
+
+  describe '.connection' do
+    it 'returns the Unidata connection' do
+      Unidata.stub('connection').and_return(double('connection'))
+      subject.connection.should == Unidata.connection
+    end
+  end
+
+  describe '.field' do
+    it 'adds Field with given index, name, and type to fields hash' do
+      field = Record.fields[:age]
+      field.index.should == [2]
+      field.name.should == :age
+      field.type.should == Integer
+    end
+
+    it 'defines attribute reader/writer for field' do
+      obj = Record.new
+      obj.age = 25
+      obj.age.should == 25
+    end
+  end
+
+  describe '.to_unidata' do
+    before(:each) do
+      @obj = Record.new(
+        :id         => 1234,
+        :name       => 'John Doe',
+        :age        => 25,
+        :birth_date => Date.today,
+        :employer   => 'Awesome Company',
+        :job_title  => 'Manager',
+        :salary     => BigDecimal.new('60_000.00')
+      )
+    end
+
+    it 'converts model to UniDynArray' do
+      record = Record.to_unidata(@obj)
+      record.extract(1).to_s.should == 'JOHN DOE'
+      record.extract(2).to_s.should == '25'
+      record.extract(3).to_s.should == Date.to_unidata(Date.today).to_s
+      record.extract(4, 1).to_s.should == 'AWESOME COMPANY'
+      record.extract(4, 2).to_s.should == 'MANAGER'
+      record.extract(4, 3).to_s.should == '6000000'
+    end
+
+    it 'skips id field' do
+      record = Record.to_unidata(@obj)
+      record.extract(0).to_s.should == ''
+    end
+  end
+
+  describe '.from_unidata' do
+    before(:each) do
+      @record = Java::AsjavaUniclientlibs::UniDynArray.new
+      @record.replace 0, 123
+      @record.replace 1, 'JOHN DOE'
+      @record.replace 2, 25
+      @record.replace 3, Date.to_unidata(Date.today)
+      @record.replace 4, 1, 'AWESOME COMPANY'
+      @record.replace 4, 2, 'MANAGER'
+      @record.replace 4, 3, 6_000_000
+    end
+
+    it 'converts UniDynArray to model' do
+      obj = Record.from_unidata(@record)
+      obj.name.should == 'JOHN DOE'
+      obj.age.should == 25
+      obj.birth_date.should == Date.today
+      obj.employer.should == 'AWESOME COMPANY'
+      obj.job_title.should == 'MANAGER'
+      obj.salary.should == BigDecimal.new('60_000.00')
+    end
+
+    it 'skips id field' do
+      obj = Record.from_unidata(@record)
+      obj.id.should be_nil
+    end
+  end
+
+  describe '.exists?' do
+    before(:each) do
+      @connection = double('connection')
+      @connection.stub(:exists?).with('TEST', 123).and_return(true)
+      @connection.stub(:exists?).with('TEST', 234).and_return(false)
+
+      Unidata.stub(:connection).and_return(@connection)
+    end
+
+    it 'returns true if record with id exists in file' do
+      Record.exists?(123).should == true
+    end
+
+    it 'returns false if record with id does not exist in file' do
+      Record.exists?(234).should == false
+    end
+  end
+
+  describe '.find' do
+    before(:each) do
+      @record = Java::AsjavaUniclientlibs::UniDynArray.new
+      @record.replace 1, 'JOHN DOE'
+      @record.replace 2, 25
+      @record.replace 3, Date.to_unidata(Date.today)
+      @record.replace 4, 1, 'AWESOME COMPANY'
+      @record.replace 4, 2, 'MANAGER'
+      @record.replace 4, 3, 6_000_000
+
+      @connection = double('connection', :read => @record)
+      Unidata.stub(:connection).and_return(@connection)
+    end
+
+    it 'reads record from file' do
+      @connection.should_receive(:read).with('TEST', 123).and_return(@record)
+      Record.find(123)
+    end
+
+    it 'returns model' do
+      obj = Record.find(123)
+      obj.id.should == 123
+      obj.name.should == 'JOHN DOE'
+      obj.age.should == 25
+      obj.birth_date.should == Date.today
+      obj.employer.should == 'AWESOME COMPANY'
+      obj.job_title.should == 'MANAGER'
+      obj.salary.should == BigDecimal.new('60_000.00')
+    end
+  end
+
+  describe '#initialize' do
+    it 'captures provied attributes' do
+      instance = Record.new(:id => 123, :name => 'John Doe')
+      instance.attributes.should == { :id => 123, :name => 'John Doe' }
+    end
+
+    it 'ignores attributes that are not defined in fields' do
+      instance = Record.new(:id => 123, :name => 'John Doe', :nickname => 'J-Dog')
+      instance.attributes.should == { :id => 123, :name => 'John Doe' }
+    end
+  end
+
+  describe '#save' do
+    it 'writes record to file' do
+      connection = double('connection', :write => nil)
+      Unidata.stub(:connection).and_return(connection)
+
+      obj = Record.new(
+        :id         => 1234,
+        :name       => 'John Doe',
+        :age        => 25,
+        :birth_date => Date.today,
+        :employer   => 'Awesome Company',
+        :job_title  => 'Manager',
+        :salary     => BigDecimal.new('60_000.00')
+      )
+
+      record = Java::AsjavaUniclientlibs::UniDynArray.new
+      record.replace 1, 'JOHN DOE'
+      record.replace 2, 25
+      record.replace 3, Date.to_unidata(Date.today)
+      record.replace 4, 1, 'AWESOME COMPANY'
+      record.replace 4, 2, 'MANAGER'
+      record.replace 4, 3, 6_000_000
+
+      connection.should_receive(:write).with('TEST', 1234, record)
+      obj.save
+    end
+  end
+end
+

data/spec/unidata_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Unidata do
+  before(:each) do
+    @config = { :user => 'test', :password => 'secret', :host => 'localhost', :data_dir => 'testdir' }
+  end
+
+  describe '.prepare_connection' do
+    it 'prepares a unidata connection with config options' do
+      Unidata.prepare_connection @config
+
+      Unidata.connection.should be_kind_of(Unidata::Connection)
+      Unidata.connection.user.should == @config[:user]
+      Unidata.connection.password.should == @config[:password]
+      Unidata.connection.host.should == @config[:host]
+      Unidata.connection.data_dir.should == @config[:data_dir]
+    end
+
+    it 'should not open the connection' do
+      Unidata.prepare_connection @config
+      Unidata.connection.should_not be_open
+    end
+  end
+end

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: unidata
+version: !ruby/object:Gem::Version
+  prerelease:
+  version: 0.0.1
+platform: ruby
+authors:
+- Jeremy Israelsen
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2012-06-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: udjrb
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+    none: false
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency
+  name: rake
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+    none: false
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency
+  name: rspec
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+    none: false
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+    none: false
+  prerelease: false
+  type: :development
+description: A simple ORM for Rocket's UniData database
+email:
+- jisraelsen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/unidata.rb
+- lib/unidata/connection.rb
+- lib/unidata/extensions.rb
+- lib/unidata/extensions/big_decimal.rb
+- lib/unidata/extensions/date.rb
+- lib/unidata/extensions/float.rb
+- lib/unidata/extensions/integer.rb
+- lib/unidata/extensions/string.rb
+- lib/unidata/extensions/time.rb
+- lib/unidata/field.rb
+- lib/unidata/model.rb
+- lib/unidata/version.rb
+- LICENSE
+- README.md
+- spec/spec_helper.rb
+- spec/unidata/connection_spec.rb
+- spec/unidata/field_spec.rb
+- spec/unidata/model_spec.rb
+- spec/unidata_spec.rb
+homepage: http://github.com/totalcareauto/unidata
+licenses: []
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+requirements: []
+rubyforge_project:
+rubygems_version: 1.8.24
+signing_key:
+specification_version: 3
+summary: A simple ORM for Rocket's UniData database
+test_files:
+- spec/spec_helper.rb
+- spec/unidata/connection_spec.rb
+- spec/unidata/field_spec.rb
+- spec/unidata/model_spec.rb
+- spec/unidata_spec.rb
+...