russian_workdays 1.4.0 → 2.0.0

data/Gemfile

@@ -1,3 +1,5 @@
-source 'https://rubygems.org'
+# frozen_string_literal: true
 
-gemspec
+source "https://rubygems.org"
+
+gemspec

data/README.md

@@ -1,4 +1,5 @@
 # russian_workdays
+
 [![Gem Version](https://badge.fury.io/rb/russian_workdays.svg)](https://badge.fury.io/rb/russian_workdays)
 [![Build Status](https://travis-ci.org/heckfy/russian_workdays.svg?branch=master)](https://travis-ci.org/heckfy/russian_workdays)
 [![Code Climate](https://codeclimate.com/github/heckfy/russian_workdays/badges/gpa.svg)](https://codeclimate.com/github/heckfy/russian_workdays)
@@ -6,52 +7,69 @@
 Производственный календарь РФ
 
 ## Установка
+
 Выполняем в терминале:
 
-	gem install russian_workdays
-	
+    gem install russian_workdays
+
 и подгружаем:
 
 ```ruby
-require 'russian_workdays'
+require "russian_workdays"
 ```
 
 ## Использование
 
-Получить массив с выходными днями в 2014 году
-
-```ruby
-RussianWorkdays.holidays(2014)
-```
+#### Класс RussianWorkdays::Collection
 
-Получить массив с короткими днями в 2014 году
+Инициализатор принимает массив или интервал дат.
 
 ```ruby
-RussianWorkdays.shorts(2014)
+collection = RussianWorkdays::Collection.new((Date.new(2014, 2, 10)..Date.new(2014, 3, 10)))
+# Получить массив с выходными днями c 10 февраля 2014 по 10 марта 2014:
+collection.holidays
+# Получить массив с предпраздничными днями:
+collection.preholidays
+# Получить массив с рабочими днями:
+collection.works
+# Получить количество рабочих часов:
+collection.work_hours_count
+# В качестве аргумента метод work_hours_count принимает количество рабочих часов в неделю, по умолчанию это 40 часов. Получить количество рабочих часов при 36-часовой рабочей неделе:
+collection.work_hours_count(36)
 ```
 
-Получить массив с рабочими днями в 2014 году
+#### Класс RussianWorkdays::Year
 
-```ruby
-RussianWorkdays.works(2014)
-```
-
-Является ли дата выходным днем?
+Инициализатор принимает в качестве параметра год. Имеет те же методы что и RussianWorkdays::Collection.
 
 ```ruby
-RussianWorkdays.holiday?(Date.new 2014, 10, 5)
+collection = RussianWorkdays::Year.new(2014)
+# Получить массив с выходными днями в 2014 году:
+collection.holidays
 ```
 
-Является ли дата коротким днем?
+#### Класс RussianWorkdays::Month
+
+Инициализатор принимает первым параметром год, вторым - номер месяца. Имеет те же методы что и RussianWorkdays::Collection.
 
 ```ruby
-RussianWorkdays.short?(Date.new 2014, 10, 5)
+collection = RussianWorkdays::Month.new(2014, 2)
+# Получить массив с выходными днями в феврале 2014 года:
+collection.holidays
 ```
 
-Является ли дата рабочим днем?
+#### Класс RussianWorkdays::Day
+
+Предназначен для работы с одной датой. В качестве параметра принимает объект класса Date.
 
 ```ruby
-RussianWorkdays.work?(Date.new 2014, 10, 5)
+date = RussianWorkdays::Day.new(Date.new(2014, 10, 5))
+# Является ли дата выходным днем?
+date.holiday?
+# Является ли дата предпраздничным днем?
+date.preholiday?
+# Является ли дата рабочим днем?
+date.work?
 ```
 
 ## Contributing

data/Rakefile

@@ -1,8 +1,10 @@
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
 
 # Default directory to look in is `/specs`
 # Run with `rake spec`
 RSpec::Core::RakeTask.new(:spec)
 
-task default: :spec
+task default: :spec

data/lib/russian_workdays/collection.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module RussianWorkdays
+  class Collection
+    include Enumerable
+    AVAILABLE_WORK_HOURS_PER_WEEK = [24, 36, 40].freeze
+
+    def initialize(collection)
+      unless %w[Array Range].include? collection.class.name
+        raise ArgumentError, "Must be a Array or Range object"
+      end
+      @collection = collection.to_a
+    end
+
+    def each
+      @collection.each { |i| yield(i) }
+    end
+
+    %w[holiday preholiday work].each do |type|
+      define_method "#{type}s" do
+        @collection.select { |date| Day.new(date).send("#{type}?") }
+      end
+    end
+
+    def work_hours_count(work_hours_per_week = 40)
+      unless AVAILABLE_WORK_HOURS_PER_WEEK.include?(work_hours_per_week)
+        raise ArgumentError, "Unknown work hours count. Must be one of #{AVAILABLE_WORK_HOURS_PER_WEEK}"
+      end
+      work_hours_per_day = (work_hours_per_week / 5.to_f)
+      mapping = { work: work_hours_per_day, preholiday: work_hours_per_day - 1 }
+      @collection.map { |i| mapping.fetch(Day.new(i).type, 0) }.sum.ceil(1)
+    end
+  end
+end

data/lib/russian_workdays/collection_preset.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "forwardable"
+
+class CollectionPreset
+  extend Forwardable
+  def_delegators :@dates, :holidays, :preholidays, :works, :work_hours_count
+end