Metadata-Version: 2.1
Name: easy-entrez
Version: 0.2.0
Summary: Python REST API for Entrez E-Utilities: stateless, easy to use, reliable.
Home-page: https://github.com/krassowski/easy-entrez
Author: Michal Krassowski
Author-email: krassowski.michal+pypi@gmail.com
License: MIT
Description: easy-entrez
        ===========
        
        |Documentation Status|
        
        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
        
        .. code:: python
        
           from easy_entrez import EntrezAPI
        
           entrez_api = EntrezAPI(
               'your-tool-name',
               'e@mail.com',
               # 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 <./Demo.ipynb>`__.
        
        Installation
        ~~~~~~~~~~~~
        
        Requires Python 3.6+. Install with:
        
        .. code:: bash
        
           pip install easy-entrez
        
        If you wish to enable (optional, tqdm-based) progress bars use:
        
        .. code:: bash
        
           pip install easy-entrez[with_progress_bars]
        
        Alternatives:
        ~~~~~~~~~~~~~
        
        -  `biopython.Entrez <https://biopython.org/docs/1.74/api/Bio.Entrez.html>`__
        -  entrezpy
        
        .. |Documentation Status| image:: https://readthedocs.org/projects/easy-entrez/badge/?version=latest
           :target: https://easy-entrez.readthedocs.io/en/latest/?badge=latest
        
Keywords: entrez,pubmed,e-utilities,ncbi,rest,api
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Utilities
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Provides-Extra: with_progress_bars
