The cl-arxiv-api Reference Manual

Next: , Previous: , Up: (dir)   [Contents][Index]

The cl-arxiv-api Reference Manual

This is the cl-arxiv-api Reference Manual, version 0.1, generated automatically by Declt version 4.0 beta 2 "William Riker" on Thu Sep 15 03:33:39 2022 GMT+0.

Table of Contents


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:


2 Systems

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


Previous: , Up: Systems   [Contents][Index]

2.1 cl-arxiv-api

Bindings for API of arXiv.org

Author

Alexandr Popolitov <popolit@gmail.com>

License

MIT

Version

0.1

Dependencies
  • trivial-http (system).
  • cl-interpol (system).
  • cl-ppcre (system).
  • iterate (system).
  • cxml (system).
Source

cl-arxiv-api.asd.

Child Components

3 Files

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


Previous: , Up: Files   [Contents][Index]

3.1 Lisp


Next: , Previous: , Up: Lisp   [Contents][Index]

3.1.1 cl-arxiv-api/cl-arxiv-api.asd

Source

cl-arxiv-api.asd.

Parent Component

cl-arxiv-api (system).

ASDF Systems

cl-arxiv-api.


3.1.2 cl-arxiv-api/package.lisp

Source

cl-arxiv-api.asd.

Parent Component

cl-arxiv-api (system).

Packages

cl-arxiv-api.


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

Dependency

package.lisp (file).

Source

cl-arxiv-api.asd.

Parent Component

cl-arxiv-api (system).

Public Interface
Internals

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

Dependency

compose-query.lisp (file).

Source

cl-arxiv-api.asd.

Parent Component

cl-arxiv-api (system).

Public Interface

parse-arxiv-response (function).

Internals

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

Dependency

parse-query.lisp (file).

Source

cl-arxiv-api.asd.

Parent Component

cl-arxiv-api (system).

Public Interface

arxiv-get (function).


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

Dependency

cl-arxiv-api.lisp (file).

Source

cl-arxiv-api.asd.

Parent Component

cl-arxiv-api (system).

Internals

4 Packages

Packages are listed by definition order.


Previous: , Up: Packages   [Contents][Index]

4.1 cl-arxiv-api

Source

package.lisp.

Use List
  • common-lisp.
  • cxml.
  • iterate.
  • trivial-http.
Public Interface
Internals

5 Definitions

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


Next: , Previous: , Up: Definitions   [Contents][Index]

5.1 Public Interface


5.1.1 Ordinary 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.

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.

Function: parse-arxiv-response (str)
Package

cl-arxiv-api.

Source

parse-query.lisp.


5.1.2 Standalone methods

Method: print-object ((condition http-get-error) stream)
Source

compose-query.lisp.


5.2 Internals


Next: , Previous: , Up: Internals   [Contents][Index]

5.2.1 Special variables

Special Variable: *arxiv-api-url*
Package

cl-arxiv-api.

Source

compose-query.lisp.

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

cl-arxiv-api.

Source

oai-pmh.lisp.

Special Variable: *default-namespace*
Package

cl-arxiv-api.

Source

parse-query.lisp.

Special Variable: *err-code->sym*
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Special Variable: *known-responses*
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Special Variable: *known-verbs*
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Special Variable: *method-names*
Package

cl-arxiv-api.

Source

compose-query.lisp.

Special Variable: *namespace-map*
Package

cl-arxiv-api.

Source

parse-query.lisp.

Special Variable: *oai-pmh-url*
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Special Variable: *parsers*
Package

cl-arxiv-api.

Source

parse-query.lisp.

Special Variable: *query-connectives*
Package

cl-arxiv-api.

Source

compose-query.lisp.

Special Variable: *query-params-abbrevs*
Package

cl-arxiv-api.

Source

compose-query.lisp.

Special Variable: *response-parsers*
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

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

cl-arxiv-api.

Source

oai-pmh.lisp.

Special Variable: *valid-errors*
Package

cl-arxiv-api.

Source

oai-pmh.lisp.


5.2.2 Macros

Macro: define-all-fetcher (name args base-name base-args)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Macro: define-default-parser (thing)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Macro: define-default-parser-for (&rest things)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Macro: define-integer-parser (thing)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Macro: define-integer-parser-for (&rest things)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Macro: define-parser (thing &body body)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Macro: fail-parse ()
Package

cl-arxiv-api.

Source

parse-query.lisp.


Next: , Previous: , Up: Internals   [Contents][Index]

5.2.3 Ordinary functions

Function: %parse-arxiv-response (str)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Function: %serialize-query (query &optional toplevel)
Package

cl-arxiv-api.

Source

compose-query.lisp.

Function: arxiv-get-record (identifier metadata-prefix)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: arxiv-identify ()
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: arxiv-list-all-identifiers (metadata-prefix &key from until set)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: arxiv-list-all-records (metadata-prefix &key from until set)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: arxiv-list-all-sets ()
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: arxiv-list-identifiers (&key metadata-prefix from until set resumption-token)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: arxiv-list-metadata-formats (&key identifier)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: arxiv-list-records (&key metadata-prefix from until set resumption-token)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: arxiv-list-sets (&key resumption-token)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: arxiv-nasty-verb ()
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: atomic-query-p (query)
Package

cl-arxiv-api.

Source

compose-query.lisp.

Function: camelcaseize (name)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: compose-oai-pmh-request (verb &rest args)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: composite-query-p (query)
Package

cl-arxiv-api.

Source

compose-query.lisp.

Function: empty-line-p (smth)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Function: ensure-namespace-free (thing)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Function: error-message (err)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: error-symbol (err)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: get-parsers (response-type)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: group2 (lst)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: hash->assoc (hash)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Function: http-retrying-get (request)
Package

cl-arxiv-api.

Source

compose-query.lisp.

Function: http-simple-get (request)
Package

cl-arxiv-api.

Source

compose-query.lisp.

Function: parse-as-list (smth)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Function: parse-oai-pmh-response (response)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: query-head (query)
Package

cl-arxiv-api.

Source

compose-query.lisp.

Function: serialize-query (query)

Transform query form Lisp-form to string form

Package

cl-arxiv-api.

Source

compose-query.lisp.

Function: subcamcaseize (name)
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Function: try-to-descend (smth)
Package

cl-arxiv-api.

Source

parse-query.lisp.

Function: understand-spec (spec)
Package

cl-arxiv-api.

Source

parse-query.lisp.


5.2.4 Conditions

Condition: arxiv-parse-error
Package

cl-arxiv-api.

Source

parse-query.lisp.

Direct superclasses
  • error.
  • simple-condition.
Condition: bad-argument
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Direct superclasses

oai-pmh-error.

Condition: bad-resumption-token
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Direct superclasses

oai-pmh-error.

Condition: bad-verb
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Direct superclasses

oai-pmh-error.

Condition: cannot-disseminate-format
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Direct superclasses

oai-pmh-error.

Condition: http-get-error
Package

cl-arxiv-api.

Source

compose-query.lisp.

Direct superclasses
  • error.
  • simple-condition.
Direct methods

print-object.

Direct slots
Slot: code
Initargs

:code

Slot: headers
Initargs

:headers

Condition: id-does-not-exist
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Direct superclasses

oai-pmh-error.

Condition: no-metadata-formats
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Direct superclasses

oai-pmh-error.

Condition: no-records-match
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Direct superclasses

oai-pmh-error.

Condition: no-set-hierarchy
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Direct superclasses

oai-pmh-error.

Condition: oai-pmh-error
Package

cl-arxiv-api.

Source

oai-pmh.lisp.

Direct superclasses
  • error.
  • simple-condition.
Direct subclasses
Direct slots
Slot: errors
Initargs

:errors

Slot: rest
Package

common-lisp.

Initargs

rest


Appendix A Indexes


Next: , Previous: , Up: Indexes   [Contents][Index]

A.1 Concepts


Next: , Previous: , Up: Indexes   [Contents][Index]

A.2 Functions

Jump to:   %  
A   C   D   E   F   G   H   M   P   Q   S   T   U  
Index Entry  Section

%
%parse-arxiv-response: Private ordinary functions
%serialize-query: Private ordinary functions

A
arxiv-get: Public ordinary functions
arxiv-get-raw: Public ordinary functions
arxiv-get-record: Private ordinary functions
arxiv-identify: Private ordinary functions
arxiv-list-all-identifiers: Private ordinary functions
arxiv-list-all-records: Private ordinary functions
arxiv-list-all-sets: Private ordinary functions
arxiv-list-identifiers: Private ordinary functions
arxiv-list-metadata-formats: Private ordinary functions
arxiv-list-records: Private ordinary functions
arxiv-list-sets: Private ordinary functions
arxiv-nasty-verb: Private ordinary functions
atomic-query-p: Private ordinary functions

C
camelcaseize: Private ordinary functions
compose-oai-pmh-request: Private ordinary functions
composite-query-p: Private ordinary functions

D
define-all-fetcher: Private macros
define-default-parser: Private macros
define-default-parser-for: Private macros
define-integer-parser: Private macros
define-integer-parser-for: Private macros
define-parser: Private macros

E
empty-line-p: Private ordinary functions
ensure-namespace-free: Private ordinary functions
error-message: Private ordinary functions
error-symbol: Private ordinary functions

F
fail-parse: Private macros
Function, %parse-arxiv-response: Private ordinary functions
Function, %serialize-query: Private ordinary functions
Function, arxiv-get: Public ordinary functions
Function, arxiv-get-raw: Public ordinary functions
Function, arxiv-get-record: Private ordinary functions
Function, arxiv-identify: Private ordinary functions
Function, arxiv-list-all-identifiers: Private ordinary functions
Function, arxiv-list-all-records: Private ordinary functions
Function, arxiv-list-all-sets: Private ordinary functions
Function, arxiv-list-identifiers: Private ordinary functions
Function, arxiv-list-metadata-formats: Private ordinary functions
Function, arxiv-list-records: Private ordinary functions
Function, arxiv-list-sets: Private ordinary functions
Function, arxiv-nasty-verb: Private ordinary functions
Function, atomic-query-p: Private ordinary functions
Function, camelcaseize: Private ordinary functions
Function, compose-oai-pmh-request: Private ordinary functions
Function, composite-query-p: Private ordinary functions
Function, empty-line-p: Private ordinary functions
Function, ensure-namespace-free: Private ordinary functions
Function, error-message: Private ordinary functions
Function, error-symbol: Private ordinary functions
Function, get-parsers: Private ordinary functions
Function, group2: Private ordinary functions
Function, hash->assoc: Private ordinary functions
Function, http-retrying-get: Private ordinary functions
Function, http-simple-get: Private ordinary functions
Function, parse-arxiv-response: Public ordinary functions
Function, parse-as-list: Private ordinary functions
Function, parse-oai-pmh-response: Private ordinary functions
Function, query-head: Private ordinary functions
Function, serialize-query: Private ordinary functions
Function, subcamcaseize: Private ordinary functions
Function, try-to-descend: Private ordinary functions
Function, understand-spec: Private ordinary functions

G
get-parsers: Private ordinary functions
group2: Private ordinary functions

H
hash->assoc: Private ordinary functions
http-retrying-get: Private ordinary functions
http-simple-get: Private ordinary functions

M
Macro, define-all-fetcher: Private macros
Macro, define-default-parser: Private macros
Macro, define-default-parser-for: Private macros
Macro, define-integer-parser: Private macros
Macro, define-integer-parser-for: Private macros
Macro, define-parser: Private macros
Macro, fail-parse: Private macros
Method, print-object: Public standalone methods

P
parse-arxiv-response: Public ordinary functions
parse-as-list: Private ordinary functions
parse-oai-pmh-response: Private ordinary functions
print-object: Public standalone methods

Q
query-head: Private ordinary functions

S
serialize-query: Private ordinary functions
subcamcaseize: Private ordinary functions

T
try-to-descend: Private ordinary functions

U
understand-spec: Private ordinary functions

Jump to:   %  
A   C   D   E   F   G   H   M   P   Q   S   T   U  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.3 Variables

Jump to:   *  
C   E   H   R   S  
Index Entry  Section

*
*arxiv-api-url*: Private special variables
*bkup-of-list-sets*: Private special variables
*default-namespace*: Private special variables
*err-code->sym*: Private special variables
*known-responses*: Private special variables
*known-verbs*: Private special variables
*method-names*: Private special variables
*namespace-map*: Private special variables
*oai-pmh-url*: Private special variables
*parsers*: Private special variables
*query-connectives*: Private special variables
*query-params-abbrevs*: Private special variables
*response-parsers*: Private special variables
*sample-xml-with-resumption-token*: Private special variables
*valid-errors*: Private special variables

C
code: Private conditions

E
errors: Private conditions

H
headers: Private conditions

R
rest: Private conditions

S
Slot, code: Private conditions
Slot, errors: Private conditions
Slot, headers: Private conditions
Slot, rest: Private conditions
Special Variable, *arxiv-api-url*: Private special variables
Special Variable, *bkup-of-list-sets*: Private special variables
Special Variable, *default-namespace*: Private special variables
Special Variable, *err-code->sym*: Private special variables
Special Variable, *known-responses*: Private special variables
Special Variable, *known-verbs*: Private special variables
Special Variable, *method-names*: Private special variables
Special Variable, *namespace-map*: Private special variables
Special Variable, *oai-pmh-url*: Private special variables
Special Variable, *parsers*: Private special variables
Special Variable, *query-connectives*: Private special variables
Special Variable, *query-params-abbrevs*: Private special variables
Special Variable, *response-parsers*: Private special variables
Special Variable, *sample-xml-with-resumption-token*: Private special variables
Special Variable, *valid-errors*: Private special variables

Jump to:   *  
C   E   H   R   S  

Previous: , Up: Indexes   [Contents][Index]

A.4 Data types

Jump to:   A   B   C   F   H   I   N   O   P   S  
Index Entry  Section

A
arxiv-parse-error: Private conditions

B
bad-argument: Private conditions
bad-resumption-token: Private conditions
bad-verb: Private conditions

C
cannot-disseminate-format: Private conditions
cl-arxiv-api: The cl-arxiv-api system
cl-arxiv-api: The cl-arxiv-api package
cl-arxiv-api.asd: The cl-arxiv-api/cl-arxiv-api․asd file
cl-arxiv-api.lisp: The cl-arxiv-api/cl-arxiv-api․lisp file
compose-query.lisp: The cl-arxiv-api/compose-query․lisp file
Condition, arxiv-parse-error: Private conditions
Condition, bad-argument: Private conditions
Condition, bad-resumption-token: Private conditions
Condition, bad-verb: Private conditions
Condition, cannot-disseminate-format: Private conditions
Condition, http-get-error: Private conditions
Condition, id-does-not-exist: Private conditions
Condition, no-metadata-formats: Private conditions
Condition, no-records-match: Private conditions
Condition, no-set-hierarchy: Private conditions
Condition, oai-pmh-error: Private conditions

F
File, cl-arxiv-api.asd: The cl-arxiv-api/cl-arxiv-api․asd file
File, cl-arxiv-api.lisp: The cl-arxiv-api/cl-arxiv-api․lisp file
File, compose-query.lisp: The cl-arxiv-api/compose-query․lisp file
File, oai-pmh.lisp: The cl-arxiv-api/oai-pmh․lisp file
File, package.lisp: The cl-arxiv-api/package․lisp file
File, parse-query.lisp: The cl-arxiv-api/parse-query․lisp file

H
http-get-error: Private conditions

I
id-does-not-exist: Private conditions

N
no-metadata-formats: Private conditions
no-records-match: Private conditions
no-set-hierarchy: Private conditions

O
oai-pmh-error: Private conditions
oai-pmh.lisp: The cl-arxiv-api/oai-pmh․lisp file

P
Package, cl-arxiv-api: The cl-arxiv-api package
package.lisp: The cl-arxiv-api/package․lisp file
parse-query.lisp: The cl-arxiv-api/parse-query․lisp file

S
System, cl-arxiv-api: The cl-arxiv-api system

Jump to:   A   B   C   F   H   I   N   O   P   S