UNPKG

1.89 kBMarkdownView Raw
1#Ruby Starter Kit
2This 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
11Place 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```
18cd my-app
19gem install bundler
20bundle install
21```
22
23Alternatively 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
26Run the app entry point script:
27```
28repo=octokit.py bin/app.rb
29```
30
31Run the guard dev env tool:
32```
33guard
34```
35It will run rubocop on start, will run rubocop inspections on changed files and will re-run all RSpecs and rubocop
36inspections if you hit Enter in guard window.