Retrieve formatted citation

Addresses #423.

Author: arunkannawadi

scholarly/data_types.py

@@ -119,6 +119,7 @@ class BibEntry(TypedDict, total=False):
     :param number: NA number of a publication
     :param pages: range of pages
     :param publisher: The publisher's name
+    :param citation: Formatted citation string, usually containing journal name, volume and page numbers (source: AUTHOR_PUBLICATION_ENTRY)
     :param pub_url: url of the website providing the publication
     """
     pub_type: str
@@ -133,6 +134,7 @@ class BibEntry(TypedDict, total=False):
     number: str
     pages: str
     publisher: str
+    citation: str
 
 
 class Mandate(TypedDict, total=False):

scholarly/publication_parser.py

@@ -127,6 +127,13 @@ def _citation_pub(self, __data, publication: Publication):
                 and len(year.text) > 0):
             publication['bib']['pub_year'] = year.text.strip()
 
+        author_citation = __data.find_all('div', class_='gs_gray')
+        try:
+            citation = author_citation[1].text
+        except IndexError:
+            citation = ""
+        publication['bib']['citation'] = citation
+
         return publication
 
     def get_publication(self, __data, pubtype: PublicationSource)->Publication:

test_module.py

@@ -501,6 +501,22 @@ def test_full_title(self):
         self.assertEqual(pub['bib']['title'],
                          u'Evaluation of toxicity of Dichlorvos (Nuvan) to fresh water fish Anabas testudineus and possible modulation by crude aqueous extract of Andrographis paniculata: A preliminary investigation')
 
+        self.assertEqual(pub['bib']['citation'], "")
+
+        for i in range(len(author['publications'])):
+            if author['publications'][i]['author_pub_id'] == 'Xxjj6IsAAAAJ:ldfaerwXgEUC':
+                pub_index = i
+        self.assertGreaterEqual(i, 0)
+        # elided title
+        self.assertEqual(author['publications'][pub_index]['bib']['title'],
+                         u'Evaluation of toxicity of Dichlorvos (Nuvan) to fresh water fish Anabas testudineus and possible modulation by crude aqueous extract of Andrographis paniculata: A preliminary …')
+        # full text
+        pub = scholarly.fill(author['publications'][pub_index])
+        self.assertEqual(pub['bib']['title'],
+                         u'Evaluation of toxicity of Dichlorvos (Nuvan) to fresh water fish Anabas testudineus and possible modulation by crude aqueous extract of Andrographis paniculata: A preliminary …')
+
+        self.assertEqual(pub['bib']['citation'], "Journal of Fisheries and Life Sciences 5 (2), 74-84, 2020")
+
     def test_author_organization(self):
         """
         """
@@ -590,6 +606,7 @@ def test_related_articles_from_author(self):
         scholarly.fill(author, sections=['basics', 'publications'])
         pub = author['publications'][0]
         self.assertEqual(pub['bib']['title'], 'Prospect theory: An analysis of decision under risk')
+        self.assertEqual(pub['bib']['citation'], 'Handbook of the fundamentals of financial decision making: Part I, 99-127, 2013')
         related_articles = scholarly.get_related_articles(pub)
         # Typically, the same publication is returned as the most related article
         same_article = next(related_articles)