libgeo 0.1.0

data/lib/libgeo/version.rb

@@ -0,0 +1,3 @@
+module Libgeo
+  VERSION = '0.1.0'
+end

data/libgeo.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'libgeo/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'libgeo'
+  spec.version       = Libgeo::VERSION
+  spec.authors       = ['Andrey Savchenko']
+  spec.email         = ['andrey@aejis.eu']
+  spec.summary       = %q{Collection of geographical primitives}
+  spec.description   = %q{Collection of geographical primitives}
+  spec.homepage      = 'https://github.com/Ptico/libgeo'
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+end

data/spec/shared_examples/coordinate_attrs.rb

@@ -0,0 +1,74 @@
+shared_examples_for 'Coordinate#degrees' do
+  subject { instance.degrees }
+
+  context 'when int' do
+    let(:degrees) { 48 }
+
+    it { expect(subject).to eql(48) }
+    it { expect(subject).to be_an(Integer) }
+  end
+
+  context 'when float' do
+    let(:degrees) { 48.0 }
+
+    it { expect(subject).to eql(48) }
+    it { expect(subject).to be_an(Integer) }
+  end
+
+  context 'when string' do
+    let(:degrees) { '48' }
+
+    it { expect(subject).to eql(48) }
+    it { expect(subject).to be_an(Integer) }
+  end
+end
+
+shared_examples_for 'Coordinate#minutes' do
+  subject { instance.minutes }
+
+  context 'when int' do
+    let(:minutes) { 4 }
+
+    it { expect(subject).to eql(4) }
+    it { expect(subject).to be_an(Integer) }
+  end
+
+  context 'when float' do
+    let(:minutes) { 4.0 }
+
+    it { expect(subject).to eql(4) }
+    it { expect(subject).to be_an(Integer) }
+  end
+
+  context 'when string' do
+    let(:minutes) { '4' }
+
+    it { expect(subject).to eql(4) }
+    it { expect(subject).to be_an(Integer) }
+  end
+end
+
+shared_examples_for 'Coordinate#seconds' do
+  subject { instance.seconds }
+
+  context 'when int' do
+    let(:seconds) { 15 }
+
+    it { expect(subject).to eql(15.0) }
+    it { expect(subject).to be_a(Float) }
+  end
+
+  context 'when float' do
+    let(:seconds) { 15.7836 }
+
+    it { expect(subject).to eql(15.7836) }
+    it { expect(subject).to be_a(Float) }
+  end
+
+  context 'when string' do
+    let(:seconds) { '15.7836' }
+
+    it { expect(subject).to eql(15.7836) }
+    it { expect(subject).to be_a(Float) }
+  end
+end

data/spec/shared_examples/coordinate_inputs.rb

@@ -0,0 +1,127 @@
+shared_examples_for 'Coordinate#inputs' do
+
+  describe '.dms different notations' do
+    let(:instance) { described_class.dms(input) }
+
+    context 'only degrees' do
+      let(:input) { '58' }
+
+      it { expect(instance.degrees).to eql(58) }
+      it { expect(instance.minutes).to eql(0) }
+    end
+
+    context 'without seconds' do
+      let(:input) { '58 45'}
+
+      it { expect(instance.degrees).to eql(58) }
+      it { expect(instance.minutes).to eql(45) }
+      it { expect(instance.seconds).to eql(0.0) }
+
+    end
+
+    context 'different formats' do
+      context '51 52 53' do
+        let(:input) { '51 52 53' }
+
+        it { expect(instance.degrees).to eql(51) }
+        it { expect(instance.minutes).to eql(52) }
+        it { expect(instance.seconds).to eql(53.0) }
+      end
+
+      context "51'52'53" do
+        let(:input) { "51'52'53" }
+
+        it { expect(instance.degrees).to eql(51) }
+        it { expect(instance.minutes).to eql(52) }
+        it { expect(instance.seconds).to eql(53.0) }
+      end
+
+      context '51 52 53 HEMI' do
+        let(:input) { "51 52 53 #{hemisphere}" }
+
+        it { expect(instance.degrees).to eql(51) }
+        it { expect(instance.minutes).to eql(52) }
+        it { expect(instance.seconds).to eql(53.0) }
+        it { expect(instance.hemisphere).to eql(hemisphere) }
+      end
+
+      context '51 52 53, HEMI' do
+        let(:input) { "51 52 53, #{hemisphere}" }
+
+        it { expect(instance.degrees).to eql(51) }
+        it { expect(instance.minutes).to eql(52) }
+        it { expect(instance.seconds).to eql(53.0) }
+        it { expect(instance.hemisphere).to eql(hemisphere) }
+      end
+    end
+
+  end
+
+  describe '.nmea different notations' do
+    let(:instance) { described_class.nmea(input) }
+
+    context 'only degrees and minutes' do
+      let(:input) { '03920' }
+
+      it { expect(instance.degrees).to eql(39) }
+      it { expect(instance.minutes).to eql(20) }
+      it { expect(instance.seconds).to eql(0.0) }
+    end
+
+    context 'only degrees and hemisphere' do
+      let(:input) { "03920,#{hemisphere}" }
+
+      it { expect(instance.degrees).to eql(39) }
+      it { expect(instance.minutes).to eql(20) }
+      it { expect(instance.seconds).to eql(0.0) }
+      it { expect(instance.hemisphere).to eql(hemisphere) }
+
+    end
+
+    context 'different formats' do
+      context '03920 HEMI' do
+        let(:input) { "03920 #{hemisphere}" }
+
+        it { expect(instance.degrees).to eql(39) }
+        it { expect(instance.minutes).to eql(20) }
+        it { expect(instance.seconds).to eql(0.0) }
+        it { expect(instance.hemisphere).to eql(hemisphere) }
+      end
+
+      context '03920,HEMI' do
+        let(:input) { "03920,#{hemisphere}" }
+
+        it { expect(instance.degrees).to eql(39) }
+        it { expect(instance.minutes).to eql(20) }
+        it { expect(instance.seconds).to eql(0.0) }
+        it { expect(instance.hemisphere).to eql(hemisphere) }
+      end
+
+      context '03920, HEMI' do
+        let(:input) { "03920, #{hemisphere}" }
+
+        it { expect(instance.degrees).to eql(39) }
+        it { expect(instance.minutes).to eql(20) }
+        it { expect(instance.seconds).to eql(0.0) }
+        it { expect(instance.hemisphere).to eql(hemisphere) }
+      end
+
+      context '03920.56074 HEMI' do
+        let(:input) { "03920.56074 #{hemisphere}" }
+
+        it { expect(instance.degrees).to eql(39) }
+        it { expect(instance.minutes).to eql(20) }
+        it { expect(instance.seconds).to eql(33.6444) }
+        it { expect(instance.hemisphere).to eql(hemisphere) }
+      end
+
+      context '03920' do
+        let(:input) { '03920' }
+
+        it { expect(instance.degrees).to eql(39) }
+        it { expect(instance.minutes).to eql(20) }
+        it { expect(instance.seconds).to eql(0.0) }
+      end
+    end
+  end
+end

data/spec/shared_examples/coordinate_presenters.rb

@@ -0,0 +1,16 @@
+shared_examples_for 'Coordinate#to_hash' do
+  subject { instance.to_hash }
+  let(:result) do
+    {
+      type:       instance.type,
+      degrees:    degrees,
+      minutes:    minutes,
+      seconds:    seconds,
+      hemisphere: hemi
+    }
+  end
+
+  it do
+    expect(subject).to eq(result)
+  end
+end

data/spec/shared_examples/coordinate_validation.rb

@@ -0,0 +1,89 @@
+shared_examples_for 'Coordinate#validation' do
+  describe '.nmea' do
+    let(:instance) { described_class.nmea(input) }
+
+    context 'degrees out of range' do
+      let(:input) { "#{max_degrees + 1}.2343242" }
+
+      it 'should fail' do
+        expect { instance }.to raise_error
+      end
+    end
+
+    context 'wrong hemisphere' do
+      let(:input) { "32.43 A" }
+
+      it 'should fail' do
+        expect { instance }.to raise_error
+      end
+    end
+  end
+
+  describe '.dms' do
+    let(:instance) { described_class.dms(input) }
+
+    context 'degrees out of range' do
+      let(:input) { "#{max_degrees + 1}'43'32" }
+
+      it 'should fail' do
+        expect { instance }.to raise_error
+      end
+    end
+
+    context 'minutes out of range' do
+      let(:input) { "10'90'32" }
+
+      it 'should fail' do
+        expect { instance }.to raise_error
+      end
+    end
+
+    context 'seconds out of range' do
+      let(:input) { "10'43'90" }
+
+      it 'should fail' do
+        expect { instance }.to raise_error
+      end
+    end
+
+    context 'wrong hemisphere' do
+      let(:input) { "10'43'32, A" }
+
+      it 'should fail' do
+        expect { instance }.to raise_error
+      end
+    end
+  end
+
+  describe '.decimal' do
+    let(:instance) { described_class.decimal(input) }
+
+    context 'degrees out of range' do
+      let(:input) { max_degrees + 1 }
+
+      it 'should fail' do
+        expect { instance }.to raise_error
+      end
+    end
+  end
+
+  describe '.degrees_minutes' do
+    let(:instance) { described_class.degrees_minutes(*input) }
+
+    context 'degrees out of range' do
+      let(:input) { [max_degrees + 1, 59] }
+
+      it 'should fail' do
+        expect { instance }.to raise_error
+      end
+    end
+
+    context 'minutes out of range' do
+      let(:input) { [max_degrees - 1, 61] }
+
+      it 'should fail' do
+        expect { instance }.to raise_error
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,39 @@
+if ENV['COVERAGE']
+  require 'simplecov'
+  SimpleCov.start do
+    add_filter '/spec/'
+  end
+end
+
+require 'libgeo'
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+Dir[File.join(Dir.pwd, 'spec/shared_examples/**/*.rb')].each { |f| require f }
+
+RSpec.configure do |config|
+  # Limit the spec run to only specs with the focus metadata. If no specs have
+  # the filtering metadata and `run_all_when_everything_filtered = true` then
+  # all specs will run.
+  #config.filter_run :focus
+
+  # Run all specs when none match the provided filter. This works well in
+  # conjunction with `config.filter_run :focus`, as it will run the entire
+  # suite when no specs have `:filter` metadata.
+  #config.run_all_when_everything_filtered = true
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.mock_with :rspec do |mocks|
+    mocks.verify_doubled_constant_names = true
+  end
+
+  config.order = 'random'
+end

data/spec/unit/libgeo/coordinate_spec.rb

@@ -0,0 +1,82 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Libgeo::Coordinate do
+  let(:instance) do
+    described_class.new(
+      params[:hemi],
+      params[:degrees],
+      params[:minutes],
+      params[:seconds]
+    )
+  end
+
+  let(:second_instance) do
+    described_class.new(
+      second_params[:hemi],
+      second_params[:degrees],
+      second_params[:minutes],
+      second_params[:seconds]
+    )
+  end
+
+  let(:params) do
+    {
+      hemi:    :N,
+      degrees: 10,
+      minutes: 10,
+      seconds: 5.6
+    }
+  end
+
+  describe 'equality' do
+    context 'when attributes same' do
+      let(:second_params) { params }
+
+      it 'coordinates should be same' do
+        expect(instance.eql?(second_instance)).to eql(true)
+        expect(instance == second_instance).to    eql(true)
+      end
+    end
+
+    context 'when different' do
+      context 'degrees' do
+        let(:second_params) { params.merge(degrees: 20) }
+
+        it 'should not be equal' do
+          expect(instance.eql?(second_instance)).to eql(false)
+          expect(instance == second_instance).to    eql(false)
+        end
+      end
+
+      context 'minutes' do
+        let(:second_params) { params.merge(minutes: 30) }
+
+        it 'should not be equal' do
+          expect(instance.eql?(second_instance)).to eql(false)
+          expect(instance == second_instance).to    eql(false)
+        end
+      end
+
+      context 'seconds' do
+        let(:second_params) { params.merge(seconds: 6.6) }
+
+        it 'should not be equal' do
+          expect(instance.eql?(second_instance)).to eql(false)
+          expect(instance == second_instance).to    eql(false)
+        end
+      end
+
+      context 'hemisphere' do
+        let(:second_params) { params.merge(hemi: :S) }
+
+        it 'should not be equal' do
+          expect(instance.eql?(second_instance)).to eql(false)
+          expect(instance == second_instance).to    eql(false)
+        end
+      end
+    end
+  end
+
+end