Add support for github checks

.gitignore

@@ -1,7 +1,9 @@
 /homu/__pycache__/
+/tests/__pycache__/
 /.venv/
 /cfg.toml
 /cfg.json
 /homu.egg-info/
 /main.db
 /cache
+**/*.pyc

.travis.yml

@@ -0,0 +1,20 @@
+sudo: false
+language: python
+python:
+  - 3.4
+  - 3.5
+  - 3.6
+install:
+  - pip install flake8
+  - pip install 'github3.py<1.0'
+  - pip install 'toml'
+  - pip install 'Jinja2'
+  - pip install 'requests'
+  - pip install 'bottle'
+  - pip install 'waitress'
+  - pip install 'retrying'
+script:
+  - flake8 homu
+  - python -m unittest discover tests
+notifications:
+  webhooks: http://build.servo.org:54856/travis

README.md

@@ -3,12 +3,13 @@
 [![Hommando]][Akemi Homura]
 
 Homu is a bot that integrates with GitHub and your favorite continuous
-integration service, such as [Buildbot] or [Travis CI].
+integration service such as [Travis CI], [Appveyor] or [Buildbot].
 
 [Hommando]: https://i.imgur.com/j0jNvHF.png
 [Akemi Homura]: https://wiki.puella-magi.net/Homura_Akemi
 [Buildbot]: http://buildbot.net/
 [Travis CI]: https://travis-ci.org/
+[Appveyor]: https://www.appveyor.com/
 
 ## Why is it needed?
 
@@ -31,8 +32,9 @@ approval comment from one of the configured reviewers. When the pull request is
 approved, Homu tests it using your favorite continuous integration service, and
 only when it passes all the tests, it is merged into `master`.
 
-Note that Homu is **not** a replacement of Travis CI or Buildbot. It works on
-top of them. Homu itself doesn't have the ability to test pull requests.
+Note that Homu is **not** a replacement of Travis CI, Buildbot or Appveyor. It
+works on top of them. Homu itself doesn't have the ability to test pull
+requests.
 
 ## Influences of bors
 
@@ -50,86 +52,92 @@ before the merge" came from bors. However, there are also some differences:
    feature. This approach improves the overall performance and the response
    time, because the bot is informed about the status changes immediately.
 
-And also, Homu has more features, such as `rollup`, `try`, and the Travis CI
-support.
+And also, Homu has more features, such as `rollup`, `try`, and the Travis CI &
+Appveyor support.
 
 [bors]: https://github.com/graydon/bors
 [Webhooks]: https://developer.github.com/webhooks/
-[HttpStatusPush]: http://docs.buildbot.net/current/manual/cfg-statustargets.html#httpstatuspush
+[HttpStatusPush]: http://docs.buildbot.net/0.8.12/manual/cfg-statustargets.html#httpstatuspush
 
 ## Usage
 
 ### How to install
 
 ```sh
-sudo apt-get install python3-venv
-
-pyvenv .venv
-. .venv/bin/activate
-
-# Stable version
-
-pip install homu
-
-# Development version
-
-git clone https://github.com/barosl/homu.git
-pip install -e homu
+$ sudo apt-get install python3-venv 
+$ pyvenv .venv
+$ . .venv/bin/activate
+$ git clone https://github.com/servo/homu.git
+$ pip install -e homu
 ```
 
 ### How to configure
 
-1. Copy `cfg.sample.toml` to `cfg.toml`, and edit it accordingly.
-
-2. Create a GitHub account that will be used by Homu. You can also use an
-   existing account. In the [account settings][settings], register a new
-   application and generate a new access token (with the `repo` permission).
-   The OAuth Callback URL should be `http://HOST:PORT/callback`, the homepage URL
-   isn't needed and can be anything, for example `http://HOST:PORT/`.
-
-3. Add a Webhook to your repository:
-
- - Payload URL: `http://HOST:PORT/github`
- - Content type: `application/json`
- - Secret: The same as `repo.NAME.github.secret` in cfg.toml
- - Events: Issue Comment, Pull Request, Push
-
-4. Add a Webhook to your continuous integration service:
+In the following instructions, `HOST` refers to the hostname (or IP address)
+where you are running your custom homu instance. `PORT` is the port the service
+is listening to and is configured in `web.port` in `cfg.toml`. `NAME` refers to
+the name of the repository you are configuring homu for.
 
- - Buildbot
+1. Copy `cfg.sample.toml` to `cfg.toml`. You'll need to edit this file to set up
+   your configuration. The following steps explain where you can find important
+   config values. 
 
-   Insert the following code to the `master.cfg` file:
-
-    ```python
-    from buildbot.status.status_push import HttpStatusPush
-
-    c['status'].append(HttpStatusPush(
+2. Create a GitHub account that will be used by Homu. You can also use an
+   existing account. In the [account settings][settings], go to "OAuth
+   applications" and create a new application:
+   - Make note of the "Client ID" and "Client Secret"; you will need to put them in
+   your `cgf.toml`.
+   - The OAuth Callback URL should be `http://HOST:PORT/callback`.
+   - The homepage URL isn't necessary; you could set `http://HOST:PORT/`.
+
+3. Go to the user settings of the GitHub account you created/used in the
+   previous step. Go to "Personal access tokens". Click "Generate new token" and
+   choose the "repo" and "user" scopes. Put the token value in your `cfg.toml`.
+
+4. Add your new GitHub account as a Collaborator to the GitHub repo you are
+   setting up homu for. This can be done in repo (NOT user) "Settings", then
+   "Collaborators".
+
+     4.1. Make sure you login as the new GitHub account and that you **accept 
+          the collaborator invitation** you just sent! 
+
+5. Add a Webhook to your repository. This is done under repo (NOT user)
+   "Settings", then "Webhooks". Click "Add webhook", the set:
+   - Payload URL: `http://HOST:PORT/github`
+   - Content type: `application/json`
+   - Secret: The same as `repo.NAME.github.secret` in `cfg.toml`
+   - Events: `Issue Comment`, `Pull Request`, `Push`, `Status`, `Check runs`
+
+6. Add a Webhook to your continuous integration service, if necessary. You don't
+   need this if using Travis/Appveyor.
+   - Buildbot 
+
+     Insert the following code to the `master.cfg` file:
+
+     ```python
+     from buildbot.status.status_push import HttpStatusPush
+
+     c['status'].append(HttpStatusPush(
         serverUrl='http://HOST:PORT/buildbot',
         extra_post_params={'secret': 'repo.NAME.buildbot.secret in cfg.toml'},
-    ))
-    ```
-
- - Travis CI
-
-   Add [your Travis token][travis] as `repo.NAME.travis.token` in cfg.toml.
-   Insert the following code to the `.travis.yml` file:
+     ))
+     ```
 
-    ```yaml
-    notifications:
-        webhooks: http://HOST:PORT/travis
-
-    branches:
-        only:
-            - auto
-    ```
+7. Go through the rest of your `cfg.toml` and uncomment (and change, if needed)
+   parts of the config you'll need.
 
 [settings]: https://github.com/settings/applications
 [travis]: https://travis-ci.org/profile/info
 
 ### How to run
 
 ```sh
-. .venv/bin/activate
-
-homu
+$ . .venv/bin/activate
+$ homu
 ```
+
+## Deploying Servo's Homu
+
+After merging a change to this repo, updated the pinned hash in [Salt].
+
+[Salt]: https://github.com/servo/saltfs/blob/master/homu/map.jinja