arxiv 0.0.1 → 0.0.2

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 YOURNAME
+
+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

@@ -1,3 +1,42 @@
-= arXiv
+http://docs.scholastica.s3.amazonaws.com/scholastica_logo.png
 
-Not quite ready for production.
+A Ruby wrapper for the {arXiv API}[http://arxiv.org/help/api/index]. ArXiv is an open access pre-print server used primarily in physics, mathematics, computer science, quantitative biology, quantitative finance and statistics.
+
+<i>This is not a complete wrapper around the arXiv API. We'll be making improvements as needed for our overlay journals. If you'd like something added, send us a note or make a pull request.</i>
+
+== Fetching a manuscript
+Grab a manuscript using the arXiv document id:
+
+  manuscript = Arxiv.get('1202.0819')
+
+And inspect it:
+
+  manuscript.revision?  # => false
+  manuscript.title      # => "Laser frequency comb techniques for precise astronomical spectroscopy"
+  manuscript.abstract   # => "Precise astronomical spectroscopic analyses routinely assume..."
+  manuscript.arxiv_id   # => "1202.0819"
+  manuscript.version    # => 1
+  manuscript.pdf_url    # => "http://arxiv.org/pdf/1202.0819v1"
+
+== Authors
+Look up a manuscript's authors:
+
+  authors = manuscript.authors  # => an array of all the manuscript's authors
+  authors.map(&:name)   # => ["Michael T. Murphy", "Clayton R. Locke", "Philip S. Light", "Andre N. Luiten", "Jon S. Lawrence"]
+
+  # a single author
+  authors.last.name           # => "Jon S. Lawrence"
+  authors.last.affiliations   # => ["Australian Astronomical Observatory", "Macquarie University"]
+
+== Categories
+Look at a manuscript's categories:
+
+  manuscript.categories                       # => an array of categories
+  manuscript.categories.map(&:abbreviation)   # => ["astro-ph.IM", "astro-ph.CO", "astro-ph.EP"]
+
+  # a single category
+  manuscript.primary_category.name          # => "astro-ph.IM"
+  manuscript.primary_category.description   # => "Physics - Instrumentation and Methods for Astrophysics"
+
+== License
+This project uses MIT-LICENSE.

data/lib/arxiv.rb

@@ -1,8 +1,15 @@
-require 'arxiv/version'
 require 'open-uri'
 require 'nokogiri'
 require 'happymapper'
 
+require 'arxiv/version'
+require 'arxiv/string_scrubber'
+
+require 'arxiv/models/author'
+require 'arxiv/models/link'
+require 'arxiv/models/category'
+require 'arxiv/models/manuscript'
+
 module Arxiv
 
   def self.get(id)
@@ -11,99 +18,4 @@ module Arxiv
     manuscript = Arxiv::Manuscript.parse(response.to_s, single: id)
   end
 
-  class StringScrubber
-    def self.scrub(string)
-      string.gsub("\n", ' ').strip.squeeze(" ")
-    end
-  end
-
-  class Author
-    include HappyMapper
-    element :name, StringScrubber, parser: :scrub
-    has_many :affiliations, StringScrubber, parser: :scrub, tag: 'affiliation'
-  end
-
-  class Link
-    include HappyMapper
-    attribute :url, String, tag: 'href'
-    attribute :content_type, String, tag: 'type'
-  end
-
-  class Category
-    include HappyMapper
-
-    def self.types
-      url = ::URI.parse("http://arxiv-api.googlegroups.com/attach/5e540c5aa16cd1a1/servicedocument.xml?gda=GkSq-0UAAACv8MuSQ9shr-Fm8egpLVNUyoJFgZHB152DBrQX4ANeXa_N1TJg9KB-8oF-EwbRpI6O3f1cykW9hbJ1ju6H3kglGu1iLHeqhw4ZZRj3RjJ_-A&view=1&part=2")
-      xml = ::Nokogiri::XML(open(url)).remove_namespaces!
-      category_mapping = {}
-      categories = xml.xpath("/service/workspace/collection/categories/category")
-      categories.each do |category|
-        abbreviation = category.attributes["term"].value.match(/[^\/]+$/)[0]
-        description = category.attributes["label"].value
-        category_mapping.merge!(abbreviation => description)
-      end
-      category_mapping
-    end
-
-    Types = Category.types
-
-    attribute :abbreviation, String, tag: 'term'
-
-    def description
-      Types[abbreviation]
-    end
-
-    def long_description
-      "#{abbreviation} (#{description})"
-    end
-
-  end
-
-  class Manuscript
-    include HappyMapper
-
-    tag 'entry'
-    element :arxiv_url, String, tag: 'id'
-    element :created_at, DateTime, tag: 'published'
-    element :updated_at, DateTime, tag: 'published'
-    element :title, StringScrubber, parser: :scrub
-    element :summary, StringScrubber, parser: :scrub
-    element :comment, StringScrubber, parser: :scrub
-    has_one :primary_category, Category
-    has_many :categories, Category
-    has_many :authors, Author
-    has_many :links, Link
-
-    alias :abstract :summary
-
-    def revision?
-      created_at != updated_at
-    end
-
-    def arxiv_id
-      arxiv_url.match(/([^\/]+)v\d+$/)[1]
-    end
-
-    def arxiv_versioned_id
-      arxiv_url.match(/([^\/]+)$/)[1]
-    end
-
-    def version
-      arxiv_url.match(/v(\d+)$/)[1].to_i
-    end
-
-    def content_types
-      links.map(&:content_type)
-    end
-
-    def available_in_pdf?
-      content_types.any? { |type| type == "application/pdf" }
-    end
-
-    def pdf_url
-      links.find { |l| l.content_type == "application/pdf" }.url if available_in_pdf?
-    end
-
-  end
-
 end

data/lib/arxiv/models/author.rb

@@ -0,0 +1,7 @@
+module Arxiv
+  class Author
+    include HappyMapper
+    element :name, StringScrubber, parser: :scrub
+    has_many :affiliations, StringScrubber, parser: :scrub, tag: 'affiliation'
+  end
+end

data/lib/arxiv/models/category.rb

@@ -0,0 +1,31 @@
+module Arxiv
+  class Category
+    include HappyMapper
+
+    def self.types
+      url = ::URI.parse("http://arxiv-api.googlegroups.com/attach/5e540c5aa16cd1a1/servicedocument.xml?gda=GkSq-0UAAACv8MuSQ9shr-Fm8egpLVNUyoJFgZHB152DBrQX4ANeXa_N1TJg9KB-8oF-EwbRpI6O3f1cykW9hbJ1ju6H3kglGu1iLHeqhw4ZZRj3RjJ_-A&view=1&part=2")
+      xml = ::Nokogiri::XML(open(url)).remove_namespaces!
+      category_mapping = {}
+      categories = xml.xpath("/service/workspace/collection/categories/category")
+      categories.each do |category|
+        abbreviation = category.attributes["term"].value.match(/[^\/]+$/)[0]
+        description = category.attributes["label"].value
+        category_mapping.merge!(abbreviation => description)
+      end
+      category_mapping
+    end
+
+    Types = Category.types
+
+    attribute :abbreviation, String, tag: 'term'
+
+    def description
+      Types[abbreviation]
+    end
+
+    def long_description
+      "#{abbreviation} (#{description})"
+    end
+
+  end
+end

data/lib/arxiv/models/link.rb

@@ -0,0 +1,7 @@
+module Arxiv
+  class Link
+    include HappyMapper
+    attribute :url, String, tag: 'href'
+    attribute :content_type, String, tag: 'type'
+  end
+end

data/lib/arxiv/models/manuscript.rb

@@ -0,0 +1,48 @@
+module Arxiv
+  class Manuscript
+    include HappyMapper
+
+    tag 'entry'
+    element :arxiv_url, String, tag: 'id'
+    element :created_at, DateTime, tag: 'published'
+    element :updated_at, DateTime, tag: 'published'
+    element :title, StringScrubber, parser: :scrub
+    element :summary, StringScrubber, parser: :scrub
+    element :comment, StringScrubber, parser: :scrub
+    has_one :primary_category, Category
+    has_many :categories, Category
+    has_many :authors, Author
+    has_many :links, Link
+
+    alias :abstract :summary
+
+    def revision?
+      created_at != updated_at
+    end
+
+    def arxiv_id
+      arxiv_url.match(/([^\/]+)v\d+$/)[1]
+    end
+
+    def arxiv_versioned_id
+      arxiv_url.match(/([^\/]+)$/)[1]
+    end
+
+    def version
+      arxiv_url.match(/v(\d+)$/)[1].to_i
+    end
+
+    def content_types
+      links.map(&:content_type)
+    end
+
+    def available_in_pdf?
+      content_types.any? { |type| type == "application/pdf" }
+    end
+
+    def pdf_url
+      links.find { |l| l.content_type == "application/pdf" }.url if available_in_pdf?
+    end
+
+  end
+end

data/lib/arxiv/string_scrubber.rb

@@ -0,0 +1,7 @@
+module Arxiv
+  class StringScrubber
+    def self.scrub(string)
+      string.gsub("\n", ' ').strip.squeeze(" ")
+    end
+  end
+end

data/lib/arxiv/version.rb

@@ -1,3 +1,3 @@
 module Arxiv
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/spec/arxiv/models/author_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+module Arxiv
+  describe Author do
+    before(:all) { @author = Arxiv.get('1202.0819').authors.first }
+
+    describe "name" do
+      it "should return the author's name" do
+        @author.name.should == "Michael T. Murphy"
+      end
+    end
+
+    describe "affiliations" do
+      it "should return an array of the author's affiliations" do
+        @author.affiliations.should include("Swinburne University of Technology")
+      end
+    end
+
+  end
+end

data/spec/arxiv/models/category_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+module Arxiv
+  describe Category do
+    before(:all) { @category = Arxiv.get('1202.0819').primary_category }
+
+    describe "abbreviation" do
+      it "should fetch the category's abbreviation" do
+        @category.abbreviation.should == "astro-ph.IM"
+      end
+    end
+
+    describe "description" do
+      it "should fetch the category's description" do
+        @category.description.should == "Physics - Instrumentation and Methods for Astrophysics"
+      end
+    end
+
+    describe "long_description" do
+      it "should fetch the category's #long_description" do
+        @category.long_description.should == "astro-ph.IM (Physics - Instrumentation and Methods for Astrophysics)"
+      end
+    end
+
+  end
+end

data/spec/arxiv/models/link_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+module Arxiv
+  describe Link do
+    before(:all) { @link = Arxiv.get('1202.0819').links.last }
+
+    describe "content_type" do
+      it "should fetch the link's content type" do
+        @link.content_type.should == 'application/pdf'
+      end
+    end
+
+    describe "url" do
+      it "should fetch the link's url" do
+        @link.url.should == 'http://arxiv.org/pdf/1202.0819v1'
+      end
+    end
+
+  end
+end

data/spec/arxiv/models/manuscript_spec.rb

@@ -0,0 +1,105 @@
+require 'spec_helper'
+
+module Arxiv
+  describe Manuscript do
+    before(:all) { @manuscript = Arxiv.get('1202.0819') }
+
+    describe "arxiv_url" do
+      it "should fetch the link to the manuscript's page on arXiv" do
+        @manuscript.arxiv_url.should == "http://arxiv.org/abs/1202.0819v1"
+      end
+    end
+
+    describe "created_at" do
+      it "should fetch the datetime when the manuscript was first published to arXiv" do
+        @manuscript.created_at.should == DateTime.parse("2012-02-03T21:00:00Z")
+      end
+    end
+
+    describe "updated_at" do
+      it "should fetch the datetime when the manuscript was last updated" do
+        @manuscript.updated_at.should == DateTime.parse("2012-02-03T21:00:00Z")
+      end
+    end
+
+    describe "title" do
+      it "should fetch the manuscript's title" do
+        @manuscript.title.should == "Laser frequency comb techniques for precise astronomical spectroscopy"
+      end
+    end
+
+    describe "abstract" do
+      it "should fetch the manuscript's abstract" do
+        @manuscript.abstract.should == "Precise astronomical spectroscopic analyses routinely assume that individual pixels in charge-coupled devices (CCDs) have uniform sensitivity to photons. Intra-pixel sensitivity (IPS) variations may already cause small systematic errors in, for example, studies of extra-solar planets via stellar radial velocities and cosmological variability in fundamental constants via quasar spectroscopy, but future experiments requiring velocity precisions approaching ~1 cm/s will be more strongly affected. Laser frequency combs have been shown to provide highly precise wavelength calibration for astronomical spectrographs, but here we show that they can also be used to measure IPS variations in astronomical CCDs in situ. We successfully tested a laser frequency comb system on the Ultra-High Resolution Facility spectrograph at the Anglo-Australian Telescope. By modelling the 2-dimensional comb signal recorded in a single CCD exposure, we find that the average IPS deviates by <8 per cent if it is assumed to vary symmetrically about the pixel centre. We also demonstrate that series of comb exposures with absolutely known offsets between them can yield tighter constraints on symmetric IPS variations from ~100 pixels. We discuss measurement of asymmetric IPS variations and absolute wavelength calibration of astronomical spectrographs and CCDs using frequency combs."
+      end
+    end
+
+    describe "comment" do
+      it "should fetch the manuscript's comment" do
+        @manuscript.comment.should == "11 pages, 7 figures. Accepted for publication in MNRAS"
+      end
+    end
+
+    describe "revision?" do
+      it "should return true if the manuscript has been revised" do
+        @manuscript.should_not be_revision
+      end
+    end
+
+    describe "arxiv_versioned_id" do
+      it "should return the unique document id used by arXiv" do
+        @manuscript.arxiv_versioned_id.should == '1202.0819v1'
+      end
+    end
+
+    describe "arxiv_id" do
+      it "should return the unique document id used by arXiv" do
+        @manuscript.arxiv_id.should == '1202.0819'
+      end
+    end
+
+    describe "version" do
+      it "should return the manuscript's version number" do
+        @manuscript.version.should == 1
+      end
+    end
+
+    describe "content_types" do
+      it "return an array of available content_types" do
+        @manuscript.content_types.should include("text/html", "application/pdf")
+        @manuscript.content_types.should have(2).content_types
+      end
+    end
+
+    describe "available_in_pdf?" do
+      it "should return true if the manuscript is available to be downloaded in PDF" do
+        @manuscript.should be_available_in_pdf
+      end
+    end
+
+    describe "pdf_url" do
+      it "should return the url to download the manuscript in PDF format" do
+        @manuscript.pdf_url.should == 'http://arxiv.org/pdf/1202.0819v1'
+      end
+    end
+
+    describe "authors" do
+      it "should return an array of all the manuscript's authors" do
+        @manuscript.authors.should have(5).authors
+      end
+    end
+
+    describe "categories" do
+      it "should fetch the manuscript's categories" do
+        @manuscript.categories.map(&:abbreviation).should include("astro-ph.IM", "astro-ph.CO", "astro-ph.EP")
+      end
+    end
+
+    describe "primary_category" do
+      it "should description" do
+        @manuscript.primary_category.abbreviation.should == "astro-ph.IM"
+      end
+    end
+
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: arxiv
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -15,7 +15,7 @@ date: 2012-02-14 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: happymapper
-  requirement: &2152849100 !ruby/object:Gem::Requirement
+  requirement: &2153612280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -23,10 +23,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2152849100
+  version_requirements: *2153612280
 - !ruby/object:Gem::Dependency
   name: nokogiri
-  requirement: &2152848680 !ruby/object:Gem::Requirement
+  requirement: &2153611860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -34,10 +34,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2152848680
+  version_requirements: *2153611860
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2152848260 !ruby/object:Gem::Requirement
+  requirement: &2153611440 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -45,7 +45,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2152848260
+  version_requirements: *2153611440
 description: Makes interacting with arXiv data really easy.
 email:
 - coryschires@gmail.com
@@ -57,12 +57,21 @@ files:
 - .rspec
 - .rvmrc
 - Gemfile
+- MIT-LICENSE
 - README.rdoc
 - Rakefile
 - arxiv.gemspec
 - lib/arxiv.rb
+- lib/arxiv/models/author.rb
+- lib/arxiv/models/category.rb
+- lib/arxiv/models/link.rb
+- lib/arxiv/models/manuscript.rb
+- lib/arxiv/string_scrubber.rb
 - lib/arxiv/version.rb
-- spec/arxiv_spec.rb
+- spec/arxiv/models/author_spec.rb
+- spec/arxiv/models/category_spec.rb
+- spec/arxiv/models/link_spec.rb
+- spec/arxiv/models/manuscript_spec.rb
 - spec/spec_helper.rb
 homepage: ''
 licenses: []
@@ -89,5 +98,8 @@ signing_key:
 specification_version: 3
 summary: Ruby wrapper accessing the arXiv API
 test_files:
-- spec/arxiv_spec.rb
+- spec/arxiv/models/author_spec.rb
+- spec/arxiv/models/category_spec.rb
+- spec/arxiv/models/link_spec.rb
+- spec/arxiv/models/manuscript_spec.rb
 - spec/spec_helper.rb

data/spec/arxiv_spec.rb

@@ -1,102 +0,0 @@
-require 'spec_helper'
-
-describe Arxiv do
-  before :all do
-    @manuscript = Arxiv.get('1202.0819') # export.arxiv.org/api/query?id_list=1202.0819
-  end
-
-  it "should fetch the link to the manuscript's page on arXiv" do
-    @manuscript.arxiv_url.should == "http://arxiv.org/abs/1202.0819v1"
-  end
-  it "should fetch the datetime when the manuscript was first published to arXiv" do
-    @manuscript.created_at.should == DateTime.parse("2012-02-03T21:00:00Z")
-  end
-  it "should fetch the datetime when the manuscript was last updated" do
-    @manuscript.updated_at.should == DateTime.parse("2012-02-03T21:00:00Z")
-  end
-  it "should fetch the manuscript's title" do
-    @manuscript.title.should == "Laser frequency comb techniques for precise astronomical spectroscopy"
-  end
-  it "should fetch the manuscript's abstract" do
-    @manuscript.abstract.should == "Precise astronomical spectroscopic analyses routinely assume that individual pixels in charge-coupled devices (CCDs) have uniform sensitivity to photons. Intra-pixel sensitivity (IPS) variations may already cause small systematic errors in, for example, studies of extra-solar planets via stellar radial velocities and cosmological variability in fundamental constants via quasar spectroscopy, but future experiments requiring velocity precisions approaching ~1 cm/s will be more strongly affected. Laser frequency combs have been shown to provide highly precise wavelength calibration for astronomical spectrographs, but here we show that they can also be used to measure IPS variations in astronomical CCDs in situ. We successfully tested a laser frequency comb system on the Ultra-High Resolution Facility spectrograph at the Anglo-Australian Telescope. By modelling the 2-dimensional comb signal recorded in a single CCD exposure, we find that the average IPS deviates by <8 per cent if it is assumed to vary symmetrically about the pixel centre. We also demonstrate that series of comb exposures with absolutely known offsets between them can yield tighter constraints on symmetric IPS variations from ~100 pixels. We discuss measurement of asymmetric IPS variations and absolute wavelength calibration of astronomical spectrographs and CCDs using frequency combs."
-  end
-  it "should fetch the manuscript's comment" do
-    @manuscript.comment.should == "11 pages, 7 figures. Accepted for publication in MNRAS"
-  end
-
-  context "authors" do
-    it "should fetch the authors" do
-      @manuscript.authors.should have(5).authors
-    end
-    it "should fetch the author's affiliations" do
-      author = @manuscript.authors.first
-      author.affiliations.should include("Swinburne University of Technology")
-    end
-  end
-
-  context "categories" do
-    it "should fetch the manuscript's categories" do
-      @manuscript.categories.map(&:abbreviation).should include("astro-ph.IM", "astro-ph.CO", "astro-ph.EP")
-    end
-    it "should fetch the category's abbreviation" do
-      @manuscript.primary_category.abbreviation.should == "astro-ph.IM"
-    end
-    it "should fetch the category's description" do
-      @manuscript.primary_category.description.should == "Physics - Instrumentation and Methods for Astrophysics"
-    end
-    it "should fetch the category's #long_description" do
-      @manuscript.primary_category.long_description.should == "astro-ph.IM (Physics - Instrumentation and Methods for Astrophysics)"
-    end
-
-  end
-
-  context "links" do
-    let(:pdf) {@manuscript.links.last}
-    it "should fetch the link's content type" do
-      pdf.content_type.should == 'application/pdf'
-    end
-    it "should fetch the link's url" do
-      pdf.url.should == 'http://arxiv.org/pdf/1202.0819v1'
-    end
-  end
-
-  context "instance methods" do
-    describe "revision?" do
-      it "should return true if the manuscript has been revised" do
-        @manuscript.should_not be_revision
-      end
-    end
-    describe "arxiv_versioned_id" do
-      it "should return the unique document id used by arXiv" do
-        @manuscript.arxiv_versioned_id.should == '1202.0819v1'
-      end
-    end
-    describe "arxiv_id" do
-      it "should return the unique document id used by arXiv" do
-        @manuscript.arxiv_id.should == '1202.0819'
-      end
-    end
-    describe "version" do
-      it "should return the manuscript's version number" do
-        @manuscript.version.should == 1
-      end
-    end
-    describe "content_types" do
-      it "return an array of available content_types" do
-        @manuscript.content_types.should include("text/html", "application/pdf")
-        @manuscript.content_types.should have(2).content_types
-      end
-    end
-    describe "available_in_pdf?" do
-      it "should return true if the manuscript is available to be downloaded in PDF" do
-        @manuscript.should be_available_in_pdf
-      end
-    end
-    describe "pdf_url" do
-      it "should return the url to download the manuscript in PDF format" do
-        @manuscript.pdf_url.should == 'http://arxiv.org/pdf/1202.0819v1'
-      end
-    end
-  end
-
-end