arxiv 0.0.1

data/.gitignore

@@ -0,0 +1,10 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+
+# Textmate
+tmtags
+
+# Mac OSX hidden files
+.DS_Store

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.rvmrc

@@ -0,0 +1 @@
+rvm use ruby-1.9.2-p290@arxiv --create

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in arxiv.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,3 @@
+= arXiv
+
+Not quite ready for production.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/arxiv.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "arxiv/version"
+
+Gem::Specification.new do |s|
+  s.name        = "arxiv"
+  s.version     = Arxiv::VERSION
+  s.authors     = ["Cory Schires", "Brian Cody", "Robert Walsh"]
+  s.email       = ["coryschires@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{Ruby wrapper accessing the arXiv API}
+  s.description = %q{Makes interacting with arXiv data really easy.}
+
+  s.rubyforge_project = "arxiv"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_runtime_dependency "happymapper"
+  s.add_runtime_dependency "nokogiri"
+
+  s.add_development_dependency "rspec"
+
+end

data/lib/arxiv.rb

@@ -0,0 +1,109 @@
+require 'arxiv/version'
+require 'open-uri'
+require 'nokogiri'
+require 'happymapper'
+
+module Arxiv
+
+  def self.get(id)
+    url = ::URI.parse("http://export.arxiv.org/api/query?id_list=#{id}")
+    response = ::Nokogiri::XML(open(url)).remove_namespaces!
+    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/version.rb

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

data/spec/arxiv_spec.rb

@@ -0,0 +1,102 @@
+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

data/spec/spec_helper.rb

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

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: arxiv
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Cory Schires
+- Brian Cody
+- Robert Walsh
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-14 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: happymapper
+  requirement: &2152849100 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2152849100
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &2152848680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2152848680
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2152848260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2152848260
+description: Makes interacting with arXiv data really easy.
+email:
+- coryschires@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- README.rdoc
+- Rakefile
+- arxiv.gemspec
+- lib/arxiv.rb
+- lib/arxiv/version.rb
+- spec/arxiv_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses: []
+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.10
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper accessing the arXiv API
+test_files:
+- spec/arxiv_spec.rb
+- spec/spec_helper.rb