Metadata-Version: 2.1
Name: ebi-ols-client
Version: 1.1.0
Summary: OLS - REST Api Client - python library
Home-page: https://github.com/Ensembl/ols-client
Author: Marc Chakiachvili
Author-email: mchakiachvili@ebi.ac.uk
License: Apache 2.0
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
Requires-Dist: inflection (==0.3.1)
Requires-Dist: coreapi (==2.3.3)
Requires-Dist: hal-codec (==1.0.2)
Requires-Dist: requests (==2.22.0)

[![Coverage Status](https://coveralls.io/repos/github/Ensembl/ols-client/badge.svg?branch=master)](https://coveralls.io/github/Ensembl/ols-client?branch=master)
[![Build Status](https://travis-ci.org/Ensembl/ols-client.svg?branch=master)](https://travis-ci.org/Ensembl/ols-client)

OLS Ontologies loader
=====================

Provide class based client for accessing OLS RestAPI from EMBL-EBI

Install
-------

with pip

```bash
    pip install ebi-ols-client
```

See: https://www.ebi.ac.uk/ols/docs/api for more information on OLS API

Main files
----------

    - ebi.ols.api.client.py: contains main classes to access OLS via HAL schema.
    - ebi.ols.api.helpers.py: data tranfer object loaded from API calls

How to use
----------

```python

from ebi.ols.api.client import OlsClient

client = OlsClient()
ontology = client.ontology('fpo')

terms = ontology.terms()
individuals = ontology.individuals()
properties = ontology.properties()

# work with all 'list' item types (terms, individuals, properties
for term in terms:
    # do whatever
    print(term)

# Direct List'like access on all list types
term = terms[1254]
individual = individuals[123]
# ...
```


Contribute
----------

Please do ! If you need to run tests locally, add to your virtual env requirements-dev.txt content.None

```bash
    pip install -r requirements.txt
    pip install -r requirements-dev.txt

    # to run tests
    nosetests --withcoverage
```


