presdocs 0.0.1 → 0.5

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    presdocs (0.0.1)
+    presdocs (0.5)
       json
       oj
 

data/README.md

@@ -2,6 +2,10 @@
 
 The White House releases a lot of stuff, and some of it is included in what's known as the [Compilation of Presidential Documents](http://www.gpo.gov/fdsys/browse/collection.action?collectionCode=CPD). This is a Ruby library for accessing details about those documents, including subjects, dates, locations and more.
 
+Nearly every day, the White House releases one or more official publications, which may include presidential statements, announcements of nominations, press releases and schedule information. These are published by the Government Printing Office. Presdocs wraps JSON endpoints exposed by GPO, which has created a [mobile application](http://m.gpo.gov/dcpd) for browsing and searching these documents. I owe a debt of gratitude to the government employees who made these endpoints available; your commitment to making public information more easily accessible is truly a public service.
+
+The current version is 0.5.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -24,14 +28,18 @@ Or install it yourself as:
     
     @latest_docs = Document.latest
     
-More documentation coming soon. Check the tests, too.
+Please see [the documentation](http://dwillis.github.com/presdocs/) for a more complete description of the library.
 
-## Test
+## Tests
 
-Presdocs uses minitest; to run the tests:
+Presdocs uses minitest and is tested under Ruby 1.9.3; to run the tests:
   
     rake test
 
+## License
+
+Presdocs is licensed under the MIT License. See LICENSE.txt for more details.
+
 ## Contributing
 
 1. Fork it
@@ -39,4 +47,3 @@ Presdocs uses minitest; to run the tests:
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
-

data/lib/presdocs/category.rb

@@ -14,7 +14,7 @@ module Presdocs
       results = Oj.load(open(url).read)
       create_categories(results['navigatorResults']['Category'])
     end
-    
+        
     def self.create_categories(results)
       cats = []
       results.each do |result|

data/lib/presdocs/document.rb

@@ -32,6 +32,57 @@ module Presdocs
       results = Oj.load(open(url).read)
       create_from_search_results(results['searchResults'], results['coordinates'])
     end
+
+    def self.city(city, state)
+      url = "http://m.gpo.gov/wscpd/mobilecpd/location/#{city}/#{state}.json"
+      results = Oj.load(open(url).read)
+      create_from_search_results(results['searchResults'], results['coordinates'])
+    end
+    
+    def self.state(state)
+      url = "http://m.gpo.gov/wscpd/mobilecpd/location/#{state}.json"
+      results = Oj.load(open(url).read)
+      create_from_search_results(results['searchResults'], results['coordinates'])
+    end
+    
+    def self.location_with_distance(lat, lng, distance)
+      url = "http://m.gpo.gov/wscpd/mobilecpd/location/#{lat}/#{lng}/#{distance}.json"
+      results = Oj.load(open(url).read)
+      create_from_search_results(results['searchResults'], results['coordinates'])
+    end
+    
+    def self.date(date)
+      d = process_date(date)
+      url = "http://m.gpo.gov/wscpd/mobilecpd/date/#{d}.json"
+      results = Oj.load(open(url).read)
+      create_from_search_results(results['searchResults'], nil)
+    end
+    
+    def self.date_range(start_date, end_date)
+      s = process_date(start_date)
+      e = process_date(end_date)
+      url = "http://m.gpo.gov/wscpd/mobilecpd/date/#{s}/#{e}.json"
+      results = Oj.load(open(url).read)
+      create_from_search_results(results['searchResults'], nil)
+    end
+    
+    def self.category(category)
+      url = "http://m.gpo.gov/wscpd/mobilecpd/category/#{category}.json"
+      results = Oj.load(open(url).read)
+      create_from_search_results(results['searchResults'], nil)
+    end
+    
+    def self.process_date(date)
+      begin
+        if date.is_a?(Date)
+          d = date.strftime("%-m-%-d-%Y")
+        else
+          d = Date.strptime(date, '%m/%d/%Y').strftime("%-m-%-d-%Y")
+        end
+      rescue
+        raise "Dates must be Ruby Date objects or a Date string such as '2/14/2013'"
+      end
+    end
     
     def self.create_from_search_results(results, coordinates)
       docs = []

data/lib/presdocs/version.rb

@@ -1,3 +1,3 @@
 module Presdocs
-  VERSION = "0.0.1"
+  VERSION = "0.5"
 end

data/test/test_document.rb

@@ -10,6 +10,7 @@ class TestDocument < MiniTest::Unit::TestCase
     @categories = Category.all
     @locations = Document.with_locations
     @doc = Document.detail('DCPD-201300104')
+    @date = Document.date('2/14/2013')
   end
 
   def test_that_there_are_five_latest_docs
@@ -32,5 +33,15 @@ class TestDocument < MiniTest::Unit::TestCase
   def test_that_document_detail_has_an_fdsys_url
     assert_equal "http://www.gpo.gov/fdsys/pkg/DCPD-201300104/html/DCPD-201300104.htm", @doc.fdsys_url
   end
-
+  
+  def test_that_document_date_results_are_from_same_date
+    assert_equal Date.strptime('2/14/2013', '%m/%d/%Y'), @date.map{|d| d.date}.uniq.first
+  end
+  
+  def test_that_date_range_raises_error_for_bad_dates
+    assert_raises RuntimeError do 
+      @range = Document.date_range('2/14/2013', '235')
+    end
+  end
+  
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: presdocs
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: '0.5'
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-24 00:00:00.000000000 Z
+date: 2013-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -124,7 +124,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3717820495547087070
+      hash: -1267846798555734002
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: