pubmedly 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ce515f0fc81d823f6685a8711ea61113003ff1417de4b51981ed130f7f1b074
-  data.tar.gz: 93feffd74c056084fee11e5bc75307ff9a91b5fc301da2082e36fb180b0da6fb
+  metadata.gz: 931f21135967ca4a8f8fd133e6381be02a5da461f71dcae1bd1c716900be29ab
+  data.tar.gz: 6f12c9b994516417d2d247577b35f8d52272b92da6f36643638ed415a8ba5f99
 SHA512:
-  metadata.gz: e6bd4ef020f8e5f85d44843acd24170ae5d08b519944041b938055584e85fd92c1bb5674e457634eb4348caa7c9a113957fc2c01acaebb5242ca2179b37c55f8
-  data.tar.gz: e53587fd6bf4d3070fa79a6e46d7f8fc825cf6086271ce7d13401bf2444a44661d8565dd8b59c005d790affe6155d4edcc917aab330a721c894d361e33456bfd
+  metadata.gz: 64174015e0bbc4b7baa4d2bb62a018d5fc16896ab76ddea8464316e08d9eb2a72c4d8866bb44ffa3863fe063173ebe18112a2dedd7fb7aa347e26b37508439ee
+  data.tar.gz: e2543ae0797da9d3a6213a6374e25a6fc18c763bc806b09122314dff82a6ccfe4829853f916a44df1a56aa4e614efcf1545255115d0479d9c3671e4496f4a3b7

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/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    pubmedly (0.2.0)
+    pubmedly (0.4.0)
       nokogiri
 
 GEM

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,10 +40,26 @@ 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
       end
+
+      def pmcid
+        @xml.xpath(".//PubmedData/ArticleIdList/ArticleId [@IdType='pmc']")&.text
+      end
+
+      def doi
+        @xml.xpath(".//ELocationID [@EIdType='doi']")&.text
+      end
     end
   end
 end

data/lib/pubmedly/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pubmedly
-  VERSION = "0.2.0"
+  VERSION = "0.4.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.4.0
 platform: ruby
 authors:
 - Rob Simpson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-05-20 00:00:00.000000000 Z
+date: 2024-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -223,7 +223,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Ruby client for the NCBI eutils Pubmed API