science 0.0.1a → 0.0.1b

data/Gemfile.lock

@@ -1,12 +1,17 @@
 PATH
   remote: .
   specs:
-    science (0.2.0)
+    science (0.0.1a)
+      savon (~> 2.1.0)
       version (~> 1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    akami (1.2.0)
+      gyoku (>= 0.4.0)
+      nokogiri (>= 1.4.0)
+    builder (3.2.0)
     coderay (1.0.8)
     diff-lcs (1.1.3)
     fuubar (1.1.0)
@@ -25,13 +30,20 @@ GEM
     guard-yard (2.0.1)
       guard (>= 1.1.0)
       yard (>= 0.7.0)
+    gyoku (1.0.0)
+      builder (>= 2.1.2)
+    httpi (2.0.2)
+      rack
     listen (0.6.0)
     lumberjack (1.0.2)
     method_source (0.8.1)
+    nokogiri (1.5.6)
+    nori (2.0.3)
     pry (0.9.10)
       coderay (~> 1.0.5)
       method_source (~> 0.8)
       slop (~> 3.3.1)
+    rack (1.5.2)
     rb-fsevent (0.9.2)
     redcarpet (2.2.2)
     rspec (2.12.0)
@@ -44,9 +56,20 @@ GEM
     rspec-instafail (0.2.4)
     rspec-mocks (2.12.0)
     ruby-progressbar (1.0.2)
+    savon (2.1.0)
+      akami (~> 1.2.0)
+      builder (>= 2.1.2)
+      gyoku (~> 1.0.0)
+      httpi (~> 2.0.2)
+      nokogiri (>= 1.4.0)
+      nori (~> 2.0.3)
+      wasabi (~> 3.0.0)
     slop (3.3.3)
     thor (0.16.0)
     version (1.0.0)
+    wasabi (3.0.0)
+      httpi (~> 2.0)
+      nokogiri (>= 1.4.0)
     yard (0.8.3)
 
 PLATFORMS

data/README.md

@@ -14,6 +14,14 @@ Science, as homosapiens understand it, written in Ruby.
 
 ## Usage
 
+## TODO
+
+* Alot. I mean, a *whole* lot. see the `Contributing` section below to help!
+* Each and every module may have different dependencies.
+  Because of this, each module must be abstracted to it's own gem.  
+  For example, the `Science::PhysicalGeography::Elevation` module will be abstracted to the
+  `science-physical_geography-elevation` gem, which will then become a dependency of this gem.
+
 ## Contributing
 
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
@@ -22,7 +30,7 @@ Science, as homosapiens understand it, written in Ruby.
 * Start a feature/bugfix branch
 * Commit and push until you are happy with your contribution
 * Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+* Please try not to mess with the Rakefile or VERSION.
 
 ## Copyright
 

data/Rakefile

@@ -20,7 +20,13 @@ spec = Gem::Specification.new do |s|
   s.description = 'Knowledge.'
   
   # Dependencies
+  
+  # science
   s.add_dependency 'version', '~> 1.0'
+  
+  # science-physical_geography-elevation
+  s.add_dependency 'savon', '~> 2.1.0'
+  
   s.add_development_dependency 'guard-rspec', '~> 2.1'
   s.add_development_dependency 'guard-yard', '~> 2.0'
   s.add_development_dependency 'rb-fsevent', '~> 0.9'

data/VERSION

@@ -1 +1 @@
-0.0.1a
+0.0.1b

data/examples/science/physical_geography/earth/elevation.rb

@@ -0,0 +1,16 @@
+require 'bundler/setup'
+require 'science/physical_geography/earth/elevation'
+
+include Science::PhysicalGeography::Earth
+
+locations = {
+  house: { latitude: 42.72664, longitude: -73.68996 },
+  park: { latitude: 42.72423, longitude: -73.68501 }
+}
+
+locations[:house][:elevation] = Elevation.usgs( locations[:house].merge(log: false) )
+locations[:park][:elevation] =  Elevation.usgs( locations[:park].merge(log: false) )
+
+require 'pp'
+
+pp locations

data/lib/science.rb

@@ -1,3 +1,6 @@
+require 'science/helpers'
+require 'logger'
+
 module Science
 	
 	# Modules:
@@ -15,7 +18,7 @@ module Science
 	
 	# Cosmology, ExtragalacticAstronomy, GalacticAstronomy, PlanetaryAstronomy, StellarAstronomy, SolarAstronomy
 	
-	# Meteorology, Climatology, Ecology, Environmental, Geodesy, Geology, Geomorphology, Geophysics, Glaciology, Hydrology, 
+	# Meteorology, Climatology, Ecology, Environmental, Geodesy, Geology, Geomorphology, GeoPhysics, Glaciology, Hydrology, 
 	# Limnology, Oceanography, Paleoclimatology, Paleoecology, Palynology, Geography, Pedology, Edaphology
 	
 	# Anatomy, AstroBiology, BioGeography, BehavioralNeuroscience, BotanyCellBiology, ConservationBiology, CryoBiology
@@ -36,4 +39,8 @@ module Science
 	# ArtificialIntelligence, Bioethics, Bioinformatics, Biostatistics, CognitiveScience, Cultural, Cybernetics
 	# Ethnics, EvolutionaryPsychology, Forestry, Military, Semiotics
 	
+  def self.logger
+    @@logger ||= Logger.new(STDOUT)
+  end
+  
 end

data/lib/science/helpers.rb

@@ -0,0 +1,34 @@
+module Science
+  
+  # General helpers for the internals of this gem.
+  # In time, most of these should be abstracted to gems.
+  module Helpers
+    
+    # TODO: Abstract to `convertable` and `error` gems.
+    def validate_and_convert_hash(name, object)
+      raise TypeError, "`#{name}` should be a Hash or respond to :to_hash or :to_h" unless object.is_a?(Hash) || object.respond_to?(:to_hash) || object.respond_to?(:to_h)
+      object = object.to_hash rescue object.to_h unless object.is_a?(Hash)
+      
+      object
+    end
+    
+    # TODO: Abstract to `convertable` and `error` gems.
+    def validate_and_convert_float(name, object)
+      raise TypeError, "`#{name}` should be a Float or respond to :to_f" unless object.is_a?(Float) || object.respond_to?(:to_f)
+      object = object.to_f unless object.is_a?(Float)
+      
+      object
+    end
+    
+    # TODO: Abstract to `convertable` gem
+    def validate_hash_keys(name, hash, *keys)
+      keys.each do |key|
+        raise "`#{name}` requires key #{key.inspect}" unless hash.has_key?(key)
+      end
+    end
+    
+    extend self
+    
+  end
+  
+end

data/lib/science/physical_geography.rb

@@ -0,0 +1,9 @@
+module Science
+  
+  # Physical geography is one of the two major subfields of geography which deals with the study of processes
+  # and patterns in the natural environment like the atmosphere, hydrosphere, biosphere, and geosphere.
+  module PhysicalGeography
+    
+  end
+  
+end

data/lib/science/physical_geography/earth.rb

@@ -0,0 +1,14 @@
+module Science
+  module PhysicalGeography
+    
+    # This contains data about the physical geography on the planet Earth.
+    module Earth
+      
+      def continents
+      
+      end
+      
+    end
+    
+  end
+end

data/lib/science/physical_geography/earth/elevation.rb

@@ -0,0 +1,39 @@
+require 'science'
+require 'savon'
+
+module Science
+  module PhysicalGeography
+    module Earth
+      
+      # Access elevation data from various sources
+      module Elevation
+        
+        USGS_API_URL = 'http://gisdata.usgs.gov/xmlwebservices2/elevation_service.asmx?WSDL'
+        
+        # Retrieve the elevation at a specific latitude and longitude through the
+        # United States Geological Survey (USGS) Elevation Service API.
+        def usgs(options={})
+          options = Science::Helpers.validate_and_convert_hash('options', options)
+          Science::Helpers.validate_hash_keys('options', options, :latitude, :longitude)
+          latitude  = Science::Helpers.validate_and_convert_float( 'options[:latitude]', options.delete(:latitude) )
+          longitude = Science::Helpers.validate_and_convert_float( 'options[:longitude]', options.delete(:longitude) )
+          
+          options.merge!(wsdl: USGS_API_URL)
+          
+          client = Savon.client(options)
+          message = { 'Y_Value' => latitude, 'X_Value' => longitude } # Note that USGS seems to have X and Y backwards: X should be latitude and Y should be longitude.
+          
+          response = client.call(:get_elevation, message: message)
+          response_message = response.body[:get_elevation_response][:get_elevation_result][:usgs_elevation_web_service_query][:elevation_query]
+          
+          response_message[:elevation].to_f # TODO: Use a unit library to say this is measured in feet.
+        end
+    
+        extend self
+        
+      end
+      
+    end
+    
+  end
+end

data/science.gemspec

@@ -2,14 +2,14 @@
 
 Gem::Specification.new do |s|
   s.name = "science"
-  s.version = "0.0.1a"
+  s.version = "0.0.1b"
 
   s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
   s.authors = ["Ryan Scott Lewis"]
-  s.date = "2013-02-23"
+  s.date = "2013-02-25"
   s.description = "Knowledge."
   s.email = "ryan@rynet.us"
-  s.files = [".gitignore", ".rvmrc", "Gemfile", "Gemfile.lock", "Guardfile", "LICENSE", "README.md", "Rakefile", "VERSION", "lib/science.rb", "spec/science_spec.rb", "spec/spec_helper.rb"]
+  s.files = [".gitignore", ".rvmrc", "Gemfile", "Gemfile.lock", "Guardfile", "LICENSE", "README.md", "Rakefile", "VERSION", "examples/science/physical_geography/earth/elevation.rb", "lib/science.rb", "lib/science/helpers.rb", "lib/science/physical_geography.rb", "lib/science/physical_geography/earth.rb", "lib/science/physical_geography/earth/elevation.rb", "science.gemspec", "spec/science_spec.rb", "spec/spec_helper.rb"]
   s.homepage = "http://github.com/RyanScottLewis/science"
   s.require_paths = ["lib"]
   s.rubygems_version = "1.8.25"
@@ -20,6 +20,7 @@ Gem::Specification.new do |s|
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<version>, ["~> 1.0"])
+      s.add_runtime_dependency(%q<savon>, ["~> 2.1.0"])
       s.add_development_dependency(%q<guard-rspec>, ["~> 2.1"])
       s.add_development_dependency(%q<guard-yard>, ["~> 2.0"])
       s.add_development_dependency(%q<rb-fsevent>, ["~> 0.9"])
@@ -28,6 +29,7 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<github-markup>, ["~> 0.7"])
     else
       s.add_dependency(%q<version>, ["~> 1.0"])
+      s.add_dependency(%q<savon>, ["~> 2.1.0"])
       s.add_dependency(%q<guard-rspec>, ["~> 2.1"])
       s.add_dependency(%q<guard-yard>, ["~> 2.0"])
       s.add_dependency(%q<rb-fsevent>, ["~> 0.9"])
@@ -37,6 +39,7 @@ Gem::Specification.new do |s|
     end
   else
     s.add_dependency(%q<version>, ["~> 1.0"])
+    s.add_dependency(%q<savon>, ["~> 2.1.0"])
     s.add_dependency(%q<guard-rspec>, ["~> 2.1"])
     s.add_dependency(%q<guard-yard>, ["~> 2.0"])
     s.add_dependency(%q<rb-fsevent>, ["~> 0.9"])

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: science
 version: !ruby/object:Gem::Version
-  version: 0.0.1a
+  version: 0.0.1b
   prerelease: 5
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-23 00:00:00.000000000 Z
+date: 2013-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: version
@@ -27,6 +27,22 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.1.0
 - !ruby/object:Gem::Dependency
   name: guard-rspec
   requirement: !ruby/object:Gem::Requirement
@@ -138,7 +154,12 @@ files:
 - README.md
 - Rakefile
 - VERSION
+- examples/science/physical_geography/earth/elevation.rb
 - lib/science.rb
+- lib/science/helpers.rb
+- lib/science/physical_geography.rb
+- lib/science/physical_geography/earth.rb
+- lib/science/physical_geography/earth/elevation.rb
 - science.gemspec
 - spec/science_spec.rb
 - spec/spec_helper.rb
@@ -156,7 +177,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1918570815646396757
+      hash: -731604041832293251
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: