1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
|
import re
import sys
import json
import datetime
from bs4 import BeautifulSoup
from pylatexenc.latex2text import LatexNodes2Text
import fatcat_client
from .common import EntityImporter, clean
from .crossref import lookup_license_slug
latex2text = LatexNodes2Text()
def latex_to_text(raw):
try:
return latex2text.latex_to_text(raw).strip()
except AttributeError:
return raw.strip()
except IndexError:
return raw.strip()
def parse_arxiv_authors(raw):
if not raw:
return []
raw = raw.replace('*', '')
if '(' in raw:
raw = re.sub(r'\(.*\)', '', raw)
authors = raw.split(', ')
if authors:
last = authors[-1].split(" and ")
if len(last) == 2:
authors[-1] = last[0]
authors.append(last[1])
if authors[-1].startswith("and "):
authors[-1] = authors[-1][4:]
authors = [latex_to_text(a).strip() for a in authors]
authors = [a for a in authors if a]
return authors
def test_parse_arxiv_authors():
assert parse_arxiv_authors("Raphael Chetrite, Shamik Gupta, Izaak Neri and \\'Edgar Rold\\'an") == [
"Raphael Chetrite",
"Shamik Gupta",
"Izaak Neri",
"Édgar Roldán",
]
assert parse_arxiv_authors("Izaak Neri and \\'Edgar Rold\\'an") == [
"Izaak Neri",
"Édgar Roldán",
]
assert parse_arxiv_authors("Izaak Neri, and \\'Edgar Rold\\'an") == [
"Izaak Neri",
"Édgar Roldán",
]
assert parse_arxiv_authors("Izaak Neri, et al.") == [
"Izaak Neri",
"et al.",
]
assert parse_arxiv_authors("Raphael Chetrite Shamik Gupta") == [
"Raphael Chetrite Shamik Gupta",
]
assert parse_arxiv_authors("B. P. Lanyon, T. J. Weinhold, N. K. Langford, M. Barbieri, D. F. V. James*, A. Gilchrist, and A. G. White (University of Queensland, *University of Toronto)") == [
"B. P. Lanyon",
"T. J. Weinhold",
"N. K. Langford",
"M. Barbieri",
"D. F. V. James",
"A. Gilchrist",
"A. G. White",
]
class ArxivRawImporter(EntityImporter):
"""
Converts arxiv.org "arXivRaw" OAI-PMH XML records to fatcat release entities
TODO: arxiv_id lookup in API (rust) with no version specified should select
the "most recent" version; can be a simple sort?
"""
def __init__(self, api, **kwargs):
eg_desc = kwargs.get('editgroup_description',
"Automated import of arxiv metadata via arXivRaw OAI-PMH feed")
eg_extra = kwargs.get('editgroup_extra', dict())
eg_extra['agent'] = eg_extra.get('agent', 'fatcat_tools.ArxivRawImporter')
# lower batch size, because multiple versions per entry (guessing 2-3 on average?)
batch_size = kwargs.get('edit_batch_size', 50)
super().__init__(api,
editgroup_description=eg_desc,
editgroup_extra=eg_extra,
batch_size=batch_size,
**kwargs)
self._test_override = False
def parse_record(self, record):
if not record:
return None
metadata = record.arXivRaw
if not metadata:
return None
extra = dict()
extra_arxiv = dict()
# don't know!
release_type = "article"
base_id = metadata.id.string
doi = None
if metadata.doi and metadata.doi.string:
doi = metadata.doi.string.lower().split()[0].strip()
if not (doi.startswith('10.') and '/' in doi):
sys.stderr.write("BOGUS DOI: {}\n".format(doi))
doi = None
title = latex_to_text(metadata.title.string)
authors = parse_arxiv_authors(metadata.authors.string)
contribs = [fatcat_client.ReleaseContrib(index=i, raw_name=a, role='author') for i, a in enumerate(authors)]
lang = "en" # the vast majority in english
if metadata.comments and metadata.comments.string:
comments = metadata.comments.string.strip()
extra_arxiv['comments'] = comments
if 'in french' in comments.lower():
lang = 'fr'
elif 'in spanish' in comments.lower():
lang = 'es'
elif 'in portuguese' in comments.lower():
lang = 'pt'
elif 'in hindi' in comments.lower():
lang = 'hi'
elif 'in japanese' in comments.lower():
lang = 'ja'
elif 'in german' in comments.lower():
lang = 'de'
elif 'simplified chinese' in comments.lower():
lang = 'zh'
elif 'in russian' in comments.lower():
lang = 'ru'
# more languages?
number = None
if metadata.find('journal-ref') and metadata.find('journal-ref').string:
journal_ref = metadata.find('journal-ref').string.strip()
extra_arxiv['journal_ref'] = journal_ref
if "conf." in journal_ref.lower() or "proc." in journal_ref.lower():
release_type = "paper-conference"
if metadata.find('report-no') and metadata.find('report-no').string:
number = metadata.find('report-no').string.strip()
# at least some people plop extra metadata in here. hrmf!
if 'ISSN ' in number or 'ISBN ' in number or len(number.split()) > 2:
extra_arxiv['report-no'] = number
number = None
else:
release_type = "report"
if metadata.find('acm-class') and metadata.find('acm-class').string:
extra_arxiv['acm_class'] = metadata.find('acm-class').string.strip()
if metadata.categories and metadata.categories.string:
extra_arxiv['categories'] = metadata.categories.string.split()
license_slug = None
if metadata.license and metadata.license.string:
license_slug = lookup_license_slug(metadata.license.string)
abstracts = None
if metadata.abstract:
# TODO: test for this multi-abstract code path
abstracts = []
abst = metadata.abstract.string.strip()
orig = None
if '-----' in abst:
both = abst.split('-----')
abst = both[0].strip()
orig = both[1].strip()
if '$' in abst or '{' in abst:
mime = "application/x-latex"
abst_plain = latex_to_text(abst)
abstracts.append(fatcat_client.ReleaseAbstract(content=abst_plain, mimetype="text/plain", lang="en"))
else:
mime = "text/plain"
abstracts.append(fatcat_client.ReleaseAbstract(content=abst, mimetype=mime, lang="en"))
if orig:
abstracts.append(fatcat_client.ReleaseAbstract(content=orig, mimetype=mime))
# indicates that fulltext probably isn't english either
if lang == 'en':
lang = None
# extra:
# withdrawn_date
# translation_of
# subtitle
# aliases
# container_name
# group-title
# arxiv: comments, categories, etc
extra_arxiv['base_id'] = base_id
extra['arxiv'] = extra_arxiv
versions = []
for version in metadata.find_all('version'):
arxiv_id = base_id + version['version']
release_date = version.date.string.strip()
release_date = datetime.datetime.strptime(release_date, "%a, %d %b %Y %H:%M:%S %Z").date()
# TODO: source_type?
versions.append(fatcat_client.ReleaseEntity(
work_id=None,
title=title,
#original_title
version=version['version'],
release_type=release_type,
release_stage='submitted',
release_date=release_date.isoformat(),
release_year=release_date.year,
ext_ids=fatcat_client.ReleaseExtIds(
arxiv=arxiv_id,
),
number=number,
language=lang,
license_slug=license_slug,
abstracts=abstracts,
contribs=contribs,
extra=extra,
))
# TODO: assert that versions are actually in order?
assert versions
# only apply DOI to most recent version (HACK)
if doi:
versions[-1].ext_ids.doi = doi
if len(versions) > 1:
versions[-1].release_stage = "accepted"
return versions
def try_update(self, versions):
"""
This is pretty complex! There is no batch/bezerk mode for arxiv importer.
For each version, do a lookup by full arxiv_id, and store work/release
id results.
If a version has a DOI, also do a doi lookup and store that result. If
there is an existing release with both matching, set that as the
existing work. If they don't match, use the full arxiv_id match and
move on (maybe log or at least count the error?). If it's a
one/or/other case, update the existing release (and mark version as
existing).
If there was any existing release, take its work_id.
Iterate back through versions. If it didn't already exist, insert it
with any existing work_id. If there wasn't an existing work_id, lookup
the new release (by rev from edit?) and use that for the rest.
Do not pass any versions on for batch insert.
"""
# first do lookups
any_work_id = None
for v in versions:
v._existing_work_id = None
v._updated = False
existing = None
existing_doi = None
try:
existing = self.api.lookup_release(arxiv=v.ext_ids.arxiv)
except fatcat_client.rest.ApiException as err:
if err.status != 404:
raise err
if existing:
v._existing_work_id = existing.work_id
any_work_id = existing.work_id
if v.ext_ids.doi:
try:
existing_doi = self.api.lookup_release(doi=v.ext_ids.doi)
except fatcat_client.rest.ApiException as err:
if err.status != 404:
raise err
if existing_doi:
if existing and existing.ident == existing_doi.ident:
# great, they match and have idents, nothing to do
pass
elif existing and existing.ident != existing_doi.ident:
# could be that a new arxiv version was created (update?),
# or that VOR has no arxiv version (or catalog is borked or
# something else)
# stick with arxiv_id match as existing, but don't set DOI;
# don't update anything
v.ext_ids.doi = None
pass
else:
assert not existing
# there's a pre-existing DOI release we should group under,
# but we don't know if we're the version-of-record or what,
# so just group but don't update existing DOI release
v.ext_ids.doi = None
any_work_id = any_work_id or existing_doi.work_id
last_edit = None
for v in versions:
if v._existing_work_id:
if not v._updated:
self.counts['exists'] += 1
continue
if not any_work_id and last_edit:
# fetch the last inserted release from this group
r = self.api.get_release_revision(last_edit.revision)
assert r.work_id
any_work_id = r.work_id
v.work_id = any_work_id
last_edit = self.api.create_release(self.get_editgroup_id(), v)
self.counts['insert'] += 1
return False
def insert_batch(self, batch_batch):
# there is no batch/bezerk mode for arxiv importer, except for testing
if self._test_override:
for batch in batch_batch:
self.api.create_release_auto_batch(fatcat_client.ReleaseAutoBatch(
editgroup=fatcat_client.Editgroup(
description=self.editgroup_description,
extra=self.editgroup_extra),
entity_list=batch))
self.counts['insert'] += len(batch) - 1
else:
raise NotImplementedError()
def parse_file(self, handle):
# 1. open with beautiful soup
soup = BeautifulSoup(handle, "xml")
# 2. iterate over articles, call parse_article on each
for article in soup.find_all("record"):
resp = self.parse_record(article)
print(json.dumps(resp))
#sys.exit(-1)
if __name__=='__main__':
parser = ArxivRawImporter(None)
parser.parse_file(open(sys.argv[1]))
|