==========
querynator
==========
.. image:: https://img.shields.io/pypi/v/querynator.svg
:target: https://pypi.python.org/pypi/querynator
.. image:: https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fqbic-pipelines%2Fquerynator%2Fbadge%3Fref%3Dmaster&style=flat-square
:target: https://actions-badge.atrox.dev/qbic-pipelines/querynator/goto?ref=master
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
.. image:: https://img.shields.io/badge/code%20style-prettier-ff69b4.svg
:target: https://github.com/prettier/prettier
.. image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336
:target: https://pycqa.github.io/isort
.. image:: https://readthedocs.org/projects/querynator/badge/?version=latest
:target: https://querynator.readthedocs.io/en/latest/?version=latest
:alt: Documentation Status
Python package to query cancer variant databases
* Free software: MIT license
* Documentation: https://querynator.readthedocs.io.
Features
--------
* Command-line tool to query the `cancergenomeinterpreter <https://www.cancergenomeinterpreter.org/home>`_ via its REST API
* Command-line tool to query the `Clinical Interpretation of Variants in Cancer (CIViC) Knowledgebase <https://civicdb.org/>`_ using `CIViCpy <https://docs.civicpy.org/en/latest/>`_
Credits
-------
This package uses the cancergenomeinterpreter.org REST API for data retrieval.
* Muiños, F., Martínez-Jiménez, F., Pich, O. et al. In silico saturation mutagenesis of cancer genes. Nature 596, 428–432 (2021). https://doi.org/10.1038/s41586-021-03771-1
* Tamborero, D. Rubio-Perez, C., Deu-Pons, J. et al., Cancer Genome Interpreter annotates the biological and clinical relevance of tumor alterations. Genome Medicine 10, (2018). doi: https://doi.org/10.1101/140475
This package uses the CIViCpy package for data retrieval from the CIViC database.
* Wagner, Alex H., et al. "CIViCpy: a python software development and analysis toolkit for the CIViC knowledgebase." JCO Clinical Cancer Informatics 4 (2020): 245-253. doi: https://doi.org/10.1200/CCI.19.00127
* Griffith, M., Spies, N., Krysiak, K. et al. CIViC is a community knowledgebase for expert crowdsourcing the clinical interpretation of variants in cancer. Nat Genet 49, 170–174 (2017). doi: https://doi.org/10.1038/ng.3774
This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
Changelog
============
0.4.1 - Stormy Saturn (2023-06-13)
---------------------------------------------
**Added**
**Fixed**
* Bug fixes to include all evidence of CIViC
**Dependencies**
**Deprecated**
0.4.0 - Stormy Saturn (2023-05-31)
---------------------------------------------
**Added**
**Fixed**
* Fixed functionality for new CGI file structure
* Fixed case when CIViC has no hits
**Dependencies**
**Deprecated**
0.3.3 - Iron Mercury (2023-05-05)
---------------------------------------------
**Added**
**Fixed**
* Fixed API docs
**Dependencies**
**Deprecated**
0.3.2 - Iron Mercury (2023-05-05)
---------------------------------------------
**Added**
**Fixed**
* Fixed version bump
**Dependencies**
**Deprecated**
0.3.1 - Iron Mercury (2023-05-05)
---------------------------------------------
**Added**
**Fixed**
* Fixed import of site-packages in setup.py
**Dependencies**
**Deprecated**
0.3.0 - Iron Mercury (2023-05-04)
---------------------------------------------
**Added**
* Added functionality to combine the results of the Knowledgebases in an HTML report
* Added possibility to have non-numerical chromosome columns in the input vcf
* Added deletion of CGI jobs from CGI Server after completion
**Fixed**
**Dependencies**
**Deprecated**
0.2.2 - Sour Venus (2023-03-16)
---------------------------------------------
**Added**
* Optional VEP annotation based filtering
* Additional metadata
* Usage of pyVCF3 to read vcf files
* Querynator ID added for filtered vcf files
* All possible reference genomes for CIViC
**Fixed**
**Dependencies**
**Deprecated**
* Usage of pysam to read vcf files
0.2.1 - Sour Venus (2023-02-16)
---------------------------------------------
**Added**
**Fixed**
* Rendering API docs
**Dependencies**
**Deprecated**
0.2.0 - Sour Venus (2023-02-07)
---------------------------------------------
**Added**
* Added functionality to query the Clinical Interpretation of Variants in Cancer (CIViC) Knowledgebase
* Added possibility to query bgzipped files
**Fixed**
**Dependencies**
**Deprecated**
0.1.3 - Diamond Neptune (2022-11-21)
---------------------------------------------
**Added**
**Fixed**
* Fix including module
**Dependencies**
**Deprecated**
0.1.2 - Diamond Neptune (2022-11-18)
---------------------------------------------
**Added**
**Fixed**
* Fix installing requirements
**Dependencies**
**Deprecated**
0.1.1 - Methane Titan (2022-11-18)
---------------------------------------------
**Added**
**Fixed**
* Github Actions publishing to PyPI
* Fix docs
**Dependencies**
**Deprecated**
0.1.0 - initial release (2022-11-18)
---------------------------------------------
**Added**
* First release on PyPI
* Created the package template with cookiecutter
* Functions to query the cancergenomeinterpreter REST API
**Fixed**
**Dependencies**
**Deprecated**
Raw data
{
"_id": null,
"home_page": "https://github.com/qbic-pipelines/querynator",
"name": "querynator",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<3.11",
"maintainer_email": "",
"keywords": "querynator",
"author": "Susanne Jodoin, Mark Polster",
"author_email": "susanne.jodoin@qbic.uni-tuebingen.de, mark.polster@uni-tuebingen.de",
"download_url": "https://files.pythonhosted.org/packages/82/3e/c4bc3a0e9423415ea9ee5234098211671f00e9fbac44cbcfc7ba45a3a271/querynator-0.4.1.tar.gz",
"platform": null,
"description": "==========\nquerynator\n==========\n\n\n.. image:: https://img.shields.io/pypi/v/querynator.svg\n :target: https://pypi.python.org/pypi/querynator\n\n.. image:: https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fqbic-pipelines%2Fquerynator%2Fbadge%3Fref%3Dmaster&style=flat-square\n :target: https://actions-badge.atrox.dev/qbic-pipelines/querynator/goto?ref=master\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n\n.. image:: https://img.shields.io/badge/code%20style-prettier-ff69b4.svg\n :target: https://github.com/prettier/prettier\n\n.. image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336\n :target: https://pycqa.github.io/isort\n\n.. image:: https://readthedocs.org/projects/querynator/badge/?version=latest\n :target: https://querynator.readthedocs.io/en/latest/?version=latest\n :alt: Documentation Status\n\n\n\n\nPython package to query cancer variant databases\n\n\n* Free software: MIT license\n* Documentation: https://querynator.readthedocs.io.\n\n\nFeatures\n--------\n\n* Command-line tool to query the `cancergenomeinterpreter <https://www.cancergenomeinterpreter.org/home>`_ via its REST API\n* Command-line tool to query the `Clinical Interpretation of Variants in Cancer (CIViC) Knowledgebase <https://civicdb.org/>`_ using `CIViCpy <https://docs.civicpy.org/en/latest/>`_\n\nCredits\n-------\n\nThis package uses the cancergenomeinterpreter.org REST API for data retrieval.\n\n* Mui\u00f1os, F., Mart\u00ednez-Jim\u00e9nez, F., Pich, O. et al. In silico saturation mutagenesis of cancer genes. Nature 596, 428\u2013432 (2021). https://doi.org/10.1038/s41586-021-03771-1\n* Tamborero, D. Rubio-Perez, C., Deu-Pons, J. et al., Cancer Genome Interpreter annotates the biological and clinical relevance of tumor alterations. Genome Medicine 10, (2018). doi: https://doi.org/10.1101/140475\n\nThis package uses the CIViCpy package for data retrieval from the CIViC database.\n\n* Wagner, Alex H., et al. \"CIViCpy: a python software development and analysis toolkit for the CIViC knowledgebase.\" JCO Clinical Cancer Informatics 4 (2020): 245-253. doi: https://doi.org/10.1200/CCI.19.00127\n* Griffith, M., Spies, N., Krysiak, K. et al. CIViC is a community knowledgebase for expert crowdsourcing the clinical interpretation of variants in cancer. Nat Genet 49, 170\u2013174 (2017). doi: https://doi.org/10.1038/ng.3774\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n\n\n\n\nChangelog\n============\n\n0.4.1 - Stormy Saturn (2023-06-13)\n---------------------------------------------\n\n**Added**\n\n**Fixed**\n\n* Bug fixes to include all evidence of CIViC\n\n**Dependencies**\n\n**Deprecated**\n\n0.4.0 - Stormy Saturn (2023-05-31)\n---------------------------------------------\n\n**Added**\n\n**Fixed**\n\n* Fixed functionality for new CGI file structure\n* Fixed case when CIViC has no hits\n\n**Dependencies**\n\n**Deprecated**\n\n0.3.3 - Iron Mercury (2023-05-05)\n---------------------------------------------\n\n**Added**\n\n**Fixed**\n\n* Fixed API docs\n\n**Dependencies**\n\n**Deprecated**\n\n0.3.2 - Iron Mercury (2023-05-05)\n---------------------------------------------\n\n**Added**\n\n**Fixed**\n\n* Fixed version bump\n\n**Dependencies**\n\n**Deprecated**\n\n0.3.1 - Iron Mercury (2023-05-05)\n---------------------------------------------\n\n**Added**\n\n**Fixed**\n\n* Fixed import of site-packages in setup.py\n\n**Dependencies**\n\n**Deprecated**\n\n0.3.0 - Iron Mercury (2023-05-04)\n---------------------------------------------\n\n**Added**\n\n* Added functionality to combine the results of the Knowledgebases in an HTML report\n* Added possibility to have non-numerical chromosome columns in the input vcf\n* Added deletion of CGI jobs from CGI Server after completion\n\n**Fixed**\n\n**Dependencies**\n\n**Deprecated**\n\n0.2.2 - Sour Venus (2023-03-16)\n---------------------------------------------\n\n**Added**\n\n* Optional VEP annotation based filtering\n* Additional metadata\n* Usage of pyVCF3 to read vcf files\n* Querynator ID added for filtered vcf files\n* All possible reference genomes for CIViC\n\n**Fixed**\n\n**Dependencies**\n\n**Deprecated**\n\n* Usage of pysam to read vcf files\n\n\n0.2.1 - Sour Venus (2023-02-16)\n---------------------------------------------\n\n**Added**\n\n**Fixed**\n\n* Rendering API docs\n\n**Dependencies**\n\n**Deprecated**\n\n0.2.0 - Sour Venus (2023-02-07)\n---------------------------------------------\n\n**Added**\n\n* Added functionality to query the Clinical Interpretation of Variants in Cancer (CIViC) Knowledgebase\n* Added possibility to query bgzipped files\n\n**Fixed**\n\n**Dependencies**\n\n**Deprecated**\n\n0.1.3 - Diamond Neptune (2022-11-21)\n---------------------------------------------\n\n**Added**\n\n**Fixed**\n\n* Fix including module\n\n**Dependencies**\n\n**Deprecated**\n\n0.1.2 - Diamond Neptune (2022-11-18)\n---------------------------------------------\n\n**Added**\n\n**Fixed**\n\n* Fix installing requirements\n\n**Dependencies**\n\n**Deprecated**\n\n0.1.1 - Methane Titan (2022-11-18)\n---------------------------------------------\n\n**Added**\n\n**Fixed**\n\n* Github Actions publishing to PyPI\n* Fix docs\n\n**Dependencies**\n\n**Deprecated**\n\n\n0.1.0 - initial release (2022-11-18)\n---------------------------------------------\n\n**Added**\n\n* First release on PyPI\n* Created the package template with cookiecutter\n* Functions to query the cancergenomeinterpreter REST API\n\n**Fixed**\n\n**Dependencies**\n\n**Deprecated**\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "Python package to query cancer variant databases",
"version": "0.4.1",
"project_urls": {
"Homepage": "https://github.com/qbic-pipelines/querynator"
},
"split_keywords": [
"querynator"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5a7df400d29a7982389372b8166171a866d4352615ba4d5570f1962347253522",
"md5": "7cf763f069c5efb4772b1e4fc4d45e58",
"sha256": "8223751118ceb2c1fb27e5794cd893ee34d5eb9d21d8ccbb77e2d6f74c29ac6e"
},
"downloads": -1,
"filename": "querynator-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7cf763f069c5efb4772b1e4fc4d45e58",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<3.11",
"size": 43644,
"upload_time": "2023-06-13T14:19:51",
"upload_time_iso_8601": "2023-06-13T14:19:51.399835Z",
"url": "https://files.pythonhosted.org/packages/5a/7d/f400d29a7982389372b8166171a866d4352615ba4d5570f1962347253522/querynator-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "823ec4bc3a0e9423415ea9ee5234098211671f00e9fbac44cbcfc7ba45a3a271",
"md5": "0e5d5142573578d11a4ce78be27ac57a",
"sha256": "394a48c700ce6c8940cf134ffe0cf1f58f2418fcc8fffef4509a9a08567bda1c"
},
"downloads": -1,
"filename": "querynator-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "0e5d5142573578d11a4ce78be27ac57a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<3.11",
"size": 46254,
"upload_time": "2023-06-13T14:19:53",
"upload_time_iso_8601": "2023-06-13T14:19:53.866150Z",
"url": "https://files.pythonhosted.org/packages/82/3e/c4bc3a0e9423415ea9ee5234098211671f00e9fbac44cbcfc7ba45a3a271/querynator-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-13 14:19:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "qbic-pipelines",
"github_project": "querynator",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "querynator"
}