pubmedly 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ce515f0fc81d823f6685a8711ea61113003ff1417de4b51981ed130f7f1b074
-  data.tar.gz: 93feffd74c056084fee11e5bc75307ff9a91b5fc301da2082e36fb180b0da6fb
+  metadata.gz: e53e6275febdb64a857f7fa9945cd5f33872a3970812fea25c74467ba4f74114
+  data.tar.gz: a7d4a0f420fb810dee254e141789f608a58a21aecd7d08420de09a86a5972138
 SHA512:
-  metadata.gz: e6bd4ef020f8e5f85d44843acd24170ae5d08b519944041b938055584e85fd92c1bb5674e457634eb4348caa7c9a113957fc2c01acaebb5242ca2179b37c55f8
-  data.tar.gz: e53587fd6bf4d3070fa79a6e46d7f8fc825cf6086271ce7d13401bf2444a44661d8565dd8b59c005d790affe6155d4edcc917aab330a721c894d361e33456bfd
+  metadata.gz: df53c06ff3817ca214d3aa8a669dadb600b8c077244767373e023b082a1a3ee371ac80e94a5004efb904ec1b552b565b5df07176b267fcd38c278eff3bbb4855
+  data.tar.gz: acb868ee974088141abcf369bba847289495f9eafd6c9961c889bf9c0b0d1df287dde1f2672076e5185a8808823b8e9f9c2792e339f17436dc20c52b360e391c

data/CHANGELOG.md

@@ -1,4 +1,7 @@
-## [Unreleased]
+## [0.3.0] - 2023-05-29
+
+- Add PUBMEDLY::FIELD_TAGS
+- Add Article#first/last_author
 
 ## [0.2.0] - 2023-05-20
 

data/README.md

@@ -1,6 +1,5 @@
 # Pubmedly
-
-**WIP**
+![main](https://github.com/robsimpsondev/pubmedly/actions/workflows/main.yml/badge.svg)
 
 This gem provides a `Pubmedly::Client` with methods that get data from the NCBI's [Pubmed database](https://pubmed.ncbi.nlm.nih.gov/) using their [eutils APIs](https://www.ncbi.nlm.nih.gov/books/NBK25499/).
 
@@ -10,17 +9,16 @@ You will need an API key to use this gem; doing this is simple and described wit
 
 ## Installation
 
-Requirements: Ruby.
-
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+Requirements:
+ - Ruby 3.0+
 
 Install the gem and add to the application's Gemfile by executing:
 
-    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+    $ bundle add pubmedly
 
 If bundler is not being used to manage dependencies, install the gem by executing:
 
-    $ gem install UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+    $ gem install pubmedly
 
 ## Usage
 
@@ -86,7 +84,7 @@ Given a version number MAJOR.MINOR.PATCH, increment the:
  - MAJOR version when you make incompatible API changes
  - MINOR version when you add functionality in a backward compatible manner
  - PATCH version when you make backward compatible bug fixes
- 
+
 Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.
 
 ## License

data/lib/pubmedly/parsers/article.rb

@@ -40,6 +40,14 @@ module Pubmedly
         end
       end
 
+      def first_author
+        authors.first
+      end
+
+      def last_author
+        authors.last
+      end
+
       def pmid
         id = @xml.xpath(".//PMID").text.to_i
         id.zero? ? nil : id

data/lib/pubmedly/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pubmedly
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/pubmedly.rb

@@ -9,4 +9,56 @@ require_relative "pubmedly/pubmed"
 module Pubmedly
   class ApiWarning < StandardError; end
   # Your code goes here...
+
+  # https://pubmed.ncbi.nlm.nih.gov/help/#search-tags
+  FIELD_TAGS = {
+    "Affiliation" => ["ad"],
+    "All Fields" => ["all"],
+    "Article Identifier" => ["aid"],
+    "Author" => ["au"],
+    "Author Identifier" => ["auid"],
+    "Book" => ["book"],
+    "Completion Date" => ["dcom"],
+    "Conflict of Interest Statement" => ["cois"],
+    "Corporate Author" => ["cn"],
+    "Create Date" => ["crdt"],
+    "EC/RN Number" => ["rn"],
+    "Editor" => ["ed"],
+    "Entry Date" => ["edat"],
+    "Filter" => %w[filter sb],
+    "First Author Name" => ["1au"],
+    "Full Author Name" => ["fau"],
+    "Full Investigator Name" => ["fir"],
+    "Grant Number" => ["gr"],
+    "Investigator" => ["ir"],
+    "ISBN" => ["isbn"],
+    "Issue" => ["ip"],
+    "Journal" => ["ta"],
+    "Language" => ["la"],
+    "Last Author Name" => ["lastau"],
+    "Location ID" => ["lid"],
+    "MeSH Date" => ["mhda"],
+    "MeSH Major Topic" => ["majr"],
+    "MeSH Subheadings" => ["sh"],
+    "MeSH Terms" => ["mh"],
+    "Modification Date" => ["lr"],
+    "NLM Unique ID" => ["jid"],
+    "Other Term" => ["ot"],
+    "Pagination" => ["pg"],
+    "Personal Name as Subject" => ["ps"],
+    "Pharmacological Action" => ["pa"],
+    "Place of Publication" => ["pl"],
+    "PMID" => ["pmid"],
+    "Publication Date" => ["dp"],
+    "Publication Type" => ["pt"],
+    "Publisher" => ["pubn"],
+    "Secondary Source ID" => ["si"],
+    "Subset" => ["sb"],
+    "Supplementary Concept" => ["nm"],
+    "Text Words" => ["tw"],
+    "Title" => ["ti"],
+    "Title/Abstract" => ["tiab"],
+    "Transliterated Title" => ["tt"],
+    "Volume" => ["vi"],
+  }.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pubmedly
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Rob Simpson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-05-20 00:00:00.000000000 Z
+date: 2023-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri