Skip to content

altmetric/house_style

Repository files navigation

HouseStyle

Be nice and consistent from project to project.

This gem acts as a local repository for house style checkers for Ruby and Rails projects.

Installation

Add this line to your application's Gemfile:

gem 'house_style'

And then execute:

$ bundle

Usage

For non-Rails projects, add the following to the top of your .rubocop.yml file:

inherit_gem:
  house_style: ruby/rubocop.yml

If your project is a Rails project, you should use the instruction below, which includes all the standard Ruby house styles, with Rails-specific cops:

inherit_gem:
  house_style: rails/rubocop.yml

house_style comes with a Rails generator which can set up both your project root and your RSpec folder to start using the default house styles by default. With house_style declared in your Gemfile:

$ rails generate house_style:install

This will create .rubocop.yml files in your project root and spec folders.

Development

The gem has no executable code of its own, so there is no test suite to speak of.

Before committing any changes, ensure that it conforms to its own rubocop settings.

To install this gem onto your local machine, run bundle exec rake install.

Releasing a new version

Update the version number in house_style.gemspec, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/altmetric/house_style. 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.

License

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