Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chembl/chembl_webresource_client
Official Python client for accessing ChEMBL API
https://github.com/chembl/chembl_webresource_client
chembl cheminformatics chemistry chemoinformatics python rest rest-client
Last synced: 3 months ago
JSON representation
Official Python client for accessing ChEMBL API
- Host: GitHub
- URL: https://github.com/chembl/chembl_webresource_client
- Owner: chembl
- License: other
- Created: 2014-04-10T15:00:44.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-02-26T15:44:57.000Z (9 months ago)
- Last Synced: 2024-07-22T05:05:59.240Z (4 months ago)
- Topics: chembl, cheminformatics, chemistry, chemoinformatics, python, rest, rest-client
- Language: Python
- Homepage: https://www.ebi.ac.uk/chembl/api/data/docs
- Size: 2.17 MB
- Stars: 359
- Watchers: 32
- Forks: 95
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- top-life-sciences - **chembl/chembl_webresource_client** - client`<br><img src='https://github.com/HubTou/topgh/blob/main/icons/gstars.png'> 356 <img src='https://github.com/HubTou/topgh/blob/main/icons/forks.png'> 95 <img src='https://github.com/HubTou/topgh/blob/main/icons/code.png'> Python <img src='https://github.com/HubTou/topgh/blob/main/icons/license.png'> Other <img src='https://github.com/HubTou/topgh/blob/main/icons/last.png'> 2024-02-26 15:44:57 | (Ranked by starred repositories)
README
[](https://pypi.python.org/pypi/chembl_webresource_client/)
[](https://pypi.python.org/pypi/chembl_webresource_client/)
[](https://pypi.python.org/pypi/chembl_webresource_client/)
[](http://beta.mybinder.org/v2/gh/chembl/chembl_webresource_client/master?filepath=demo_wrc.ipynb)
# ChEMBL webresource client
This is the only official Python client library developed and supported by ChEMBL group.
The library helps accessing ChEMBL data and cheminformatics tools from Python. You don't need to know how to write SQL. You don't need to know how to interact with REST APIs. You don't need to compile or install any cheminformatics frameworks. Results are cached.
The client handles interaction with the HTTPS protocol and caches all results in the local file system for faster retrieval. Abstracting away all network-related tasks, the client provides the end user with a convenient interface, giving the impression of working with a local resource. Design is based on the Django QuerySet interface. The client also implements lazy evaluation of results, which means it will only evaluate a request for data when a value is required. This approach reduces number of network requests and increases performance.
## Installation
```bash
pip install chembl_webresource_client
```
## Live Jupyter notebook with examples
[Click here](http://beta.mybinder.org/v2/gh/chembl/chembl_webresource_client/master?filepath=demo_wrc.ipynb)
## Available filters
The design of the client is based on Django QuerySet (https://docs.djangoproject.com/en/1.11/ref/models/querysets) and most important lookup types are supported. These are:
- exact
- iexact
- contains
- icontains
- in
- gt
- gte
- lt
- lte
- startswith
- istartswith
- endswith
- iendswith
- range
- isnull
- regex
- iregex
- search
## Only operator
`only` is a special method allowing to limit the results to a selected set of fields. only should take a single argument: a list of fields that should be included in result. Specified fields have to exists in the endpoint against which only is executed. Using only will usually make an API call faster because less information returned will save bandwidth. The API logic will also check if any SQL joins are necessary to return the specified field and exclude unnecessary joins with critically improves performance.
Please note that only has one limitation: a list of fields will ignore nested fields i.e. calling only(['molecule_properties__alogp']) is equivalent to only(['molecule_properties']).
For many 2 many relationships only will not make any SQL join optimisation.
## Settings
In order to use settings you need to import them before using the client:
```python
from chembl_webresource_client.settings import Settings
```
Settings object is a singleton that exposes Instance method, for example:
```python
Settings.Instance().TIMEOUT = 10
```
Most important options:
CACHING: should results be cached locally (default is True)
CACHE_EXPIRE: cache expiry time in seconds (default 24 hours)
CACHE_NAME: name of the .sqlite file with cache
TOTAL_RETRIES: number of total retires per HTTP request (default is 3)
CONCURRENT_SIZE: total number of concurrent requests (default is 50)
FAST_SAVE: Speedup cache saving up to 50 times but with possibility of data loss (default is True)
## Citing
https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4489243/