arxivarius 0.10.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ae569c1030d082bb94e10a63472ef34aeb89bb9bef56db25c57f68254dc00be8
+  data.tar.gz: f3f664f4a8feb5b7a585166187590018ae68f7e98cd5ae290a85259baab40222
+SHA512:
+  metadata.gz: f218c5e45f1f1305ab9437a205f9c35db5494bc5491af3d6d19c560e025ba452990caff7fb709fcde5e07302fe73ad8ea9e2a6f043831873cdd076c2fd8a8ccf
+  data.tar.gz: 95396dc42e302e54b4e6ae42475bd375ee77d8f49b04ee6383e57dfb0a8d144c2cc1c59cd135ea57c043fa1be8c9fc575c8cf09240dea03179e939097415ca7b

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 antlypls
+
+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.md

@@ -0,0 +1,125 @@
+# ArXivarius
+
+A Ruby gem for fetching paper metadata from the [arXiv](https://arxiv.org/).
+Retrieve titles, abstracts, authors, categories, and links for any paper on arXiv.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'arxivarius'
+```
+
+Or install directly:
+
+```
+gem install arxivarius
+```
+
+## Usage
+
+### Fetching a paper
+
+Pass any arXiv ID to `Arxivarius.get`:
+
+```ruby
+paper = Arxivarius.get('2601.00470')
+```
+
+All common ID formats work:
+
+```ruby
+Arxivarius.get('2601.00470')                        # current format
+Arxivarius.get('2601.00470v1')                      # with version
+Arxivarius.get('hep-th/9901001')                    # legacy format
+Arxivarius.get('math.DG/0510097')                   # legacy with subcategory (auto-normalized)
+Arxivarius.get('https://arxiv.org/abs/2601.00470')  # full URL
+```
+
+### Paper metadata
+
+```ruby
+paper.title       # => "Betelgeuse: Detection of the Expanding Wake of the Companion Star"
+paper.abstract    # => "Recent analyses conclude that Betelgeuse, a red supergiant star..."
+paper.comment     # => "20 pages + 1 appendix, 9 figures, accepted by ApJ"
+paper.arxiv_url   # => "https://arxiv.org/abs/2601.00470v1"
+paper.created_at  # => 2026-01-01 20:56:05 UTC
+paper.updated_at  # => 2026-01-01 20:56:05 UTC
+```
+
+### IDs and versions
+
+```ruby
+paper.arxiv_id            # => "2601.00470"
+paper.arxiv_versioned_id  # => "2601.00470v1"
+paper.version             # => 1
+paper.revision?           # => false (true when the paper has been updated)
+paper.legacy_article?     # => false (true for pre-2007 IDs like hep-th/9901001)
+```
+
+### PDF access
+
+```ruby
+paper.available_in_pdf?  # => true
+paper.pdf_url            # => "https://arxiv.org/pdf/2601.00470v1"
+paper.content_types      # => ["text/html", "application/pdf"]
+```
+
+### Links
+
+Each paper has a list of links with URLs and content types:
+
+```ruby
+paper.links.each do |link|
+  link.url           # => "https://arxiv.org/pdf/2601.00470v1"
+  link.content_type  # => "application/pdf"
+end
+```
+
+### Authors
+
+```ruby
+paper.authors.map(&:name)
+# => ["Andrea K. Dupree", "Paul I. Cristofari", "Morgan MacLeod", "Kateryna Kravchenko"]
+
+author = paper.authors.first
+author.name          # => "Andrea K. Dupree"
+author.first_name    # => "Andrea K."
+author.last_name     # => "Dupree"
+author.affiliations  # => ["Center for Astrophysics | Harvard & Smithsonian, Cambridge, USA"]
+```
+
+### Categories
+
+The gem includes descriptions for all 150+ arXiv categories:
+
+```ruby
+paper.categories.map(&:name)  # => ["astro-ph.SR", "physics.space-ph"]
+
+cat = paper.primary_category
+cat.name              # => "astro-ph.SR"
+cat.description       # => "Solar and Stellar Astrophysics"
+cat.long_description  # => "astro-ph.SR (Solar and Stellar Astrophysics)"
+```
+
+## Error handling
+
+```ruby
+begin
+  paper = Arxivarius.get('2601.00470')
+rescue Arxivarius::Error::PaperNotFound
+  # paper does not exist on arXiv
+rescue Arxivarius::Error::MalformedId
+  # the ID format is invalid
+end
+```
+
+## Credits
+
+ArXivarius is based on the outdated [arxiv](https://rubygems.org/gems/arxiv) gem.
+Arxivarius picks up where it left off, with updated dependencies and a few improvements.
+
+## License
+
+MIT

data/lib/arxivarius/author.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Arxivarius
+  class Author
+    include HappyMapper
+
+    element :name, Text, parser: :squish
+    has_many :affiliations, Text, parser: :squish, tag: 'affiliation'
+
+    def first_name = name_parts.first
+
+    def last_name = name_parts.last
+
+    private
+
+    def name_parts
+      @name_parts ||= FullNameSplitter.split(name)
+    end
+  end
+end

data/lib/arxivarius/category.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Arxivarius
+  class Category
+    include HappyMapper
+
+    # Maps category names to human-readable labels.
+    # Not available through the arXiv API, so we maintain a local copy.
+    CATEGORIES_PATH = File.expand_path('data/categories.yml', __dir__)
+
+    def self.types
+      @types ||= YAML.safe_load_file(CATEGORIES_PATH)
+    end
+
+    attribute :name, String, tag: 'term'
+
+    def description
+      Category.types[name]
+    end
+
+    def long_description
+      description ? "#{name} (#{description})" : name
+    end
+  end
+end

data/lib/arxivarius/data/categories.yml

@@ -0,0 +1,156 @@
+---
+astro-ph.CO: Cosmology and Nongalactic Astrophysics
+astro-ph.EP: Earth and Planetary Astrophysics
+astro-ph.GA: Astrophysics of Galaxies
+astro-ph.HE: High Energy Astrophysical Phenomena
+astro-ph.IM: Instrumentation and Methods for Astrophysics
+astro-ph.SR: Solar and Stellar Astrophysics
+cond-mat.dis-nn: Disordered Systems and Neural Networks
+cond-mat.mes-hall: Mesoscale and Nanoscale Physics
+cond-mat.mtrl-sci: Materials Science
+cond-mat.other: Other Condensed Matter
+cond-mat.quant-gas: Quantum Gases
+cond-mat.soft: Soft Condensed Matter
+cond-mat.stat-mech: Statistical Mechanics
+cond-mat.str-el: Strongly Correlated Electrons
+cond-mat.supr-con: Superconductivity
+cs.AI: Artificial Intelligence
+cs.AR: Hardware Architecture
+cs.CC: Computational Complexity
+cs.CE: Computational Engineering, Finance, and Science
+cs.CG: Computational Geometry
+cs.CL: Computation and Language
+cs.CR: Cryptography and Security
+cs.CV: Computer Vision and Pattern Recognition
+cs.CY: Computers and Society
+cs.DB: Databases
+cs.DC: Distributed, Parallel, and Cluster Computing
+cs.DL: Digital Libraries
+cs.DM: Discrete Mathematics
+cs.DS: Data Structures and Algorithms
+cs.ET: Emerging Technologies
+cs.FL: Formal Languages and Automata Theory
+cs.GL: General Literature
+cs.GR: Graphics
+cs.GT: Computer Science and Game Theory
+cs.HC: Human-Computer Interaction
+cs.IR: Information Retrieval
+cs.IT: Information Theory
+cs.LG: Machine Learning
+cs.LO: Logic in Computer Science
+cs.MA: Multiagent Systems
+cs.MM: Multimedia
+cs.MS: Mathematical Software
+cs.NA: Numerical Analysis
+cs.NE: Neural and Evolutionary Computing
+cs.NI: Networking and Internet Architecture
+cs.OH: Other Computer Science
+cs.OS: Operating Systems
+cs.PF: Performance
+cs.PL: Programming Languages
+cs.RO: Robotics
+cs.SC: Symbolic Computation
+cs.SD: Sound
+cs.SE: Software Engineering
+cs.SI: Social and Information Networks
+cs.SY: Systems and Control
+econ.EM: Econometrics
+econ.GN: General Economics
+econ.TH: Theoretical Economics
+eess.AS: Audio and Speech Processing
+eess.IV: Image and Video Processing
+eess.SP: Signal Processing
+eess.SY: Systems and Control
+gr-qc: General Relativity and Quantum Cosmology
+hep-ex: High Energy Physics - Experiment
+hep-lat: High Energy Physics - Lattice
+hep-ph: High Energy Physics - Phenomenology
+hep-th: High Energy Physics - Theory
+math-ph: Mathematical Physics
+math.AC: Commutative Algebra
+math.AG: Algebraic Geometry
+math.AP: Analysis of PDEs
+math.AT: Algebraic Topology
+math.CA: Classical Analysis and ODEs
+math.CO: Combinatorics
+math.CT: Category Theory
+math.CV: Complex Variables
+math.DG: Differential Geometry
+math.DS: Dynamical Systems
+math.FA: Functional Analysis
+math.GM: General Mathematics
+math.GN: General Topology
+math.GR: Group Theory
+math.GT: Geometric Topology
+math.HO: History and Overview
+math.IT: Information Theory
+math.KT: K-Theory and Homology
+math.LO: Logic
+math.MG: Metric Geometry
+math.MP: Mathematical Physics
+math.NA: Numerical Analysis
+math.NT: Number Theory
+math.OA: Operator Algebras
+math.OC: Optimization and Control
+math.PR: Probability
+math.QA: Quantum Algebra
+math.RA: Rings and Algebras
+math.RT: Representation Theory
+math.SG: Symplectic Geometry
+math.SP: Spectral Theory
+math.ST: Statistics Theory
+nlin.AO: Adaptation and Self-Organizing Systems
+nlin.CD: Chaotic Dynamics
+nlin.CG: Cellular Automata and Lattice Gases
+nlin.PS: Pattern Formation and Solitons
+nlin.SI: Exactly Solvable and Integrable Systems
+nucl-ex: Nuclear Experiment
+nucl-th: Nuclear Theory
+physics.acc-ph: Accelerator Physics
+physics.ao-ph: Atmospheric and Oceanic Physics
+physics.app-ph: Applied Physics
+physics.atm-clus: Atomic and Molecular Clusters
+physics.atom-ph: Atomic Physics
+physics.bio-ph: Biological Physics
+physics.chem-ph: Chemical Physics
+physics.class-ph: Classical Physics
+physics.comp-ph: Computational Physics
+physics.data-an: Data Analysis, Statistics and Probability
+physics.ed-ph: Physics Education
+physics.flu-dyn: Fluid Dynamics
+physics.gen-ph: General Physics
+physics.geo-ph: Geophysics
+physics.hist-ph: History and Philosophy of Physics
+physics.ins-det: Instrumentation and Detectors
+physics.med-ph: Medical Physics
+physics.optics: Optics
+physics.plasm-ph: Plasma Physics
+physics.pop-ph: Popular Physics
+physics.soc-ph: Physics and Society
+physics.space-ph: Space Physics
+q-bio.BM: Biomolecules
+q-bio.CB: Cell Behavior
+q-bio.GN: Genomics
+q-bio.MN: Molecular Networks
+q-bio.NC: Neurons and Cognition
+q-bio.OT: Other Quantitative Biology
+q-bio.PE: Populations and Evolution
+q-bio.QM: Quantitative Methods
+q-bio.SC: Subcellular Processes
+q-bio.TO: Tissues and Organs
+q-fin.CP: Computational Finance
+q-fin.EC: Economics
+q-fin.GN: General Finance
+q-fin.MF: Mathematical Finance
+q-fin.PM: Portfolio Management
+q-fin.PR: Pricing of Securities
+q-fin.RM: Risk Management
+q-fin.ST: Statistical Finance
+q-fin.TR: Trading and Market Microstructure
+quant-ph: Quantum Physics
+stat.AP: Applications
+stat.CO: Computation
+stat.ME: Methodology
+stat.ML: Machine Learning
+stat.OT: Other Statistics
+stat.TH: Statistics Theory

data/lib/arxivarius/link.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Arxivarius
+  class Link
+    include HappyMapper
+
+    attribute :url, String, tag: 'href'
+    attribute :content_type, String, tag: 'type'
+  end
+end

data/lib/arxivarius/paper.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Arxivarius
+  class Paper
+    include HappyMapper
+
+    tag 'entry'
+    element :arxiv_url, String, tag: 'id'
+    element :created_at, Time, tag: 'published'
+    element :updated_at, Time, tag: 'updated'
+    element :title, Text, parser: :squish
+    element :summary, Text, parser: :squish
+    element :comment, Text, parser: :squish
+    has_one :primary_category, Category
+    has_many :categories, Category
+    has_many :authors, Author
+    has_many :links, Link
+
+    alias_method :abstract, :summary
+
+    def arxiv_url
+      force_https(@arxiv_url)
+    end
+
+    def revision?
+      created_at != updated_at
+    end
+
+    def legacy_article?
+      arxiv_url.match?(Arxivarius::LEGACY_URL_FORMAT)
+    end
+
+    def arxiv_id
+      arxiv_versioned_id.match(/([^v]+)v\d+$/)[1]
+    end
+
+    def arxiv_versioned_id
+      @arxiv_versioned_id ||= if legacy_article?
+        arxiv_url.match(/(#{Arxivarius::LEGACY_URL_FORMAT})/)[1]
+      else
+        arxiv_url.match(/(#{Arxivarius::CURRENT_URL_FORMAT})/)[1]
+      end
+    end
+
+    def version
+      arxiv_url.match(/v(\d+)$/)[1].to_i
+    end
+
+    def content_types
+      @content_types ||= links.map(&:content_type).compact.grep_v(/^\s*$/)
+    end
+
+    def available_in_pdf?
+      content_types.any? { |type| type == 'application/pdf' }
+    end
+
+    def pdf_url
+      link = links.find { |l| l.content_type == 'application/pdf' }
+      force_https(link.url) if link
+    end
+
+    private
+
+    def force_https(url)
+      url.sub(/^http:/, 'https:')
+    end
+  end
+end

data/lib/arxivarius/text.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Arxivarius
+  module Text
+    module_function
+
+    def squish(string)
+      string.tr("\n", ' ').strip.squeeze(' ')
+    end
+  end
+end

data/lib/arxivarius/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Arxivarius
+  VERSION = '0.10.0'
+end

data/lib/arxivarius.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'time'
+require 'nokogiri'
+require 'happymapper'
+require 'full-name-splitter'
+require 'yaml'
+
+require 'arxivarius/version'
+require 'arxivarius/text'
+
+require 'arxivarius/author'
+require 'arxivarius/link'
+require 'arxivarius/category'
+require 'arxivarius/paper'
+
+module Arxivarius
+  module Error
+    class PaperNotFound < StandardError; end
+    class MalformedId < StandardError; end
+  end
+
+  # ArXiv uses two ID formats:
+  #   Legacy:  math/0510097v1   (pre-2007)
+  #   Current: 1202.0819v1      (2007+)
+  LEGACY_URL_FORMAT = /[^\/]+\/\d+(?:v\d+)?$/
+  CURRENT_URL_FORMAT = /\d{4,}\.\d{4,}(?:v\d+)?$/
+
+  LEGACY_ID_FORMAT = /^#{LEGACY_URL_FORMAT}/
+  ID_FORMAT = /^#{CURRENT_URL_FORMAT}/
+
+  class << self
+    def get(identifier)
+      id = parse_arxiv_identifier(identifier)
+
+      raise Arxivarius::Error::MalformedId, 'Paper ID format is invalid' unless valid_id?(id)
+
+      id = normalize_legacy_id(id)
+
+      url = URI("https://export.arxiv.org/api/query?id_list=#{id}")
+      response = ::Nokogiri::XML(Net::HTTP.get(url)).remove_namespaces!
+      paper = Arxivarius::Paper.parse(response.to_s, single: true)
+
+      # Paper is nil when the API returns no <entry> for the given ID.
+      raise Arxivarius::Error::PaperNotFound, "Paper #{id} doesn't exist on arXiv" unless paper&.title
+
+      paper
+    end
+
+    private
+
+    def parse_arxiv_identifier(identifier)
+      if valid_url?(identifier)
+        format = legacy_url?(identifier) ? LEGACY_URL_FORMAT : CURRENT_URL_FORMAT
+        identifier.match(/(#{format})/)[1]
+      else
+        identifier
+      end
+    end
+
+    def valid_id?(identifier)
+      identifier.match?(ID_FORMAT) || identifier.match?(LEGACY_ID_FORMAT)
+    end
+
+    def valid_url?(identifier)
+      identifier.match?(LEGACY_URL_FORMAT) || identifier.match?(CURRENT_URL_FORMAT)
+    end
+
+    def legacy_url?(identifier)
+      identifier.match?(LEGACY_URL_FORMAT)
+    end
+
+    # The arXiv API no longer resolves subcategory legacy IDs.
+    # Strips the subcategory: math.DG/0510097 -> math/0510097.
+    def normalize_legacy_id(id)
+      id.sub(/^([a-z-]+)\.[A-Z][A-Za-z]*\//, '\1/')
+    end
+  end
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: arxivarius
+version: !ruby/object:Gem::Version
+  version: 0.10.0
+platform: ruby
+authors:
+- antlypls
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: full-name-splitter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+- !ruby/object:Gem::Dependency
+  name: nokogiri-happymapper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+description: 'Look up any arXiv paper by ID or URL and get structured metadata: titles,
+  authors, abstracts, categories, and PDF links.'
+email:
+- hello@antlypls.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/arxivarius.rb
+- lib/arxivarius/author.rb
+- lib/arxivarius/category.rb
+- lib/arxivarius/data/categories.yml
+- lib/arxivarius/link.rb
+- lib/arxivarius/paper.rb
+- lib/arxivarius/text.rb
+- lib/arxivarius/version.rb
+homepage: https://github.com/antlypls/arxivarius
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Fetch and parse papers metadata from arXiv
+test_files: []