Metadata-Version: 2.1
Name: softpack-builder
Version: 0.1.0
Summary: SoftPack Builder provides services for building SoftPack environments.
Home-page: https://github.com/wtsi-hgi/softpack-builder
License: MIT
Author: Altaf Ali
Author-email: altaf.ali@sanger.ac.uk
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: archspec (>=0.2.0,<0.3.0)
Requires-Dist: bokeh (>=2.4.3,<3.0)
Requires-Dist: fastapi (>=0.94.0,<0.95.0)
Requires-Dist: greenlet (>=2.0.2,<3.0.0)
Requires-Dist: hvac (>=1.1.0,<2.0.0)
Requires-Dist: jinja2 (>=3.1.2,<4.0.0)
Requires-Dist: mergedeep (>=1.3.4,<2.0.0)
Requires-Dist: oras (>=0.1.17,<0.2.0)
Requires-Dist: pip (>=23.0.1,<24.0.0)
Requires-Dist: prefect (==2.8.6)
Requires-Dist: prefect-dask (>=0.2.3,<0.3.0)
Requires-Dist: prefect-shell (>=0.1.5,<0.2.0)
Requires-Dist: pydantic (>=1.10.6,<2.0.0)
Requires-Dist: python-box (>=7.0.1,<8.0.0)
Requires-Dist: requests (<2.30.0)
Requires-Dist: ruamel-yaml (>=0.17.21,<0.18.0)
Requires-Dist: semver (>=3.0.0,<4.0.0)
Requires-Dist: singleton-decorator (>=1.0.0,<2.0.0)
Requires-Dist: sqlalchemy (==1.4.45)
Requires-Dist: typer (>=0.9.0,<0.10.0)
Description-Content-Type: text/markdown

# SoftPack Builder


[![pypi](https://img.shields.io/pypi/v/softpack-builder.svg)](https://pypi.org/project/softpack-builder/)
[![python](https://img.shields.io/pypi/pyversions/softpack-builder.svg)](https://pypi.org/project/softpack-builder/)
[![Build Status](https://github.com/wtsi-hgi/softpack-builder/actions/workflows/dev.yml/badge.svg)](https://github.com/wtsi-hgi/softpack-builder/actions/workflows/dev.yml)
[![codecov](https://codecov.io/gh/wtsi-hgi/softpack-builder/branch/main/graphs/badge.svg)](https://codecov.io/github/wtsi-hgi/softpack-builder)
[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/wtsi-hgi/softpack-builder.svg)](http://isitmaintained.com/project/wtsi-hgi/softpack-builder "Average time to resolve an issue")
[![Percentage of issues still open](http://isitmaintained.com/badge/open/wtsi-hgi/softpack-builder.svg)](http://isitmaintained.com/project/wtsi-hgi/softpack-builder "Percentage of issues still open")
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://www.contributor-covenant.org/version/2/1/code_of_conduct)



SoftPack Builder provides services for building SoftPack environments.


* Documentation: <https://wtsi-hgi.github.io/softpack-builder>
* GitHub: <https://github.com/wtsi-hgi/softpack-builder>
* PyPI: <https://pypi.org/project/softpack-builder/>
* Free software: MIT


## Features

* Delivers cross-platform software packaging environments for reproducible research.
* Includes integrated management and monitoring of build flows using [Prefect][].
* Supports distributed and parallel builds using [Dask][] for seamless scalability.

## Installation

### Stable release

To install SoftPack Builder, run this command in your
terminal:

``` console
$ pip install softpack-builder
```

This is the preferred method to install SoftPack Builder, as it will always install the most recent stable release.

If you don't have [pip][] installed, this [Python installation guide][]
can guide you through the process.

### From source

The source for SoftPack Builder can be downloaded from
the [Github repo][].

You can either clone the public repository:

``` console
$ git clone https://github.com/wtsi-hgi/softpack-builder.git
```

Or download the [tarball][]:

``` console
$ curl -OJL https://github.com/wtsi-hgi/softpack-builder/tarball/master
```

Once you have a copy of the source, you can install it with:

``` console
$ pip install .
```

### Development

For development mode, clone the repository and use [Poetry][] to install the
package.

``` console
$ git clone https://github.com/wtsi-hgi/softpack-builder.git
```

Install [Poetry][]:

``` console
$ pip install poetry
```

Install [Poetry][] environments for development:

``` console
poetry install --with dev,doc,test
```

Run tests with [Tox][]

``` console
poetry run tox
```

Run [MkDocs] server to view documentation:

``` console
poetry run mkdocs serve
```


[pip]: https://pip.pypa.io
[Python installation guide]: http://docs.python-guide.org/en/latest/starting/installation/
[Github repo]: https://github.com/wtsi-hgi/softpack-builder
[tarball]: https://github.com/wtsi-hgi/softpack-builder/tarball/master
[Dask]: https://www.dask.org
[Prefect]: https://www.prefect.io
[Poetry]: https://python-poetry.org
[Tox]: https://tox.wiki
[MkDocs]: https://www.mkdocs.org

## Credits

This package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [altaf-ali/cookiecutter-pypackage](https://altaf-ali.github.io/cookiecutter-pypackage) project template.

SoftPack mascot and logo courtesy of <a href="https://www.vecteezy.com/free-vector/cartoon">Cartoon Vectors by Vecteezy</a>.

