pipestat


Namepipestat JSON
Version 0.9.1 PyPI version JSON
download
home_pagehttps://github.com/pepkit/pipestat
SummaryA pipeline results reporter
upload_time2024-04-24 21:22:35
maintainerNone
docs_urlNone
authorMichal Stolarczyk, Nathan Sheffield
requires_pythonNone
licenseBSD2
keywords project metadata bioinformatics sequencing ngs workflow
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ![Run pytests](https://github.com/pepkit/pipestat/workflows/Run%20pytests/badge.svg)
[![docs-badge](https://readthedocs.org/projects/pipestat/badge/?version=latest)](https://pipestat.databio.org/en/latest/)
[![pypi-badge](https://img.shields.io/pypi/v/pipestat)](https://pypi.org/project/pipestat)
[![codecov](https://codecov.io/gh/pepkit/pipestat/branch/master/graph/badge.svg?token=O07MXSQZ32)](https://codecov.io/gh/pepkit/pipestat)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)


<img src="https://raw.githubusercontent.com/pepkit/pipestat/master/docs/img/pipestat_logo.svg?sanitize=true" alt="pipestat" height="70"/><br>

Pipestat standardizes reporting of pipeline results. It provides 1) a standard specification for how pipeline outputs should be stored; and 2) an implementation to easily write results to that format from within Python or from the command line. A pipeline author defines all the outputs produced by a pipeline by writing a JSON-schema. The pipeline then uses pipestat to report pipeline outputs as the pipeline runs, either via the Python API or command line interface. The user configures results to be stored either in a [YAML-formatted file](https://yaml.org/spec/1.2/spec.html) or a [PostgreSQL database](https://www.postgresql.org/).

See [Pipestat documentation](https://pep.databio.org/pipestat/) for complete details.


## Developer tests

###  Optional Dependencies

Note: to run the pytest suite locally, you will need to install the related requirements:

```bash
cd pipestat

pip install -r requirements/requirements-test.txt

```

### Database Backend Configuration for Tests

Many of the tests require a postgres database to be set up otherwise many of the tests will skip.

We recommend using docker:
```bash
docker run --rm -it --name pipestat_test_db \
    -e POSTGRES_USER=postgres \
    -e POSTGRES_PASSWORD=pipestat-password \
    -e POSTGRES_DB=pipestat-test \
    -p 5432:5432 \
    postgres
```


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/pepkit/pipestat",
    "name": "pipestat",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "project, metadata, bioinformatics, sequencing, ngs, workflow",
    "author": "Michal Stolarczyk, Nathan Sheffield",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/c0/93/32180eb339d726848471e4da30d43f973ddac1cece05c86915ca717f646c/pipestat-0.9.1.tar.gz",
    "platform": null,
    "description": "![Run pytests](https://github.com/pepkit/pipestat/workflows/Run%20pytests/badge.svg)\n[![docs-badge](https://readthedocs.org/projects/pipestat/badge/?version=latest)](https://pipestat.databio.org/en/latest/)\n[![pypi-badge](https://img.shields.io/pypi/v/pipestat)](https://pypi.org/project/pipestat)\n[![codecov](https://codecov.io/gh/pepkit/pipestat/branch/master/graph/badge.svg?token=O07MXSQZ32)](https://codecov.io/gh/pepkit/pipestat)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n\n<img src=\"https://raw.githubusercontent.com/pepkit/pipestat/master/docs/img/pipestat_logo.svg?sanitize=true\" alt=\"pipestat\" height=\"70\"/><br>\n\nPipestat standardizes reporting of pipeline results. It provides 1) a standard specification for how pipeline outputs should be stored; and 2) an implementation to easily write results to that format from within Python or from the command line. A pipeline author defines all the outputs produced by a pipeline by writing a JSON-schema. The pipeline then uses pipestat to report pipeline outputs as the pipeline runs, either via the Python API or command line interface. The user configures results to be stored either in a [YAML-formatted file](https://yaml.org/spec/1.2/spec.html) or a [PostgreSQL database](https://www.postgresql.org/).\n\nSee [Pipestat documentation](https://pep.databio.org/pipestat/) for complete details.\n\n\n## Developer tests\n\n###  Optional Dependencies\n\nNote: to run the pytest suite locally, you will need to install the related requirements:\n\n```bash\ncd pipestat\n\npip install -r requirements/requirements-test.txt\n\n```\n\n### Database Backend Configuration for Tests\n\nMany of the tests require a postgres database to be set up otherwise many of the tests will skip.\n\nWe recommend using docker:\n```bash\ndocker run --rm -it --name pipestat_test_db \\\n    -e POSTGRES_USER=postgres \\\n    -e POSTGRES_PASSWORD=pipestat-password \\\n    -e POSTGRES_DB=pipestat-test \\\n    -p 5432:5432 \\\n    postgres\n```\n\n",
    "bugtrack_url": null,
    "license": "BSD2",
    "summary": "A pipeline results reporter",
    "version": "0.9.1",
    "project_urls": {
        "Homepage": "https://github.com/pepkit/pipestat"
    },
    "split_keywords": [
        "project",
        " metadata",
        " bioinformatics",
        " sequencing",
        " ngs",
        " workflow"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "18132831386c2e4a88995658e3bb0474b2e8f4440285cbc067ea292450b28295",
                "md5": "c78b6e83413b0b2809ae14429e04cc03",
                "sha256": "9d3dd33fef1562bb4f9bc25bef45a4e81d92e97939c38ccd8545b31a8788329f"
            },
            "downloads": -1,
            "filename": "pipestat-0.9.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c78b6e83413b0b2809ae14429e04cc03",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 82596,
            "upload_time": "2024-04-24T21:22:34",
            "upload_time_iso_8601": "2024-04-24T21:22:34.089402Z",
            "url": "https://files.pythonhosted.org/packages/18/13/2831386c2e4a88995658e3bb0474b2e8f4440285cbc067ea292450b28295/pipestat-0.9.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c09332180eb339d726848471e4da30d43f973ddac1cece05c86915ca717f646c",
                "md5": "e58f78ee194e0fed89887c53a497e968",
                "sha256": "61c44726612bb06c34cf608dc2e45d8bb0e2b71b5249f1a2010addd32b4678dc"
            },
            "downloads": -1,
            "filename": "pipestat-0.9.1.tar.gz",
            "has_sig": false,
            "md5_digest": "e58f78ee194e0fed89887c53a497e968",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 84559,
            "upload_time": "2024-04-24T21:22:35",
            "upload_time_iso_8601": "2024-04-24T21:22:35.465602Z",
            "url": "https://files.pythonhosted.org/packages/c0/93/32180eb339d726848471e4da30d43f973ddac1cece05c86915ca717f646c/pipestat-0.9.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-24 21:22:35",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pepkit",
    "github_project": "pipestat",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "pipestat"
}
        
Elapsed time: 0.24363s