# Marvin
Marvin is a bot for Redmine. He helps you to tidy up your ticket system by nudging and/or closing abandoned tickets.

## Configuration
After pulling the repository you have to create a virtual environment within the repository folder:
```bash
python3 -m venv ./venv
```

Activate the virtual environment:
```bash
source venv/bin/activate
```

Then you have to fulfill the dependencies with:
```bash
pip3 install -r requirements.txt
```
Next copy the example files, rename them to `.env` and `config.yaml` and fill in the right values.

### Configure actions
You can define different actions for the bot to perform.  
Below the `actions` section in the `config.yaml` you can add your own actions.

```yaml
actions:

  waiting_for_feedback:
    start_date: "2021-01-01"  # Date from which tickets are to be processed (all tickets from yyyy-mm-dd)
    time_range: "14"  # Number of days that should be exceeded without updates on the ticket
    projects:
      - "IT Tickets"  # List of redmine projects
    status:
      - "Waiting for feedback"  # List of all issue status you want to treat
    close_ticket: true  # optional: should the ticket get closed after the update?
    template: "close_ticket" # Template for the update massage

  in_revision:
    start_date: "2021-01-01"
    time_range: "14"
    projects:
      - "IT Tickets"
    status:
      - "In revision"
    template: "nudge_ticket"
    change_status_to: "Waiting for feedback"  # optional: change the ticket status to "waiting for feedback"
```

## Usage
To run the script at regular intervals, simply add it to the crontab.  

Open crontab
```bash
crontab -e
```

Add entry
```
30 8 * * 1-5 /path/to/Marvin/venv/bin/python /path/to/Marvin/main.py
```
This executes the script every weekday at 8.30 am.