|
1 | 1 | [](https://raw.githubusercontent.com/circleci/local-cli/master/LICENSE)
|
2 | 2 |
|
3 |
| -# DEPRECATION NOTICE and call for further development |
4 |
| - |
5 |
| -This repo is no longer being maintained since I no longer use Circle-CI. |
6 |
| - |
7 |
| -[The upstream project that pre-commit hook relies on](https://github.com/circleci/local-cli) has also been deprecated and replaced with <https://github.com/CircleCI-Public/circleci-cli>. |
8 |
| - |
9 |
| -If you use Circle-CI and find this project useful, please consider forking this project and making it work with the new circleci-cli. If you do so, open a ticket here and I will link to your project. |
10 |
| - |
11 | 3 | # pre-commit-circleci
|
12 | 4 |
|
13 |
| -pre-commit-circleci is a [pre-commit](https://github.com/pre-commit/pre-commit) component, which wraps [circleci](https://github.com/circleci/local-cli) to check CircleCI config yaml files. |
14 |
| - |
15 |
| -Table of Contents |
16 |
| ------------------ |
| 5 | +`pre-commit-circleci` is a |
| 6 | +[pre-commit](https://github.com/pre-commit/pre-commit) component that checks |
| 7 | +CircleCI configuration YAML files in Git repositories. It wraps |
| 8 | +[circleci-cli](https://github.com/CircleCI-Public/circleci-cli) in a hook that |
| 9 | +pre-commit can use. |
17 | 10 |
|
18 |
| - * [Requirements](#requirements) |
19 |
| - * [Install](#install) |
20 |
| - * [Contributing](#contributing) |
21 |
| - * [License](#license) |
22 |
| - * [Author](#author) |
23 | 11 |
|
24 |
| -Requirements |
25 |
| ------------- |
26 |
| - pre-commit-circleci requires the following to run: |
| 12 | +## Requirements |
27 | 13 |
|
28 |
| - * [pre-commit](http://pre-commit.com) |
29 |
| - * [circleci local-cli](https://github.com/circleci/local-cli) |
30 |
| - * [docker](https://www.docker.com/) is a prerequisite for circleci local-cli |
| 14 | +`pre-commit-circleci` requires the following to run: |
31 | 15 |
|
| 16 | +* [pre-commit](http://pre-commit.com) |
| 17 | +* [circleci-cli](https://github.com/CircleCI-Public/circleci-cli) |
32 | 18 |
|
33 |
| -Install |
34 |
| ---------- |
35 | 19 |
|
36 |
| -1. create .pre-commit-config.yaml in you git project |
37 |
| -2. pre-commit install |
38 |
| -3. enjoy it |
| 20 | +## Installation |
39 | 21 |
|
40 |
| -example .pre-commit-config.yaml as following: |
| 22 | +1. [Install pre-commit](https://pre-commit.com/#install). |
| 23 | +1. [Install circlei-cli](https://github.com/CircleCI-Public/circleci-cli). |
| 24 | +1. Create a `.pre-commit-config.yaml` file in your repository. Set up CircleCI |
| 25 | + validation as follows: |
| 26 | + ```yaml |
| 27 | + repos: |
| 28 | + - repo: http://github.com/KoBoldMetals/pre-commit-circleci |
| 29 | + rev: v0.0.4 |
| 30 | + hooks: |
| 31 | + - id: circleci-validate |
| 32 | + ``` |
| 33 | +1. Run `pre-commit install` to install the hook. |
41 | 34 |
|
42 |
| -```yaml |
43 |
| -- repo: http://github.com/danielhoherd/pre-commit-circleci |
44 |
| - rev: v0.0.1 |
45 |
| - hooks: |
46 |
| - - id: circleci-validate |
47 |
| -``` |
48 | 35 |
|
49 |
| -Contributing |
50 |
| ------------- |
| 36 | +## Contributing |
51 | 37 |
|
52 |
| -To contribute to pre-commit-circleci, clone this repo locally and commit your code on a separate branch. |
| 38 | +To contribute to `pre-commit-circleci`, clone this repository locally and |
| 39 | +commit your code on a separate branch, then submit a pull request. |
53 | 40 |
|
54 | 41 |
|
55 |
| -Author |
56 |
| ------- |
| 42 | +## Authors |
57 | 43 |
|
58 |
| -- GitHub [@danielhoherd](https://github.com/danielhoherd) |
59 |
| -- GitHub [@detailyang](https://github.com/detailyang) - [pre-commit shell-lint](https://github.com/detailyang/pre-commit-shell) was used as a template for pre-commit circleci-validate. |
| 44 | +- GitHub [@mplough](https://github.com/mplough) |
| 45 | +- GitHub [@danielhoherd](https://github.com/danielhoherd) - forked from his |
| 46 | + original [pre-commit-circle-ci](https://github.com/danielhoherd/pre-commit-circleci) tool. |
| 47 | +- GitHub [@detailyang](https://github.com/detailyang) - [pre-commit |
| 48 | + shell-lint](https://github.com/detailyang/pre-commit-shell) was used as a |
| 49 | + template for the validation hook. |
60 | 50 |
|
61 | 51 |
|
62 |
| -License |
63 |
| -------- |
| 52 | +## License |
64 | 53 |
|
65 |
| -pre-commit-circleci is licensed under the [MIT](https://github.com/danielhoherd/pre-commit-circleci/blob/master/LICENSE) license. |
| 54 | +pre-commit-circleci is licensed under the [MIT](https://github.com/KoBoldMetals/pre-commit-circleci/blob/master/LICENSE) license. |
0 commit comments