{ "info": { "author": "Cyrus Afrasiabi, Xinghua Zhou, Chunlei Wu", "author_email": "cwu@scripps.edu", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: BSD License", "Operating System :: MacOS :: MacOS X", "Operating System :: Microsoft :: Windows", "Operating System :: OS Independent", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Scientific/Engineering :: Bio-Informatics", "Topic :: Utilities" ], "description": ".. image:: https://badge.fury.io/py/biothings-client.svg\n :target: https://pypi.python.org/pypi/biothings-client\n\n.. image:: https://img.shields.io/pypi/pyversions/biothings-client.svg\n :target: https://pypi.python.org/pypi/biothings-client\n\n.. image:: https://img.shields.io/pypi/format/biothings-client.svg\n :target: https://pypi.python.org/pypi/biothings-client\n\n.. image:: https://travis-ci.org/biothings/biothings_client.py.svg?branch=master\n :target: https://travis-ci.org/biothings/biothings_client.py\n\n.. image:: https://api.codacy.com/project/badge/Grade/0ec3b39fb487418686ca121d623ec96c\n :alt: Codacy Badge\n :target: https://app.codacy.com/app/newgene/biothings_client.py?utm_source=github.com&utm_medium=referral&utm_content=biothings/biothings_client.py&utm_campaign=Badge_Grade_Dashboard\n\nIntro\n=====\n\n*biothings_client* is an easy-to-use Python wrapper to access any Biothings.api_\n-based backend service. Currently, the following clients are available:\n\n * gene - The client for MyGene.Info_, which provides access to gene objects.\n * variant - The client MyVariant.Info_, which provides access to genetic variant objects.\n * chem - The client for MyChem.Info_, which provides access to chemical/drug objects.\n * disease - The client for MyDisease.Info_, which provides access to disease objects.\n * taxon - The client for t.biothings.io_, which provides access to taxon objects.\n\n.. _t.biothings.io: http://t.biothings.io\n.. _Biothings.api: http://biothings.io\n.. _MyGene.Info: http://mygene.info\n.. _MyVariant.Info: http://myvariant.info\n.. _MyChem.Info: http://mychem.info\n.. _MyDisease.Info: http://mydisease.info\n.. _requests: https://pypi.python.org/pypi/requests\n\nRequirements\n============\n python >=2.7 (including all python3 versions)\n\n (It may still work under python 2.6, but it's not supported any more.)\n\n requests_ (install using \"pip install requests\")\n\nOptional dependencies\n======================\n * `pandas `_ (install using \"pip install pandas\") is required for returning a list of variant objects as `DataFrame `_.\n * `requests_cache `_ (install using \"pip install requests_cache\") is required for local caching of API requests.\n\nInstallation\n=============\n\n Option 1\n ::\n\n pip install biothings_client\n\n Option 2\n download/extract the source code and run::\n\n python setup.py install\n\n Option 3\n install the latest code directly from the repository::\n\n pip install -e git+https://github.com/biothings/biothings_client.py\n\nVersion history\n===============\n\n `CHANGES.txt `_\n\nTutorial\n=========\n\n See the `quick start tutorial `_ at the `biothings_client doc page `_.\n\nDocumentation\n=============\n\n https://biothings-clientpy.readthedocs.io\n\nUsage\n=====\n\n.. code-block:: python\n\n In [1]: from biothings_client import get_client\n\n # get a client for variant objects\n\n In [2]: mv = get_client(\"variant\")\n\n In [3]: mv.getvariant(\"chr7:g.140453134T>C\")\n Out[3]: #output below is collapsed\n {\"_id\": \"chr7:g.140453134T>C\",\n \"_version\": 1,\n \"chrom\": \"7\",\n \"cadd\": {...},\n \"clinvar\": {...},\n \"cosmic\": {...},\n \"dbnsfp\": {...},\n \"dbsnp\": {...},\n \"docm\": {...},\n \"hg19\": {'end': 140453134, 'start': 140453134},\n \"mutdb\": {...},\n \"snpeff\": {...},\n \"vcf\": {\n \"alt\": \"C\",\n \"position\": \"140453134\",\n \"ref\": \"T\"\n }}\n\n # get a client for gene objects\n\n In [7]: mg = get_client(\"gene\")\n\n In [8]: mg.getgene(1017, 'name,symbol,refseq')\n Out[8]:\n {'_id': '1017',\n '_score': 21.03413,\n 'name': 'cyclin dependent kinase 2',\n 'refseq': {'genomic': ['NC_000012.12', 'NC_018923.2', 'NG_034014.1'],\n 'protein': ['NP_001277159.1',\n 'NP_001789.2',\n 'NP_439892.2',\n 'XP_011536034.1'],\n 'rna': ['NM_001290230.1', 'NM_001798.4', 'NM_052827.3', 'XM_011537732.1'],\n 'translation': [{'protein': 'NP_001789.2', 'rna': 'NM_001798.4'},\n {'protein': 'NP_439892.2', 'rna': 'NM_052827.3'},\n {'protein': 'NP_001277159.1', 'rna': 'NM_001290230.1'},\n {'protein': 'XP_011536034.1', 'rna': 'XM_011537732.1'}]},\n 'symbol': 'CDK2'}\n\n # get a client for chems/drugs\n\n In [9]: md = get_client(\"chem\")\n\n In [10]: md.getchem(\"ATBDZSAENDYQDW-UHFFFAOYSA-N\", fields=\"pubchem\")\n Out[10]:\n {'_id': 'ATBDZSAENDYQDW-UHFFFAOYSA-N',\n '_version': 1,\n 'pubchem': {'chiral_atom_count': 0,\n 'chiral_bond_count': 0,\n 'cid': 'CID4080429',\n 'complexity': 250,\n 'covalently-bonded_unit_count': 1,\n 'defined_atom_stereocenter_count': 0,\n 'defined_bond_stereocenter_count': 0,\n 'exact_mass': 184.019415,\n 'formal_charge': 0,\n 'heavy_atom_count': 12,\n 'hydrogen_bond_acceptor_count': 3,\n 'hydrogen_bond_donor_count': 1,\n 'inchi': 'InChI=1S/C8H8O3S/c1-2-7-4-3-5-8(6-7)12(9,10)11/h2-6H,1H2,(H,9,10,11)',\n 'inchi_key': 'ATBDZSAENDYQDW-UHFFFAOYSA-N',\n 'isotope_atom_count': 0,\n 'iupac': {'traditional': '3-vinylbesylic acid'},\n 'molecular_formula': 'C8H8O3S',\n 'molecular_weight': 184.21232,\n 'monoisotopic_weight': 184.019415,\n 'rotatable_bond_count': 2,\n 'smiles': {'isomeric': 'C=CC1=CC(=CC=C1)S(=O)(=O)O'},\n 'tautomers_count': 1,\n 'topological_polar_surface_area': 62.8,\n 'undefined_atom_stereocenter_count': 0,\n 'undefined_bond_stereocenter_count': 0,\n 'xlogp': 1.4}}\n\n # get a client for taxa\n\n In [11]: mt = get_client(\"taxon\")\n\n In [12]: mt.gettaxon(9606)\n Out[12]:\n {'_id': '9606',\n '_version': 1,\n 'authority': ['homo sapiens linnaeus, 1758'],\n 'common_name': 'man',\n 'genbank_common_name': 'human',\n 'has_gene': True,\n 'lineage': [9606,\n 9605,\n 207598,\n 9604,\n 314295,\n 9526,\n 314293,\n 376913,\n 9443,\n 314146,\n 1437010,\n 9347,\n 32525,\n 40674,\n 32524,\n 32523,\n 1338369,\n 8287,\n 117571,\n 117570,\n 7776,\n 7742,\n 89593,\n 7711,\n 33511,\n 33213,\n 6072,\n 33208,\n 33154,\n 2759,\n 131567,\n 1],\n 'other_names': ['humans'],\n 'parent_taxid': 9605,\n 'rank': 'species',\n 'scientific_name': 'homo sapiens',\n 'taxid': 9606,\n 'uniprot_name': 'homo sapiens'}\n\nContact\n========\nDrop us any feedback `@biothingsapi `_\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/biothings/biothings_client.py", "keywords": "biology variant gene taxon species drug annotation web service client api myvariant mygene", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "biothings-client", "package_url": "https://pypi.org/project/biothings-client/", "platform": "", "project_url": "https://pypi.org/project/biothings-client/", "project_urls": { "Homepage": "https://github.com/biothings/biothings_client.py" }, "release_url": "https://pypi.org/project/biothings-client/0.2.1/", "requires_dist": [ "requests (>=2.3.0)", "nose", "requests-cache (>=0.4.13) ; extra == 'caching'", "pandas (>=0.18.0) ; extra == 'dataframe'", "PyLD (>=0.7.2) ; extra == 'jsonld'" ], "requires_python": "", "summary": "Python Client for BioThings API services.", "version": "0.2.1" }, "last_serial": 5773658, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "0a63dc8f807f70f5c4213280efc6da1f", "sha256": "afd5a49164ce44e4d10e74c51cb77141768f7d4bf39f501ffe9ea7d548c98c9c" }, "downloads": -1, "filename": "biothings_client-0.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "0a63dc8f807f70f5c4213280efc6da1f", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 17962, "upload_time": "2017-04-24T21:24:12", "url": "https://files.pythonhosted.org/packages/ce/79/e2ddec944ce787bf80503f672632e5dbb3a9e1fd41608ab6304608b48511/biothings_client-0.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "af58b4556a9206f8e766d9d5b0c676e2", "sha256": "410ba0141274c72face2423ff9d990f752299d8bb4299b3fb80110d07906841e" }, "downloads": -1, "filename": "biothings_client-0.1.0.tar.gz", "has_sig": false, "md5_digest": "af58b4556a9206f8e766d9d5b0c676e2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13765, "upload_time": "2017-04-24T21:24:14", "url": "https://files.pythonhosted.org/packages/cb/98/81616f0c60d1c5c049dbb0d15f17b8a5c2b8949f266cefd193b3a5f077e3/biothings_client-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "2f05cd35e41eaacfaa66a77ea2320f87", "sha256": "c32ba9f964ab703d5a13d8b436f7750a3df24969689a1b09a18680775974aeba" }, "downloads": -1, "filename": "biothings_client-0.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "2f05cd35e41eaacfaa66a77ea2320f87", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 24106, "upload_time": "2017-04-26T17:01:27", "url": "https://files.pythonhosted.org/packages/79/fa/ae3b64076d18400ee933cf1c16064ea55d3cccc0bff7059695219a569f62/biothings_client-0.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "163591fe3600bb041fad5fe23a7c59c7", "sha256": "e3ef3e7d4655b6c39671242df8b4e5cb23b7893eed872d4268ade125b2bf9bc0" }, "downloads": -1, "filename": "biothings_client-0.1.1.tar.gz", "has_sig": false, "md5_digest": "163591fe3600bb041fad5fe23a7c59c7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19967, "upload_time": "2017-04-26T17:01:33", "url": "https://files.pythonhosted.org/packages/87/09/f5aba87846536a21ff7070464f13a0a32cb40c87965a9eb7460fb2be26a7/biothings_client-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "9c253a218dd1a4e66665eef50c1b00fc", "sha256": "b245dea87608ce6c4007285dadaa69f713fc4549277da5e98a8a3e73139c234a" }, "downloads": -1, "filename": "biothings_client-0.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "9c253a218dd1a4e66665eef50c1b00fc", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 36062, "upload_time": "2018-12-14T18:00:13", "url": "https://files.pythonhosted.org/packages/c3/ab/3930be24a748951d21ab639e60ad9dc6ff483b7e0acc5e399172d2df5f9a/biothings_client-0.2.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b5b37ccb7da10457978f8f63fc891a03", "sha256": "9e86d0c106eb5b175b603b52aff82330598d25d4468a5ddc3ba7c23072b1dad4" }, "downloads": -1, "filename": "biothings_client-0.2.0.tar.gz", "has_sig": false, "md5_digest": "b5b37ccb7da10457978f8f63fc891a03", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 25340, "upload_time": "2018-12-14T18:00:15", "url": "https://files.pythonhosted.org/packages/b6/60/a31a2ecfd5d7eca3a2869398f723b648e9c404dfd3435ff373715d627502/biothings_client-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "993d7774a203d04bbf2d40bba3f01778", "sha256": "8dca389165cfa2c924d6544a16c695d3e5c709f9e01607198dae29fe684ff84f" }, "downloads": -1, "filename": "biothings_client-0.2.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "993d7774a203d04bbf2d40bba3f01778", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 37424, "upload_time": "2019-09-03T03:30:51", "url": "https://files.pythonhosted.org/packages/b9/fd/4954f8ef8db9a9e3fc56cf96d5c132cd85ef483c4d41710a2586798d9d99/biothings_client-0.2.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a756f3365b55f386f4740532829645e0", "sha256": "47ec7cfebcb87b51ceeff9883c043a862efb7ca1d7bbe21fcaf0f19f26a36caf" }, "downloads": -1, "filename": "biothings_client-0.2.1.tar.gz", "has_sig": false, "md5_digest": "a756f3365b55f386f4740532829645e0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 25697, "upload_time": "2019-09-03T03:30:53", "url": "https://files.pythonhosted.org/packages/b7/12/4db95ab97bcdfa3302ea82bb7fd8b1a49ee02607911814fbe343cf0e9e28/biothings_client-0.2.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "993d7774a203d04bbf2d40bba3f01778", "sha256": "8dca389165cfa2c924d6544a16c695d3e5c709f9e01607198dae29fe684ff84f" }, "downloads": -1, "filename": "biothings_client-0.2.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "993d7774a203d04bbf2d40bba3f01778", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 37424, "upload_time": "2019-09-03T03:30:51", "url": "https://files.pythonhosted.org/packages/b9/fd/4954f8ef8db9a9e3fc56cf96d5c132cd85ef483c4d41710a2586798d9d99/biothings_client-0.2.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a756f3365b55f386f4740532829645e0", "sha256": "47ec7cfebcb87b51ceeff9883c043a862efb7ca1d7bbe21fcaf0f19f26a36caf" }, "downloads": -1, "filename": "biothings_client-0.2.1.tar.gz", "has_sig": false, "md5_digest": "a756f3365b55f386f4740532829645e0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 25697, "upload_time": "2019-09-03T03:30:53", "url": "https://files.pythonhosted.org/packages/b7/12/4db95ab97bcdfa3302ea82bb7fd8b1a49ee02607911814fbe343cf0e9e28/biothings_client-0.2.1.tar.gz" } ] }