====================================================
MEMOTE - the genome-scale metabolic model test suite
====================================================
.. image:: https://img.shields.io/pypi/v/memote.svg
:target: https://pypi.org/project/memote/
:alt: Current PyPI Version
.. image:: https://img.shields.io/pypi/pyversions/memote.svg
:target: https://pypi.org/project/memote/
:alt: Supported Python Versions
.. image:: https://img.shields.io/pypi/l/memote.svg
:target: https://www.apache.org/licenses/LICENSE-2.0
:alt: Apache Software License Version 2.0
.. image:: https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg
:target: .github/CODE_OF_CONDUCT.md
:alt: Code of Conduct
.. image:: https://github.com/opencobra/memote/workflows/CI-CD/badge.svg
:target: https://github.com/opencobra/memote/workflows/CI-CD
:alt: GitHub Actions
.. image:: https://codecov.io/gh/opencobra/memote/branch/master/graph/badge.svg
:target: https://codecov.io/gh/opencobra/memote
:alt: Codecov
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/ambv/black
:alt: Code Style Black
.. image:: https://readthedocs.org/projects/memote/badge/?version=latest
:target: https://memote.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://badges.gitter.im/opencobra/memote.svg
:target: https://gitter.im/opencobra/memote
:alt: Gitter
.. summary-start
Our goal in promoting this tool is to achieve two major shifts in the metabolic
model building community:
1. Models should be version-controlled such that changes can be tracked and if
necessary reverted. Ideally, they should be available through a public
repository such as GitHub that will allow other researchers to inspect,
share, and contribute to the model.
2. Models should, for the benefit of the community and for research gain, live
up to certain standards and minimal functionality.
The `MEMOTE` tool therefore performs four subfunctions:
1. Create a skeleton git repository for the model.
2. Run the current model through a `test suite that represents the community
standard`_.
3. Generate an informative report which details the results of the test suite in
a visually appealing manner.
4. (Re-)compute test statistics for an existing version controlled history of
a metabolic model.
And in order to make this process as easy as possible the generated repository
can easily be integrated with continuous integration testing providers such as
Travis CI, which means that anytime you push a model change to GitHub, the test
suite will be run automatically and a report will be available for you to look
at via GitHub pages for your repository.
.. _test suite that represents the community standard:
https://github.com/opencobra/memote/wiki/Test-Catalog
.. summary-end
* Documentation: https://memote.readthedocs.io/.
Installation
============
Before installing `MEMOTE`, please make sure that you have correctly installed the
latest version of `git <https://git-scm.com/>`_.
Moreover, we highly recommend creating a Python virtualenv for your model
testing purposes.
To install `MEMOTE`, run this command in your terminal:
.. code-block:: console
$ pip install memote
This is the preferred method to install `MEMOTE`, as it will always install the
most recent stable release.
.. who-start
Contact
=======
For comments and questions get in touch via
* our `gitter chatroom <https://gitter.im/opencobra/memote>`_
* or open a `GitHub issue <https://github.com/opencobra/memote/issues/new>`_.
Are you excited about this project? Consider `contributing
<https://memote.readthedocs.io/en/latest/contributing.html>`_ by adding novel
tests, reporting or fixing bugs, and generally help us make this a better
software for everyone.
Copyright
=========
* Copyright (c) 2017, Novo Nordisk Foundation Center for Biosustainability,
Technical University of Denmark.
* Free software: `Apache Software License 2.0 <LICENSE>`_
.. who-end
Credits
=======
This package was created with Cookiecutter_ and the
`audreyr/cookiecutter-pypackage`_ project template.
`Memote` relies on click_ for the command line interface, pytest_ for unit
and model tests, gitpython_ for interacting with git repositories,
pandas_ for tabular datastructures and data input, jinja2_ for interacting
with HTML templates, cobrapy_ for analysing genome-scale metabolic
models, python_libsbml_ for reading and writing Systems Biology Markup
Language (SBML_), ruamel_ for handling YAML generation, travispy_ and
travis-encrypt_ for interacting with Travis CI, pygithub_ for access to the
Github API, sympy_ for matrix calculations, sqlalchemy_ for managing
``history`` results, numpydoc_ for beautifully formatted doc strings using
sphinx_, pylru_ for caching, goodtables_ for validation of tabular data,
depinfo_ for pretty printing our dependencies, six_ and future_ for backward
and forward compatibility.
The Memote Report App user interface is built with `Angular 5`_,
`Angular Flex-Layout`_, and `Angular Material`_. We rely on Taucharts_ for plotting
results.
The initial development of `MEMOTE` has received funding from:
.. image:: https://upload.wikimedia.org/wikipedia/commons/d/d5/Novo_nordisk_foundation_Logo.png
:target: http://novonordiskfonden.dk/en
.. image:: https://innovationsfonden.dk/sites/all/themes/novigo/logo.png
:target: https://innovationsfonden.dk/da
.. image:: http://dd-decaf.eu/images/decaf-logo-md.svg
:target: http://dd-decaf.eu/
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`:
https://github.com/audreyr/cookiecutter-pypackage
.. _click: http://click.pocoo.org/5/
.. _pytest: https://docs.pytest.org/en/latest/
.. _gitpython: https://github.com/gitpython-developers/GitPython
.. _pandas: https://pypi.org/project/pandas/
.. _jinja2: http://jinja.pocoo.org/
.. _cobrapy: https://github.com/opencobra/cobrapy
.. _python_libsbml: https://pypi.org/project/python-libsbml/
.. _SBML: http://sbml.org/Main_Page
.. _ruamel: https://pypi.org/project/ruamel.yaml/
.. _travispy: https://pypi.org/project/TravisPy/
.. _travis-encrypt: https://pypi.org/project/travis-encrypt/
.. _pygithub: https://github.com/PyGithub/PyGithub
.. _sympy: http://www.sympy.org/en/index.html
.. _sqlalchemy: http://www.sqlalchemy.org/
.. _numpydoc: https://github.com/numpy/numpydoc
.. _sphinx: http://www.sphinx-doc.org/en/stable/
.. _pylru: https://pypi.org/project/pylru/
.. _goodtables: https://github.com/frictionlessdata/goodtables-py
.. _depinfo: https://pypi.org/project/depinfo/
.. _six: https://pypi.org/project/six/
.. _future: https://pypi.org/project/future/
.. _Angular 5: https://angular.io/
.. _Angular Flex-Layout: https://github.com/angular/flex-layout
.. _Angular Material: https://material.angular.io/
.. _Taucharts: https://taucharts.com/
Raw data
{
"_id": null,
"home_page": "https://github.com/opencobra/memote",
"name": "memote",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "memote,metabolic model,constraint-based,COBRA,test suite,quality control,quality assurance",
"author": "Moritz E. Beber",
"author_email": "midnighter@posteo.net",
"download_url": "https://files.pythonhosted.org/packages/ca/e4/95dc615da20f333f94b130b156f9f72567d2ee77ffbdf92f79c6ac816dad/memote-0.17.0.tar.gz",
"platform": null,
"description": "====================================================\nMEMOTE - the genome-scale metabolic model test suite\n====================================================\n\n.. image:: https://img.shields.io/pypi/v/memote.svg\n :target: https://pypi.org/project/memote/\n :alt: Current PyPI Version\n\n.. image:: https://img.shields.io/pypi/pyversions/memote.svg\n :target: https://pypi.org/project/memote/\n :alt: Supported Python Versions\n\n.. image:: https://img.shields.io/pypi/l/memote.svg\n :target: https://www.apache.org/licenses/LICENSE-2.0\n :alt: Apache Software License Version 2.0\n\n.. image:: https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg\n :target: .github/CODE_OF_CONDUCT.md\n :alt: Code of Conduct\n\n.. image:: https://github.com/opencobra/memote/workflows/CI-CD/badge.svg\n :target: https://github.com/opencobra/memote/workflows/CI-CD\n :alt: GitHub Actions\n\n.. image:: https://codecov.io/gh/opencobra/memote/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/opencobra/memote\n :alt: Codecov\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/ambv/black\n :alt: Code Style Black\n\n.. image:: https://readthedocs.org/projects/memote/badge/?version=latest\n :target: https://memote.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. image:: https://badges.gitter.im/opencobra/memote.svg\n :target: https://gitter.im/opencobra/memote\n :alt: Gitter\n\n.. summary-start\n\nOur goal in promoting this tool is to achieve two major shifts in the metabolic\nmodel building community:\n\n1. Models should be version-controlled such that changes can be tracked and if\n necessary reverted. Ideally, they should be available through a public\n repository such as GitHub that will allow other researchers to inspect,\n share, and contribute to the model.\n2. Models should, for the benefit of the community and for research gain, live\n up to certain standards and minimal functionality.\n\nThe `MEMOTE` tool therefore performs four subfunctions:\n\n1. Create a skeleton git repository for the model.\n2. Run the current model through a `test suite that represents the community\n standard`_.\n3. Generate an informative report which details the results of the test suite in\n a visually appealing manner.\n4. (Re-)compute test statistics for an existing version controlled history of\n a metabolic model.\n\nAnd in order to make this process as easy as possible the generated repository\ncan easily be integrated with continuous integration testing providers such as\nTravis CI, which means that anytime you push a model change to GitHub, the test\nsuite will be run automatically and a report will be available for you to look\nat via GitHub pages for your repository.\n\n.. _test suite that represents the community standard: \n https://github.com/opencobra/memote/wiki/Test-Catalog\n\n.. summary-end\n\n* Documentation: https://memote.readthedocs.io/.\n\nInstallation\n============\n\nBefore installing `MEMOTE`, please make sure that you have correctly installed the\nlatest version of `git <https://git-scm.com/>`_.\n\nMoreover, we highly recommend creating a Python virtualenv for your model\ntesting purposes.\n\nTo install `MEMOTE`, run this command in your terminal:\n\n.. code-block:: console\n\n $ pip install memote\n\nThis is the preferred method to install `MEMOTE`, as it will always install the\nmost recent stable release.\n\n.. who-start\n\nContact\n=======\n\nFor comments and questions get in touch via\n\n* our `gitter chatroom <https://gitter.im/opencobra/memote>`_\n* or open a `GitHub issue <https://github.com/opencobra/memote/issues/new>`_.\n\nAre you excited about this project? Consider `contributing\n<https://memote.readthedocs.io/en/latest/contributing.html>`_ by adding novel\ntests, reporting or fixing bugs, and generally help us make this a better\nsoftware for everyone.\n\nCopyright\n=========\n\n* Copyright (c) 2017, Novo Nordisk Foundation Center for Biosustainability,\n Technical University of Denmark.\n* Free software: `Apache Software License 2.0 <LICENSE>`_\n\n.. who-end\n\nCredits\n=======\n\nThis package was created with Cookiecutter_ and the\n`audreyr/cookiecutter-pypackage`_ project template.\n\n`Memote` relies on click_ for the command line interface, pytest_ for unit\nand model tests, gitpython_ for interacting with git repositories, \npandas_ for tabular datastructures and data input, jinja2_ for interacting \nwith HTML templates, cobrapy_ for analysing genome-scale metabolic \nmodels, python_libsbml_ for reading and writing Systems Biology Markup \nLanguage (SBML_), ruamel_ for handling YAML generation, travispy_ and \ntravis-encrypt_ for interacting with Travis CI, pygithub_ for access to the \nGithub API, sympy_ for matrix calculations, sqlalchemy_ for managing \n``history`` results, numpydoc_ for beautifully formatted doc strings using \nsphinx_, pylru_ for caching, goodtables_ for validation of tabular data, \ndepinfo_ for pretty printing our dependencies, six_ and future_ for backward \nand forward compatibility.\n\nThe Memote Report App user interface is built with `Angular 5`_, \n`Angular Flex-Layout`_, and `Angular Material`_. We rely on Taucharts_ for plotting \nresults.\n\nThe initial development of `MEMOTE` has received funding from:\n\n.. image:: https://upload.wikimedia.org/wikipedia/commons/d/d5/Novo_nordisk_foundation_Logo.png\n :target: http://novonordiskfonden.dk/en\n\n.. image:: https://innovationsfonden.dk/sites/all/themes/novigo/logo.png\n :target: https://innovationsfonden.dk/da\n\n.. image:: http://dd-decaf.eu/images/decaf-logo-md.svg\n :target: http://dd-decaf.eu/\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: \n https://github.com/audreyr/cookiecutter-pypackage\n.. _click: http://click.pocoo.org/5/\n.. _pytest: https://docs.pytest.org/en/latest/\n.. _gitpython: https://github.com/gitpython-developers/GitPython\n.. _pandas: https://pypi.org/project/pandas/\n.. _jinja2: http://jinja.pocoo.org/\n.. _cobrapy: https://github.com/opencobra/cobrapy\n.. _python_libsbml: https://pypi.org/project/python-libsbml/\n.. _SBML: http://sbml.org/Main_Page\n.. _ruamel: https://pypi.org/project/ruamel.yaml/\n.. _travispy: https://pypi.org/project/TravisPy/\n.. _travis-encrypt: https://pypi.org/project/travis-encrypt/\n.. _pygithub: https://github.com/PyGithub/PyGithub\n.. _sympy: http://www.sympy.org/en/index.html\n.. _sqlalchemy: http://www.sqlalchemy.org/\n.. _numpydoc: https://github.com/numpy/numpydoc\n.. _sphinx: http://www.sphinx-doc.org/en/stable/\n.. _pylru: https://pypi.org/project/pylru/\n.. _goodtables: https://github.com/frictionlessdata/goodtables-py\n.. _depinfo: https://pypi.org/project/depinfo/\n.. _six: https://pypi.org/project/six/\n.. _future: https://pypi.org/project/future/\n.. _Angular 5: https://angular.io/\n.. _Angular Flex-Layout: https://github.com/angular/flex-layout\n.. _Angular Material: https://material.angular.io/\n.. _Taucharts: https://taucharts.com/\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "the genome-scale metabolic model test suite",
"version": "0.17.0",
"project_urls": {
"Bug Tracker": "https://github.com/opencobra/memote/issues",
"Documentation": "https://memote.readthedocs.io",
"Download": "https://pypi.org/project/memote/",
"Homepage": "https://github.com/opencobra/memote",
"Source Code": "https://github.com/opencobra/memote"
},
"split_keywords": [
"memote",
"metabolic model",
"constraint-based",
"cobra",
"test suite",
"quality control",
"quality assurance"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "30f7ab25f696edfc12af9f6726431f6d1a9eef5ecf24020b582a12b344fd74db",
"md5": "be59dce83825827efb5492d0af8bda3c",
"sha256": "f8dbf07308c41ce5cc4178078f285585dcbb86dc426396d6be5ade8c33126593"
},
"downloads": -1,
"filename": "memote-0.17.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "be59dce83825827efb5492d0af8bda3c",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.6",
"size": 961003,
"upload_time": "2024-01-08T10:08:10",
"upload_time_iso_8601": "2024-01-08T10:08:10.560324Z",
"url": "https://files.pythonhosted.org/packages/30/f7/ab25f696edfc12af9f6726431f6d1a9eef5ecf24020b582a12b344fd74db/memote-0.17.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cae495dc615da20f333f94b130b156f9f72567d2ee77ffbdf92f79c6ac816dad",
"md5": "466816f1c8dc21eebfd5495cde14c5e7",
"sha256": "b61b222c6fe7719f0f916f01a5c68679567bad8884ed36eb634311ddbc565f19"
},
"downloads": -1,
"filename": "memote-0.17.0.tar.gz",
"has_sig": false,
"md5_digest": "466816f1c8dc21eebfd5495cde14c5e7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 941113,
"upload_time": "2024-01-08T10:08:13",
"upload_time_iso_8601": "2024-01-08T10:08:13.471275Z",
"url": "https://files.pythonhosted.org/packages/ca/e4/95dc615da20f333f94b130b156f9f72567d2ee77ffbdf92f79c6ac816dad/memote-0.17.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-08 10:08:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "opencobra",
"github_project": "memote",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "memote"
}