Metadata-Version: 2.1
Name: mailtrigger
Version: 0.0.2
Summary: Remote service trigger with mail
Home-page: https://github.com/craftslab/mailtrigger
Author: Jia Jia
Author-email: angersax@sina.com
License: Apache-2.0
Download-URL: https://github.com/craftslab/mailtrigger/archive/v0.0.2.tar.gz
Keywords: gerrit,jenkins,jira,mail,mailtrigger,trigger
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: colorama
Requires-Dist: coverage
Requires-Dist: pytest
Requires-Dist: setuptools
Requires-Dist: twine
Requires-Dist: wheel

# Mail Trigger

[![PyPI](https://img.shields.io/pypi/v/mailtrigger.svg?color=brightgreen)](https://pypi.org/project/mailtrigger/)
[![Travis](https://travis-ci.com/craftslab/mailtrigger.svg?branch=master)](https://travis-ci.com/craftslab/mailtrigger)
[![Coverage Status](https://coveralls.io/repos/github/craftslab/mailtrigger/badge.svg?branch=master)](https://coveralls.io/github/craftslab/mailtrigger?branch=master)
[![License](https://img.shields.io/github/license/craftslab/mailtrigger.svg?color=brightgreen)](https://github.com/craftslab/mailtrigger/blob/master/LICENSE)



## Requirements

- Python (3.7+)
- pip
- python-dev



## Installation

On Ubuntu / Mint, install *Mail Trigger* with the following commands:

```bash
sudo apt update
sudo apt install python3-dev python3-pip python3-setuptools
sudo pip3 install mailtrigger
```

On OS X, install *Mail Trigger* via [Homebrew](https://brew.sh/) (or via [Linuxbrew](https://linuxbrew.sh/) on Linux):

```
TBD
```

On Windows, install *Mail Trigger* with the following commands:

```
TBD
```



## Updating

```bash
pip3 install mailtrigger --upgrade
```



## Settings

Several *Mail Trigger* parameters can be set in the file [config.json](https://github.com/craftslab/mailtrigger/blob/master/source/config/config.json).

An example of config.json:

```
{
  "debug": false,
  "pop3": {
    "host": "pop.example.com",
    "pass": "pass",
    "port": 995,
    "ssl": true,
    "user": "user"
  },
  "smtp": {
    "host": "smtp.example.com",
    "pass": "pass",
    "port": 465,
    "ssl": true,
    "user": "user"
  }
}
```



## Usage

### Title

```
[trigger]: Write your description here
```

**Note: `[trigger]` is the reserved word in title**



### Recipient

The recipient is mail receiver as *Mail Trigger*.



### Content

#### Gerrit Trigger

```
@gerrit help
@gerrit list
@gerrit restart <host>
@gerrit start <host>
@gerrit stop <host>
@gerrit verify <host>

@gerrit <host>:<port> review
  [--project <PROJECT> | -p <PROJECT>]
  [--branch <BRANCH> | -b <BRANCH>]
  [--message <MESSAGE> | -m <MESSAGE>]
  [--notify <NOTIFYHANDLING> | -n <NOTIFYHANDLING>]
  [--submit | -s]
  [--abandon | --restore]
  [--rebase]
  [--move <BRANCH>]
  [--publish]
  [--json | -j]
  [--delete]
  [--verified <N>] [--code-review <N>]
  [--label Label-Name=<N>]
  [--tag TAG]
  {COMMIT | CHANGEID,PATCHSET}
```



#### Jenkins Trigger

```
@jenkins help
@jenkins list
@jenkins <host>:<port> build JOB [--parameter <PARAMETER> | -p <PARAMETER>]
@jenkins <host>:<port> list
@jenkins <host>:<port> query JOB
@jenkins <host>:<port> rebuild JOB
@jenkins <host>:<port> stop JOB
@jenkins <host>:<port> verify JOB
```



#### Jira Trigger

```
@jira help
```



#### Trigger Help

```
@help
```



## License Apache

Project License can be found [here](https://github.com/craftslab/mailtrigger/blob/master/LICENSE).


