Metadata-Version: 2.1
Name: apyhgnc
Version: 0.2.0
Summary: Async pythonic interface to HGNC.
Home-page: https://github.com/robertopreste/apyhgnc
Author: Roberto Preste
Author-email: robertopreste@gmail.com
License: MIT license
Keywords: apyhgnc
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: requests (==2.21.0)
Requires-Dist: pandas (==0.24.2)
Requires-Dist: asyncio (==3.4.3)
Requires-Dist: aiohttp (==3.5.4)

=======
apyhgnc
=======


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

.. 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/apyhgnc.svg?branch=master
    :target: https://travis-ci.com/robertopreste/apyhgnc

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

.. image:: https://app.codeship.com/projects/c832f1e0-44fe-0137-a826-5a0258e749b3/status?branch=master
        :target: https://app.codeship.com/projects/337097
        :alt: Codeship Status for robertopreste/apyhgnc

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

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


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

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



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


Async pythonic interface to HGNC.


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


Features
--------

This Python package allows to retrieve entries from HGNC_ using synchronous or asynchronous calls.

* Return searchable fields and stored fields separately using the ``info()`` function (or the lower-level ``Info`` class).
* Return all entries of interest limiting results only to hgnc_id, symbol and score fields using the ``search()`` function for synchronous calls or the ``asearch()`` function for asynchronous calls (or the lower-level ``Search`` class).
* Return entries according to the given searchable fields, returning all the available stored fields using the ``fetch()`` function for synchronous calls or the ``afetch()`` function for asynchronous calls (or the lower-level ``Fetch`` class).

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

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

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

    pip install apyhgnc

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.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`cc-pypackage`: https://github.com/robertopreste/cc-pypackage
.. _HGNC: https://www.genenames.org
.. _Usage: https://apyhgnc.readthedocs.io/en/latest/usage.html
.. _Installation: https://apyhgnc.readthedocs.io/en/latest/installation.html


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

0.1.0 (2019-04-10)
------------------

* First release.

0.1.1 (2019-04-18)
==================

* Add basic classes Info, Search and Fetch;
* Add tests for Info, Search and Fetch.

0.1.2 (2019-04-19)
==================

* Refactor code and fix tests.

0.1.3 (2019-04-21)
==================

* Update tests;
* Fix importing issue;
* Update requirements.

0.2.0 (2019-04-24)
------------------

* Setup proper async calls (``afetch`` and ``asearch``);
* Update tests;
* Fix documentation.



