The cl-arxiv-api Reference Manual

Table of Contents

The cl-arxiv-api Reference Manual

This is the cl-arxiv-api Reference Manual, version 0.1, generated automatically by Declt version 3.0 "Montgomery Scott" on Sun May 15 03:35:44 2022 GMT+0.

1 Introduction

cl-arxiv-api

A tiny wrapping layer on top of web-API of www.arXiv.org http://arxiv.org/help/api/index

The main API function is ARXIV-GET, parameters of which literally parallel parameters of http query (except some parameters are keywords and are keyword-valued).

(arxiv-get '(:author "Popolitov") :max-results 1 :sort-order :asc :sort-by :submit)

((:SELF-LINK
  . "http://arxiv.org/api/query?search_query%3Dau%3A%20Popolitov%26id_list%3D%26start%3D0%26max_results%3D1")
 (:TITLE
  . "ArXiv Query: search_query=au: Popolitov&id_list=&start=0&max_results=1")
 (:ID . "http://arxiv.org/api/eqh0wUfSoqUlr9BWqd8knMzmeUA")
 (:UPDATED . "2015-08-16T00:00:00-04:00") (:TOTAL-RESULTS . 13)
 (:START-INDEX . 0) (:ITEMS-PER-PAGE . 1)
 (:ENTRY (:ID . "http://arxiv.org/abs/0710.2073v2")
  (:UPDATED . "2007-10-12T11:18:49Z") (:PUBLISHED . "2007-10-10T17:58:06Z")
  (:TITLE . "On coincidence of Alday-Maldacena-regularized $σ$-model and
  Nambu-Goto areas of minimal surfaces")
  (:SUMMARY . "  For the $\\sigma$-model and Nambu-Goto actions, values of the
Alday-Maldacena-regularized actions are calculated on solutions of the
equations of motion with constant non-regularized Lagrangian. It turns out that
these values coincide up to a factor, independent of boundary conditions.
")
  (:AUTHOR . "A. Popolitov") (:DOI . "10.1134/S0021364007210011")
  (:RELATED-LINK . "http://dx.doi.org/10.1134/S0021364007210011")
  (:COMMENT . "3 pages, submitted to JETP Letters, corrected some misprints and
  missing factors in formulas (10) and (11)")
  (:JOURNAL-REF . "JETP Lett.86:559-561,2008")
  (:ALTERNATE-LINK . "http://arxiv.org/abs/0710.2073v2")
  (:RELATED-LINK . "http://arxiv.org/pdf/0710.2073v2")
  (:PRIMARY-CATEGORY . "hep-th") (:CATEGORY . "hep-th")))

As is clear from the example, ARXIV-GET parses XML returned by arXiv into simple assoc-list. CL-ARXIV-API exports two more functions:

• ARXIV-GET-RAW, which does not do the parsing, returing raw XML
• PARSE-ARXIV-RESPONSE, which actually does parsing of XML to assoc-list

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 cl-arxiv-api

Author

Alexandr Popolitov <popolit@gmail.com>

License

MIT

Description

Bindings for API of arXiv.org

Version

0.1

Dependencies

• trivial-http
• cl-interpol
• cl-ppcre
• iterate
• cxml

Source

cl-arxiv-api.asd (file)

Components

• package.lisp (file)
• compose-query.lisp (file)
• parse-query.lisp (file)
• cl-arxiv-api.lisp (file)
• oai-pmh.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 cl-arxiv-api.asd

Location

cl-arxiv-api.asd

Systems

cl-arxiv-api (system)

3.1.2 cl-arxiv-api/package.lisp

Parent

cl-arxiv-api (system)

Location

package.lisp

Packages

cl-arxiv-api

3.1.3 cl-arxiv-api/compose-query.lisp

Dependency

package.lisp (file)

Parent

cl-arxiv-api (system)

Location

compose-query.lisp

Exported Definitions

arxiv-get-raw (function)

Internal Definitions

• %serialize-query (function)
• *arxiv-api-url* (special variable)
• *method-names* (special variable)
• *query-connectives* (special variable)
• *query-params-abbrevs* (special variable)
• atomic-query-p (function)
• composite-query-p (function)
• http-get-error (condition)
• http-retrying-get (function)
• http-simple-get (function)
• query-head (function)
• serialize-query (function)

3.1.4 cl-arxiv-api/parse-query.lisp

Dependency

compose-query.lisp (file)

Parent

cl-arxiv-api (system)

Location

parse-query.lisp

Exported Definitions

parse-arxiv-response (function)

Internal Definitions

• %parse-arxiv-response (function)
• *default-namespace* (special variable)
• *namespace-map* (special variable)
• *parsers* (special variable)
• arxiv-parse-error (condition)
• define-default-parser (macro)
• define-default-parser-for (macro)
• define-integer-parser (macro)
• define-integer-parser-for (macro)
• define-parser (macro)
• empty-line-p (function)
• ensure-namespace-free (function)
• fail-parse (macro)
• hash->assoc (function)
• parse-as-list (function)
• try-to-descend (function)
• understand-spec (function)

3.1.5 cl-arxiv-api/cl-arxiv-api.lisp

Dependency

parse-query.lisp (file)

Parent

cl-arxiv-api (system)

Location

cl-arxiv-api.lisp

Exported Definitions

arxiv-get (function)

3.1.6 cl-arxiv-api/oai-pmh.lisp

Dependency

cl-arxiv-api.lisp (file)

Parent

cl-arxiv-api (system)

Location

oai-pmh.lisp

Internal Definitions

• *bkup-of-list-sets* (special variable)
• *err-code->sym* (special variable)
• *known-responses* (special variable)
• *known-verbs* (special variable)
• *oai-pmh-url* (special variable)
• *response-parsers* (special variable)
• *sample-xml-with-resumption-token* (special variable)
• *valid-errors* (special variable)
• arxiv-get-record (function)
• arxiv-identify (function)
• arxiv-list-all-identifiers (function)
• arxiv-list-all-records (function)
• arxiv-list-all-sets (function)
• arxiv-list-identifiers (function)
• arxiv-list-metadata-formats (function)
• arxiv-list-records (function)
• arxiv-list-sets (function)
• arxiv-nasty-verb (function)
• bad-argument (condition)
• bad-resumption-token (condition)
• bad-verb (condition)
• camelcaseize (function)
• cannot-disseminate-format (condition)
• compose-oai-pmh-request (function)
• define-all-fetcher (macro)
• error-message (function)
• error-symbol (function)
• get-parsers (function)
• group2 (function)
• id-does-not-exist (condition)
• no-metadata-formats (condition)
• no-records-match (condition)
• no-set-hierarchy (condition)
• oai-pmh-error (condition)
• parse-oai-pmh-response (function)
• subcamcaseize (function)

4 Packages

Packages are listed by definition order.

4.1 cl-arxiv-api

Source

package.lisp (file)

Use List

• cxml
• iterate
• trivial-http
• common-lisp

Exported Definitions

• arxiv-get (function)
• arxiv-get-raw (function)
• parse-arxiv-response (function)

Internal Definitions

• %parse-arxiv-response (function)
• %serialize-query (function)
• *arxiv-api-url* (special variable)
• *bkup-of-list-sets* (special variable)
• *default-namespace* (special variable)
• *err-code->sym* (special variable)
• *known-responses* (special variable)
• *known-verbs* (special variable)
• *method-names* (special variable)
• *namespace-map* (special variable)
• *oai-pmh-url* (special variable)
• *parsers* (special variable)
• *query-connectives* (special variable)
• *query-params-abbrevs* (special variable)
• *response-parsers* (special variable)
• *sample-xml-with-resumption-token* (special variable)
• *valid-errors* (special variable)
• arxiv-get-record (function)
• arxiv-identify (function)
• arxiv-list-all-identifiers (function)
• arxiv-list-all-records (function)
• arxiv-list-all-sets (function)
• arxiv-list-identifiers (function)
• arxiv-list-metadata-formats (function)
• arxiv-list-records (function)
• arxiv-list-sets (function)
• arxiv-nasty-verb (function)
• arxiv-parse-error (condition)
• atomic-query-p (function)
• bad-argument (condition)
• bad-resumption-token (condition)
• bad-verb (condition)
• camelcaseize (function)
• cannot-disseminate-format (condition)
• compose-oai-pmh-request (function)
• composite-query-p (function)
• define-all-fetcher (macro)
• define-default-parser (macro)
• define-default-parser-for (macro)
• define-integer-parser (macro)
• define-integer-parser-for (macro)
• define-parser (macro)
• empty-line-p (function)
• ensure-namespace-free (function)
• error-message (function)
• error-symbol (function)
• fail-parse (macro)
• get-parsers (function)
• group2 (function)
• hash->assoc (function)
• http-get-error (condition)
• http-retrying-get (function)
• http-simple-get (function)
• id-does-not-exist (condition)
• no-metadata-formats (condition)
• no-records-match (condition)
• no-set-hierarchy (condition)
• oai-pmh-error (condition)
• parse-as-list (function)
• parse-oai-pmh-response (function)
• query-head (function)
• serialize-query (function)
• subcamcaseize (function)
• try-to-descend (function)
• understand-spec (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Functions

Function: arxiv-get QUERY &key START MAX-RESULTS ID-LIST SORT-BY SORT-ORDER AUTO-RETRY

Package

cl-arxiv-api

Source

cl-arxiv-api.lisp (file)

Function: arxiv-get-raw QUERY &key START MAX-RESULTS ID-LIST SORT-BY SORT-ORDER AUTO-RETRY

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Function: parse-arxiv-response STR

Package

cl-arxiv-api

Source

parse-query.lisp (file)

5.2 Internal definitions

5.2.1 Special variables

Special Variable: *arxiv-api-url*

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Special Variable: *bkup-of-list-sets*

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Special Variable: *default-namespace*

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Special Variable: *err-code->sym*

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Special Variable: *known-responses*

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Special Variable: *known-verbs*

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Special Variable: *method-names*

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Special Variable: *namespace-map*

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Special Variable: *oai-pmh-url*

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Special Variable: *parsers*

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Special Variable: *query-connectives*

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Special Variable: *query-params-abbrevs*

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Special Variable: *response-parsers*

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Special Variable: *sample-xml-with-resumption-token*

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Special Variable: *valid-errors*

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

5.2.2 Macros

Macro: define-all-fetcher NAME ARGS BASE-NAME BASE-ARGS

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Macro: define-default-parser THING

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Macro: define-default-parser-for &rest THINGS

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Macro: define-integer-parser THING

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Macro: define-integer-parser-for &rest THINGS

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Macro: define-parser THING &body BODY

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Macro: fail-parse ()

Package

cl-arxiv-api

Source

parse-query.lisp (file)

5.2.3 Functions

Function: %parse-arxiv-response STR

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Function: %serialize-query QUERY &optional TOPLEVEL

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Function: arxiv-get-record IDENTIFIER METADATA-PREFIX

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: arxiv-identify ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: arxiv-list-all-identifiers METADATA-PREFIX &key FROM UNTIL SET

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: arxiv-list-all-records METADATA-PREFIX &key FROM UNTIL SET

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: arxiv-list-all-sets ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: arxiv-list-identifiers &key METADATA-PREFIX FROM UNTIL SET RESUMPTION-TOKEN

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: arxiv-list-metadata-formats &key IDENTIFIER

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: arxiv-list-records &key METADATA-PREFIX FROM UNTIL SET RESUMPTION-TOKEN

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: arxiv-list-sets &key RESUMPTION-TOKEN

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: arxiv-nasty-verb ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: atomic-query-p QUERY

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Function: camelcaseize NAME

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: compose-oai-pmh-request VERB &rest ARGS

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: composite-query-p QUERY

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Function: empty-line-p SMTH

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Function: ensure-namespace-free THING

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Function: error-message ERR

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: error-symbol ERR

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: get-parsers RESPONSE-TYPE

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: group2 LST

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: hash->assoc HASH

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Function: http-retrying-get REQUEST

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Function: http-simple-get REQUEST

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Function: parse-as-list SMTH

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Function: parse-oai-pmh-response RESPONSE

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: query-head QUERY

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Function: serialize-query QUERY

Transform query form Lisp-form to string form

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Function: subcamcaseize NAME

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Function: try-to-descend SMTH

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Function: understand-spec SPEC

Package

cl-arxiv-api

Source

parse-query.lisp (file)

5.2.4 Conditions

Condition: arxiv-parse-error ()

Package

cl-arxiv-api

Source

parse-query.lisp (file)

Direct superclasses

• simple-condition (condition)
• error (condition)

Condition: bad-argument ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Direct superclasses

oai-pmh-error (condition)

Condition: bad-resumption-token ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Direct superclasses

oai-pmh-error (condition)

Condition: bad-verb ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Direct superclasses

oai-pmh-error (condition)

Condition: cannot-disseminate-format ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Direct superclasses

oai-pmh-error (condition)

Condition: http-get-error ()

Package

cl-arxiv-api

Source

compose-query.lisp (file)

Direct superclasses

• simple-condition (condition)
• error (condition)

Direct methods

print-object (method)

Direct slots

Slot: code

Initargs

:code

Slot: headers

Initargs

:headers

Condition: id-does-not-exist ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Direct superclasses

oai-pmh-error (condition)

Condition: no-metadata-formats ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Direct superclasses

oai-pmh-error (condition)

Condition: no-records-match ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Direct superclasses

oai-pmh-error (condition)

Condition: no-set-hierarchy ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Direct superclasses

oai-pmh-error (condition)

Condition: oai-pmh-error ()

Package

cl-arxiv-api

Source

oai-pmh.lisp (file)

Direct superclasses

• simple-condition (condition)
• error (condition)

Direct subclasses

• bad-argument (condition)
• bad-resumption-token (condition)
• bad-verb (condition)
• cannot-disseminate-format (condition)
• id-does-not-exist (condition)
• no-records-match (condition)
• no-metadata-formats (condition)
• no-set-hierarchy (condition)

Direct slots

Slot: errors

Initargs

:errors

Slot: rest

Initargs

rest

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types