Build Status Maintainability Test Coverage

SafePusher

Run your favorite linters and specs on the files you touched, before committing and pushing your branch.

Installation

Add these lines to your application's Gemfile:

# Lint and launch specs before pushing.
gem 'safe_pusher', require: false

And then execute:

$ bundle

Or install it yourself as:

$ gem install safe_pusher

To use the gem fully, you should install pronto and rspec first.

Configuration

Generate the binstubs for pronto, rspec and safepush:

$ bundler binstubs pronto rspec-core safe_pusher

Create the safe_pusher.yml file at the root of your application:

files_to_skip:
  - file/to/skip_1
  - file/to/skip/2
base_branch: developement # default master
app_base_directory: app
repo_url: https://github.com/williampollet/safe_pusher
services:
  test: rspec
  lint: pronto
  push: github
  open: github
  add: git
  amend: git
  commit: git
verbose: true

Usage

To see the commands available, type:

$ safepush

To run pronto checks before you push to GitHub run:

$ safepush lint push open

or

$ safepush l p o

To run specs and pronto before you push to GitHub run:

$ safepush test lint push open

or

$ safepush t l p o

Available commands so far

  • test (runs the tests only on the files you touched)
  • lint (runs a linter only on the files you touched)
  • commit (commit your changes)
  • add (track your changes)
  • amend (amend your tracked changes to your last commit)
  • push (push and set upstream your local branch on github)
  • open (open a pull request on github)

Contributing

You can easily add a new client, or a new command.

To add a client

  • create the client api under lib/safe_pusher/client/***.rb
  • require it in lib/safe_pusher.rb
  • write the specs for your client, then submit a PR
  • You will be able to specify in which command to use it, via the configuration !

To add a command

  • configure your command and its client in config/commands.yml
  • create your safepusher client api, as detailed above (if necessary)
  • include your command's description in the help, in config/en.yml

Guidelines

Bug reports and pull requests are welcome on GitHub at https://github.com/williampollet/safe_pusher. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Development

Setup development:

$ bin/setup

Open a console:

$ bin/console

Test the CLI:

$ ruby -Ilib exe/safepush

Launch specs and lint:

$ rake

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the SafePusher project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.