locapoint 0.0.1

data/CHANGELOG

@@ -0,0 +1,2 @@
+Version 0.0.1 (October 21, 2006)
+* First release.

data/MIT-LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2006 Yohji Shidara
+
+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

@@ -0,0 +1,27 @@
+= LocaPoint conversion library for Ruby
+
+A ruby library for conversion between LocaPoint and latitude/longuitude notation.
+
+== What is LocaPoint?
+
+LocaPoint is the state-of-the-art location pointer that can express any location of the world, only with 12 letters.
+(quoted from http://www.locapoint.com)
+
+== Examples
+
+  Locapoint.decode("SD9.XC4.ER9.CY4")
+  > [35.6586477189174, 139.745663667239]
+
+  Locapoint.encode(35.658648,139.745664)
+  > "SD9.XC4.ER9.CY4"
+
+== See Also
+
+* LocaPoint Official Site: http://www.locapoint.com
+* LocaPoint Specifications: http://www.locapoint.com/en/spec.html
+
+== Author
+
+Copyright (c) 2006 Yohji Shidara, under MIT License.
+
+Yohji Shidara <dara@shidara.net>

data/Rakefile

@@ -0,0 +1,85 @@
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/contrib/rubyforgepublisher'
+require 'fileutils'
+include FileUtils
+require File.join(File.dirname(__FILE__), 'lib', 'locapoint', 'version')
+
+AUTHOR = "shidara"
+EMAIL = "dara@shidara.net"
+DESCRIPTION = "LocaPoint conversion library"
+RUBYFORGE_PROJECT = "locapoint"
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+BIN_FILES = %w(  )
+
+
+NAME = "locapoint"
+REV = File.read(".svn/entries")[/committed-rev="(d+)"/, 1] rescue nil
+VERS = ENV['VERSION'] || (Locapoint::VERSION::STRING + (REV ? ".#{REV}" : ""))
+CLEAN.include ['**/.*.sw?', '*.gem', '.config']
+RDOC_OPTS = ['--quiet', '--title', "locapoint documentation",
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+desc "Packages up locapoint gem."
+task :default => [:test]
+task :package => [:clean]
+
+Rake::TestTask.new("test") { |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+  t.verbose = true
+}
+
+spec =
+    Gem::Specification.new do |s|
+        s.name = NAME
+        s.version = VERS
+        s.platform = Gem::Platform::RUBY
+        s.has_rdoc = true
+        s.extra_rdoc_files = ["README", "CHANGELOG"]
+        s.rdoc_options += RDOC_OPTS + ['--exclude', '^(examples|extras)/']
+        s.summary = DESCRIPTION
+        s.description = DESCRIPTION
+        s.author = AUTHOR
+        s.email = EMAIL
+        s.homepage = HOMEPATH
+        s.executables = BIN_FILES
+        s.rubyforge_project = RUBYFORGE_PROJECT
+        s.bindir = "bin"
+        s.require_path = "lib"
+        s.autorequire = "locapoint"
+
+        #s.add_dependency('activesupport', '>=1.3.1')
+        #s.required_ruby_version = '>= 1.8.2'
+
+        s.files = %w(README CHANGELOG MIT-LICENSE Rakefile) +
+          Dir.glob("{bin,doc,test,lib,templates,generator,extras,website,script}/**/*") + 
+          Dir.glob("ext/**/*.{h,c,rb}") +
+          Dir.glob("examples/**/*.rb") +
+          Dir.glob("tools/*.rb")
+        
+        # s.extensions = FileList["ext/**/extconf.rb"].to_a
+    end
+
+Rake::GemPackageTask.new(spec) do |p|
+    p.need_tar = true
+    p.gem_spec = spec
+end
+
+task :install do
+  name = "#{NAME}-#{VERS}.gem"
+  sh %{rake package}
+  sh %{sudo gem install pkg/#{name}}
+end
+
+task :uninstall => [:clean] do
+  sh %{sudo gem uninstall #{NAME}}
+end

data/examples/example.rb

@@ -0,0 +1,5 @@
+require 'rubygems'
+require 'locapoint'
+
+p Locapoint.decode("SD9.XC4.ER9.CY4")
+p Locapoint.encode(35.658648,139.745664)

data/lib/locapoint/locapoint.rb

@@ -0,0 +1,61 @@
+=begin
+LocaPoint Conversion Library for Ruby
+Copyright (c) 2006 Yohji Shidara, under MIT License
+=end
+
+# LocaPoint module.
+module Locapoint
+  # Regular expression that matches LocaPoint strings.
+  LOCAPOINT_REGEXP = /[A-Z][A-Z][0-9]\.[A-Z][A-Z][0-9]\.[A-Z][A-Z][0-9]\.[A-Z][A-Z][0-9]/
+  
+  # Exception thrown by LocaPoint format errors.
+  class FormatError < Exception; end
+
+  # Will convert a LocaPoint string into a pair of +latitude+ and +longitude+.
+  def decode(locapoint)
+    unless locapoint =~ LOCAPOINT_REGEXP && locapoint.size == 15
+      raise FormatError, "Invalid format"
+    end
+    
+    s = locapoint.to_s
+    latitude = ((s[0] - ?A) * 1757600 \
+                +(s[1] - ?A) * 67600 \
+                +(s[2] - ?0) * 6760 \
+                +(s[8] - ?A) * 260 \
+                +(s[9] - ?A) * 10 \
+                +(s[10] - ?0) ) * 180 / 45697600.0 -90;
+    longitude = ((s[4] - ?A) * 1757600 \
+                 +(s[5] - ?A) * 67600 \
+                 +(s[6] - ?0) * 6760 \
+                 +(s[12] - ?A) * 260 \
+                 +(s[13] - ?A) * 10 \
+                 +(s[14] - ?0) ) * 360 / 45697600.0 -180;
+    return latitude, longitude
+  end
+  
+  # Will convert latitude and longitude into LocaPoint string.
+  def encode(latitude, longitude)
+    latitude_step = (latitude.to_f + 90) / 180 * 45697600;
+    longitude_step = (longitude.to_f + 180) / 360 * 45697600;
+    
+    s = "AA0.AA0.AA0.AA0"
+    s[0] += (latitude_step / 1757600 % 26).to_i
+    s[1] += (latitude_step / 67600 % 26).to_i
+    s[2] += (latitude_step / 6760 % 10).to_i
+    
+    s[4] += (longitude_step / 1757600 % 26).to_i
+    s[5] += (longitude_step / 67600 % 26).to_i
+    s[6] += (longitude_step / 6760 % 10).to_i
+
+    s[8] += (latitude_step / 260 % 26).to_i
+    s[9] += (latitude_step / 10 % 26).to_i
+    s[10] += (latitude_step / 1 % 10).to_i
+    
+    s[12] += (longitude_step / 260 % 26).to_i
+    s[13] += (longitude_step / 10 % 26).to_i
+    s[14] += (longitude_step / 1 % 10).to_i
+
+    return s
+  end
+  module_function :decode, :encode
+end

data/lib/locapoint/version.rb

@@ -0,0 +1,9 @@
+module Locapoint #:nodoc:
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/locapoint.rb

@@ -0,0 +1 @@
+Dir[File.join(File.dirname(__FILE__), 'locapoint/**/*.rb')].sort.each { |lib| require lib }

data/test/locapoint_test.rb

@@ -0,0 +1,23 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class LocapointTest < Test::Unit::TestCase
+
+  def setup
+  end
+  
+  def test_decodeing
+    lat,lon = Locapoint.decode("SD9.XC4.ER9.CY4")
+    assert_in_delta( 35.658648, lat, 1e-6)
+    assert_in_delta(139.745664, lon, 1e-6)
+  end
+
+  def test_decodeing_of_invalid_string
+    assert_raise(Locapoint::FormatError) {
+      Locapoint.decode("Hello World.")
+    }
+  end
+
+  def test_encoding
+    assert_equal("SD9.XC4.ER9.CY4", Locapoint.encode(35.658648,139.745664))
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,2 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/locapoint'

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: locapoint
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+date: 2006-10-21 00:00:00 +09:00
+summary: LocaPoint conversion library
+require_paths: 
+- lib
+email: dara@shidara.net
+homepage: http://locapoint.rubyforge.org
+rubyforge_project: locapoint
+description: LocaPoint conversion library
+autorequire: locapoint
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- shidara
+files: 
+- README
+- CHANGELOG
+- MIT-LICENSE
+- Rakefile
+- test/locapoint_test.rb
+- test/test_helper.rb
+- lib/locapoint
+- lib/locapoint.rb
+- lib/locapoint/locapoint.rb
+- lib/locapoint/version.rb
+- examples/example.rb
+test_files: []
+
+rdoc_options: 
+- --quiet
+- --title
+- locapoint documentation
+- --opname
+- index.html
+- --line-numbers
+- --main
+- README
+- --inline-source
+- --exclude
+- ^(examples|extras)/
+extra_rdoc_files: 
+- README
+- CHANGELOG
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+