easy-entrez 0.2.0

Python REST API for Entrez E-Utilities: stateless, easy to use, reliable.

Python REST API for Entrez E-Utilities, aiming to be easy to use and reliable.

While other packages attempt to use stateful extensions (queries with history) which is error-prone and led to misleading results, this implementation: - avoids the problem altogether by not using such stateful API, - makes common tasks easy thanks to Pythonic API, - is typed and integrates well with mypy

Stats: Beta

from easy_entrez import EntrezAPI

entrez_api = EntrezAPI(
    'your-tool-name',
    '[e-mail]',
    # optional
    return_type='json'
)

# find up to 10 000 results for cancer in human
result = entrez_api.search('cancer AND human[organism]', max_results=10_000)

# data will be populated with JSON or XML (depending on the `return_type` value)
result.data

See more in the Demo notebook.

Installation

Requires Python 3.6+. Install with:

pip install easy-entrez

If you wish to enable (optional, tqdm-based) progress bars use:

pip install easy-entrez[with_progress_bars]

Alternatives:

• biopython.Entrez

• entrezpy