Metadata-Version: 2.1
Name: apybiomart
Version: 0.2.6
Summary: Async pythonic interface to Biomart. 
Home-page: https://github.com/robertopreste/apybiomart
Author: Roberto Preste
Author-email: robertopreste@gmail.com
License: MIT license
Keywords: apybiomart
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/x-rst
Requires-Dist: asyncio (==3.4.3)
Requires-Dist: aiohttp (==3.5.4)
Requires-Dist: pandas (==0.24.2)

==========
apybiomart
==========


.. image:: https://img.shields.io/pypi/v/apybiomart.svg
    :target: https://pypi.python.org/pypi/apybiomart

.. image:: https://www.repostatus.org/badges/latest/wip.svg
    :alt: Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.
    :target: https://www.repostatus.org/#wip

.. image:: https://travis-ci.com/robertopreste/apybiomart.svg?branch=master
    :target: https://travis-ci.com/robertopreste/apybiomart

.. image:: https://circleci.com/gh/robertopreste/apybiomart.svg?style=svg
    :target: https://circleci.com/gh/robertopreste/apybiomart

.. image:: https://codecov.io/gh/robertopreste/apybiomart/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/robertopreste/apybiomart

.. image:: https://readthedocs.org/projects/apybiomart/badge/?version=latest
    :target: https://apybiomart.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

.. image:: https://pyup.io/repos/github/robertopreste/apybiomart/shield.svg
    :target: https://pyup.io/repos/github/robertopreste/apybiomart/
    :alt: Updates

.. image:: https://pyup.io/repos/github/robertopreste/apybiomart/python-3-shield.svg
    :target: https://pyup.io/repos/github/robertopreste/apybiomart/
    :alt: Python 3

.. image:: https://pepy.tech/badge/apybiomart
    :target: https://pepy.tech/project/apybiomart
    :alt: Downloads


Async pythonic interface to BioMart.


* Free software: MIT license
* Documentation: https://apybiomart.readthedocs.io.
* GitHub repo: https://github.com/robertopreste/apybiomart


Features
--------

apybiomart is a Python module which provides a simple asynchronous interface to Ensembl BioMart_. Users can exploit the async interface to schedule multiple queries using all the commodities offered by Python's asyncio library.

Depending on specific needs, apybiomart offers different entry points:

* an asynchronous ``aquery()`` function, to schedule multiple queries in the same event loop;
* a synchronous ``query()`` function, which can be used for exploratory queries, executed in real time;
* a set of synchronous ``list_*()`` functions, which can be used to retrieve the list of available marts, datasets for a specific mart, attributes and filters for a specific dataset.

Please refer to the Usage_ section of the documentation for further information.

Background
==========

apybiomart was originally born as a fork of the great pybiomart_ package.

I was working on a project that employed a series of async calls to several online resources, but I couldn't manage to perform asynchronous calls to BioMart using that package, so I decided to modify it to better suit my needs. However, it gradually evolved into a very different thing: the original implementation was rewritten and the structure of the package changed a bit, in a way that I found most useful for my purpose.

This said, all the credits go to jrderuiter_, which created the original pybiomart_ package.

Installation
------------

**apybiomart only supports Python 3**, and can be installed using pip::

    pip install apybiomart

Please refer to the Installation_ section of the documentation for further information.

Credits
-------

This package was created with Cookiecutter_ and the `cc-pypackage`_ project template.

.. _BioMart: https://www.ensembl.org/biomart/martview
.. _Usage: https://apybiomart.readthedocs.io/en/latest/usage.html
.. _pybiomart: https://github.com/jrderuiter/pybiomart
.. _jrderuiter: https://github.com/jrderuiter
.. _Installation: https://apybiomart.readthedocs.io/en/latest/installation.html
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`cc-pypackage`: https://github.com/robertopreste/cc-pypackage


=======
History
=======

0.1.0 (2019-03-26)
------------------

* First development release.

0.1.1 (2019-03-27)
==================

* Requests are converted to async calls;
* Code style is clean and Python 3 compatible.

0.1.2 (2019-03-27)
==================

* Add basic tests.


0.2.0 (2019-03-31)
------------------

* New version with different organisation of classes and functions;
* Sync ``query`` and async ``aquery`` functions to query Biomart;
* Sync ``list_*`` functions to retrieve available ``marts``, ``datasets``, ``filters`` and ``attributes``.

0.2.1 (2019-04-01)
==================

* Add tests.

0.2.2 (2019-04-01)
==================

* Basic functions working and tested;
* Fix documentation;
* Update requirements.

0.2.3 (2019-04-02)
==================

* Update requirements;
* Fix type hints for query functions;
* Reorganise query classes into a single class;
* Update documentation.

0.2.4 (2019-04-04)
==================

* Fix type hints;
* Fix docstrings in classes;
* Add docstrings to main entry points.

0.2.5 (2019-04-09)
==================

* Fix test files with new BioMart versions;
* Add script to create test files automatically.

0.2.6 (2019-04-29)
==================

* Update test files;
* Fix and update documentation.


