Epost

entrezpy.epost.eposter.Eposter implements the E-Utility EPost [0]. Eposter queries post UIDs onto the Entrez History server and return the corresponding WebEnv and query_key. If an exisitng WebEnv is passed as parameter, the posted UIDs will be added to this WebEnv by increasing its query_key.

Usage

import entrezpy.epost.eposter

e = entrezpy.epost.eposter.Eposter(tool,
                                   email,
                                   apikey=None,
                                   apikey_var=None,
                                   threads=None,
                                   qid=None)

analyzer = e.inquire({'db' : 'pubmed','id' : [12466850])
print(analyzer.get_result().get_link_parameters())

Eposter

entrezpy.epost.eposter.Eposter

param str tool:string with no internal spaces uniquely identifying the software producing the request, i.e. your tool/pipeline.
param str email:
 a complete and valid e-mail address of the software developer and not that of a third-party end user. entrezpy is a library, not a tool.
param str apikey:
 NCBI API key
param str apikey_var:
 NCBI API key
param int threads:
 number of threads
param str qid:Unique Epost query id. Will be generated if not given.

Supported E-Utility parameter

Parameters are passed as dictionary to entrezpy.epost.eposter.Eposter.inquire() and are expected to be the same as those for the E-Utility [0]. For example:

{{'db' : 'pubmed','id' : [11237011,12466850]}

Parameter   Type
E-Utility    
db str
id list
WebEnv string

Result

Instance of entrezpy.esearch.esearch_result.EsearchResult.

If retmax = 0 or retmode = count no UIDs are returned. If usehistory is True (default), WebEnv and query_key for the request is returned.

  • count : number of found UIDs for request
  • retmax : number of UIDs to retrieve
  • retstart : number of first UID to retrieve
  • uids : list of fetched UIDs

Approach

  1. Parameters are checked and the request size is configured.
  2. UIDs are posted to NCBI.
  3. If no errors were encountered, returns the analyzer with the result storing the WebEnv and query_key for the UIDs.