boring_generators

Boring generators aims to make your development faster by delegating boring setups to us.

Description

About Boring Generator Boring Generator aims to reduce the amount of time spent on configuration, installation and addition of services, gems and libraries to the Rails application by a developer by delegating boring setups to us.

Motivation Have you ever started a new adventure/hobby project of your and instead of spending time in solving the actual problem statement with the website ended up configuring the application and put a lot of effort into it. Yeah, We felt that too.

I try to contribute to Ruby on Rails and recently I spent some times working on contributing to the Rails ActionText and Action Mailbox modules. Rails provide with many generators. Yes, rails new is also a generator used behind the scene with Thor gem. Action Text provides install a generator to easily configure Action Text instead of letting the developer running into configuration issue.

This motivated me to build something which could help the people around Rails community who can spend less time on configuration and installation of the libraries/gems(basically boring stuff) and focus on the root problem you want to encounter by the awesome application you build.

Contributing All contributor, advisor, critic are welcome to contribute to the project. We welcome every idea, feature request and pull-request from the developers to make the boring generator more awesome and boring :). Read contributing guide.

Monthly Downloads: 221

Programming language: Ruby

License: MIT License

Tags: Configuration     Rails Application Generators     Rails    

Latest version: v0.11.0

README

Boring Generators

Have you ever started a new adventure/hobby project of your and instead of spending time in solving the actual problem statement with the website ended up configuring the application and put a lot of effort into it. Yeah, We felt that too. Boring generator tries to resolve the painful same redundant configuration you do in every application by adding generators to easily configure it.

Check out the generator we support right now. We are planning to add support to most of the mostly used and required gems. We are open to any idea of yours, feel free to raise a discussion by opening up an issue or try contributing.

Installation

Add this line to your application's Gemfile:

gem 'boring_generators'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install boring_generators

And then you can use it this way:

$ boring generate boring:simple_form:install --css_framework=<css_framework>
$ boring g boring:pry:install

Usage

The boring generator introduces following generators:

• Install Tailwind CSS: rails generate boring:tailwind:install
• Install Bootstrap: rails generate boring:bootstrap:install
• Install JQuery: rails generate boring:jquery:install
• Install FontAwesome via Yarn: rails generate boring:font_awesome:yarn:install
• Install FontAwesome via RubyGems: rails generate boring:font_awesome:ruby_gem:install
• Install Bullet: rails generate boring:bullet:install
• Install Audit gems(bundler-audit, ruby_audit): rails generate boring:audit:install
• Install Pry gems for easy debugging: rails generate boring:pry:install
• Install Active Storage for Google Cloud Service: rails generate boring:active_storage:google:install
• Install Active Storage for AWS: rails generate boring:active_storage:aws:install
• Install Active Storage for Azure: rails generate boring:active_storage:azure:install
• Install CircleCI: rails generate boring:ci:circleci:install --repository_name=<name> --ruby_version=<version>
• Install GitHub Actions: rails generate boring:ci:github_action:install --repository_name=<name> --ruby_version=<version>
• Install Travis CI: rails generate boring:ci:travisci:install --ruby_version=<version>
• Install Rubocop: rails generate boring:rubocop:install --ruby_version=<version>
• Build Favicon: rails generate boring:favicon:build --application_name=<application_name> --favico_letter=<favico_letter> --primary_color=<color>
• Install Pundit: rails generate boring:pundit:install
• Install GraphQL: rails generate boring:graphql:install
• Install SimpleForm: rails generate boring:simple_form:install --css_framework=<css_framework>
• Install Devise: rails generate boring:devise:install
• Install Devise Facebook Omniauth: rails generate boring:oauth:facebook:install
• Install Devise GitHub Omniauth: rails generate boring:oauth:github:install
• Install Devise Google Omniauth: rails generate boring:oauth:google:install
• Install Devise Twitter Omniauth: rails generate boring:oauth:twitter:install
• Install Twilio: rails generate boring:twilio:install
• Install Ahoy: rails generate boring:ahoy:install
• Install Stripe: rails generate boring:payments:stripe:install
• Install Stimulus: rails generate boring:stimulus:install
• Install Rails Admin: rails generate boring:rails_admin:install
• Install Paper Trail: rails generate boring:paper_trail:install
• Install Flipper: rails generate boring:flipper:install

Screencasts

• How to use Boring Generators by Yaroslav Shmarov

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

You can also run specific test cases using following commands:

bundle exec ruby -w -Itest test/generators/tailwind_install_generator_test.rb

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, 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/abhaynikam/boring_generators. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

Changelog

Boring Generators changelog is available here.

License

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

Code of Conduct

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