rorschach - GitLite

KO | EN

gitlite — search

#python #ai #typescript #go #android #machine-learning #linux #docker #macos #windows #awesome #vue #ios #open-source

rorschach

(★ 105)

Bootstrap pull request sanity checker bot

파일 탐색기

최종 버전 다운로드 (.zip)

- against-gh-pages.md
- cname.md
- css.md
- gh-pages-into-master.md
- js.md
- newfile.md
- title.md
- build.properties
- plugins.sbt
.gitattributes
.gitignore
.travis.yml
build.sbt
CONTRIBUTING.md
Dockerfile
LICENSE.txt
README.md
setup_droplet.sh

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/twbs/rorschach

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd rorschach

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker build -t rorschach .

Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.

docker run -p 8080:80 rorschach

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Rorschach
=========
[![Build Status](https://travis-ci.org/twbs/rorschach.svg?branch=master)](https://travis-ci.org/twbs/rorschach)
![Development Status :: 5 - Production/Stable](https://img.shields.io/badge/maturity-stable-green.svg "Development Status :: 5 - Production/Stable")
[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg "MIT License")](https://github.com/twbs/rorschach/blob/master/LICENSE.txt)

Rorschach ([@twbs-rorschach](https://github.com/twbs-rorschach)) is a [Bootstrap](https://github.com/twbs/bootstrap/) pull request sanity checker bot.

Rorschach watches for new or modified pull requests, runs sanity checks on them, and if a sanity check fails, it leaves an informative comment on the pull request explaining the mistake and how to fix it, and then closes the pull request.

Rorschach requires Java 8 or higher.

## Motivation

You're a member of a popular open source project that involves front-end Web technologies. Cool.

But due to the project's popularity, you will get some pull requests proposed by folks who don't read the contributing guidelines, folks who don't understand asset pipelines, or just plain newbies (hey, everybody's gotta start somewhere).

By automating the process of sanity-checking proposed pull requests:
* Feedback can be given to the pull requester *extremely* quickly, decreasing the turnaround time on fixing the pull request and decreasing friction for the requester.
* The requester can be referred to canonical write-ups explaining the common mistakes in detail, so that they have full context for understanding the reported mistakes.
* Issue triagers will have less work to deal with, and human error in failing to zealously check every single pull request for every common mistake is eliminated.

## Checks performed

* [Pull requests must never be against the `gh-pages` branch.](docs/against-gh-pages.md)
* [Pull requests must not attempt to merge the `gh-pages` branch into the `master` branch.](docs/gh-pages-into-master.md)
* [Pull requests must never edit `/dist/js/bootstrap.js` without also editing `/js/*.js`](docs/js.md).
* [Pull requests must never edit `/dist/css/bootstrap.css` without also editing `/scss/*.scss` or `/less/*.less`.](docs/css.md)
* [Pull requests must never modify the `CNAME` file.](docs/cname.md)
* Pull requests must not be used solely to test out Git or GitHub instead of proposing legitimate improvements.
  * [Pull requests must not have titles which strongly suggest this.](docs/title.md)
  * [Pull requests must not create new files with names which strongly suggest this (e.g. `new-file.txt`).](docs/newfile.md)

## GitHub webhook configuration

* Payload URL: `http://your-domain.example/rorschach`
* Content type: `application/json`
* Secret: Same as your `web-hook-secret-key` config value
* Which events would you like to trigger this webhook?: "Pull Request"

## License
Rorschach is released under the [MIT License](https://github.com/twbs/rorschach/blob/master/LICENSE.txt).

## Acknowledgments
We all stand on the shoulders of giants and get by with a little help from our friends. Rorschach is written in [Scala](http://www.scala-lang.org) and built on top of:
* [Akka](http://akka.io) & [Spray](http://spray.io), for async processing & HTTP
* [Eclipse EGit GitHub library](https://github.com/eclipse/egit-github), for working with [the GitHub API](https://developer.github.com/v3/)

## See also
* [LMVTFY](https://github.com/cvrebert/lmvtfy), Rorschach's sister bot who does HTML validation
* [Savage](https://github.com/twbs/savage), Rorschach's sister bot who runs cross-browser JS tests on Sauce Labs
* [NO CARRIER](https://github.com/twbs/no-carrier), Rorschach's sister bot who closes old abandoned issues