times_wire 0.8.0 → 0.9.0

data/README.rdoc

@@ -9,6 +9,7 @@ Times Wire is a Ruby gem for interacting with The New York Times Newswire API (h
 
 == News
 
+* May 3, 2013: Version 0.9.0 released, added Item.url method and tested under 1.9.3.
 * Dec. 16, 2011: Version 0.8.0 released, Item returns DateTime objects instead of Dates.
 * Dec. 15, 2011: Version 0.7.0 released, adding support for retrieving list of sections.
 * Dec. 14, 2011: Version 0.6.0 released, with support for related URLs and blog name attributes.
@@ -22,15 +23,20 @@ Install Times Wire as a gem:
   
 For use in a Rails 3 application, put the following in your Gemfile:
 
-  gem "times_wire", "~> 0.7.0"
+  gem "times_wire", "~> 0.9.0"
 
-then issue the 'bundle install' command. Times Wire has been tested under Ruby 1.8.7.
+then issue the 'bundle install' command. Times Wire has been tested under Ruby 1.8.7 and 1.9.3.
 
 == Getting Started
 
 You'll need an API Key from The New York Times Developer Network (http://developer.nytimes.com/). You can set your key as an environment variable (handy for running the test suite) or set it within a script or app:
 
   TimesWire::Base.api_key = API_KEY
+
+To retrieve details for a single URL, pass it in:
+
+  @item = Item.url("http://www.nytimes.com/2013/05/04/business/economy/us-adds-165000-jobs-in-april.html")
+  => \#<TimesWire::Item:0x1014b2088 @blog_name=nil, @created_date=\#<DateTime: 212234344421/86400,-1/6,2299161>, @byline="By NELSON D. SCHWARTZ", @org_facets="", @section="Business Day", @kicker="", @updated_date=#<DateTime: 13264647209/5400,-1/6,2299161>, @related_urls=nil, @url="http://www.nytimes.com/2013/05/04/business/economy/us-adds-165000-jobs-in-april.html", @des_facets=["Labor and Jobs", "United States Economy"], @material_type_facet="News", @source="The New York Times", @geo_facets="", @abstract="The economy in April added 165,000 jobs, slightly more than expected, and the Labor Department sharply revised upward its estimates for job creation in the previous two months.", @multimedia=[{"height"=>75, "url"=>"http://graphics8.nytimes.com/images/2013/05/04/business/economy/04jobs/04jobs-thumbStandard.jpg", "subtype"=>"photo", "width"=>75, "format"=>"Standard Thumbnail", "copyright"=>"Spencer Platt/Getty Images", "caption"=>"Job candidates waited to meet with employers at a job and internship fair in New York last week.", "type"=>"image"}], @published_date=#<DateTime: 7369250/3,-1/6,2299161>, @per_facets="", @item_type="Article", @title="Jobs Data Ease Fears of Sharp Slowdown in U.S. Economy", @subheadline="">
   
 Times Wire allows users to retrieve news items by source ('nyt', 'iht' or 'all'), by section (such as 'world', 'u.s.', 'sports') or by NYTimes.com blog names ("The Caucus", "FiveThirtyEight" or "At War", for example). Building a request is easy. To retrieve the latest items from The New York Times:
 

data/lib/times_wire/base.rb

@@ -13,6 +13,7 @@ module TimesWire
   	@@api_key = nil
   	@@debug = false
   	@@copyright = nil
+  	@@semantic_api_key = nil
 
 		# The copyright footer to be placed at the bottom of any data from the New York Times. Note this is only set after an API call.
 		def copyright
@@ -29,6 +30,14 @@ module TimesWire
 			@@api_key
 		end
 		
+		def self.semantic_api_key=(key)
+		  @@semantic_api_key = key
+		end
+		
+		def self.api_key
+		  @@semantic_api_key
+		end
+		
 		def self.datetime_parser(datetime)
 		  datetime ? DateTime.parse(datetime) : nil
 		end

data/lib/times_wire/item.rb

@@ -35,6 +35,12 @@ module TimesWire
                :multimedia => params['multimedia']
     end
     
+    def self.url(url)
+      reply = Base.invoke('', {'url' => url})
+      return nil unless reply['results'].first
+			Item.create_from_api(reply['results'].first)
+    end
+    
     def self.latest(source="nyt", limit=20)
 		  reply = Base.invoke("#{source}/all", {"limit" => limit})
 			results = reply['results']
@@ -53,5 +59,10 @@ module TimesWire
 			results = reply['results'].select{|i| i['blog_name'] == blog}
 			@items = results.map {|r| Item.create_from_api(r)}    
     end
+    
+    def semantic_terms
+      
+    end
+    
   end
 end

data/lib/times_wire/version.rb

@@ -1,3 +1,3 @@
 module TimesWire
-  VERSION = "0.8.0"
+  VERSION = "0.9.0"
 end

metadata

@@ -1,47 +1,35 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: times_wire
-version: !ruby/object:Gem::Version 
-  hash: 63
+version: !ruby/object:Gem::Version
+  version: 0.9.0
   prerelease: 
-  segments: 
-  - 0
-  - 8
-  - 0
-  version: 0.8.0
 platform: ruby
-authors: 
+authors:
 - Derek Willis
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-12-16 00:00:00 -05:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2013-05-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: shoulda
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &2152119880 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id001
-description: A Ruby library for parsing stories and blog posts from The New York Times Newswire API
-email: 
+  prerelease: false
+  version_requirements: *2152119880
+description: A Ruby library for parsing stories and blog posts from The New York Times
+  Newswire API
+email:
 - dwillis@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - Gemfile
 - LICENSE
@@ -56,41 +44,31 @@ files:
 - test/times_wire/test_item.rb
 - test/times_wire/test_section.rb
 - times_wire.gemspec
-has_rdoc: true
 homepage: http://rubygems.org/gems/times_wire
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: times_wire
-rubygems_version: 1.6.2
+rubygems_version: 1.8.17
 signing_key: 
 specification_version: 3
 summary: A thin client for The New York Times Newswire API
-test_files: 
+test_files:
 - test/test_helper.rb
 - test/times_wire/test_item.rb
 - test/times_wire/test_section.rb