1 | #Ruby Starter Kit
|
2 | This is a Ruby app boilerplate with conventional code structure and basic dev env to start some console mode utility app with (Bundler, Guard, ActiveSupport Logger, Rubocop, RSpec, WebMock, Travis, CodeClimate).
|
3 |
|
4 | [![Travis build status](http://img.shields.io/travis/artemv/ruby-starter-kit.svg?style=flat)](https://travis-ci.org/artemv/ruby-starter-kit)
|
5 | [![Code Climate](https://codeclimate.com/github/artemv/ruby-starter-kit/badges/gpa.svg)](https://codeclimate.com/github/artemv/ruby-starter-kit)
|
6 | [![Test Coverage](https://codeclimate.com/github/artemv/ruby-starter-kit/badges/coverage.svg)](https://codeclimate.com/github/artemv/ruby-starter-kit/coverage)
|
7 | [![Dependency Status](https://gemnasium.com/artemv/ruby-starter-kit.svg)](https://gemnasium.com/artemv/ruby-starter-kit)
|
8 | [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
|
9 |
|
10 | #App code structure
|
11 | Place your app-specific code in app/ dir, and utility code that you'd like to extract to gems later to lib/ dir. Files in both of them are autoloaded from app.rb (via lib/environment.rb).
|
12 |
|
13 | #Installation
|
14 | * Clone the repo: `git clone https://github.com/artemv/ruby-starter-kit.git my-app`
|
15 | * Install Ruby 2.3.0 from https://www.ruby-lang.org/en/downloads/ or via RVM (https://rvm.io/)
|
16 | * Install Bundler and dependencies:
|
17 | ```
|
18 | cd my-app
|
19 | gem install bundler
|
20 | bundle install
|
21 | ```
|
22 |
|
23 | Alternatively if you are using Yeoman you can install it using its generator as described [here](https://github.com/artemv/generator-ruby-starter-kit).
|
24 |
|
25 | #Usage
|
26 | Run the app entry point script:
|
27 | ```
|
28 | repo=octokit.py bin/app.rb
|
29 | ```
|
30 |
|
31 | Run the guard dev env tool:
|
32 | ```
|
33 | guard
|
34 | ```
|
35 | It will run rubocop on start, will run rubocop inspections on changed files and will re-run all RSpecs and rubocop
|
36 | inspections if you hit Enter in guard window.
|