geoq 0.0.1.pre

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f9190180a02062cf1119badc7fd43d908bd1e5ba
+  data.tar.gz: ad237a21af279b4fd18e1dd0950f81e7986919da
+SHA512:
+  metadata.gz: b3a19251027bf22b2696c5286cd797fa3c4e36725969259619be913a06012469a431df93e6d6dc9af4fa94051ba9b2510d9f14689b51753dd33b6b25547d9345
+  data.tar.gz: 38c00b909152f112bc6e7de00fd971e553e9dc44f33b9ae965b7201b4a6f72b1af7aa8bf22cbb55e3ddef53a226aa55b762cb92741923ae66132faa5fc960143

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,85 @@
+PATH
+  remote: .
+  specs:
+    geoq (0.0.1)
+      gli (~> 2.17)
+      pr_geohash (~> 1.0)
+      rgeo (~> 1.0)
+      rgeo-geojson (~> 2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ansi (1.5.0)
+    aruba (0.14.5)
+      childprocess (>= 0.6.3, < 0.10.0)
+      contracts (~> 0.9)
+      cucumber (>= 1.3.19)
+      ffi (~> 1.9.10)
+      rspec-expectations (>= 2.99)
+      thor (~> 0.19)
+    backports (3.11.3)
+    builder (3.2.3)
+    childprocess (0.9.0)
+      ffi (~> 1.0, >= 1.0.11)
+    coderay (1.1.2)
+    contracts (0.16.0)
+    cucumber (3.1.0)
+      builder (>= 2.1.2)
+      cucumber-core (~> 3.1.0)
+      cucumber-expressions (~> 5.0.4)
+      cucumber-wire (~> 0.0.1)
+      diff-lcs (~> 1.3)
+      gherkin (~> 5.0)
+      multi_json (>= 1.7.5, < 2.0)
+      multi_test (>= 0.1.2)
+    cucumber-core (3.1.0)
+      backports (>= 3.8.0)
+      cucumber-tag_expressions (~> 1.1.0)
+      gherkin (>= 5.0.0)
+    cucumber-expressions (5.0.17)
+    cucumber-tag_expressions (1.1.1)
+    cucumber-wire (0.0.1)
+    diff-lcs (1.3)
+    ffi (1.9.23)
+    gherkin (5.0.0)
+    gli (2.17.1)
+    method_source (0.9.0)
+    minitest (5.11.3)
+    minitest-reporters (1.2.0)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    multi_json (1.13.1)
+    multi_test (0.1.2)
+    pr_geohash (1.0.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rake (12.3.1)
+    rdoc (6.0.4)
+    rgeo (1.0.0)
+    rgeo-geojson (2.0.0)
+      rgeo (~> 1.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.1)
+    ruby-progressbar (1.9.0)
+    thor (0.20.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba (~> 0.14)
+  geoq!
+  minitest (~> 5.11)
+  minitest-reporters (~> 1.2)
+  pry (~> 0.11)
+  rake (~> 12.3)
+  rdoc (~> 6.0)
+
+BUNDLED WITH
+   1.16.2

data/README.md

@@ -0,0 +1,55 @@
+# geoq
+
+[![Gem Version](https://badge.fury.io/rb/geoq.svg)](https://badge.fury.io/rb/geoq)
+
+[![Build Status](https://travis-ci.org/worace/geoq.svg?branch=master)](https://travis-ci.org/worace/geoq)
+
+Geospatial Utility Belt.
+
+## Install
+
+```
+gem install geoq
+```
+
+## Usage
+
+**[View the Usage Doc](https://github.com/worace/geoq/blob/master/usage.md)** for detailed usage examples.
+
+To view the included help just run the base command:
+
+```
+geoq
+# or
+geoq --help
+```
+
+Or view help for a specific command:
+
+```
+geoq wkt --help
+```
+
+## Feature Wishlist
+
+* [X] Read WKT
+* [X] Read GeoJSON
+* [X] Read Geohash
+* [X] Read Lat,Lon
+* [X] Output GeoJSON geom
+* [X] Output GeoJSON feature
+* [X] Output GeoJSON featurecollection
+* [X] Output geohash (point)
+* [ ] Output geohashes (geometry -- covering geohashes)
+* [ ] Output Geom Centroid
+* [ ] Output Geom area
+* [ ] Output Geom perimeter
+* [X] Output Geohash Children
+* [X] Output Geohash Neighbors
+* [ ] Output results to gist (geojson only)
+* [X] Literate-style Usage doc with checked examples
+
+## Releasing
+
+```
+```

data/README.rdoc

@@ -0,0 +1,6 @@
+= geoq
+
+Describe your project here
+
+:include:geoq.rdoc
+

data/Rakefile

@@ -0,0 +1,45 @@
+require 'rake/clean'
+require 'rubygems'
+require 'rubygems/package_task'
+require 'rdoc/task'
+require 'cucumber'
+require 'cucumber/rake/task'
+Rake::RDocTask.new do |rd|
+  rd.main = "README.rdoc"
+  rd.rdoc_files.include("README.rdoc","lib/**/*.rb","bin/**/*")
+  rd.title = 'Your application title'
+end
+
+spec = eval(File.read('geoq.gemspec'))
+
+Gem::PackageTask.new(spec) do |pkg|
+end
+CUKE_RESULTS = 'results.html'
+CLEAN << CUKE_RESULTS
+desc 'Run features'
+Cucumber::Rake::Task.new(:features) do |t|
+  opts = "features --format html -o #{CUKE_RESULTS} --format progress -x"
+  opts += " --tags #{ENV['TAGS']}" if ENV['TAGS']
+  t.cucumber_opts =  opts
+  t.fork = false
+end
+
+desc 'Run features tagged as work-in-progress (@wip)'
+Cucumber::Rake::Task.new('features:wip') do |t|
+  tag_opts = ' --tags ~@pending'
+  tag_opts = ' --tags @wip'
+  t.cucumber_opts = "features --format html -o #{CUKE_RESULTS} --format pretty -x -s#{tag_opts}"
+  t.fork = false
+end
+
+task :cucumber => :features
+task 'cucumber:wip' => 'features:wip'
+task :wip => 'features:wip'
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => [:test]

data/bin/geoq

@@ -0,0 +1,141 @@
+#!/usr/bin/env ruby
+require 'gli'
+begin # XXX: Remove this begin/rescue before distributing your app
+require 'geoq'
+rescue LoadError
+  STDERR.puts "In development, you need to use `bundle exec bin/geoq` to run your app"
+  STDERR.puts "At install-time, RubyGems will make sure lib, etc. are in the load path"
+  STDERR.puts "Feel free to remove this message from bin/geoq now"
+  exit 64
+end
+
+include GLI::App
+
+program_desc <<-desc
+Geospatial utility belt
+
+    geoq is a command-line tool for converting between various
+    GIS serialization formats. For example:
+
+        echo 9q5 | geoq gj geometry
+
+    Will output the geohash 9q5 as a geojson geometry.
+
+    Most commands will accept a Lat/Lon (comma-separated), a Geohash
+    (base 32 encoded), a WKT, or a GeoJSON input.
+
+    The tool should recognize the input type based on its format.
+
+    Commands expect one geo entity per line.
+
+    See COMMANDS for more possible commands.
+
+    See geoq <COMMAND> --help for more info on a given command.
+desc
+
+version Geoq::VERSION
+
+subcommand_option_handling :normal
+arguments :strict
+
+
+desc 'Convert to and manipulate GeoJSON.'
+# desc 'Treat all lines of input as a single collection'
+# switch [:s,:slurp]
+command :gj do |c|
+  c.desc "Output entity as a geojson geometry"
+  c.command :geometry do |c|
+    c.action do |global_options,options,args|
+      Geoq::GeomReader.new(STDIN).each do |entity|
+        puts entity.to_geojson
+      end
+    end
+  end
+
+  c.desc "Output entity as a geojson feature"
+  c.command :feature do |c|
+    c.action do |global_options,options,args|
+      Geoq::GeomReader.new(STDIN).each do |entity|
+        puts entity.to_geojson(true)
+      end
+    end
+  end
+
+  c.desc "Combine entities into a geojson feature collection"
+  c.command :fc do |c|
+    c.action do |global_options,options,args|
+      entities = Geoq::GeomReader.new(STDIN)
+      puts Geoq::Commands::GeoJson::FeatureCollection.new(entities).output
+    end
+  end
+end
+
+desc "Output entity as WKT"
+command :wkt do |c|
+  c.action do |global_options,options,args|
+    Geoq::GeomReader.new(STDIN).each do |geom|
+      puts geom.to_wkt
+    end
+  end
+end
+
+desc "Encode and manipulate geometries as GeoHashes"
+command :gh do |c|
+  c.desc "Encode supplied point as a GeoHash at the specified level. Only supports lat,lon points."
+  c.arg "level", required: true
+  c.command :point do |c|
+    c.action do |global_options,options,args|
+      reader = Geoq::GeomReader.new(STDIN)
+      Geoq::Commands::GeoHash::Point.new(reader, global_options, options, args).output.each do |gh|
+        puts gh
+      end
+    end
+  end
+
+  c.desc "Output the 32 children of the supplied Geohash."
+  c.command :children do |c|
+    c.action do |global_options,options,args|
+      reader = Geoq::GeomReader.new(STDIN)
+      Geoq::Commands::GeoHash::Children.new(reader, global_options, options, args).output.each do |gh|
+        puts gh
+      end
+    end
+  end
+
+  c.desc "Output the 8 neighbors of the supplied Geohash."
+  c.command :neighbors do |c|
+    c.switch :i, "inclusive",
+             desc: "Include the supplied geohash in the output, giving a 3x3 grid centered on the geohash. Default: False",
+             negatable: false
+    c.action do |global_options,options,args|
+      reader = Geoq::GeomReader.new(STDIN)
+      Geoq::Commands::GeoHash::Neighbors.new(reader, global_options, options, args).output.each do |gh|
+        puts gh
+      end
+    end
+  end
+
+end
+
+pre do |global,command,options,args|
+  # Pre logic here
+  # Return true to proceed; false to abort and not call the
+  # chosen command
+  # Use skips_pre before a command to skip this block
+  # on that command only
+  true
+end
+
+post do |global,command,options,args|
+  # Post logic here
+  # Use skips_post before a command to skip this
+  # block on that command only
+end
+
+on_error do |exception|
+  # Error logic here
+  # return false to skip default error handling
+  true
+end
+
+exit run(ARGV)

data/geoq.gemspec

@@ -0,0 +1,29 @@
+# Ensure we require the local version and not one we might have installed already
+require File.join([File.dirname(__FILE__),'lib','geoq','version.rb'])
+spec = Gem::Specification.new do |s|
+  s.name = 'geoq'
+  s.version = Geoq::VERSION
+  s.author = 'Horace Williams'
+  s.email = 'horace@worace.works'
+  s.homepage = 'https://github.com/worace/geoq'
+  s.platform = Gem::Platform::RUBY
+  s.license = 'MIT'
+  s.summary = 'geoq is a command-line utility for GIS format conversion and common GIS operations'
+  s.files = `git ls-files`.split('
+')
+  s.require_paths << 'lib'
+  s.has_rdoc = false
+  s.bindir = 'bin'
+  s.executables << 'geoq'
+
+  s.add_development_dependency('rake', '~>12.3')
+  s.add_development_dependency('aruba', '~>0.14')
+  s.add_development_dependency('minitest', '~> 5.11')
+  s.add_development_dependency('minitest-reporters', '~>1.2')
+  s.add_development_dependency('pry', '~>0.11')
+
+  s.add_runtime_dependency('gli','~>2.17')
+  s.add_runtime_dependency('rgeo', '~>1.0')
+  s.add_runtime_dependency('rgeo-geojson', '~>2.0')
+  s.add_runtime_dependency('pr_geohash', '~>1.0')
+end

data/lib/geoq.rb

@@ -0,0 +1,7 @@
+require 'geoq/version.rb'
+require 'geoq/geom_reader.rb'
+require 'geoq/commands/base.rb'
+require 'geoq/commands/geohash.rb'
+require 'geoq/commands/geojson.rb'
+require 'geoq/entity.rb'
+require 'geoq/errors.rb'

data/lib/geoq/commands/base.rb

@@ -0,0 +1,17 @@
+module Geoq
+  module Commands
+    class Base
+      attr_reader :global_opts, :opts, :args, :instream
+      def initialize(instream, global_opts = {}, opts = {}, args = [])
+        @global_opts = global_opts
+        @opts = opts
+        @args = args
+        @instream = instream
+      end
+
+      def output
+        raise "Not implemented"
+      end
+    end
+  end
+end

data/lib/geoq/commands/geohash.rb

@@ -0,0 +1,43 @@
+module Geoq
+  module Commands
+    module GeoHash
+      class Point < Base
+        def level
+          args.first.to_i
+        end
+
+        def output
+          Enumerator.new do |e|
+            instream.each do |entity|
+              e << entity.gh_string(level)
+            end
+          end
+        end
+      end
+
+      class Children < Base
+        def output
+          Enumerator.new do |e|
+            instream.each do |entity|
+              entity.gh_children.each do |gh|
+                e << gh
+              end
+            end
+          end
+        end
+      end
+
+      class Neighbors < Base
+        def output
+          Enumerator.new do |e|
+            instream.each do |entity|
+              entity.gh_neighbors(opts[:inclusive]).each do |gh|
+                e << gh
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/geoq/commands/geojson.rb

@@ -0,0 +1,11 @@
+module Geoq
+  module Commands
+    module GeoJson
+      class FeatureCollection < Base
+        def output
+          Geoq::FeatureCollection.new(instream).to_geojson
+        end
+      end
+    end
+  end
+end

data/lib/geoq/entity.rb

@@ -0,0 +1,97 @@
+require "rgeo/geo_json"
+require "pr_geohash"
+require "rgeo"
+
+module Geoq
+  class Entity
+    attr_reader :entity, :raw
+
+    def initialize(entity, raw)
+      @entity = entity
+      @raw = raw
+    end
+
+    def as_geojson(feature = false)
+      geom = RGeo::GeoJSON.encode(entity)
+      if feature
+        {type: "Feature",
+         properties: {},
+         geometry: geom}
+      else
+        geom
+      end
+    end
+
+    def to_geojson(feature = false)
+      as_geojson(feature).to_json
+    end
+
+    def to_wkt
+      entity.as_text
+    end
+
+    def gh_string(level)
+      if entity.dimension == 0
+        GeoHash.encode(entity.y, entity.x, level)
+      else
+        raise RepresentationError.new("GeoHash representation not supported for #{entity.to_s}")
+      end
+    end
+
+    def gh_children
+      raise RepresentationError.new("GeoHash children not supported for #{entity.to_s}")
+    end
+
+    def gh_neighbors(inclusive = false)
+      raise RepresentationError.new("GeoHash neighbors not supported for #{entity.to_s}")
+    end
+  end
+
+  class Geohash < Entity
+    def gh_children
+      BASE_32.chars.map { |char| raw + char }
+    end
+
+    def gh_neighbors(inclusive = false)
+      if inclusive
+        [raw] + GeoHash.neighbors(raw)
+      else
+        GeoHash.neighbors(raw)
+      end
+    end
+  end
+
+  class Wkt < Entity
+  end
+
+  class LatLon < Entity
+  end
+
+  class GeoJson < Entity
+    def as_geojson(feature = false)
+      if feature
+        if entity.is_a?(RGeo::GeoJSON::Feature)
+          RGeo::GeoJSON.encode(entity)
+        else
+          {type: "Feature",
+           properties: {},
+           geometry: RGeo::GeoJSON.encode(entity)}
+        end
+      else
+        RGeo::GeoJSON.encode(entity)
+      end
+    end
+  end
+
+  class FeatureCollection
+    attr_reader :entities
+    def initialize(entities)
+      @entities = entities
+    end
+
+    def to_geojson
+      {type: "FeatureCollection",
+       features: entities.map { |e| e.as_geojson(true) } }.to_json
+    end
+  end
+end

data/lib/geoq/errors.rb

@@ -0,0 +1,4 @@
+module Geoq
+  class RepresentationError < ArgumentError
+  end
+end

data/lib/geoq/geom_reader.rb

@@ -0,0 +1,71 @@
+require "pr_geohash"
+require "rgeo"
+require "rgeo/geo_json"
+
+module Geoq
+  BASE_32 = %w(0 1 2 3 4 5 6 7 8 9 b c d e f g h j
+                 k m n p q r s t u v w x y z).join("")
+  class GeomReader
+    attr_reader :wkt
+
+    GH_REGEX = Regexp.new(/\A[#{BASE_32}]+\z/)
+
+    LAT_LON_REGEX = /\A-?\d+\.?\d*,-?\d+\.?\d*\z/
+
+    include Enumerable
+
+    def initialize(instream)
+      @instream = instream
+      @wkt = RGeo::WKRep::WKTParser.new
+      @factory = RGeo::Cartesian.factory
+    end
+
+    def each(&block)
+      instream.each_line do |l|
+        block.call(decode(l))
+      end
+    end
+
+    def decode(line)
+      if geohash?(line)
+        (lat1, lon1), (lat2, lon2) = GeoHash.decode(line)
+        p1 = factory.point(lon1, lat1)
+        p2 = factory.point(lon2, lat2)
+        geom = RGeo::Cartesian::BoundingBox.create_from_points(p1, p2).to_geometry
+        Geohash.new(geom, strip_whitespace(line))
+      elsif geojson?(line)
+        GeoJson.new(RGeo::GeoJSON.decode(line), line)
+      elsif latlon?(line)
+        LatLon.new(factory.point(*strip_whitespace(line).split(",").map(&:to_f).reverse), line)
+      else
+        Wkt.new(wkt.parse(line), line)
+      end
+    end
+
+    def strip_whitespace(line)
+      line.gsub(/\s+/, "").downcase
+    end
+
+    def geohash?(line)
+      !!GH_REGEX.match(strip_whitespace(line))
+    end
+
+    def geojson?(line)
+      line.lstrip.start_with?("{")
+    end
+
+    def latlon?(line)
+      !!LAT_LON_REGEX.match(strip_whitespace(line))
+    end
+
+    private
+
+    def instream
+      @instream
+    end
+
+    def factory
+      @factory
+    end
+  end
+end

data/lib/geoq/version.rb

@@ -0,0 +1,3 @@
+module Geoq
+  VERSION = '0.0.1.pre'
+end

data/test/commands_test.rb

@@ -0,0 +1,78 @@
+require "test_helper"
+require "json"
+
+module Geoq
+  class CommandsTest < Minitest::Test
+    def test_feature_collection
+      fc = Geoq::Commands::GeoJson::FeatureCollection.new(TestData.mixed_stream)
+      json = JSON.parse(fc.output)
+      assert_equal "FeatureCollection", json["type"]
+      assert_equal ["type", "features"].sort, json.keys.sort
+      features = json["features"]
+      assert_equal 5, features.count
+
+      # encodes properties
+      assert_equal [{}, {}, {}, {"a" => "b"}, {}], features.map { |f| f["properties"] }
+      assert_equal Hash.new, features[0]["properties"]
+      assert_equal Hash.new, features[1]["properties"]
+      assert_equal Hash.new, features[2]["properties"]
+      assert_equal({"a" => "b"}, features[3]["properties"])
+
+      assert_equal ["Polygon", "Point", "Point", "Point", "Point"], features.map { |f| f["geometry"]["type"] }
+
+      gh = [[[-119.53125, 33.75], [-118.125, 33.75], [-118.125, 35.15625], [-119.53125, 35.15625], [-119.53125, 33.75]]]
+      assert_equal [gh, [0.0,1.0], [1.0, 2.0], [3.0, 4.0], [-118.3, 34.52]], features.map { |f| f["geometry"]["coordinates"] }
+    end
+
+    def test_geohash_point
+      input = TestData.stream(["0,0", "34, -118"])
+      command = Geoq::Commands::GeoHash::Point.new(input, {}, {}, ["4"])
+      assert_equal ["7zzz", "9qh1"], command.output.to_a
+    end
+
+    def test_gh_point_raises_for_geometry
+      input = TestData.mixed_stream.take(1)
+      command = Geoq::Commands::GeoHash::Point.new(input, {}, {}, ["4"])
+      assert_raises Geoq::RepresentationError do
+        command.output.to_a
+      end
+    end
+
+    def test_geohash_children
+      input = TestData.stream(["9q"])
+      command = Geoq::Commands::GeoHash::Children.new(input)
+      children = ["9q0", "9q1", "9q2", "9q3", "9q4", "9q5", "9q6",
+                  "9q7", "9q8", "9q9", "9qb", "9qc", "9qd", "9qe",
+                  "9qf", "9qg", "9qh", "9qj", "9qk", "9qm", "9qn",
+                  "9qp", "9qq", "9qr", "9qs", "9qt", "9qu", "9qv",
+                  "9qw", "9qx", "9qy", "9qz"]
+      assert_equal children, command.output.to_a
+    end
+
+    def test_geohash_children_raises_for_other_geoms
+      TestData.mixed_stream.reject do |entity|
+        entity.is_a?(Geohash)
+      end.each do |i|
+        s = TestData.stream([i.raw])
+        command = Geoq::Commands::GeoHash::Children.new(s)
+        assert_raises Geoq::RepresentationError do
+          command.output.to_a
+        end
+      end
+    end
+
+    def test_geohash_neighbors
+      input = TestData.stream(["9q"])
+      command = Geoq::Commands::GeoHash::Neighbors.new(input)
+      neighbors = ["9r", "9x", "9w", "9t", "9m", "9j", "9n", "9p"]
+      assert_equal neighbors, command.output.to_a
+    end
+
+    def test_geohash_neighbors_inclusive
+      input = TestData.stream(["9q"])
+      command = Geoq::Commands::GeoHash::Neighbors.new(input, {}, {inclusive: true})
+      neighbors = ["9q", "9r", "9x", "9w", "9t", "9m", "9j", "9n", "9p"]
+      assert_equal neighbors, command.output.to_a
+    end
+  end
+end

data/test/geom_reader_test.rb

@@ -0,0 +1,56 @@
+require "test_helper"
+require "json"
+
+module Geoq
+  class GeomReaderTest < Minitest::Test
+    attr_reader :reader
+
+    def setup
+      r,w = IO.pipe
+      w.close
+      @reader = Geoq::GeomReader.new(r)
+    end
+
+    def test_recognizes_geohashes
+      assert reader.geohash?("9q5")
+      assert reader.geohash?("9Q5")
+      assert reader.geohash?(" 9Q5  ")
+      refute reader.geohash?(" 9aQ5  ")
+      assert reader.geohash?("u58seqshdz50")
+    end
+
+    def test_recognizes_geojson
+      assert reader.geojson?({type: "Point", coordinates: [0,1]}.to_json)
+      refute reader.geojson?("a")
+    end
+
+    def test_parse_objects
+      parsed = TestData.mixed_stream.to_a
+      assert parsed[0].is_a? Geoq::Geohash
+      assert parsed[1].is_a? Geoq::GeoJson
+      assert parsed[2].is_a? Geoq::Wkt
+      assert parsed[3].is_a? Geoq::GeoJson
+      assert parsed[4].is_a? Geoq::LatLon
+    end
+
+    def test_parsing_lat_lons
+      assert reader.latlon?("0,0")
+      assert reader.latlon?("0, 0")
+      assert reader.latlon?("123.456,98.2")
+      assert reader.latlon?("  -123.456,-98.2 ")
+    end
+
+    def test_correct_lat_lon_ordering
+      entities = TestData.stream(["1,2", "34, -118"]).to_a
+      assert_equal entities[0].entity.x, 2
+      assert_equal entities[0].entity.y, 1
+      assert_equal entities[1].entity.x, -118
+      assert_equal entities[1].entity.y, 34
+    end
+
+    def test_lat_lon_geohash_conversion
+      point = TestData.stream(["34, -118"]).first
+      assert_equal "9qh1", point.gh_string(4)
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,28 @@
+$LOAD_PATH.unshift File.expand_path("../../lib", __FILE__)
+require "geoq"
+
+require "minitest/autorun"
+require "minitest/reporters"
+require "minitest/spec"
+
+Minitest::Reporters.use! Minitest::Reporters::DefaultReporter.new
+
+module Geoq::TestData
+  def self.stream(strings)
+    r,w = IO.pipe
+    strings.each do |s|
+      w.puts(s)
+    end
+    w.close
+    Geoq::GeomReader.new(r)
+  end
+
+  def self.mixed_stream
+    inputs = ["9q5",
+              {type: "Point", coordinates: [0,1]}.to_json,
+              "POINT (1.0 2.0)",
+              {type: "Feature", properties: {a: "b"}, geometry: {type: "Point", coordinates: [3,4]}}.to_json,
+              "34.52,-118.3"]
+    stream(inputs)
+  end
+end

data/test/usage_test.rb

@@ -0,0 +1,35 @@
+require "test_helper"
+
+module Geoq
+  class UsageTest < Minitest::Test
+    def script_setup
+      File.read("./usage.md").match(/```setup\n(.+)\n```/)[1]
+    end
+
+    def examples
+      File.read("./usage.md").scan(/```example\n(.*?)```\n/m).to_a.flatten.map { |match| match.split("\n=> ") }
+    end
+
+    def setup
+    end
+
+    def test_reads_examples
+      assert_equal 15, examples.count
+    end
+
+    def checked_command(command)
+      result = `#{command}`
+      if $? != 0
+        raise RuntimeError.new("Command #{command} exited with non-zero response code.")
+      end
+      result
+    end
+
+    def test_run_examples
+      examples.each do |command, expected_output|
+        result = checked_command(command)
+        assert_equal expected_output, result, "Checked example: #{command} failed"
+      end
+    end
+  end
+end

data/usage.md

@@ -0,0 +1,150 @@
+# Geoq Usage
+
+```setup
+alias geoqqq="bundle exec geoq" &&
+```
+
+## GeoJSON (`geoq gj`)
+
+Output a geo feature as a GeoJSON Geometry
+
+```example
+echo 9q5 | bundle exec bin/geoq gj geometry
+=> {"type":"Polygon","coordinates":[[[-119.53125,33.75],[-118.125,33.75],[-118.125,35.15625],[-119.53125,35.15625],[-119.53125,33.75]]]}
+```
+
+Output a geo feature as a GeoJSON Feature
+
+```example
+echo 9q5 | bundle exec bin/geoq gj feature
+=> {"type":"Feature","properties":{},"geometry":{"type":"Polygon","coordinates":[[[-119.53125,33.75],[-118.125,33.75],[-118.125,35.15625],[-119.53125,35.15625],[-119.53125,33.75]]]}}
+```
+
+Combine 1 or more geo features into a GeoJSON Feature Collection
+
+```example
+printf "9q5\n9q4\n" | bundle exec bin/geoq gj fc
+=> {"type":"FeatureCollection","features":[{"type":"Feature","properties":{},"geometry":{"type":"Polygon","coordinates":[[[-119.53125,33.75],[-118.125,33.75],[-118.125,35.15625],[-119.53125,35.15625],[-119.53125,33.75]]]}},{"type":"Feature","properties":{},"geometry":{"type":"Polygon","coordinates":[[[-120.9375,33.75],[-119.53125,33.75],[-119.53125,35.15625],[-120.9375,35.15625],[-120.9375,33.75]]]}}]}
+```
+
+Converts Geohashes, WKTs, Lat/Lons, and GeoJSON into GeoJSON
+
+```example
+echo 9q5 | bundle exec bin/geoq gj geometry
+=> {"type":"Polygon","coordinates":[[[-119.53125,33.75],[-118.125,33.75],[-118.125,35.15625],[-119.53125,35.15625],[-119.53125,33.75]]]}
+```
+
+```example
+echo "POINT (1.0 2.0)" | bundle exec bin/geoq gj geometry
+=> {"type":"Point","coordinates":[1.0,2.0]}
+```
+
+```example
+echo "34.52,-118.3" | bundle exec bin/geoq gj geometry
+=> {"type":"Point","coordinates":[-118.3,34.52]}
+```
+
+```example
+echo '{"type":"Point","coordinates":[-118.3,34.52]}' | bundle exec bin/geoq gj geometry
+=> {"type":"Point","coordinates":[-118.3,34.52]}
+```
+
+## Geohashes (`geoq gh`)
+
+Convert a point to a geohash at specified level
+
+```example
+echo "34,-118" | bundle exec bin/geoq gh point 4
+=> 9qh1
+```
+
+Get children of a geohash
+
+```example
+echo 9qh1 | bundle exec bin/geoq gh children
+=> 9qh10
+9qh11
+9qh12
+9qh13
+9qh14
+9qh15
+9qh16
+9qh17
+9qh18
+9qh19
+9qh1b
+9qh1c
+9qh1d
+9qh1e
+9qh1f
+9qh1g
+9qh1h
+9qh1j
+9qh1k
+9qh1m
+9qh1n
+9qh1p
+9qh1q
+9qh1r
+9qh1s
+9qh1t
+9qh1u
+9qh1v
+9qh1w
+9qh1x
+9qh1y
+9qh1z
+```
+
+Get neighbors of a geohash
+
+```example
+echo 9qh1 | bundle exec bin/geoq gh neighbors
+=> 9qh4
+9qh6
+9qh3
+9qh2
+9qh0
+9q5b
+9q5c
+9q5f
+```
+
+Include the original geohash in the neighbors list:
+
+```example
+echo 9qh1 | bundle exec bin/geoq gh neighbors -i
+=> 9qh1
+9qh4
+9qh6
+9qh3
+9qh2
+9qh0
+9q5b
+9q5c
+9q5f
+```
+
+## WKT (`geoq wkt`)
+
+Converts Geohashes, WKTs, Lat/Lons, and GeoJSON into GeoJSON
+
+```example
+echo 9q5 | bundle exec bin/geoq wkt
+=> POLYGON ((-119.53125 33.75, -118.125 33.75, -118.125 35.15625, -119.53125 35.15625, -119.53125 33.75))
+```
+
+```example
+echo "POINT (1.0 2.0)" | bundle exec bin/geoq wkt
+=> POINT (1.0 2.0)
+```
+
+```example
+echo "34.52,-118.3" | bundle exec bin/geoq wkt
+=> POINT (-118.3 34.52)
+```
+
+```example
+echo '{"type":"Point","coordinates":[-118.3,34.52]}' | bundle exec bin/geoq wkt
+=> POINT (-118.3 34.52)
+```

metadata

@@ -0,0 +1,193 @@
+--- !ruby/object:Gem::Specification
+name: geoq
+version: !ruby/object:Gem::Version
+  version: 0.0.1.pre
+platform: ruby
+authors:
+- Horace Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-05-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.17'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.17'
+- !ruby/object:Gem::Dependency
+  name: rgeo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rgeo-geojson
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pr_geohash
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: 
+email: horace@worace.works
+executables:
+- geoq
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- README.md
+- README.rdoc
+- Rakefile
+- bin/geoq
+- geoq.gemspec
+- lib/geoq.rb
+- lib/geoq/commands/base.rb
+- lib/geoq/commands/geohash.rb
+- lib/geoq/commands/geojson.rb
+- lib/geoq/entity.rb
+- lib/geoq/errors.rb
+- lib/geoq/geom_reader.rb
+- lib/geoq/version.rb
+- test/commands_test.rb
+- test/geom_reader_test.rb
+- test/test_helper.rb
+- test/usage_test.rb
+- usage.md
+homepage: https://github.com/worace/geoq
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14.1
+signing_key: 
+specification_version: 4
+summary: geoq is a command-line utility for GIS format conversion and common GIS operations
+test_files: []