Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/ci.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ name: ci

on:
push:
branches: [master]
branches: [main]
pull_request:

jobs:
Expand Down
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,4 @@
/.pydevproject
/.settings/
*__pycache__*
/docs/_build
47 changes: 16 additions & 31 deletions README.rst → README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,11 @@
.. image:: https://github.com/HECBioSim/Longbow/actions/workflows/ci.yaml/badge.svg
:target: https://github.com/HECBioSim/Longbow/actions/workflows/ci.yaml
.. image:: https://img.shields.io/pypi/v/Longbow.svg
:target: https://pypi.python.org/pypi/Longbow/
.. image:: https://img.shields.io/pypi/status/Longbow.svg
:target: https://pypi.python.org/pypi/Longbow
.. image:: https://coveralls.io/repos/github/HECBioSim/Longbow/badge.svg?branch=master
:target: https://coveralls.io/github/HECBioSim/Longbow?branch=master
.. image:: https://readthedocs.org/projects/longbow/badge/?version=latest
:target: https://longbow.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status


*******
Longbow
*******
[![ci](https://github.com/HECBioSim/Longbow/actions/workflows/ci.yaml/badge.svg)](https://github.com/HECBioSim/Longbow/actions/workflows/ci.yaml)
![PyPI - Version](https://img.shields.io/pypi/v/longbow?logo=pypi&logoColor=white)
![PyPI - Status](https://img.shields.io/pypi/status/longbow?logo=pypi&logoColor=white)
![PyPI - Downloads](https://img.shields.io/pypi/dm/longbow?logo=pypi&logoColor=white)
[![Coverage Status](https://coveralls.io/repos/github/HECBioSim/Longbow/badge.svg?branch=main)](https://coveralls.io/github/HECBioSim/Longbow?branch=main)
[![Docs - Status](https://readthedocs.org/projects/longbow/badge/?version=latest)](https://longbow.readthedocs.io/en/latest/?badge=latest)

# Longbow

Longbow is an automated simulation submission and monitoring tool. Longbow
is designed to reproduce the look and feel of using software on the users
Expand Down Expand Up @@ -45,15 +37,13 @@ for automating job submission. Longbow is available as a convenient and
light-weight python API that can be integrated in a number of different way.


Licensing
=========
## Licensing

Longbow is released under the BSD 3-clause license. A copy of this license is
provided when Longbow is downloaded and installed.


Citing
======
## Citing

If you make use of Longbow in your own code or in production simulations that
result in publishable output, then please reference our paper:
Expand All @@ -63,8 +53,7 @@ A Lightweight Remote Job Submission Tool. Journal of Open Research Software,
4: e1, DOI: http://dx.doi.org/10.5334/jors.95


Installation
============
## Installation

Releases can be installed either via pip or can be installed manually, to
install via pip:
Expand All @@ -78,16 +67,14 @@ http://www.hecbiosim.ac.uk/longbow
and then extract and run the setup.py script to install.


Documentation
=============
## Documentation

Documentation for Longbow users can be found here:

http://www.hecbiosim.ac.uk/longbow-docs


Examples
========
## Examples

Example files can be installed either through the Longbow command-line or by
downloading from the HECBioSim website manually:
Expand All @@ -97,8 +84,7 @@ longbow --examples
http://www.hecbiosim.ac.uk/longbow-examples


Support
=======
## Support

Support for any issues arising from using Longbow, whether these are questions,
to report a bug or to suggest new ideas. You should use the Longbow forums
Expand All @@ -107,8 +93,7 @@ here:
https://github.com/HECBioSim/Longbow/issues


Developers
==========
## Developers

Developers that wish to contribute to Longbow are welcome. We do ask that if
you wish to contribute to the Longbow base code that you contact us first.
Expand All @@ -117,6 +102,6 @@ The following resources are available to developers:

Code repository: https://github.com/hecbiosim/longbow

Unit testing: https://travis-ci.org/HECBioSim/Longbow
Unit testing: https://github.com/HECBioSim/Longbow/actions

Code coverage: https://coveralls.io/github/HECBioSim/Longbow
1 change: 0 additions & 1 deletion docs/changelog.rst

This file was deleted.

4 changes: 2 additions & 2 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@
#
# This is also used if you do content translation via gettext catalogs.
# Usually you set "language" from the command line for these cases.
language = None
language = 'en'

# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
Expand Down Expand Up @@ -157,4 +157,4 @@
]

def setup(app):
app.add_stylesheet('table-overflow.css')
app.add_css_file('table-overflow.css')
1 change: 0 additions & 1 deletion docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,6 @@ Support for any issues arising from using Longbow, whether these are questions,
usr-configuration
usr-running-jobs
usr-troubleshooting
changelog

.. toctree::
:maxdepth: 2
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ name = "Longbow"
dynamic = ["version"] # read from longbow/__init__.py
description = "Biomolecular simulation remote job submission tool."
authors = [{name = "James Gebbie-Rayet", email = "james.gebbie@stfc.ac.uk"}]
readme = "README.rst"
readme = "README.md"
license = {file = "LICENSE"}
classifiers = [
'Development Status :: 5 - Production/Stable',
Expand Down