querynator


Namequerynator JSON
Version 0.4.1 PyPI version JSON
download
home_pagehttps://github.com/qbic-pipelines/querynator
SummaryPython package to query cancer variant databases
upload_time2023-06-13 14:19:53
maintainer
docs_urlNone
authorSusanne Jodoin, Mark Polster
requires_python>=3.8,<3.11
licenseMIT license
keywords querynator
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ==========
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"
}
        
Elapsed time: 0.08666s