Metadata-Version: 2.1
Name: wheatley
Version: 0.5.2
Summary: A program that will ring any set of bells in Ringing Room.
Home-page: https://github.com/Kneasle/wheatley/
Author: Ben White-Horne
Author-email: kneasle@gmail.com
License: MIT
Description: # Wheatley
        [![PyPI version](https://badge.fury.io/py/wheatley.svg)](https://badge.fury.io/py/wheatley)
        ![Tests and Linting](https://github.com/Kneasle/wheatley/workflows/Tests%20and%20Linting/badge.svg)
        
        A bot for [Ringing Room](https://ringingroom.com/) that can fill in any set of bells to increase the scope of potential practices.
        
        Wheatley is designed to be a **'ninja helper with no ego'**.
        
        He'll ring all unassigned bells perfectly whilst fitting in with whatever you are doing, adjusting to
        your changes in rhythm.
        He'll also never try to take control of the ringing by giving instructions or powering on with a
        different rhythm to everyone else (unless you tell him to).
        
        Only one ringer needs to run the command and Wheatley will ring with you after anyone calls
        `Look to` in Ringing Room.
        He understands all Ringing Room calls – `Go`, `Look to`, `That's all` and `Stand next` will
        take effect the handstroke after they are called, and `Bob` and `Single` will result in `14` and
        `1234` lead end calls (unless otherwise specified).
        
        ### Notable features
        - Configurable rhythm detection that updates in real time
        - Holding up over people when they hesitate
        - Automatic correction for Ringing Room using multiple server URLs for load balancing
        - Very light resource footprint, as Wheatley doesn't interact with a browser to communicate with Ringing Room
        
        ### Contributing
        Contributions are very welcome!  See [here](CONTRIBUTING.md) for guidance.
        
        If you have any issues/suggestions, either
        [make an issue](https://github.com/Kneasle/ringing-room-bot/issues/new), or drop me a message
        [on Facebook](https://www.facebook.com/kneasle.wh.71).
        
        
        ## Quickstart
        ### Installation (using Pip)
        Run the following command to install or update to the
        [latest version of Wheatley](https://pypi.org/project/wheatley/):
           ```bash
           pip install --upgrade wheatley
           ```
        
        ## Examples
        Pick an example below to run Wheatley!
        
        For help with what parameters Wheatley has and what they do, type `wheatley --help`.
        
        *   Join a `ringingroom.com` tower with (9 digit) ID `[ID NUMBER]` and ring Plain Bob Major (tower
            bell style – wait for `Go` and `That's all`):
            ```bash
            wheatley [ID NUMBER] --method "Plain Bob Major"
            ```
        
        *   Ring 'up, down and in' rather than waiting for 'go':
            ```bash
            wheatley [ID NUMBER] --use-up-down-in --method [METHOD TITLE]
            # or
            wheatley [ID NUMBER] -u --method [METHOD TITLE]
            ```
        
        *   Ring full handbell style, i.e. 'up, down and in' and standing at rounds (`-H` is
            equivalent to `-us`):
            ```bash
            wheatley [ID NUMBER] --use-up-down-in --stop-at-rounds --method [METHOD TITLE]
            # or
            wheatley [ID NUMBER] -us --method [METHOD TITLE]
            # or
            wheatley [ID NUMBER] -H --method [METHOD TITLE]
            ```
        
        *   Join a server other than `ringingroom.com`:
        
            <!--- doctest-ignore -->
            ```bash
            wheatley [ID NUMBER] --url otherwebsite.com --method [METHOD TITLE]
            ```
        
        *   Ring rows taken from a (public) composition from [complib.org](http://complib.org/), in this
            case https://complib.org/composition/65034:
            ```bash
            wheatley [ID NUMBER] --comp 65034
            ```
        
        *   Ring at a peal speed of 3 hours 30 minutes (i.e. quite slowly):
            ```bash
            wheatley [ID NUMBER] --method [METHOD TITLE] --peal-speed 3h30
            # or
            wheatley [ID NUMBER] --method [METHOD TITLE] -S 3h30
            ```
        
        *   Make Wheatley push on with the rhythm rather than waiting for people to ring.
            ```bash
            wheatley [ID NUMBER] --method [METHOD TITLE] --keep-going
            # or
            wheatley [ID NUMBER] --method [METHOD TITLE] -k
            ```
        
        *   Completely ignore other users' changes in rhythm (useful if he's ringing most of
            the bells and you don't want him to randomly change speed when you make mistakes):
            ```bash
            wheatley [ID NUMBER] --method [METHOD TITLE] --inertia 1.0
            # or
            wheatley [ID NUMBER] --method [METHOD TITLE] -I 1.0
            ```
        
Platform: any
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
