fiscally 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9362c857fbcfb1bac89099d792bbf1b8973ff73d
+  data.tar.gz: 143390f0d2b770114241a70e25280455f8509a82
+SHA512:
+  metadata.gz: c1cbbe76af2cd0b4171a811502b1ebd083d91ed57bf455247cc6a22833877d7029a5b269775a0eb911dc83efc0407a74ec9ad24af845abd275db192317cbd006
+  data.tar.gz: 1c8e61347016690a516100b3f6f1268d9e93e29383c9475b309a61fbeed781bbbb3ef426424724455b7b996916877cabe2d18873b2ba424361720bfa8ac2664b

data/.gitignore

@@ -0,0 +1,37 @@
+## Virtual Machine files
+/.vagrant/
+
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--require spec_helper
+--format Fuubar

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+
+cache: bundler
+
+rvm:
+  - 2.0.0
+  - 2.1.0
+  - 2.2.0
+  - 2.2.1
+  - 2.2.2
+  - 2.3.0
+  - ruby-head
+
+script: bundle exec rspec spec

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Forge Software
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,357 @@
+# fiscally
+
+[![Gem Version](https://badge.fury.io/rb/fiscally.svg)](https://rubygems.org/gems/fiscally)
+[![Build Status](https://travis-ci.org/forgecrafted/fiscally.svg?branch=master)](https://travis-ci.org/forgecrafted/fiscally)
+[![Coverage Status](https://coveralls.io/repos/forgecrafted/fiscally/badge.svg?branch=master)](https://coveralls.io/r/forgecrafted/fiscally?branch=master)
+
+Projects with a financial or business bent often have to deal with awareness of a fiscal year, which typically doesn't line up with a normal calendar year.
+
+The `Fiscally` gem adds the necessary awareness to your date and time objects, covering start and end dates for fiscal years and quarterly breakdowns.
+
+## Installation
+
+Gemfile
+```
+gem 'fiscally'
+```
+
+Command line
+```
+gem install 'fiscally'
+```
+
+### Ruby Version
+
+Built and tested against **`2.0.0` and above**, but Probably Works™ in `1.9.3`.
+
+## Usage
+
+All calculations are done **relative to the date and/or time represented by your object**. This is particularly important to remember for methods that calculate a "current" value. Our documentation examples use dates in the past to drive this point home.
+
+Time is always set to midnight (`00:00:00`), when applicable.
+
+Examples below use `Time`, but all methods outlined are available to `Date` and `DateTime` objects as well.
+
+  - [`#fiscal_start=`](https://github.com/forgecrafted/fiscally#fiscal_start) :boom:
+  - [`#fiscal_quarter`](https://github.com/forgecrafted/fiscally#fiscal_quarter)
+  - [`#all_quarter_months`](https://github.com/forgecrafted/fiscally#all_quarter_months)
+  - [`#fiscal_quarter_months`](https://github.com/forgecrafted/fiscally#fiscal_quarter_months)
+  - [`#first_month_of_quarter`](https://github.com/forgecrafted/fiscally#first_month_of_quarter)
+  - [`#first_quarter`](https://github.com/forgecrafted/fiscally#first_quarter)
+  - [`#second_quarter`](https://github.com/forgecrafted/fiscally#second_quarter)
+  - [`#third_quarter`](https://github.com/forgecrafted/fiscally#third_quarter)
+  - [`#fourth_quarter`](https://github.com/forgecrafted/fiscally#fourth_quarter)
+  - [`#beginning_of_fiscal_year`](https://github.com/forgecrafted/fiscally#beginning_of_fiscal_year)
+  - [`#beginning_of_fiscal_quarter`](https://github.com/forgecrafted/fiscally#beginning_of_fiscal_quarter)
+  - [`#end_of_fiscal_year`](https://github.com/forgecrafted/fiscally#end_of_fiscal_year)
+  - [`#end_of_fiscal_quarter`](https://github.com/forgecrafted/fiscally#end_of_fiscal_quarter)
+  - [`#quarter_starting_dates`](https://github.com/forgecrafted/fiscally#quarter_starting_dates)
+  - [`#quarter_ending_dates`](https://github.com/forgecrafted/fiscally#quarter_ending_dates)
+
+### `#fiscal_start=`
+###### `objekt.fiscal_start = 8`
+
+Sets the **month** in which the fiscal calendar will start on the given `objekt`, represented as an `Integer`. The **day** is always set to the first of the month, and is immutable. Defaults to January (`fiscal_start = 1`).
+
+This is the lynchpin of the entire system, adjusting the calendar start and end months to something other than January and December.
+
+Calling `objekt.fiscal_start` without an assignment will return the currently set value.
+
+This value is not frozen, and can be changed at any time.
+
+```ruby
+foo = Time.new(2014, 1)
+foo.fiscal_start
+# => 1
+
+bar = Date.new(2015, 9)
+bar.fiscal_start
+# => 1
+
+baz = DateTime.new(2025, 9)
+baz.fiscal_start
+# => 1
+
+# this is mutable
+baz.fiscal_start = 4
+baz.fiscal_start
+# => 4
+```
+
+### `#fiscal_quarter`
+
+Returns an integer representing the current quarter.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.fiscal_quarter
+# => 1
+
+jan01.fiscal_start = 4
+jan01.fiscal_quarter
+# => 4
+
+jan01.fiscal_start = 10
+jan01.fiscal_quarter
+# => 2
+```
+
+### `#all_quarter_months`
+
+Returns an array of arrays, the first level representing the quarters in order, followed by an array of integers representing the months within that quarter.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.all_quarter_months
+# => [[1,2,3], [4,5,6], [7,8,9], [10,11,12]]
+
+jan01.fiscal_start = 4
+jan01.all_quarter_months
+# => [[4,5,6], [7,8,9], [10,11,12], [1,2,3]]
+
+jan01.fiscal_start = 11
+jan01.all_quarter_months
+# => [[11,12,1], [2,3,4], [5,6,7], [8,9,10]]
+```
+
+### `#fiscal_quarter_months`
+
+Returns an array of integers, representing the months of the current quarter.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.fiscal_start = 4
+jan01.fiscal_quarter_months
+# => [1,2,3]
+
+jan01.fiscal_start = 2
+jan01.fiscal_quarter_months
+# => [11,12,1]
+
+jan01.fiscal_start = 11
+jan01.fiscal_quarter_months
+# => [11,12,1]
+
+jan01.fiscal_start = 9
+jan01.fiscal_quarter_months
+# => [12,1,2]
+```
+
+### `#first_month_of_quarter`
+
+Returns an integer representing the first month of the current quarter.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.fiscal_start = 4
+jan01.first_month_of_quarter
+# => 1
+
+jan01.fiscal_start = 2
+jan01.first_month_of_quarter
+# => 11
+
+jan01.fiscal_start = 11
+jan01.first_month_of_quarter
+# => 11
+
+jan01.fiscal_start = 9
+jan01.first_month_of_quarter
+# => 12
+```
+
+### `#first_quarter`
+
+Returns an array of integers, representing the months of the first quarter. Aliased to `q1`.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.first_quarter
+# => [1,2,3]
+jan01.q1
+# => [1,2,3]
+```
+
+### `#second_quarter`
+
+Returns an array of integers, representing the months of the second quarter. Aliased to `q2`.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.second_quarter
+# => [4,5,6]
+jan01.q2
+# => [4,5,6]
+```
+
+### `#third_quarter`
+
+Returns an array of integers, representing the months of the third quarter. Aliased to `q3`.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.third_quarter
+# => [7,8,9]
+jan01.q3
+# => [7,8,9]
+```
+
+### `#fourth_quarter`
+
+Returns an array of integers, representing the months of the fourth quarter. Aliased to `q4`.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.fourth_quarter
+# => [10,11,12]
+jan01.q4
+# => [10,11,12]
+```
+
+### `#beginning_of_fiscal_year`
+
+Returns a new `Time`/`Date`/`DateTime` object representing the starting date of the fiscal year.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.fiscal_start = 3
+jan01.beginning_of_fiscal_year.strftime('%F')
+# => '2014-03-01'
+
+jan01.fiscal_start = 9
+jan01.beginning_of_fiscal_year.strftime('%F')
+# => '2014-09-01'
+
+jan01.fiscal_start = 12
+jan01.beginning_of_fiscal_year.strftime('%F')
+# => '2014-12-01'
+```
+
+The returned object will always match the original object class.
+
+```ruby
+Time.new.beginning_of_fiscal_year.class
+# => Time
+Date.new.beginning_of_fiscal_year.class
+# => Date
+DateTime.new.beginning_of_fiscal_year.class
+# => DateTime
+```
+
+### `#beginning_of_fiscal_quarter`
+
+Returns a new `Time`/`Date`/`DateTime` object representing the starting date of the current fiscal quarter.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.beginning_of_fiscal_quarter.strftime('%F')
+# => '2015-01-01'
+
+jan01.fiscal_start = 4
+jan01.beginning_of_fiscal_quarter.strftime('%F')
+# => '2015-01-01'
+
+jan01.fiscal_start = 2
+jan01.beginning_of_fiscal_quarter.strftime('%F')
+# => '2014-11-01'
+
+jan01.fiscal_start = 11
+jan01.beginning_of_fiscal_quarter.strftime('%F')
+# => '2014-11-01'
+
+jan01.fiscal_start = 9
+jan01.beginning_of_fiscal_quarter.strftime('%F')
+# => '2014-12-01'
+```
+
+### `#end_of_fiscal_year`
+
+Returns a new `Time`/`Date`/`DateTime` object representing the last day of the current fiscal year.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-03-31'
+
+jan01.fiscal_start = 4
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-03-31'
+
+jan01.fiscal_start = 2
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-01-31'
+
+jan01.fiscal_start = 11
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-01-31'
+
+jan01.fiscal_start = 9
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-02-28'
+```
+
+### `#end_of_fiscal_quarter`
+
+Returns a new `Time`/`Date`/`DateTime` object representing the last day of the current fiscal quarter.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-03-31'
+
+jan01.fiscal_start = 4
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-03-31'
+
+jan01.fiscal_start = 2
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-01-31'
+
+jan01.fiscal_start = 11
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-01-31'
+
+jan01.fiscal_start = 9
+jan01.end_of_fiscal_quarter.strftime('%F')
+# => '2015-02-28'
+```
+
+### `#quarter_starting_dates`
+
+Returns an array of `Time`/`Date`/`DateTime` objects representing the first day of each quarter for the current fiscal year.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.quarter_starting_dates.each { |time_obj| puts time_obj.strftime('%F') }
+# => '2015-01-01'
+# => '2015-04-01'
+# => '2015-07-01'
+# => '2015-10-01'
+
+jan01.fiscal_start = 2
+jan01.quarter_starting_dates.each { |time_obj| puts time_obj.strftime('%F') }
+# => '2014-02-01'
+# => '2014-05-01'
+# => '2014-08-01'
+# => '2014-11-01'
+```
+
+### `#quarter_ending_dates`
+
+Returns an array of `Time`/`Date`/`DateTime` objects representing the last day of each quarter for the current fiscal year.
+
+```ruby
+jan01 = Time.new(2015, 1)
+jan01.quarter_ending_dates.each { |time_obj| puts time_obj.strftime('%F') }
+# => '2015-03-31'
+# => '2015-06-30'
+# => '2015-09-30'
+# => '2015-12-31'
+
+jan01.fiscal_start = 2
+jan01.quarter_ending_dates.each { |time_obj| puts time_obj.strftime('%F') }
+# => '2014-04-30'
+# => '2014-07-31'
+# => '2014-10-31'
+# => '2015-01-31'
+```

data/Rakefile

@@ -0,0 +1,24 @@
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I lib -r fiscally.rb"
+end
+task :c => :console
+
+namespace :gem do
+  desc "Connect to RubyGems.org account"
+  task :auth do
+    sh "curl -u forgecrafted https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials; chmod 0600 ~/.gem/credentials"
+  end
+
+  desc "Build the gem according to gemspec"
+  task :build do
+    sh "gem build fiscally.gemspec"
+  end
+
+  require "./lib/fiscally/version"
+  desc "Push the gem to RubyGems.org"
+  task :push do
+    sh "gem push fiscally-#{FinishingMoves::VERSION}.gem"
+  end
+end

data/Vagrantfile

@@ -0,0 +1,48 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+NAME = "fiscally"
+FQDN = "#{NAME}.example.com"
+
+Vagrant.configure("2") do |config|
+  # "trusty" is 14.04
+  config.vm.box       = "trusty64"
+  config.vm.box_url   = "https://cloud-images.ubuntu.com/vagrant/trusty/current/trusty-server-cloudimg-amd64-vagrant-disk1.box"
+
+  # Use the normal insecure key
+  # https://github.com/mitchellh/vagrant/issues/2608
+  config.ssh.insert_key = false
+
+  config.vm.provider :virtualbox do |vb|
+    vb.customize ["modifyvm", :id,
+      # Basics.
+      "--name",       NAME,
+      "--memory",     4096,
+      # I/O APIC must be enabled to support a multi-core guest.
+      "--cpus",       4,
+      "--ioapic",     "on",
+      # Enable native host virtualization features (yields better performance).
+      "--pae",        "on",
+      "--hwvirtex",   "on",
+      "--largepages", "on",
+      "--vtxvpid",    "on",
+      # This causes the virtual machine to proxy DNS requests through the host
+      # via NAT. Without this, the default resolver on the guest will introduce
+      # a 5 second latency on every HTTP request... which is a real downer.
+      "--natdnshostresolver1", "on"
+    ]
+  end
+
+  config.vm.hostname = FQDN
+  config.vm.provision :shell, path: "provision.sh"
+end
+
+#
+# DONT FORGET!
+#
+# Force update VirtualBox Guest Additions
+# Run the following command inside same directory as Vagrantfile
+# Must be done once on your dev system
+#
+#   vagrant plugin install vagrant-vbguest
+#

data/fiscally.gemspec

@@ -0,0 +1,33 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+require "fiscally/version"
+
+Gem::Specification.new do |s|
+
+  s.name        = "fiscally"
+  s.version     = Fiscally::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Frank Koehl"]
+  s.email       = ["frank@forgecrafted.com", "chris@forgecrafted.com"]
+  s.summary     = %q{Fiscal year awareness for Ruby Date and Time classes.}
+  s.description = <<-EOF
+    Projects with a financial or business bent often have to deal with awareness of a fiscal year, which typically doesn't line up with a normal calendar year.
+
+    The `Fiscally` gem adds the necessary awareness to your date and time objects, covering start and end dates for fiscal years and quarterly breakdowns.
+  EOF
+  s.homepage    = "https://github.com/forgecrafted/fiscally"
+  s.license     = "MIT"
+
+  s.files       = `git ls-files -z`.split("\x0")
+  s.test_files  = Dir["spec/**/*"]
+
+  s.add_development_dependency 'rb-readline', '>= 0'
+  s.add_development_dependency 'rspec', '~> 3.1.0'
+  s.add_development_dependency 'priscilla', '>= 0'
+  s.add_development_dependency 'pry-byebug', '>= 0'
+  s.add_development_dependency 'fuubar', '>= 0'
+  s.add_development_dependency 'coveralls', '>= 0.8.0'
+
+  s.required_ruby_version = '>= 2.0.0'
+
+end

data/lib/fiscally.rb

@@ -0,0 +1,7 @@
+module Fiscally
+
+  Dir[File.dirname(__FILE__) + '/fiscally/*.rb'].each do |file|
+    require file
+  end
+
+end

data/lib/fiscally/fiscally.rb

@@ -0,0 +1,132 @@
+require 'date'
+
+module FiscallyGemMethods
+
+  def fiscal_start
+    @fiscal_start = 1 if @fiscal_start.nil?
+    @fiscal_start
+  end
+
+  def fiscal_start=(month)
+    @fiscal_start = Integer(month)
+  end
+
+  def fiscal_quarter
+    ((( self.month + ( 12 - fiscal_start ) ) / 3 ) % 4 ) + 1
+  end
+
+  def all_quarter_months
+    quarters = []
+    this_quarter = []
+    this_month = fiscal_start
+    (1..12).each do |n|
+      this_quarter << this_month
+      if n % 3 == 0
+        quarters << this_quarter
+        this_quarter = []
+      end
+      this_month = this_month < 12 ? this_month + 1 : 1
+    end
+    quarters
+  end
+  alias_method :fiscal_calendar, :all_quarter_months
+
+  def fiscal_quarter_months
+    all_quarter_months[fiscal_quarter - 1]
+  end
+
+  def first_month_of_quarter
+    fiscal_quarter_months[0]
+  end
+
+  def first_quarter
+    all_quarter_months[0]
+  end
+  alias_method :q1, :first_quarter
+
+  def second_quarter
+    all_quarter_months[1]
+  end
+  alias_method :q2, :second_quarter
+
+  def third_quarter
+    all_quarter_months[2]
+  end
+  alias_method :q3, :third_quarter
+
+  def fourth_quarter
+    all_quarter_months[3]
+  end
+  alias_method :q4, :fourth_quarter
+
+  def beginning_of_fiscal_year
+    self.class.new _last_fiscal_year_for_month(q1[0]), q1[0]
+  end
+
+  def beginning_of_fiscal_quarter
+    self.class.new _last_fiscal_year_for_month(first_month_of_quarter), first_month_of_quarter
+  end
+
+  def end_of_fiscal_year
+    if self.class.name == 'Time'
+      d = beginning_of_fiscal_year + (60*60*24*385)
+      self.class.new(d.year, d.month) - (60*60*24)
+    else
+      d = beginning_of_fiscal_year >> 12
+      self.class.new(d.year, d.month) - 1
+    end
+  end
+
+  def end_of_fiscal_quarter
+    if self.class.name == 'Time'
+      d = beginning_of_fiscal_quarter + (60*60*24*100)
+      self.class.new(d.year, d.month) - (60*60*24)
+    else
+      d = beginning_of_fiscal_quarter >> 3
+      self.class.new(d.year, d.month) - 1
+    end
+  end
+
+  def quarter_starting_dates
+    ret = []
+    all_quarter_months.map { |months| months[0] }.each do |m|
+      y = m >= fiscal_start ? starting_year : starting_year + 1
+      ret << self.class.new(y, m)
+    end
+    ret
+  end
+
+  def quarter_ending_dates
+    ret = []
+    all_quarter_months.map { |months| months[2] }.each do |m|
+      y = m >= fiscal_start ? starting_year : starting_year + 1
+      if self.class.name == 'Time'
+        d = self.class.new(y, m) + (60*60*24*42)
+        ret << self.class.new(d.year, d.month) - (60*60*24)
+      else
+        d = self.class.new(y, m) >> 1
+        ret << self.class.new(d.year, d.month) - 1
+      end
+    end
+    ret
+  end
+
+  protected
+
+  def starting_year
+    fiscal_start > 1 ? self.year - 1 : self.year
+  end
+
+  def _last_fiscal_year_for_month(month)
+    if month == fiscal_start && month == self.month
+      self.year
+    else
+      month >= fiscal_start ? self.year - 1 : self.year
+    end
+  end
+
+end
+
+Time.send :include, FiscallyGemMethods
+Date.send :include, FiscallyGemMethods
+DateTime.send :include, FiscallyGemMethods

data/lib/fiscally/version.rb

@@ -0,0 +1,3 @@
+module Fiscally
+  VERSION = "1.0"
+end

data/provision.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+
+# Shell user settings.
+USER_NAME=vagrant
+USER_HOME=/home/$USER_NAME
+DEFAULT_RUBY='2.2.2'
+
+###############################################################################
+# Functions
+###############################################################################
+# Most of the time we can get by with this DRY wrapper for sudo commands.
+as_user() {
+  echo "$USER_NAME:~$ > ${*}"
+  su -l $USER_NAME -c "$*"
+}
+
+###############################################################################
+# Base System
+###############################################################################
+apt-get -y update
+apt-get -yfV dist-upgrade
+
+###############################################################################
+# rbenv & ruby-build, and Rubies
+# From https://github.com/sstephenson/rbenv
+# and https://github.com/sstephenson/ruby-build
+###############################################################################
+
+# Install dependencies.
+apt-get install -yfV         \
+  build-essential            \
+  curl                       \
+  git-core                   \
+  libcurl4-openssl-dev       \
+  libreadline-dev            \
+  libsqlite3-dev             \
+  libssl-dev                 \
+  libxml2-dev                \
+  libxslt1-dev               \
+  libyaml-dev                \
+  python-software-properties \
+  sqlite3                    \
+  zlib1g-dev                 \
+
+# Install rbenv and ruby-build.
+as_user "git clone https://github.com/sstephenson/rbenv.git $USER_HOME/.rbenv"
+as_user "git clone https://github.com/sstephenson/ruby-build.git $USER_HOME/.rbenv/plugins/ruby-build"
+
+# Setup bash to use rbenv for $USER_NAME.
+truncate -s 0 $USER_HOME/.bashrc
+echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> $USER_HOME/.bashrc
+echo 'eval "$(rbenv init -)"'               >> $USER_HOME/.bashrc
+echo 'cd /vagrant'                          >> $USER_HOME/.bashrc
+
+echo 'gem: --no-document' > $USER_HOME/.gemrc
+
+# Install the requested version of Ruby, with Bundler.
+as_user "rbenv install -s $DEFAULT_RUBY"
+as_user "rbenv global $DEFAULT_RUBY"
+as_user "RBENV_VERSION=$DEFAULT_RUBY gem install bundler"
+as_user "cd /vagrant && bundle"

data/spec/fiscally_spec.rb

@@ -0,0 +1,254 @@
+require 'spec_helper'
+
+describe 'Fiscally' do
+
+  let(:default_quarters) { [[1,2,3], [4,5,6], [7,8,9], [10,11,12]] }
+
+  before(:example) do
+    @jan01 = Time.new(2015, 1)
+  end
+
+  it "is included into Time, Date, and DateTime" do
+    expect(Time.method_defined? :fiscal_start).to be true
+    expect(Time.method_defined? :fiscal_quarter).to be true
+    expect(Time.method_defined? :all_quarter_months).to be true
+    expect(Time.method_defined? :fiscal_quarter_months).to be true
+
+    expect(Date.method_defined? :fiscal_start).to be true
+    expect(Date.method_defined? :fiscal_quarter).to be true
+    expect(Date.method_defined? :all_quarter_months).to be true
+    expect(Date.method_defined? :fiscal_quarter_months).to be true
+
+    expect(DateTime.method_defined? :fiscal_start).to be true
+    expect(DateTime.method_defined? :fiscal_quarter).to be true
+    expect(DateTime.method_defined? :all_quarter_months).to be true
+    expect(DateTime.method_defined? :fiscal_quarter_months).to be true
+  end
+
+  it "#fiscal_quarter" do
+    q = 1
+    default_quarters.each do |months|
+      months.each { |m| expect(Time.new(2015, m).fiscal_quarter).to eq q }
+      q += 1
+    end
+
+    # Adjusted fiscal calendar
+    @jan01.fiscal_start = 4
+    expect(@jan01.fiscal_quarter).to eq 4
+    @jan01.fiscal_start = 10
+    expect(@jan01.fiscal_quarter).to eq 2
+
+    # Make sure other date classes work
+    expect(Date.new(2015, 9).fiscal_quarter).to eq 3
+    expect(DateTime.new(2015, 9).fiscal_quarter).to eq 3
+  end
+
+  it "#all_quarter_months" do
+    expect(@jan01.all_quarter_months).to eq default_quarters
+    @jan01.fiscal_start = 4
+    expect(@jan01.all_quarter_months).to eq [[4,5,6], [7,8,9], [10,11,12], [1,2,3]]
+    @jan01.fiscal_start = 11
+    expect(@jan01.all_quarter_months).to eq [[11,12,1], [2,3,4], [5,6,7], [8,9,10]]
+
+    expect(Date.new(2015, 9).all_quarter_months).to eq default_quarters
+    expect(DateTime.new(2015, 9).all_quarter_months).to eq default_quarters
+    # alias check
+    expect(DateTime.new(2015, 9).fiscal_calendar).to eq default_quarters
+  end
+
+  it "#quarter shortcuts" do
+    expect(@jan01.first_quarter).to eq default_quarters[0]
+    expect(@jan01.q1).to eq default_quarters[0]
+    expect(@jan01.second_quarter).to eq default_quarters[1]
+    expect(@jan01.q2).to eq default_quarters[1]
+    expect(@jan01.third_quarter).to eq default_quarters[2]
+    expect(@jan01.q3).to eq default_quarters[2]
+    expect(@jan01.fourth_quarter).to eq default_quarters[3]
+    expect(@jan01.q4).to eq default_quarters[3]
+  end
+
+  it "#fiscal_quarter_months" do
+    expect(Time.new(2015, 1).fiscal_quarter_months).to eq [1,2,3]
+    expect(Date.new(2015, 2).fiscal_quarter_months).to eq [1,2,3]
+    expect(DateTime.new(2015, 5).fiscal_quarter_months).to eq [4,5,6]
+
+    @jan01.fiscal_start = 4
+    expect(@jan01.fiscal_quarter_months).to eq [1,2,3]
+    @jan01.fiscal_start = 2
+    expect(@jan01.fiscal_quarter_months).to eq [11,12,1]
+    @jan01.fiscal_start = 11
+    expect(@jan01.fiscal_quarter_months).to eq [11,12,1]
+    @jan01.fiscal_start = 9
+    expect(@jan01.fiscal_quarter_months).to eq [12,1,2]
+  end
+
+  it "#first_month_of_quarter" do
+    expect(Time.new(2015, 1).first_month_of_quarter).to eq 1
+    expect(Date.new(2015, 8).first_month_of_quarter).to eq 7
+    expect(DateTime.new(2015, 5).first_month_of_quarter).to eq 4
+
+    @jan01.fiscal_start = 4
+    expect(@jan01.first_month_of_quarter).to eq 1
+    @jan01.fiscal_start = 2
+    expect(@jan01.first_month_of_quarter).to eq 11
+    @jan01.fiscal_start = 11
+    expect(@jan01.first_month_of_quarter).to eq 11
+    @jan01.fiscal_start = 9
+    expect(@jan01.first_month_of_quarter).to eq 12
+  end
+
+  it "#beginning_of_fiscal_quarter" do
+    expect(Time.new.beginning_of_fiscal_quarter).to be_a Time
+    expect(Date.new.beginning_of_fiscal_quarter).to be_a Date
+    expect(DateTime.new.beginning_of_fiscal_quarter).to be_a DateTime
+
+    expect(@jan01.beginning_of_fiscal_quarter.strftime('%F')).to eq '2015-01-01'
+    @jan01.fiscal_start = 4
+    expect(@jan01.beginning_of_fiscal_quarter.strftime('%F')).to eq '2015-01-01'
+    @jan01.fiscal_start = 2
+    expect(@jan01.beginning_of_fiscal_quarter.strftime('%F')).to eq '2014-11-01'
+    @jan01.fiscal_start = 11
+    expect(@jan01.beginning_of_fiscal_quarter.strftime('%F')).to eq '2014-11-01'
+    @jan01.fiscal_start = 9
+    expect(@jan01.beginning_of_fiscal_quarter.strftime('%F')).to eq '2014-12-01'
+  end
+
+  it "#end_of_fiscal_quarter" do
+    expect(Time.new.end_of_fiscal_quarter).to be_a Time
+    expect(Date.new.end_of_fiscal_quarter).to be_a Date
+    expect(DateTime.new.end_of_fiscal_quarter).to be_a DateTime
+
+    expect(@jan01.end_of_fiscal_quarter.strftime('%F')).to eq '2015-03-31'
+    @jan01.fiscal_start = 4
+    expect(@jan01.end_of_fiscal_quarter.strftime('%F')).to eq '2015-03-31'
+    @jan01.fiscal_start = 2
+    expect(@jan01.end_of_fiscal_quarter.strftime('%F')).to eq '2015-01-31'
+    @jan01.fiscal_start = 11
+    expect(@jan01.end_of_fiscal_quarter.strftime('%F')).to eq '2015-01-31'
+    @jan01.fiscal_start = 9
+    expect(@jan01.end_of_fiscal_quarter.strftime('%F')).to eq '2015-02-28'
+
+    # Separate logic for Date and DateTime means separate tests
+    @jan01_date = Date.new(2015, 1)
+    expect(@jan01_date.end_of_fiscal_quarter.strftime('%F')).to eq '2015-03-31'
+    @jan01_date.fiscal_start = 4
+    expect(@jan01_date.end_of_fiscal_quarter.strftime('%F')).to eq '2015-03-31'
+    @jan01_date.fiscal_start = 2
+    expect(@jan01_date.end_of_fiscal_quarter.strftime('%F')).to eq '2015-01-31'
+    @jan01_date.fiscal_start = 11
+    expect(@jan01_date.end_of_fiscal_quarter.strftime('%F')).to eq '2015-01-31'
+    @jan01_date.fiscal_start = 9
+    expect(@jan01_date.end_of_fiscal_quarter.strftime('%F')).to eq '2015-02-28'
+
+    @jan01_datetime = DateTime.new(2015, 1)
+    expect(@jan01_datetime.end_of_fiscal_quarter.strftime('%F')).to eq '2015-03-31'
+    @jan01_datetime.fiscal_start = 4
+    expect(@jan01_datetime.end_of_fiscal_quarter.strftime('%F')).to eq '2015-03-31'
+    @jan01_datetime.fiscal_start = 2
+    expect(@jan01_datetime.end_of_fiscal_quarter.strftime('%F')).to eq '2015-01-31'
+    @jan01_datetime.fiscal_start = 11
+    expect(@jan01_datetime.end_of_fiscal_quarter.strftime('%F')).to eq '2015-01-31'
+    @jan01_datetime.fiscal_start = 9
+    expect(@jan01_datetime.end_of_fiscal_quarter.strftime('%F')).to eq '2015-02-28'
+  end
+
+  it "#beginning_of_fiscal_year" do
+    expect(Time.new.beginning_of_fiscal_year).to be_a Time
+    expect(Date.new.beginning_of_fiscal_year).to be_a Date
+    expect(DateTime.new.beginning_of_fiscal_year).to be_a DateTime
+
+    @jan01.fiscal_start = 3
+    expect(@jan01.beginning_of_fiscal_year.strftime('%F')).to eq '2014-03-01'
+    @jan01.fiscal_start = 9
+    expect(@jan01.beginning_of_fiscal_year.strftime('%F')).to eq '2014-09-01'
+    @jan01.fiscal_start = 12
+    expect(@jan01.beginning_of_fiscal_year.strftime('%F')).to eq '2014-12-01'
+  end
+
+  it "#end_of_fiscal_year" do
+    expect(Time.new.end_of_fiscal_year).to be_a Time
+    expect(Date.new.end_of_fiscal_year).to be_a Date
+    expect(DateTime.new.end_of_fiscal_year).to be_a DateTime
+
+    @jan01.fiscal_start = 3
+    expect(@jan01.end_of_fiscal_year.strftime('%F')).to eq '2015-02-28'
+    @jan01.fiscal_start = 9
+    expect(@jan01.end_of_fiscal_year.strftime('%F')).to eq '2015-08-31'
+    @jan01.fiscal_start = 12
+    expect(@jan01.end_of_fiscal_year.strftime('%F')).to eq '2015-11-30'
+
+    # Separate logic for Date and DateTime means separate tests
+    @jan01_date = Date.new(2015, 1)
+    @jan01_date.fiscal_start = 3
+    expect(@jan01_date.end_of_fiscal_year.strftime('%F')).to eq '2015-02-28'
+    @jan01_date.fiscal_start = 9
+    expect(@jan01_date.end_of_fiscal_year.strftime('%F')).to eq '2015-08-31'
+    @jan01_date.fiscal_start = 12
+    expect(@jan01_date.end_of_fiscal_year.strftime('%F')).to eq '2015-11-30'
+
+    @jan01_datetime = DateTime.new(2015, 1)
+    @jan01_datetime.fiscal_start = 3
+    expect(@jan01_datetime.end_of_fiscal_year.strftime('%F')).to eq '2015-02-28'
+    @jan01_datetime.fiscal_start = 9
+    expect(@jan01_datetime.end_of_fiscal_year.strftime('%F')).to eq '2015-08-31'
+    @jan01_datetime.fiscal_start = 12
+    expect(@jan01_datetime.end_of_fiscal_year.strftime('%F')).to eq '2015-11-30'
+  end
+
+  it "#quarter_starting_dates" do
+    expect(@jan01.quarter_starting_dates).to be_an Array
+    expect(@jan01.quarter_starting_dates.length).to eq 4
+
+    expect(@jan01.quarter_starting_dates[0].strftime('%F')).to eq '2015-01-01'
+    expect(@jan01.quarter_starting_dates[1].strftime('%F')).to eq '2015-04-01'
+    expect(@jan01.quarter_starting_dates[2].strftime('%F')).to eq '2015-07-01'
+    expect(@jan01.quarter_starting_dates[3].strftime('%F')).to eq '2015-10-01'
+
+    @jan01.fiscal_start = 2
+    expect(@jan01.quarter_starting_dates[0].strftime('%F')).to eq '2014-02-01'
+    expect(@jan01.quarter_starting_dates[1].strftime('%F')).to eq '2014-05-01'
+    expect(@jan01.quarter_starting_dates[2].strftime('%F')).to eq '2014-08-01'
+    expect(@jan01.quarter_starting_dates[3].strftime('%F')).to eq '2014-11-01'
+
+    @jan01.fiscal_start = 9
+    expect(@jan01.quarter_starting_dates[0].strftime('%F')).to eq '2014-09-01'
+    expect(@jan01.quarter_starting_dates[1].strftime('%F')).to eq '2014-12-01'
+    expect(@jan01.quarter_starting_dates[2].strftime('%F')).to eq '2015-03-01'
+    expect(@jan01.quarter_starting_dates[3].strftime('%F')).to eq '2015-06-01'
+
+    @jan01_date = Date.new(2015, 1)
+    expect(@jan01_date.quarter_starting_dates[0].strftime('%F')).to eq '2015-01-01'
+    expect(@jan01_date.quarter_starting_dates[1].strftime('%F')).to eq '2015-04-01'
+    expect(@jan01_date.quarter_starting_dates[2].strftime('%F')).to eq '2015-07-01'
+    expect(@jan01_date.quarter_starting_dates[3].strftime('%F')).to eq '2015-10-01'
+  end
+
+  it "#quarter_ending_dates" do
+    expect(@jan01.quarter_ending_dates).to be_an Array
+    expect(@jan01.quarter_ending_dates.length).to eq 4
+
+    expect(@jan01.quarter_ending_dates[0].strftime('%F')).to eq '2015-03-31'
+    expect(@jan01.quarter_ending_dates[1].strftime('%F')).to eq '2015-06-30'
+    expect(@jan01.quarter_ending_dates[2].strftime('%F')).to eq '2015-09-30'
+    expect(@jan01.quarter_ending_dates[3].strftime('%F')).to eq '2015-12-31'
+
+    @jan01.fiscal_start = 2
+    expect(@jan01.quarter_ending_dates[0].strftime('%F')).to eq '2014-04-30'
+    expect(@jan01.quarter_ending_dates[1].strftime('%F')).to eq '2014-07-31'
+    expect(@jan01.quarter_ending_dates[2].strftime('%F')).to eq '2014-10-31'
+    expect(@jan01.quarter_ending_dates[3].strftime('%F')).to eq '2015-01-31'
+
+    @jan01.fiscal_start = 9
+    expect(@jan01.quarter_ending_dates[0].strftime('%F')).to eq '2014-11-30'
+    expect(@jan01.quarter_ending_dates[1].strftime('%F')).to eq '2015-02-28'
+    expect(@jan01.quarter_ending_dates[2].strftime('%F')).to eq '2015-05-31'
+    expect(@jan01.quarter_ending_dates[3].strftime('%F')).to eq '2015-08-31'
+
+    @jan01_date = Date.new(2015, 1)
+    expect(@jan01_date.quarter_ending_dates[0].strftime('%F')).to eq '2015-03-31'
+    expect(@jan01_date.quarter_ending_dates[1].strftime('%F')).to eq '2015-06-30'
+    expect(@jan01_date.quarter_ending_dates[2].strftime('%F')).to eq '2015-09-30'
+    expect(@jan01_date.quarter_ending_dates[3].strftime('%F')).to eq '2015-12-31'
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,108 @@
+require 'rubygems'
+
+require 'bundler/setup'
+Bundler.setup
+
+require 'priscilla'
+require 'pry'
+require 'byebug'
+
+require 'coveralls'
+Coveralls.wear!
+
+require 'fiscally'
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause this
+# file to always be loaded, without a need to explicitly require it in any files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    # be_bigger_than(2).and_smaller_than(4).description
+    #   # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #   # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  config.order = :random
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Limits the available syntax to the non-monkey patched syntax that is recommended.
+  # For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: fiscally
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Frank Koehl
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-09-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rb-readline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: priscilla
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fuubar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+description: |2
+      Projects with a financial or business bent often have to deal with awareness of a fiscal year, which typically doesn't line up with a normal calendar year.
+
+      The `Fiscally` gem adds the necessary awareness to your date and time objects, covering start and end dates for fiscal years and quarterly breakdowns.
+email:
+- frank@forgecrafted.com
+- chris@forgecrafted.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- Vagrantfile
+- fiscally.gemspec
+- lib/fiscally.rb
+- lib/fiscally/fiscally.rb
+- lib/fiscally/version.rb
+- provision.sh
+- spec/fiscally_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/forgecrafted/fiscally
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Fiscal year awareness for Ruby Date and Time classes.
+test_files:
+- spec/fiscally_spec.rb
+- spec/spec_helper.rb