arxiv 0.0.8 → 0.1.0

data/lib/arxiv/models/author.rb

@@ -4,4 +4,4 @@ module Arxiv
     element :name, StringScrubber, parser: :scrub
     has_many :affiliations, StringScrubber, parser: :scrub, tag: 'affiliation'
   end
-end
+end

data/lib/arxiv/models/category.rb

@@ -2,13 +2,37 @@ module Arxiv
   class Category
     include HappyMapper
 
+    # ArXiv categorizes articles by rather specific subject area using a system
+    # of abbreviated subject codes. For example, "astro-ph.CO" is the code for
+    # "Physics - Cosmology and Extragalactic Astrophysics". As you may expect
+    # there are a lot of codes.
+    #
+    # While terse to the laymen, scientists are apparently very familiar with
+    # the abbreviated codes for their discipline. Nevertheless, all things
+    # considered, it would be better to also offer a more human readable
+    # description.
+    #
+    # ArXiv has an official mapping between abbreviation (astro-ph.CO) and
+    # label (Physics - Cosmology and Extragalactic Astrophysics) but
+    # unfortunately it's not available through their API. Actually, it's an
+    # XML file attached to a Google Groups discussion thread at
+    # http://arxiv-api.googlegroups.com/attach/5e540c5aa16cd1a1/servicedocument.xml?gda=GkSq-0UAAACv8MuSQ9shr-Fm8egpLVNUyoJFgZHB152DBrQX4ANeXa_N1TJg9KB-8oF-EwbRpI6O3f1cykW9hbJ1ju6H3kglGu1iLHeqhw4ZZRj3RjJ_-A&view=1&part=2.
+    #
+    # Relying directly on this attachment has been a problem in the past. As a
+    # result, we decided to store a local copy in this project at
+    # `lib/arxiv/data`. Not ideal but it's our best option until they update
+    # their API.
+    #
+    PATH_TO_CATEGORY_MAPPING_DATA = File.expand_path(File.dirname(__FILE__)) + "/../data/category_abbreviation_to_label_mapping.xml"
+
     @@category_mapping = {}
 
     def self.types
       return @@category_mapping unless @@category_mapping.empty?
 
-      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!
+      file = File.read(PATH_TO_CATEGORY_MAPPING_DATA)
+      xml = ::Nokogiri::XML(file).remove_namespaces!
+
       categories = xml.xpath("/service/workspace/collection/categories/category")
       categories.each do |category|
         abbreviation = category.attributes["term"].value.match(/[^\/]+$/)[0]
@@ -29,4 +53,4 @@ module Arxiv
     end
 
   end
-end
+end

data/lib/arxiv/models/link.rb

@@ -4,4 +4,4 @@ module Arxiv
     attribute :url, String, tag: 'href'
     attribute :content_type, String, tag: 'type'
   end
-end
+end

data/lib/arxiv/models/manuscript.rb

@@ -41,7 +41,7 @@ module Arxiv
     end
 
     def content_types
-      links.map(&:content_type)
+      links.map(&:content_type).compact.delete_if { |t| t =~ /^\s*$/ }
     end
 
     def available_in_pdf?
@@ -56,4 +56,4 @@ module Arxiv
     end
 
   end
-end
+end

data/lib/arxiv/string_scrubber.rb

@@ -4,4 +4,4 @@ module Arxiv
       string.gsub("\n", ' ').strip.squeeze(" ")
     end
   end
-end
+end

data/lib/arxiv/version.rb

@@ -1,3 +1,3 @@
 module Arxiv
-  VERSION = "0.0.8"
+  VERSION = "0.1.0"
 end

data/spec/arxiv/arxiv_spec.rb

@@ -1,7 +1,6 @@
 require 'spec_helper'
 
 module Arxiv
-
   RSpec::Matchers.define :fetch do |expected|
     match do |actual|
       actual.is_a?(Arxiv::Manuscript) && actual.title == expected
@@ -9,40 +8,43 @@ module Arxiv
   end
 
   describe "get" do
-
     context "when using the current arXiv id format" do
       it "should fetch a manuscript when passed an id" do
-        Arxiv.get('1202.0819').should fetch("Laser frequency comb techniques for precise astronomical spectroscopy")
+        expect(Arxiv.get('1202.0819')).to fetch("Laser frequency comb techniques for precise astronomical spectroscopy")
       end
+
       it "should fetch a manuscript when passed a valid id with a version number" do
-        Arxiv.get('1202.0819v1').should fetch("Laser frequency comb techniques for precise astronomical spectroscopy")
+        expect(Arxiv.get('1202.0819v1')).to fetch("Laser frequency comb techniques for precise astronomical spectroscopy")
       end
+
       it "should fetch a manuscript when passed full URL" do
-        Arxiv.get('http://arxiv.org/abs/1202.0819').should fetch("Laser frequency comb techniques for precise astronomical spectroscopy")
+        expect(Arxiv.get('http://arxiv.org/abs/1202.0819')).to fetch("Laser frequency comb techniques for precise astronomical spectroscopy")
       end
     end
 
     context "when using the legacy arXiv id format" do
       it "should fetch a manuscript when passed an id" do
-        Arxiv.get('math.DG/0510097').should fetch("The differential topology of loop spaces")
+        expect(Arxiv.get('math.DG/0510097')).to fetch("The differential topology of loop spaces")
       end
+
       it "should fetch a manuscript when passed a valid id with a version number" do
-        Arxiv.get('math.DG/0510097v1').should fetch("The differential topology of loop spaces")
+        expect(Arxiv.get('math.DG/0510097v1')).to fetch("The differential topology of loop spaces")
       end
+
       it "should fetch a manuscript when passed full URL" do
-        Arxiv.get('http://arxiv.org/abs/math.DG/0510097').should fetch("The differential topology of loop spaces")
+        expect(Arxiv.get('http://arxiv.org/abs/math.DG/0510097')).to fetch("The differential topology of loop spaces")
       end
     end
 
     context "when something goes wrong" do
       it "should raise an error if the manuscript cannot be found on arXiv" do
-        lambda { Arxiv.get('1234.1234') }.should raise_error(Arxiv::Error::ManuscriptNotFound)
+        expect { Arxiv.get('1234.1234') }.to raise_error(Arxiv::Error::ManuscriptNotFound)
       end
+
       it "should raise an error if the manuscript has an incorrectly formatted id" do
-        lambda { Arxiv.get('cond-mat0709123') }.should raise_error(Arxiv::Error::MalformedId)
+        expect { Arxiv.get('cond-mat0709123') }.to raise_error(Arxiv::Error::MalformedId)
       end
     end
 
   end
-
 end

data/spec/arxiv/models/author_spec.rb

@@ -6,15 +6,15 @@ module Arxiv
 
     describe "name" do
       it "should return the author's name" do
-        @author.name.should == "Michael T. Murphy"
+        expect(@author.name).to eql("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")
+        expect(@author.affiliations).to include("Swinburne University of Technology")
       end
     end
 
   end
-end
+end

data/spec/arxiv/models/category_spec.rb

@@ -9,24 +9,25 @@ module Arxiv
 
     describe "abbreviation" do
       it "should fetch the category's abbreviation" do
-        @category.abbreviation.should == "astro-ph.IM"
+        expect(@category.abbreviation).to eql("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"
+        expect(@category.description).to eql("Physics - Instrumentation and Methods for Astrophysics")
       end
     end
 
     describe "long_description" do
       it "should fetch the category's abbreviation and description"do
-        @category.long_description.should == "astro-ph.IM (Physics - Instrumentation and Methods for Astrophysics)"
+        expect(@category.long_description).to eql("astro-ph.IM (Physics - Instrumentation and Methods for Astrophysics)")
       end
-      it "should just return the abbreviation when a description cannot be found (e.g. MSC classes)"do
-        @legacy_category.long_description.should == "58D15 (Primary); 58B10 (Secondary)"
+
+      it "should return only the abbreviation when a description cannot be found (e.g. MSC classes)"do
+        expect(@legacy_category.long_description).to eql("58D15 (Primary); 58B10 (Secondary)")
       end
     end
 
   end
-end
+end

data/spec/arxiv/models/link_spec.rb

@@ -6,15 +6,15 @@ module Arxiv
 
     describe "content_type" do
       it "should fetch the link's content type" do
-        @link.content_type.should == 'application/pdf'
+        expect(@link.content_type).to eql('application/pdf')
       end
     end
 
     describe "url" do
       it "should fetch the link's url" do
-        @link.url.should == 'http://arxiv.org/pdf/1202.0819v1'
+        expect(@link.url).to eql('http://arxiv.org/pdf/1202.0819v1')
       end
     end
 
   end
-end
+end

data/spec/arxiv/models/manuscript_spec.rb

@@ -9,117 +9,121 @@ module Arxiv
 
     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"
+        expect(@manuscript.arxiv_url).to eql("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")
+        expect(@manuscript.created_at).to eql(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")
+        expect(@manuscript.updated_at).to eql(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"
+        expect(@manuscript.title).to eql("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."
+        expect(@manuscript.abstract).to eql("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"
+        expect(@manuscript.comment).to eql("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
+        expect(@manuscript).not_to be_revision
       end
     end
 
     describe "arxiv_versioned_id" do
       it "should return the unique versioned document id used by arXiv for a current manuscript" do
-        @manuscript.arxiv_versioned_id.should == '1202.0819v1'
+        expect(@manuscript.arxiv_versioned_id).to eql('1202.0819v1')
       end
+
       it "should return the unique versioned document id used by arXiv for a legacy manuscript" do
-        @legacy_manuscript.arxiv_versioned_id.should == 'math/0510097v1'
+        expect(@legacy_manuscript.arxiv_versioned_id).to eql('math/0510097v1')
       end
     end
 
     describe "arxiv_id" do
       it "should return the unique document id used by arXiv for a current manuscript" do
-        @manuscript.arxiv_id.should == '1202.0819'
+        expect(@manuscript.arxiv_id).to eql('1202.0819')
       end
+
       it "should return the unique document id used by arXiv for a legacy manuscript" do
-        @legacy_manuscript.arxiv_id.should == 'math/0510097'
+        expect(@legacy_manuscript.arxiv_id).to eql('math/0510097')
       end
     end
 
     describe "version" do
       it "should return the manuscript's version number for a current manuscript" do
-        @manuscript.version.should == 1
+        expect(@manuscript.version).to eql(1)
       end
+
       it "should return the manuscript's version number for a legacy manuscript" do
-        @legacy_manuscript.version.should == 1
+        expect(@legacy_manuscript.version).to eql(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
+        expect(@manuscript.content_types).to match_array(["text/html", "application/pdf"])
       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
+        expect(@manuscript).to 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.pdf'
+        expect(@manuscript.pdf_url).to eql('http://arxiv.org/pdf/1202.0819v1.pdf')
       end
     end
 
     describe "authors" do
       it "should return an array of all the manuscript's authors" do
-        @manuscript.authors.should have(5).authors
+        expect(@manuscript.authors.size).to eql(5)
       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")
+        catagories = @manuscript.categories.map(&:abbreviation)
+        expect(catagories).to include("astro-ph.IM", "astro-ph.CO", "astro-ph.EP")
       end
     end
 
     describe "primary_category" do
-      it "should description return the manuscript's primary category" do
-        @manuscript.primary_category.abbreviation.should == "astro-ph.IM"
+      it "should return the manuscript's primary category" do
+        expect(@manuscript.primary_category.abbreviation).to eql("astro-ph.IM")
       end
     end
 
     describe "legacy_article?" do
       it "should return true if the manuscript was upload while the legacy API was still in use" do
-        @legacy_manuscript.should be_legacy_article
+        expect(@legacy_manuscript).to be_legacy_article
       end
+
       it "should return false if the manuscript was uploaded after the transition to the new API" do
-        @manuscript.should_not be_legacy_article
+        expect(@manuscript).not_to be_legacy_article
       end
     end
   end
-end
+end

data/spec/spec_helper.rb

@@ -1,4 +1,5 @@
 require 'arxiv'
+require 'pry'
 
 RSpec.configure do |config|
   # some (optional) config here

metadata

@@ -1,51 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: arxiv
 version: !ruby/object:Gem::Version
-  version: 0.0.8
-  prerelease: 
+  version: 0.1.0
 platform: ruby
 authors:
-- Cory Schires
-- Brian Cody
-- Robert Walsh
+- Scholastica
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-27 00:00:00.000000000Z
+date: 2015-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: happymapper
-  requirement: &70311509111460 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.1
   type: :runtime
   prerelease: false
-  version_requirements: *70311509111460
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.1
 - !ruby/object:Gem::Dependency
   name: nokogiri
-  requirement: &70311509111040 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.6.2
   type: :runtime
   prerelease: false
-  version_requirements: *70311509111040
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.6.2
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70311506139720 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70311506139720
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Makes interacting with arXiv data really easy.
 email:
 - coryschires@gmail.com
@@ -53,15 +85,18 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rspec
-- .rvmrc
+- ".gitignore"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
 - Gemfile
 - MIT-LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - arxiv.gemspec
+- circle.yml
 - lib/arxiv.rb
+- lib/arxiv/data/category_abbreviation_to_label_mapping.xml
 - lib/arxiv/models/author.rb
 - lib/arxiv/models/category.rb
 - lib/arxiv/models/link.rb
@@ -74,29 +109,29 @@ files:
 - spec/arxiv/models/link_spec.rb
 - spec/arxiv/models/manuscript_spec.rb
 - spec/spec_helper.rb
-homepage: ''
-licenses: []
+homepage: https://github.com/scholastica/arxiv
+licenses:
+- MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: arxiv
-rubygems_version: 1.8.15
+rubygems_version: 2.4.6
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Ruby wrapper accessing the arXiv API
 test_files:
 - spec/arxiv/arxiv_spec.rb