to_town 0.0.4

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,25 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+
+gem "bundler"
+gem 'mongoid', "~> 2.0.0"
+gem 'thor'
+gem 'bson_ext'
+
+group :development do
+  gem "jeweler", "~> 1.6.2"
+  gem 'ruby-debug19'
+  gem "awesome_print"
+  gem 'fabrication'
+end
+
+group :test do
+  gem 'rspec'
+  gem 'simplecov', :require => false
+  gem 'autotest'
+end

data/Gemfile.lock

@@ -0,0 +1,73 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ZenTest (4.5.0)
+    activemodel (3.0.9)
+      activesupport (= 3.0.9)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activesupport (3.0.9)
+    archive-tar-minitar (0.5.2)
+    autotest (4.4.6)
+      ZenTest (>= 4.4.1)
+    awesome_print (0.4.0)
+    bson (1.3.1)
+    bson_ext (1.3.1)
+    builder (2.1.2)
+    columnize (0.3.3)
+    diff-lcs (1.1.2)
+    fabrication (1.0.0)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.6.2)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    linecache19 (0.5.12)
+      ruby_core_source (>= 0.1.4)
+    mongo (1.3.1)
+      bson (>= 1.3.1)
+    mongoid (2.0.2)
+      activemodel (~> 3.0)
+      mongo (~> 1.3)
+      tzinfo (~> 0.3.22)
+    rake (0.9.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    ruby-debug-base19 (0.11.25)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby_core_source (>= 0.1.4)
+    ruby-debug19 (0.11.6)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby-debug-base19 (>= 0.11.19)
+    ruby_core_source (0.1.5)
+      archive-tar-minitar (>= 0.5.2)
+    simplecov (0.4.2)
+      simplecov-html (~> 0.4.4)
+    simplecov-html (0.4.5)
+    thor (0.14.6)
+    tzinfo (0.3.28)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  autotest
+  awesome_print
+  bson_ext
+  bundler
+  fabrication
+  jeweler (~> 1.6.2)
+  mongoid (~> 2.0.0)
+  rspec
+  ruby-debug19
+  simplecov
+  thor

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 zhengjia
+
+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.rdoc

@@ -0,0 +1,106 @@
+= to_town
+
+Find nearby towns of a geographic latitude and longitude. Currently it only has US locations.
+Other data sources can be added if available.
+
+== Usage
+
+* Install the gem: gem install to_town
+* add to_town to your Gemfile
+* add require 'to_town' to your code
+* You can get a list of nearby points by calling ToTown.check(some_latitude_value, some_longitude_value, results_limit)
+
+Command line:
+* run `to_town config` to generate a mongoid.yml in the current directory
+* run `to_town populate` to load the data to mongodb
+* run `to_town --lat=some_latitude_value --lng=some_longitude_value` to check the result
+
+Example:
+
+to_town check --lat=45.018625 --lng=-93.239039 --limit=10
+
+St. Anthony MN
+                     type: city
+                     latitude: 45.027324
+                     longitude: -93.215533
+                     land area: 5831140
+                     water area: 305693
+
+Columbia Heights MN
+                     type: city
+                     latitude: 45.049104
+                     longitude: -93.246749
+                     land area: 8832769
+                     water area: 284420
+
+Hilltop MN
+                     type: city
+                     latitude: 45.053564
+                     longitude: -93.250129
+                     land area: 310173
+                     water area: 0
+
+Lauderdale MN
+                     type: city
+                     latitude: 44.994407
+                     longitude: -93.203134
+                     land area: 1086715
+                     water area: 2752
+
+New Brighton MN
+                     type: city
+                     latitude: 45.064894
+                     longitude: -93.209271
+                     land area: 16731107
+                     water area: 1545061
+
+Minneapolis MN
+                     type: city
+                     latitude: 44.963324
+                     longitude: -93.268284
+                     land area: 139789184
+                     water area: 9052448
+
+Fridley MN
+                     type: city
+                     latitude: 45.084246
+                     longitude: -93.26005
+                     land area: 26329217
+                     water area: 1873882
+
+Falcon Heights MN
+                     type: city
+                     latitude: 44.988048
+                     longitude: -93.174718
+                     land area: 5785375
+                     water area: 16906
+
+Roseville MN
+                     type: city
+                     latitude: 45.015422
+                     longitude: -93.155011
+                     land area: 33679465
+                     water area: 2168129
+
+Arden Hills MN
+                     type: city
+                     latitude: 45.071161
+                     longitude: -93.165504
+                     land area: 22253249
+                     water area: 2743210
+
+== Data source
+
+* US 2010 Census http://www.census.gov/geo/www/gazetteer/files/Gaz_places_national.txt.
+
+== Contributing to to_town
+
+* Fork the project
+* Start a feature/bugfix branch
+* Send pull request
+
+== Copyright
+
+Copyright (c) 2011 zhengjia. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "to_town"
+  gem.homepage = "http://github.com/zhengjia/to_town"
+  gem.license = "MIT"
+  gem.summary = %Q{Find nearby towns of a geographic latitude and longitude}
+  gem.description = %Q{Find nearby towns of a geographic latitude and longitude}
+  gem.email = "jiazheng@live.com"
+  gem.authors = ["zhengjia"]
+  gem.executables = ['to_town']
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "to_town #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.4

data/bin/to_town

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.expand_path('../lib', File.dirname(__FILE__))
+
+require 'to_town/cli'
+ToTown::CLI.start

data/lib/to_town.rb

@@ -0,0 +1,12 @@
+require 'to_town/point'
+require 'to_town/db_connection'
+
+module ToTown
+
+  def self.check(lat, lng, limit = 20)
+    # TODO validation
+    # TODO add a limit
+    Point.near(latlng: [ lat, lng ]).limit(limit)
+  end
+
+end

data/lib/to_town/cli.rb

@@ -0,0 +1,42 @@
+# TODO require all converters and generators
+
+require 'thor'
+require 'to_town'
+require 'to_town/converter/us'
+require 'to_town/generators/mongodb'
+
+module ToTown
+  class CLI < Thor
+
+    desc "populate", "populate data to mongodb"
+    def populate
+      ToTown::Converter::Us.run
+    end
+
+    desc "check", "acceps two required arguments --lat and --lng, and an optional --limit"
+    method_option :lat, :required => true
+    method_option :lng, :required => true
+    method_option :limit, :type => :numeric
+    def check
+      points = ToTown.check(options[:lat].to_f, options[:lng].to_f, options[:limit])
+            points.each do |point|
+              puts %{ #{point.name} #{point.state}\t
+                      type: #{point.town_type}\t
+                      latitude: #{point.latlng[0]}\t
+                      longitude: #{point.latlng[1]}\t
+                      land area: #{point.aland}\t
+                      water area: #{point.awater}
+                    }
+            end
+    end
+
+    desc "config", "generate database configuration file mongoid.yml"
+    def config(db_name='mongo')
+      case db_name
+      when "mongo"
+        ToTown::Generators::Mongodb.start
+      end
+    end
+
+  end
+end

data/lib/to_town/converter/us.rb

@@ -0,0 +1,37 @@
+require 'iconv'
+require 'to_town/point'
+require 'to_town/data_migration'
+require 'to_town/db_connection'
+
+module ToTown
+
+  module Converter
+
+    class Us
+      FILE_NAME     = "Gaz_places_national.txt"
+      FILE_LOCATION = File.expand_path("../../../raw_data/#{FILE_NAME}" , File.dirname(__FILE__))
+
+      def self.run(dry = 0)
+        iconv = Iconv.new('UTF-8//IGNORE', 'UTF-8')
+        if ToTown::DataMigration.where(:filename => FILE_NAME).empty?
+          if dry == 0
+            File.open(FILE_LOCATION, "r") do |file|
+              # pass the title
+              file.gets
+              while line = file.gets
+                line = iconv.iconv(line) unless line.valid_encoding?
+                data = line.chomp.split(/\t/)
+                name_town_type = data[3].split(/ ((?=[[:lower:]])|CDP)/)
+                ToTown::Point.create(:state => data[0], :geoid => data[1], :ansicode => data[2], :name => name_town_type[0], :town_type => (name_town_type-[name_town_type[0]]).join, :aland => data[4], :awater => data[5], :latlng => [data[8].to_f, data[9].to_f] )
+              end # end while
+            end # end File.open
+          end # end if dry == 0
+          ToTown::DataMigration.create(:filename => FILE_NAME)
+        end # end if
+      end
+
+    end
+
+  end
+
+end

data/lib/to_town/data_migration.rb

@@ -0,0 +1,14 @@
+# store the imported file so it won't be imported again
+
+module ToTown
+
+  class DataMigration
+
+    include Mongoid::Document
+    include Mongoid::Timestamps
+
+    field :filename
+
+  end
+
+end

data/lib/to_town/db_connection.rb

@@ -0,0 +1,14 @@
+require 'to_town/generators/mongodb'
+
+RACK_ENV ||= 'development'
+
+unless File.exists?('mongoid.yml')
+  ToTown::Generators::Mongodb.start
+end
+
+db_config = YAML::load File.open('mongoid.yml' )
+db_name = db_config[RACK_ENV]['database']
+Mongoid.configure do |config|
+  config.master = Mongo::Connection.new.db(db_name)
+  config.autocreate_indexes = true
+end

data/lib/to_town/generators/mongodb.rb

@@ -0,0 +1,19 @@
+require 'thor/group'
+
+module ToTown
+  module Generators
+    class Mongodb < Thor::Group
+
+      include Thor::Actions
+
+      def genenrate
+        template("mongoid_example.yml", "mongoid.yml")
+      end
+
+      def self.source_root
+        File.dirname(__FILE__) + "/templates"
+      end
+
+    end
+  end
+end