business_date_calculator 0.1.5 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 76736416593db5462eed799dc6f31ef5522b7f30
-  data.tar.gz: 20a36007d246e1b449e66e456b3a0242dcdfddcb
+SHA256:
+  metadata.gz: 9c6c73d127ef04d88448a0c97d29827023f527fcb6c02f3beaec8385c8846850
+  data.tar.gz: 323d8ca926b59cbb69987ee2b7447e5350dc39cd75a60427c254c3b678253e9e
 SHA512:
-  metadata.gz: af830900695fbaa8c0f27b15062cd49c0199e993ddae8c1a08faef4cfc6851c18e3e0d36c70ed8c3a141cdee3a1ba76e905ae17fc18b7db9dfc2ea23e9ad1be0
-  data.tar.gz: ebd51df76d57938987f1cea71d415dbac1e71929e9fd7c944b951b388444b6a68fa0b3d4be6778c3fed3a1e01dfd594f544d299138a0b7215082900e2da2c9f0
+  metadata.gz: d966e9d83e0506a35b9c46469baeb19b769216e6e9a27808c2b405733bfc37b80b98f0196cd089ff73f92437f00eb6458adfbadba0de448e27c7669629e5302b
+  data.tar.gz: 90cf355df47f0a03bf0c2dd646788cd9f63fec2381b2896816eb87d3b9158587063bb83a3d9f34fafd6d085d38d75d4a336a109b1873620943d4c969807800ab

data/.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.3']
+    name: rspec (ruby ${{ matrix.ruby }})
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Ruby ${{ matrix.ruby }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - name: Run rspec
+        run: bundle exec rspec --format documentation
+
+  lint:
+    runs-on: ubuntu-latest
+    name: rubocop
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+
+      - name: Run rubocop
+        run: bundle exec rubocop --no-color
+
+  audit:
+    runs-on: ubuntu-latest
+    name: bundler-audit
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+
+      - name: Run bundler-audit
+        run: |
+          bundle exec bundler-audit update
+          bundle exec bundler-audit check

data/.rubocop.yml

@@ -0,0 +1,46 @@
+AllCops:
+  TargetRubyVersion: 3.1
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - 'bin/**/*'
+    - 'vendor/**/*'
+    - 'Guardfile'
+    - '*.gemspec'
+
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/MethodLength:
+  Max: 30
+
+Metrics/AbcSize:
+  Max: 35
+
+Metrics/ClassLength:
+  Max: 150
+
+Metrics/CyclomaticComplexity:
+  Max: 10
+
+Metrics/PerceivedComplexity:
+  Max: 10
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+
+# API publica do gem usa nomes legados (is_holiday?, parametro `n` em advance).
+# Renomear quebraria callers existentes (ex.: ivt-funds-api).
+Naming/PredicatePrefix:
+  Enabled: false
+
+Naming/MethodParameterName:
+  AllowedNames:
+    - n

data/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## 1.0.0
+
+### Bug fixes (breaking behavior changes)
+
+- **`Calendar#build`**: o segundo `while` checava `start_date.wday == 6` no lugar de `end_date.wday == 6` (copy-paste). Com isso, `@end_date` podia terminar num sábado sem feriado explícito, gerando entradas `nil` em `@business_dates` e fazendo `adjust(:following)` e `advance` retornarem `nil` silenciosamente em datas no fim do range.
+
+- **`Calendar#advance`**: para `n` positivo grande o suficiente para que `adjusted_date_index(date) + n` ultrapassasse o tamanho de `@business_dates`, o método retornava `nil` silenciosamente. Agora reconstrói o calendário simetricamente ao caso `n` negativo. Resolve o cenário onde fundos com `redemption_conversion_days` alto (ex.: 270) produziam datas nulas.
+
+- **`Calendar#networkdays`**: agora levanta `ArgumentError` quando `date1 > date2`, em vez de devolver valor negativo silencioso. Comportamento documentado mas não enforçado anteriormente.
+
+### Behavior changes (non-breaking)
+
+- **`Calendar#range_check`**: expansão para trás passou de 2 dias para 252 dias (simétrico com a expansão para frente). Elimina reconstruções repetidas em consultas batch retroativas.
+
+- **`Calendar#advance`**: recursão para `n` muito negativo agora converge em uma única reconstrução (folga 2x sobre dias úteis pedidos), em vez de múltiplas iterações reconstruindo todo o calendário.
+
+- **Thread-safety**: métodos públicos protegidos por `Monitor` (reentrante). Múltiplas threads agora podem chamar `advance`, `adjust`, `networkdays`, `is_holiday?` e `last_day_of_previous_month` simultaneamente sem corromper estado interno durante reconstruções.
+
+- **Cópia defensiva de `holidays`**: a lista de feriados passada ao construtor agora é `dup.freeze`. Mutações externas pós-construção não afetam mais o estado interno.
+
+- **`Calendar#last_day_of_previous_month`**: reescrito de forma legível usando `Date.civil(year, month, 1) - 1`, sem mudança de comportamento.
+
+### Doc
+
+- Comentário de `networkdays` reescrito para refletir a semântica real ("saltos entre dias úteis", não contagem inclusiva).
+
+### Dev / build
+
+- Atualizado `bundler` para `>= 2.0` e `rake` para `>= 12.0`. Adicionado `rspec ~> 3.0` como dev dep explícita.
+- Removido pin de Ruby 2.4 do `Gemfile`.
+- Removidas dev deps `guard-rspec` e `terminal-notifier-guard` (não eram usadas em CI).

data/Gemfile

@@ -1,4 +1,4 @@
 source 'https://rubygems.org'
-ruby '2.4.0'
+
 # Specify your gem's dependencies in business_date_calculator.gemspec
 gemspec

data/Guardfile

@@ -23,7 +23,7 @@
 #
 # and, you'll have to watch "config/Guardfile" instead of "Guardfile"
 
-# Note: The cmd option is now required due to the increasing number of ways
+# NOTE: The cmd option is now required due to the increasing number of ways
 #       rspec may be run, below are examples of the most common uses.
 #  * bundler: 'bundle exec rspec'
 #  * bundler binstubs: 'bin/rspec'
@@ -32,8 +32,8 @@
 #  * zeus: 'zeus rspec' (requires the server to be started separately)
 #  * 'just' rspec: 'rspec'
 
-guard :rspec, cmd: "bundle exec rspec" do
-  require "guard/rspec/dsl"
+guard :rspec, cmd: 'bundle exec rspec' do
+  require 'guard/rspec/dsl'
   dsl = Guard::RSpec::Dsl.new(self)
 
   # Feel free to open issues for suggestions and improvements
@@ -49,15 +49,15 @@ guard :rspec, cmd: "bundle exec rspec" do
   dsl.watch_spec_files_for(ruby.lib_files)
 
   # Rails files
-  rails = dsl.rails(view_extensions: %w(erb haml slim))
+  rails = dsl.rails(view_extensions: %w[erb haml slim])
   dsl.watch_spec_files_for(rails.app_files)
   dsl.watch_spec_files_for(rails.views)
 
   watch(rails.controllers) do |m|
     [
-      rspec.spec.("routing/#{m[1]}_routing"),
-      rspec.spec.("controllers/#{m[1]}_controller"),
-      rspec.spec.("acceptance/#{m[1]}")
+      rspec.spec.call("routing/#{m[1]}_routing"),
+      rspec.spec.call("controllers/#{m[1]}_controller"),
+      rspec.spec.call("acceptance/#{m[1]}")
     ]
   end
 
@@ -67,11 +67,11 @@ guard :rspec, cmd: "bundle exec rspec" do
   watch(rails.app_controller)  { "#{rspec.spec_dir}/controllers" }
 
   # Capybara features specs
-  watch(rails.view_dirs)     { |m| rspec.spec.("features/#{m[1]}") }
+  watch(rails.view_dirs) { |m| rspec.spec.call("features/#{m[1]}") }
 
   # Turnip features and steps
   watch(%r{^spec/acceptance/(.+)\.feature$})
   watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$}) do |m|
-    Dir[File.join("**/#{m[1]}.feature")][0] || "spec/acceptance"
+    Dir[File.join("**/#{m[1]}.feature")][0] || 'spec/acceptance'
   end
 end

data/README.md

@@ -1,39 +1,142 @@
 # BusinessDateCalculator
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/business_date_calculator`. To experiment with that code, run `bin/console` for an interactive prompt.
+[![CI](https://github.com/investtools/business_date_calculator/actions/workflows/ci.yml/badge.svg)](https://github.com/investtools/business_date_calculator/actions/workflows/ci.yml)
 
-TODO: Delete this and the text above, and describe your gem
+Biblioteca Ruby para cálculos com calendário de dias úteis: identificar feriados, mover datas entre dias úteis, contar dias úteis entre datas e ajustar datas não-úteis para o próximo ou anterior dia útil.
 
-## Installation
+Pensada para casos de uso financeiros (cotização e liquidação de fundos, D+N, dias úteis no calendário ANBIMA/B3), mas sem dependências de feriados específicos — você fornece a lista.
 
-Add this line to your application's Gemfile:
+## Instalação
+
+Adicione ao `Gemfile`:
+
+```ruby
+gem 'business_date_calculator', '~> 1.0'
+```
+
+E rode:
+
+```bash
+bundle install
+```
+
+Ou instale isoladamente:
+
+```bash
+gem install business_date_calculator
+```
+
+## Uso
+
+### Criando um calendário
+
+```ruby
+require 'business_date_calculator'
+
+start_date = Date.parse('2024-01-01')
+end_date   = Date.parse('2024-12-31')
+holidays   = [Date.parse('2024-01-01'), Date.parse('2024-12-25')]
+
+calendar = BusinessDateCalculator::Calendar.new(start_date, end_date, holidays)
+```
+
+O calendário expande automaticamente seu range internamente quando você pergunta por datas fora do intervalo inicial — você não precisa pré-dimensionar.
+
+### `is_holiday?(date)`
+
+Retorna `true` para fins de semana ou datas na lista de feriados:
+
+```ruby
+calendar.is_holiday?(Date.parse('2024-01-01'))  # => true  (feriado)
+calendar.is_holiday?(Date.parse('2024-01-06'))  # => true  (sábado)
+calendar.is_holiday?(Date.parse('2024-01-08'))  # => false (segunda)
+```
+
+### `adjust(date, convention)`
+
+Ajusta uma data não-útil para o próximo dia útil (`:following`) ou anterior (`:preceding`). Use `:unadjusted` para devolver a data sem modificar.
 
 ```ruby
-gem 'business_date_calculator'
+calendar.adjust(Date.parse('2024-01-06'), :following)   # => 2024-01-08 (segunda)
+calendar.adjust(Date.parse('2024-01-06'), :preceding)   # => 2024-01-05 (sexta)
+calendar.adjust(Date.parse('2024-01-08'), :following)   # => 2024-01-08 (já é dia útil)
 ```
 
-And then execute:
+### `advance(date, n, convention = :following)`
 
-    $ bundle
+Avança `n` dias úteis a partir de `date`. Aceita `n` negativo para recuar.
 
-Or install it yourself as:
+```ruby
+calendar.advance(Date.parse('2024-01-08'), 5)    # => 2024-01-15
+calendar.advance(Date.parse('2024-01-15'), -3)   # => 2024-01-10
+calendar.advance(Date.parse('2024-01-06'), 1)    # => 2024-01-09 (sábado avança para seg + 1)
+```
+
+Se `date` cai num dia não-útil, ele é ajustado primeiro segundo a `convention` antes de avançar.
+
+### `networkdays(date1, date2, convention1 = :unadjusted, convention2 = :unadjusted)`
 
-    $ gem install business_date_calculator
+Retorna a contagem de "saltos" entre dias úteis nas duas datas. Equivalente a `índice_util(date2) - índice_util(date1)`:
 
-## Usage
+```ruby
+mon = Date.parse('2024-01-08')
+fri = Date.parse('2024-01-12')
+
+calendar.networkdays(mon, fri)  # => 4 (segunda→sexta: 4 saltos)
+calendar.networkdays(mon, mon)  # => 0 (mesma data)
+```
+
+**Levanta `ArgumentError` se `date1 > date2`.**
+
+Se as datas passadas não são úteis, especifique convenções de ajuste:
+
+```ruby
+sat = Date.parse('2024-01-06')
+fri = Date.parse('2024-01-12')
+
+calendar.networkdays(sat, fri, :following, :unadjusted)  # ajusta sat → mon, depois conta
+```
+
+### `last_day_of_previous_month(date)`
+
+Retorna o último dia útil do mês anterior:
+
+```ruby
+calendar.last_day_of_previous_month(Date.parse('2024-03-15'))
+# => 2024-02-29 (sexta — último dia útil de fevereiro)
+```
+
+## Thread-safety
+
+Métodos públicos são protegidos por `Monitor` (reentrante). Múltiplas threads podem chamar métodos da mesma instância concorrentemente sem corrupção de estado durante reconstruções internas.
+
+## Marshal / Rails.cache
+
+A classe implementa `marshal_dump` / `marshal_load` para funcionar com `Rails.cache.fetch` e outros consumidores que serializam via `Marshal`. O `Monitor` interno é recriado fresh na desserialização.
+
+## Desenvolvimento
+
+```bash
+bundle install
+bundle exec rspec          # roda testes
+bundle exec rubocop        # lint
+bundle exec bundler-audit  # security audit das deps
+```
 
-TODO: Write usage instructions here
+## Release
 
-## Development
+1. Atualize `lib/business_date_calculator/version.rb`
+2. Atualize `CHANGELOG.md`
+3. `bundle exec rake release` — cria tag git, faz push e publica no rubygems.org
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment. 
+## Contribuindo
 
-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` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+1. Fork
+2. `git checkout -b minha-feature`
+3. Adicione testes pra mudança (TDD recomendado)
+4. Garanta `bundle exec rspec` e `bundle exec rubocop` passando
+5. Pull Request pra `master`
 
-## Contributing
+## License
 
-1. Fork it ( https://github.com/[my-github-username]/business_date_calculator/fork )
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create a new Pull Request
+MIT. Veja [LICENSE.txt](LICENSE.txt) (se ausente, MIT padrão).

data/Rakefile

@@ -1,2 +1 @@
-require "bundler/gem_tasks"
-
+require 'bundler/gem_tasks'

data/business_date_calculator.gemspec

@@ -18,9 +18,10 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.8"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "guard-rspec"
-  spec.add_development_dependency "terminal-notifier-guard"
+  spec.add_development_dependency "bundler", ">= 2.0"
+  spec.add_development_dependency "bundler-audit", "~> 0.9"
+  spec.add_development_dependency "rake", ">= 12.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop", "~> 1.60"
   spec.add_dependency "activesupport"
 end

data/lib/business_date_calculator/calendar.rb

@@ -1,79 +1,175 @@
+require 'monitor'
+
 module BusinessDateCalculator
+  # Calculadora de dias uteis com calendario customizavel de feriados.
+  #
+  # Mantem uma estrutura de dados indexada cobrindo um intervalo de datas, expandida
+  # dinamicamente quando consultas saem do range inicial. Thread-safe (Monitor reentrante)
+  # e Marshal-friendly para uso com Rails.cache.
+  #
+  # @example Uso basico
+  #   holidays = [Date.parse('2024-01-01'), Date.parse('2024-12-25')]
+  #   cal = BusinessDateCalculator::Calendar.new(Date.parse('2024-01-01'), Date.parse('2024-12-31'), holidays)
+  #   cal.advance(Date.parse('2024-01-08'), 5)   # => 2024-01-15
   class Calendar
-
-    # Constroi a estrutura de dados a partir de uma lista de holidays que
-    # sao os feriados, e usando um periodo especificado (fechado nas duas pontas).
+    # Cria um novo calendario.
+    #
+    # @param start_date [Date] data inicial do range (sera ajustada para o dia util anterior se nao for util)
+    # @param end_date [Date] data final do range (sera ajustada para o proximo dia util se nao for util)
+    # @param holidays [Array<Date>] lista de feriados a considerar como nao-uteis (dup.freeze interno)
     def initialize(start_date, end_date, holidays)
+      @monitor = Monitor.new
       build(start_date, end_date, holidays)
     end
 
+    # Verifica se uma data nao e util (fim de semana ou feriado).
+    #
+    # @param date [Date] data a verificar
+    # @return [Boolean] true se for sabado, domingo ou estiver na lista de feriados
     def is_holiday?(date)
-      date.wday == 0 || date.wday == 6 || @holidays.include?(date)
+      @monitor.synchronize { date.wday.zero? || date.wday == 6 || @holidays.include?(date) }
     end
 
-    # Retorna o numero de dias uteis entre as duas data especificadas, inclusive.
-    # As duas datas devem ser dias uteis, ou caso não seja, deve ser 
-    # especificado uma convenção de ajuste para cada data.
-    # A primeira data deve ser menor ou igual a segunda.
+    # Conta dias uteis entre duas datas como "saltos" no indice de dias uteis.
+    # Equivalente a +indice_util(date2) - indice_util(date1)+: mesma data retorna 0,
+    # segunda-feira ate sexta-feira da mesma semana retorna 4.
+    #
+    # @param date1 [Date] data inicial (deve ser menor ou igual a date2)
+    # @param date2 [Date] data final
+    # @param convention1 [Symbol] convencao de ajuste para date1: +:unadjusted+, +:following+, +:preceding+
+    # @param convention2 [Symbol] convencao de ajuste para date2
+    # @return [Integer] numero de saltos entre dias uteis
+    # @raise [ArgumentError] quando date1 > date2
+    #
+    # @example
+    #   cal.networkdays(Date.parse('2024-01-08'), Date.parse('2024-01-12'))  # => 4
     def networkdays(date1, date2, convention1 = :unadjusted, convention2 = :unadjusted)
-      range_check(date1)
-      range_check(date2)
-      i1 = adjusted_date_index(date1, convention1)
-      i2 = adjusted_date_index(date2, convention2)
-      raise "Adjusted date1 #{date1} is out of range"  if i1 == nil
-      raise "Adjusted date2 #{date2} is out of range"  if i2 == nil
-      i2 - i1
+      if date1 > date2
+        raise ArgumentError,
+              "date1 must be less than or equal to date2 (got date1=#{date1}, date2=#{date2})"
+      end
+
+      @monitor.synchronize do
+        range_check(date1)
+        range_check(date2)
+        i1 = adjusted_date_index(date1, convention1)
+        i2 = adjusted_date_index(date2, convention2)
+        raise "Adjusted date1 #{date1} is out of range"  if i1.nil?
+        raise "Adjusted date2 #{date2} is out of range"  if i2.nil?
+
+        i2 - i1
+      end
     end
 
+    # Ajusta uma data para o dia util mais proximo segundo a convencao indicada.
+    # Se a data ja for util, retorna ela inalterada independente da convencao.
+    #
+    # @param date [Date] data a ajustar
+    # @param convention [Symbol] +:following+ (proximo dia util), +:preceding+ (anterior),
+    #   ou +:unadjusted+ (devolve a data sem alteracao)
+    # @return [Date] data ajustada
+    # @raise [RuntimeError] +:preceding+ quando nao ha dia util anterior conhecido
+    #
+    # @example
+    #   cal.adjust(Date.parse('2024-01-06'), :following)  # => 2024-01-08 (sabado -> segunda)
     def adjust(date, convention)
-      range_check(date)
-      if not is_holiday?(date)
-        date
-      elsif convention == :unadjusted
-        date
-      else
+      @monitor.synchronize do
+        range_check(date)
+        return date if !is_holiday?(date) || convention == :unadjusted
+
         case convention
-          when :following
-            @business_dates[@next_business_date_index[date]]
-          when :preceding
-            raise "Erro pegando data util anterior ao dia #{date}"  if @prev_business_date_index[date] == nil
-            @business_dates[@prev_business_date_index[date]]
+        when :following
+          @business_dates[@next_business_date_index[date]]
+        when :preceding
+          raise "Erro pegando data util anterior ao dia #{date}" if @prev_business_date_index[date].nil?
+
+          @business_dates[@prev_business_date_index[date]]
         end
       end
     end
 
+    # Avanca (ou recua) +n+ dias uteis a partir de +date+. Expande o calendario
+    # automaticamente quando +n+ extrapola o range conhecido.
+    #
+    # @param date [Date, #to_date] data de partida
+    # @param n [Integer] numero de dias uteis a avancar (negativo para recuar)
+    # @param convention [Symbol] convencao para ajustar +date+ caso ela seja nao-util
+    # @param margin [Integer] folga em dias corridos para expansao do calendario (uso interno em recursao)
+    # @return [Date] dia util resultante
+    #
+    # @example Avancar 5 dias uteis
+    #   cal.advance(Date.parse('2024-01-08'), 5)  # => 2024-01-15
+    #
+    # @example Recuar 3 dias uteis
+    #   cal.advance(Date.parse('2024-01-15'), -3)  # => 2024-01-10
     def advance(date, n, convention = :following, margin = 30)
-      date = date.to_date
-      range_check(date)
-      index = adjusted_date_index(date, convention) + n
-      if index < 0
-        build(date + (index - margin).days, @end_date, @holidays)
-        return advance(date, n, convention, margin + 30)
+      @monitor.synchronize do
+        date = date.to_date
+        range_check(date)
+        index = adjusted_date_index(date, convention) + n
+        if index.negative?
+          # 2x folga sobre dias uteis cobre fins de semana e feriados em uma unica reconstrucao
+          build(date + ((index * 2) - margin).days, @end_date, @holidays)
+          return advance(date, n, convention, margin + 30)
+        elsif index >= @business_dates.length
+          overshoot = index - @business_dates.length + 1
+          build(@start_date, @end_date + ((overshoot * 2) + margin).days, @holidays)
+          return advance(date, n, convention, margin + 30)
+        end
+        @business_dates[adjusted_date_index(date, convention) + n]
       end
-      @business_dates[adjusted_date_index(date, convention) + n]
     end
 
+    # Ultimo dia util do mes anterior ao da data passada.
+    #
+    # @param date [Date] data de referencia
+    # @return [Date] ultimo dia util do mes anterior (com ajuste +:preceding+ se for nao-util)
+    #
+    # @example
+    #   cal.last_day_of_previous_month(Date.parse('2024-03-15'))  # => 2024-02-29
     def last_day_of_previous_month(date)
-      m = date.month
-      y = date.year
-      if m == 1
-        m = 0
-        y = y - 1
-      end
-      adjust(Date.civil(y, (m - 1), -1), :preceding)
+      @monitor.synchronize { adjust(Date.civil(date.year, date.month, 1) - 1, :preceding) }
     end
 
+    # @!group Marshal serialization
+
+    # Monitor nao e serializavel via Marshal (Rails.cache usa Marshal). Pula o monitor
+    # na serializacao e recria fresh na deserializacao.
+    # @api private
+    def marshal_dump
+      {
+        start_date: @start_date,
+        end_date: @end_date,
+        holidays: @holidays,
+        business_dates: @business_dates,
+        business_date_index: @business_date_index,
+        next_business_date_index: @next_business_date_index,
+        prev_business_date_index: @prev_business_date_index
+      }
+    end
+
+    # @api private
+    def marshal_load(data)
+      @monitor = Monitor.new
+      @start_date = data[:start_date]
+      @end_date = data[:end_date]
+      @holidays = data[:holidays]
+      @business_dates = data[:business_dates]
+      @business_date_index = data[:business_date_index]
+      @next_business_date_index = data[:next_business_date_index]
+      @prev_business_date_index = data[:prev_business_date_index]
+    end
+
+    # @!endgroup
+
     protected
 
     def build(start_date, end_date, holidays)
+      holidays = holidays.dup.freeze
       # garante que start_date e end_date sao dias uteis
-      while start_date.wday == 0 || start_date.wday == 6 || holidays.include?(start_date) do
-        start_date -= 1.days
-      end
-      while end_date.wday == 0 || start_date.wday == 6 || holidays.include?(end_date) do
-        end_date += 1.days
-      end
-      
+      start_date -= 1.days while start_date.wday.zero? || start_date.wday == 6 || holidays.include?(start_date)
+      end_date += 1.days while end_date.wday.zero? || end_date.wday == 6 || holidays.include?(end_date)
+
       @start_date = start_date
       @end_date = end_date
       @holidays = holidays
@@ -81,10 +177,10 @@ module BusinessDateCalculator
       @business_date_index = {}
       @next_business_date_index = {}
       @prev_business_date_index = {}
-      
+
       d = start_date
       i = 0
-      while d <= end_date do
+      while d <= end_date
         if is_holiday?(d)
           # dia não útil, mapeia o indice do dia util anterior e proximo
           @next_business_date_index[d] = i
@@ -93,25 +189,27 @@ module BusinessDateCalculator
           # dia util, adiciona ao final do array, e mapeia o indice do array no mapa
           @business_dates << d
           @business_date_index[d] = i
-          i = i + 1
+          i += 1
         end
         d += 1.days
       end
     end
-    
+
+    EXPANSION_MARGIN_DAYS = 252
+
     # Verifica se a data passada esta entre o periodo desta instancia.
+    # Quando fora do range, reconstroi simetricamente com EXPANSION_MARGIN_DAYS dias de folga
+    # para evitar rebuilds em sequencia em consultas em batch.
     def range_check(date)
       if date < @start_date
-        # puts "Reconstruindo calculadora de feriados pois dia #{date} eh menor que #{@start_date} -> #{@end_date}"
-        build(date - 2.days, @end_date, @holidays)
+        build(date - EXPANSION_MARGIN_DAYS.days, @end_date, @holidays)
       elsif date > @end_date
-        # puts "Reconstruindo calculadora de feriados pois dia #{date} eh maior que #{end_date}"
-        build(@start_date, date + 252.days, @holidays)
+        build(@start_date, date + EXPANSION_MARGIN_DAYS.days, @holidays)
       end
     end
-    
+
     def adjusted_date_index(date, convention)
       @business_date_index[adjust(date, convention)]
     end
   end
-end
+end

data/lib/business_date_calculator/version.rb

@@ -1,3 +1,3 @@
 module BusinessDateCalculator
-  VERSION = "0.1.5"
+  VERSION = '1.0.0'.freeze
 end

data/lib/business_date_calculator.rb

@@ -1,2 +1,2 @@
-require "business_date_calculator/version"
-require "business_date_calculator/calendar"
+require 'business_date_calculator/version'
+require 'business_date_calculator/calendar'

metadata

@@ -1,71 +1,84 @@
 --- !ruby/object:Gem::Specification
 name: business_date_calculator
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 1.0.0
 platform: ruby
 authors:
 - Lucas Pérez
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
-  name: guard-rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '12.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '12.0'
 - !ruby/object:Gem::Dependency
-  name: terminal-notifier-guard
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -87,9 +100,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
-- ".travis.yml"
+- ".rubocop.yml"
+- CHANGELOG.md
 - Gemfile
 - Guardfile
 - README.md
@@ -104,7 +119,6 @@ homepage: https://github.com/investtools/business_date_calculator
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -119,9 +133,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.8
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A Ruby Library for dealing with business calendar.
 test_files: []

data/.travis.yml

@@ -1,3 +0,0 @@
-language: ruby
-rvm:
-  - 2.1.2