rgdal 0.0.5

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,10 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - ruby-head
+before_install:
+  - sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable -y
+  - sudo apt-get update
+  - sudo apt-get install libgdal-dev

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rgdal.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Tyler Johnston
+
+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,41 @@
+# RGdal
+
+Ruby wrapper for GDAL/OGR
+
+### Terminology Reference:
+
+| GDAL      | Database  |
+| --------- | --------- |
+| layer     | table     |
+| field_def | column    |
+| feature   | record    |
+| field     | attribute |
+
+## Examples
+
+### Writing
+    > file = RGdal::SHP.new('tmp/tmpfolder')
+    > file.create_layer('filename')
+    > file.feature(lat, long, {attr: 'foo', bar: 'baz'})
+    > file.close
+
+### Reading
+    > file = RGdal::SHP.new('tmp/tmpfolder')
+    > layer = file.current_layer
+    > layer.features.first.attributes
+    => {attr: 'foo', bar: 'baz'}
+    > file.close
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'rgdal', git: 'git@github.com:spatialnetworks/RGdal.git'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install rgdal

data/Rakefile

@@ -0,0 +1,16 @@
+#!/usr/bin/env rake
+require 'rubygems'
+require 'bundler'
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'rake'
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+Bundler.setup
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task :default => :spec

data/lib/rgdal.rb

@@ -0,0 +1,12 @@
+require 'gdal-ruby/ogr'
+require 'rgdal/overrides/layer'
+require 'rgdal/overrides/data_source'
+require 'rgdal/overrides/field_defn'
+require 'rgdal/overrides/feature'
+require 'rgdal/api'
+require 'rgdal/version'
+require 'rgdal/base'
+require 'rgdal/csv'
+require 'rgdal/kml'
+require 'rgdal/shp'
+require 'rgdal/geojson'

data/lib/rgdal/api.rb

@@ -0,0 +1,31 @@
+module RGdal
+  module API
+    module ClassMethods
+      def driver(name)
+        define_method :driver_name do
+          name
+        end
+      end
+
+      def single_layer?(bool)
+        define_method(:single_layer?) { bool }
+      end
+
+      def reference(name)
+        define_method :reference do
+          name
+        end
+      end
+
+      def format(name)
+        define_method :format do
+          name
+        end
+      end
+    end
+
+    def self.included(receiver)
+      receiver.extend(ClassMethods)
+    end
+  end
+end

data/lib/rgdal/base.rb

@@ -0,0 +1,102 @@
+module RGdal
+  class Base
+    include API
+
+    attr_reader :data_source
+    attr_reader :current_layer
+    attr_reader :driver
+
+    reference nil
+    single_layer? false
+    format Gdal::Ogr::WKBUNKNOWN
+
+    def initialize(source)
+      @source = source
+      @data_source = driver.create_data_source(@source)
+      @current_layer = layers.first
+      @columns = @current_layer ? @current_layer.fields.map(&:name) : []
+    end
+
+    def layers
+      @layers = @data_source.layers
+    end
+
+    def driver
+      @driver ||= Gdal::Ogr.get_driver_by_name(driver_name)
+    end
+
+    def switch_layer(name)
+      @current_layer = @layers.select { |layer| layer.name == name }.first
+      @columns = @current_layer ? @current_layer.fields.map(&:name) : []
+    end
+
+    def new_layer(filename='export')
+      layer(filename).tap do |layer|
+        @current_layer = layer
+        @layers << layer
+        @columns = []
+      end
+    end
+
+    def layer(filename)
+      @data_source.create_layer(filename, reference, format)
+    end
+
+    def close
+      @driver = nil
+      @data_source = nil
+      @current_layer = nil
+      @columns = nil
+    end
+
+    def add_column(name, options={})
+      options, name = {type: Gdal::Ogr::OFTSTRING, width: 254}.merge(options), header(name)
+      @columns.push(name)
+      field_definition = create_field_definition(name, options)
+      @current_layer.create_field(field_definition)
+      field_definition = nil
+    end
+
+    alias_method :layer_field_definition, :add_column
+
+    def create_field_definition(name, options)
+      Gdal::Ogr::FieldDefn.new(name, options[:type]).tap do |field|
+        field.set_width(options[:width]) if options[:width]
+        field.set_precision(options[:precision]) if options[:precision]
+      end
+    end
+
+    def feature(longitude, latitude, attributes={})
+      feat = Gdal::Ogr::Feature.new(@current_layer.definition)
+      set_geometry(latitude, longitude, feat)
+      set_attributes(attributes, feat)
+
+      @current_layer.create_feature(feat)
+      @current_layer.reset_reading
+    end
+
+private
+
+    def header(key)
+      key
+    end
+
+    def value(attrib)
+      attrib
+    end
+
+    def set_attributes(attributes, feat)
+      attributes.each do |key, value|
+        key = header(key)
+        feat.set_field(key, value(value)) if value.is_a?(String) && @columns.include?(key)
+      end
+    end
+
+    def set_geometry(latitude, longitude, feat)
+      coordinates = "POINT(#{longitude} #{latitude})"
+      geometry = Gdal::Ogr::create_geometry_from_wkt(coordinates)
+      feat.set_geometry(geometry)
+      geometry = nil
+    end
+  end
+end

data/lib/rgdal/csv.rb

@@ -0,0 +1,5 @@
+module RGdal
+  class CSV < RGdal::Base
+    driver 'CSV'
+  end
+end

data/lib/rgdal/geojson.rb

@@ -0,0 +1,5 @@
+module RGdal
+  class GeoJSON < RGdal::Base
+    driver 'GeoJSON'
+  end
+end

data/lib/rgdal/kml.rb

@@ -0,0 +1,5 @@
+module RGdal
+  class KML < RGdal::Base
+    driver 'KML'
+  end
+end

data/lib/rgdal/overrides/data_source.rb

@@ -0,0 +1,17 @@
+module Gdal
+  module Ogr
+    class DataSource
+      def to_s
+        "<#Gdal::Ogr::DataSource name='#{get_name}' layer_count='#{get_layer_count}' driver='#{driver_name}'>"
+      end
+
+      def layers
+        get_layer_count.times.map { |i| get_layer(i) }
+      end
+
+      def driver_name
+        get_driver.get_name
+      end
+    end
+  end
+end

data/lib/rgdal/overrides/feature.rb

@@ -0,0 +1,18 @@
+module Gdal
+  module Ogr
+    class Feature
+      def inspect
+        "#<Gdal::Ogr::Feature #{attributes.map { |k,v| "'#{k}'='#{v}'"}.join(' ')}>"
+      end
+
+      def attributes
+        {}.tap do |hash|
+          get_field_count.times do |i|
+            definition = self.get_field_defn_ref(i)
+            hash[definition.name] = get_field(i)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rgdal/overrides/field_defn.rb

@@ -0,0 +1,14 @@
+module Gdal
+  module Ogr
+    class FieldDefn
+      def to_s
+        "#<Gdal::Ogr::FieldDefn name='#{name}' type='#{type}' width='#{width}' precision='#{precision}' is_ignored='#{is_ignored}'>"
+      end
+
+      alias_method :name, :get_name
+      alias_method :type, :get_type_name
+      alias_method :width, :get_width
+      alias_method :precision, :get_precision
+    end
+  end
+end

data/lib/rgdal/overrides/layer.rb

@@ -0,0 +1,35 @@
+module Gdal
+  module Ogr
+    class Layer
+
+      alias_method :definition, :get_layer_defn
+
+      def features
+        [].tap do |array|
+          self.each { |feature| array << feature }
+          reset_reading
+        end
+      end
+
+      def to_s
+        "#<Gdal::Ogr::Layer name='#{self.get_name}' field_count='#{fields.count}'>"
+      end
+
+      def fields
+        definition.get_field_count.times.map { |i| definition.get_field_defn(i) }
+      end
+
+      def column_names
+        fields.map(&:name)
+      end
+
+      def fields_hash
+        {}.tap do |hash|
+          fields.each do |field|
+            hash[field.name] = field.type
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rgdal/shp.rb

@@ -0,0 +1,19 @@
+module RGdal
+  class SHP < RGdal::Base
+    driver 'ESRI Shapefile'
+    format Gdal::Ogr::WKBPOINT
+    reference Gdal::Osr::SpatialReference.new.tap { |srs| srs.import_from_proj4("+proj=longlat +ellps=WGS84 +datum=WGS84") }
+
+    FILE_EXTENSIONS = ['.shp', '.dbf', '.prj', '.shx']
+
+private
+
+    def header(key)
+      key[0..9]
+    end
+
+    def value(attrib)
+      attrib[0..253]
+    end
+  end
+end

data/lib/rgdal/version.rb

@@ -0,0 +1,3 @@
+module Rgdal
+  VERSION = "0.0.5"
+end

data/rgdal.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/rgdal/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Spatial Networks"]
+  gem.email         = ["sniadmin@spatialnetworks.com"]
+  gem.description   = %q{Pretty wrapper for GDAL/OGR}
+  gem.summary       = %q{Pretty wrapper for GDAL/OGR}
+  gem.homepage      = "https://github.com/spatialnetworks/RGdal"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "rgdal"
+  gem.require_paths = ["lib"]
+  gem.version       = Rgdal::VERSION
+
+  gem.add_dependency('gdal', '~> 0.0.5')
+  gem.add_dependency('activesupport')
+  gem.add_development_dependency('rspec')
+  gem.add_development_dependency('rake')
+end

data/spec/fixtures/record.yml

@@ -0,0 +1,6 @@
+example_one:
+  latitude: 38.89
+  longitude: -77.00
+  city: Washington
+  state: District of Colombia
+  misc: foobar

data/spec/integration/csv_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe RGdal::CSV do
+  before(:each) do
+    @fixture  = YAML.load(File.read('spec/fixtures/record.yml'))['example_one']
+    @path     = File.join(Dir.pwd, 'tmp', "#{SecureRandom.hex(16)}.csv")
+    @csv      = RGdal::CSV.new(@path)
+    @csv.new_layer('test')
+  end
+
+  it 'should create a layer' do
+    @csv.current_layer.should_not == nil
+  end
+
+  it 'should create field definition on the layer' do
+    @csv.layer_field_definition(@fixture.keys.first)
+    @csv.current_layer.fields.size.should == 1
+  end
+
+  it 'should create a valid CSV file' do
+    @fixture.keys.each { |key| @csv.add_column(key) }
+    @csv.feature(0.0, 0.0, @fixture)
+    @csv.close()
+
+    csv = CSV.open(@path, headers: true).first.to_hash
+    csv['city'].should == 'Washington'
+  end
+end

data/spec/integration/geojson_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe RGdal::GeoJSON do
+  before(:each) do
+    @fixture  = YAML.load(File.read('spec/fixtures/record.yml'))['example_one']
+    @path     = File.join(Dir.pwd, 'tmp', "#{SecureRandom.hex(16)}.json")
+    @geojson  = RGdal::GeoJSON.new(@path)
+    @geojson.new_layer('test')
+  end
+
+  it 'should create a valid CSV file' do
+    @fixture.keys.each { |key| @geojson.add_column(key) }
+    @geojson.feature(0.0, 0.0, @fixture)
+    @geojson.close()
+    GC.start && sleep(5) # Sigh
+
+    geojson = JSON.parse(File.read(@path))
+    geojson['features'].length.should == 1
+  end
+end

data/spec/integration/kml_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe RGdal::KML do
+  before(:each) do
+    @fixture  = YAML.load(File.read('spec/fixtures/record.yml'))['example_one']
+    @path     = File.join(Dir.pwd, 'tmp', "#{SecureRandom.hex(16)}")
+    @kml      = RGdal::KML.new(@path)
+    @kml.new_layer('test')
+  end
+
+  it 'should create a KML file' do
+    @fixture.keys.each { |key| @kml.add_column(key) }
+    @kml.feature(0.0, 0.0, @fixture)
+    @kml.close()
+    GC.start && sleep(5) # Sigh
+
+    File.open(@path).readline.should == "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n"
+  end
+end

data/spec/integration/shp_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe RGdal::SHP do
+  before(:each) do
+    @fixture  = YAML.load(File.read('spec/fixtures/record.yml'))['example_one']
+    @path     = File.join(Dir.pwd, 'tmp', "#{SecureRandom.hex(16)}")
+    Dir.mkdir(@path)
+    @shp      = RGdal::SHP.new(@path)
+    @shp.new_layer('test')
+  end
+
+  it 'should create a shapefile' do
+    @fixture.keys.each { |key| @shp.add_column(key) }
+    @shp.feature(0.0, 0.0, @fixture)
+    @shp.close()
+
+    File.size(File.join(@path, 'test.dbf')).should_not == 0
+  end
+end

data/spec/rgdal/overrides/data_source_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe Gdal::Ogr::DataSource do
+  before(:each) do
+    @path = "tmp/#{SecureRandom.hex(16)}.csv"
+    @csv = RGdal::CSV.new(@path)
+    @csv.new_layer('test')
+  end
+
+  it 'should return an array of layer objects' do
+    @csv.data_source.layers.length.should == 1
+    @csv.new_layer('foobar')
+    @csv.data_source.layers.length.should == 2
+  end
+
+  it 'should have a driver name' do
+    @csv.driver_name.should == 'CSV'
+  end
+end

data/spec/rgdal/overrides/feature_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe Gdal::Ogr::Feature do
+  before(:each) do
+    @path = File.join(Dir.pwd, "tmp/#{SecureRandom.hex(16)}.csv")
+    @csv = RGdal::CSV.new(@path)
+    @csv.new_layer('test')
+    @fixture  = YAML.load(File.read('spec/fixtures/record.yml'))['example_one']
+  end
+
+  it 'should create a hash of the feature' do
+    @csv.new_layer('test')
+    @fixture.keys.each { |k| @csv.layer_field_definition(k) }
+    @csv.feature('0.0', '0.0', @fixture)
+
+    attributes = @csv.current_layer.get_next_feature.attributes
+    attributes.class.should eq(Hash)
+    attributes['city'].should == 'Washington'
+  end
+end

data/spec/rgdal/overrides/layer_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Gdal::Ogr::Layer do
+  before(:each) do
+    @fixture  = YAML.load(File.read('spec/fixtures/record.yml'))['example_one']
+    @path     = File.join(Dir.pwd, 'tmp', "#{SecureRandom.hex(16)}.csv")
+    @csv      = RGdal::CSV.new(@path)
+    @csv.new_layer('test')
+    @fixture.keys.each { |k| @csv.layer_field_definition(k) }
+  end
+
+  it 'should return an array of column names' do
+    @csv.current_layer.column_names.should == %w(latitude longitude city state misc)
+  end
+
+  it 'should return an array of features' do
+    @csv.feature('0.0', '0.0', @fixture)
+    @csv.current_layer.features.length.should == 1
+  end
+
+  it 'should return a field hash with types' do
+    hash = @csv.current_layer.fields_hash
+    hash.keys.should   == %w(latitude longitude city state misc)
+    hash.values.should == %w(String) * 5
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require 'rspec'
+require 'rgdal'
+require 'csv'
+require 'tempfile'
+require 'json'
+require 'securerandom'
+require 'yaml'
+
+RSpec.configure do |config|
+  config.after(:each) do
+    temp_directory = File.join(Dir.pwd, 'tmp')
+    FileUtils.rm_r(Dir["#{temp_directory}/[^.]*"])
+  end
+end

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: rgdal
+version: !ruby/object:Gem::Version
+  version: 0.0.5
+  prerelease: 
+platform: ruby
+authors:
+- Spatial Networks
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gdal
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Pretty wrapper for GDAL/OGR
+email:
+- sniadmin@spatialnetworks.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/rgdal.rb
+- lib/rgdal/api.rb
+- lib/rgdal/base.rb
+- lib/rgdal/csv.rb
+- lib/rgdal/geojson.rb
+- lib/rgdal/kml.rb
+- lib/rgdal/overrides/data_source.rb
+- lib/rgdal/overrides/feature.rb
+- lib/rgdal/overrides/field_defn.rb
+- lib/rgdal/overrides/layer.rb
+- lib/rgdal/shp.rb
+- lib/rgdal/version.rb
+- rgdal.gemspec
+- spec/fixtures/record.yml
+- spec/integration/csv_spec.rb
+- spec/integration/geojson_spec.rb
+- spec/integration/kml_spec.rb
+- spec/integration/shp_spec.rb
+- spec/rgdal/overrides/data_source_spec.rb
+- spec/rgdal/overrides/feature_spec.rb
+- spec/rgdal/overrides/layer_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/spatialnetworks/RGdal
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Pretty wrapper for GDAL/OGR
+test_files:
+- spec/fixtures/record.yml
+- spec/integration/csv_spec.rb
+- spec/integration/geojson_spec.rb
+- spec/integration/kml_spec.rb
+- spec/integration/shp_spec.rb
+- spec/rgdal/overrides/data_source_spec.rb
+- spec/rgdal/overrides/feature_spec.rb
+- spec/rgdal/overrides/layer_spec.rb
+- spec/spec_helper.rb
+has_rdoc: