https://github.com/agrover112/buildtest

HPC System and Software Testing Framework

https://github.com/agrover112/buildtest

Keywords from Contributors

Repository

HPC System and Software Testing Framework

README.rst

| |license| |docs| |codecov| |slack| |release| |installation| |regressiontest| |gh_pages_master| |gh_pages_devel| |checkurls| |dailyurlcheck| |codefactor| |blackformat|  |black| |issues| |open_pr| |commit_activity_yearly| |commit_activity_monthly| |core_infrastructure| |zenodo|

.. |docs| image:: https://readthedocs.org/projects/buildtest/badge/?version=latest
    :alt: Documentation Status
    :scale: 100%
    :target: https://buildtest.readthedocs.io/en/latest/?badge=latest

.. |slack| image:: http://hpcbuildtest.herokuapp.com/badge.svg
    :target: http://hpcbuildtest.slack.com

.. |license| image:: https://img.shields.io/github/license/buildtesters/buildtest.svg

.. |release| image:: https://img.shields.io/github/v/release/buildtesters/buildtest.svg
   :target: https://github.com/buildtesters/buildtest/releases
   
.. |issues| image:: https://img.shields.io/github/issues/buildtesters/buildtest.svg 
    :target: https://github.com/buildtesters/buildtest/issues
    
.. |open_pr| image:: https://img.shields.io/github/issues-pr/buildtesters/buildtest.svg
    :target: https://github.com/buildtesters/buildtest/pulls
    
.. |commit_activity_yearly| image:: https://img.shields.io/github/commit-activity/y/buildtesters/buildtest.svg
 
.. |commit_activity_monthly| image:: https://img.shields.io/github/commit-activity/m/buildtesters/buildtest.svg

.. |core_infrastructure| image:: https://bestpractices.coreinfrastructure.org/projects/3469/badge

.. |codecov| image:: https://codecov.io/gh/buildtesters/buildtest/branch/devel/graph/badge.svg
    :target: https://codecov.io/gh/buildtesters/buildtest

.. |codefactor| image:: https://www.codefactor.io/repository/github/buildtesters/buildtest/badge
    :target: https://www.codefactor.io/repository/github/buildtesters/buildtest
    :alt: CodeFactor

.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black

.. |checkurls| image:: https://github.com/buildtesters/buildtest/workflows/Check%20URLs/badge.svg
    :target: https://github.com/buildtesters/buildtest/actions

.. |blackformat| image:: https://github.com/buildtesters/buildtest/workflows/Black%20Formatter/badge.svg
    :target: https://github.com/buildtesters/buildtest/actions

.. |installation| image:: https://github.com/buildtesters/buildtest/workflows/installation/badge.svg
   :target: https://github.com/buildtesters/buildtest/actions

.. |regressiontest| image:: https://github.com/buildtesters/buildtest/workflows/regressiontest/badge.svg
    :target: https://github.com/buildtesters/buildtest/actions

.. |gh_pages_devel| image:: https://github.com/buildtesters/buildtest/workflows/Upload%20JSON%20Schema%20to%20gh-pages%20on%20devel/badge.svg
    :target: https://github.com/buildtesters/buildtest/actions

.. |gh_pages_master| image:: https://github.com/buildtesters/buildtest/workflows/Upload%20JSON%20Schema%20to%20gh-pages%20for%20master%20branch/badge.svg
    :target: https://github.com/buildtesters/buildtest/actions    

.. |dailyurlcheck| image:: https://github.com/buildtesters/buildtest/workflows/Daily%20Check%20URLs/badge.svg
   :target: https://github.com/buildtesters/buildtest/actions

.. |zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3967143.svg
   :target: https://doi.org/10.5281/zenodo.3967143

buildtest
---------

`buildtest `_ is a testing framework for HPC facilities to write acceptance test
for their system. In buildtest, you will write tests in `YAML `_
called **Buildspecs** which is a test recipe used by buildtest for generating test scripts.
buildtest will process *buildspecs* and automatically create shell-scripts and run them
on your system. buildtest supports `IBM Spectrum LSF `_,
`Slurm `_, and `Cobalt `_ batch scheduler for job submission.
buildtest makes use of `jsonschema `_ to define structure of buildspecs used for validating buildspecs. 

If you want to learn more about buildtest read https://buildtest.readthedocs.io/en/latest/what_is_buildtest.html.

Installation
--------------


Installing buildtest, is relatively easy. Just clone this repo and source the setup script::

    git clone https://github.com/buildtesters/buildtest.git
    cd buildtest
    source setup.sh


For more details see `installing buildtest `_.


Schema Development
-------------------

The schemas are found in top-level folder `buildtest/schemas/ `_
and published via Github Pages at https://buildtesters.github.io/buildtest/. Each schema has a unique URI defined
by `$id `_.

For any issues with schema, please create an `issue `_ in buildtest.

References
------------

- Documentation: http://buildtest.rtfd.io/

- Schema Docs: https://buildtesters.github.io/buildtest/

- ReadTheDocs: https://readthedocs.org/projects/buildtest/

- CodeCov: https://codecov.io/gh/buildtesters/buildtest

- CodeFactor: https://www.codefactor.io/repository/github/buildtesters/buildtest

- Snyk: https://app.snyk.io/org/buildtesters/

Documentation
-------------

buildtest `documentation `_  is your
source for getting help with buildtest. If you get stuck check out the
`current issues `_ to see
if you face similar issue. If all else fails please create a ticket.

Source Code
------------

buildtest source code is under `buildtest `_
directory found in the root of this repository. The documentation pages are located in
`docs `_ folder
which consist of `Makefile `_ and
`conf.py `_ to build the sphinx project along with documentation pages in
ReStructuredText (rst). The regression test are found in top-level directory
named `tests `_ and the test suite is run via `pytest `_.

Slack
------

Slack is the **preferred** method for communication and user support with buildtest.
If you haven't joined slack click the `self invite `_
to register your account. Once you have an account you can access slack channel at https://hpcbuildtest.slack.com and post
your questions in **#general** channel.

Contributing Back
-------------------

We would love to get your feedback and contribution, for more details see
`contribution guide `_.

Author
-------

buildtest was founded by `Shahzeb Siddiqui `_.

LICENSE
--------

buildtest is released under the MIT License. See
`LICENSE `_ for more details.

Owner

GitHub Events

Committers

Last synced: 12 months ago

Issues and Pull Requests

Last synced: 12 months ago