quando 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1ac311f1942017666bffa27bcfded9b292d59b1b80733e9eb19cf275f24ae4be
+  data.tar.gz: 3c1e52f8eeffba30e192aa38732055daced228721f0ae81f935314aed80cd2c3
+SHA512:
+  metadata.gz: 58126069e12f3446a1f555fe2cdcc68229901fd9f8a05b0b58c1bc8f35187991a6c6d602b5028522d7e6c841afd19868cc326f5934b273a6fa91154c80427eab
+  data.tar.gz: 0d265149ce2f56b86281417bb312fa251ff2bee9f2ef16ea50ef44492e5a5a79e04c897d5e0b0cc4f4f4adaaab8ade5aa90af2142ab78b01c3b5533dcfdddd50

data/.editorconfig

@@ -0,0 +1,10 @@
+# editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

data/.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+.idea/
+docker/*
+docker-compose.yml

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,41 @@
+PATH
+  remote: .
+  specs:
+    quando (0.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coderay (1.1.2)
+    diff-lcs (1.3)
+    method_source (0.9.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rake (10.5.0)
+    rspec (3.6.0)
+      rspec-core (~> 3.6.0)
+      rspec-expectations (~> 3.6.0)
+      rspec-mocks (~> 3.6.0)
+    rspec-core (3.6.0)
+      rspec-support (~> 3.6.0)
+    rspec-expectations (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-mocks (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-support (3.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.15)
+  pry
+  quando!
+  rake (~> 10.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   1.16.1

data/README.md

@@ -0,0 +1,49 @@
+# Quando
+
+[![Build Status](https://semaphoreci.com/api/v1/kinkou/quando/branches/master/shields_badge.svg)](https://semaphoreci.com/kinkou/quando)
+[![Maintainability](https://api.codeclimate.com/v1/badges/b0653fc45ec54c23e05c/maintainability)](https://codeclimate.com/github/kinkou/quando/maintainability)
+
+Quando is a configurable date parser. Show it what's what and parse any (Gregorian calendar) date. Quando can be configured on:
+
+#### Application-level:
+```ruby
+Quando.configure do |c|
+  c.dlm = /[ ,-]/
+
+  c.jan = /janeiro/i
+  c.feb = /fevereiro/i
+  c.mar = /março/i
+  c.apr = /abril/i
+  # …
+  c.unimonth!
+
+  c.formats = [
+    /#{c.month_num} #{c.dlm} #{c.month_txt} #{c.dlm} #{c.year}/xi,
+    /#{c.year} #{c.dlm} #{c.month_txt} #{c.dlm} #{c.month_num}/xi,
+  ]
+end
+
+Quando.parse('14-abril-1965') #=> #<Date: 1965-04-14>
+Quando.parse('1965, abril 14') #=> #<Date: 1965-04-14>
+```
+
+#### Instance-level:
+It will not affect your application-level configuration.
+```ruby
+Quando.parse('14-abril-1965') #=> nil
+
+date_parser = Quando::Parser.new.configure do |c|
+  # here be the options from the previous example
+end
+date_parser.parse('14-abril-1965') #=> #<Date: 1965-04-14>
+
+Quando.parse('14-abril-1965') #=> nil
+```
+
+#### Or just one-time usage:
+```ruby
+m = /(?<year>#{Quando.config.year}) (?<day>\d\d) (?<month>[A-Z]+)/i
+Quando.parse('1965 14 Apr', matcher: m) #=> #<Date: 1965-04-14>
+```
+
+Enjoy.

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/quando/config.rb

@@ -0,0 +1,84 @@
+# encoding: utf-8
+# frozen_string_literal: true
+
+module Quando
+  class Config
+
+    AVAILABLE_OPTIONS = [
+      :dlm, :year, :day,
+      :jan, :feb, :mar, :apr, :may, :jun, :jul, :aug, :sep, :oct, :nov, :dec,
+      :month_num, :month_txt,
+      :formats
+    ]
+
+    attr_accessor *AVAILABLE_OPTIONS
+
+    MONTHS = [:jan, :feb, :mar, :apr, :may, :jun, :jul, :aug, :sep, :oct, :nov, :dec]
+
+    def initialize
+      @dlm = /[ -.\/\\]/
+      @year = /(?<year>(?:\d{2})|(?:\d{4}))/i
+      @month_num = /(?<month>(?:1[0-2])|(?:0?[1-9]))/
+      @day = /(?<day>(?:[3][0-1])|(?:[1-2][0-9])|(?:0?[1-9]))/
+
+      @jan = /(?:JANUARY)|(?:JAN\.?)/i
+      @feb = /(?:FEBRUARY)|(?:FEB\.?)/i
+      @mar = /(?:MARCH)|(?:MAR\.?)/i
+      @apr = /(?:APRIL)|(?:APR\.?)/i
+      @may = /(?:MAY\.?)/i
+      @jun = /(?:JUNE)|(?:JUN\.?)/i
+      @jul = /(?:JULY)|(?:JUL\.?)/i
+      @aug = /(?:AUGUST)|(?:AUG\.?)/i
+      @sep = /(?:SEPTEMBER)|(?:SEPT?\.?)/i
+      @oct = /(?:OCTOBER)|(?:OCT\.?)/i
+      @nov = /(?:NOVEMBER)|(?:NOV\.?)/i
+      @dec = /(?:DECEMBER)|(?:DEC\.?)/i
+
+      uniupdate!
+    end
+
+    def uniformats!
+      @formats = [
+        # 14.4.1965, 14/04/1965, 13-12-05
+        /\A\s* #{@day} #{@dlm} #{@month_num} #{@dlm} #{@year} \s*\z/xi,
+
+        # 14-APRIL-1965, 14-apr-65, 13/Dec/05, …
+        /\A\s* #{@day} #{@dlm} #{@month_txt} #{@dlm} #{@year} \s*\z/xi,
+
+        # April 1965, apr.1965, DEC-05, …
+        /\A\s* #{@month_txt} #{@dlm} #{@year} \s*\z/xi,
+
+        # April, DECEMBER, apr., …
+        /\A\s* #{@month_txt} \s*\z/xi,
+      ]
+    end
+
+    def unimonth!
+      all_months_txt_rxs = MONTHS.map { |m| instance_variable_get("@#{m}".to_sym) }.join('|')
+      @month_txt = Regexp.new("(?<month>#{all_months_txt_rxs})", true)
+    end
+
+    def uniupdate!
+      unimonth!
+      uniformats!
+    end
+
+  end
+
+  # @return [Quando::Config]
+  def self.config
+    @config ||= Config.new
+  end
+
+  def self.configure
+    config unless @config
+    yield(config) if block_given?
+  end
+
+  def self.reset!
+    @config = Config.new
+  end
+
+  configure
+
+end

data/lib/quando/parser.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Quando
+
+  class Parser
+
+    def initialize
+      @config = nil
+    end
+
+    # @return [Quando::Parser]
+    def configure
+      yield(@config = Quando.config.dup)
+      self
+    end
+
+    # @return [Quando::Config]
+    def config
+      @config || Quando.config
+    end
+
+    # @param text_date [String]
+    # @return [Date, nil]
+    def parse(text_date)
+      config.formats.each do |rx|
+        @date_parts = text_date.match(rx)
+        next unless @date_parts
+
+        @current_format = rx
+        year, month, day = detect_year, detect_month, detect_day
+        next unless (year || month || day)
+
+        return Date.new(year, month, day)
+      end
+
+      nil
+    end
+
+    private
+
+    # @return [Integer, nil]
+    def detect_year
+      return Time.now.year unless searched?(:year)
+      return unless found?(:year)
+
+      year = @date_parts[:year].to_i
+      year < 100 ? year + 2000 : year
+    end
+
+    # @return [Integer, nil]
+    def detect_month
+      return 1 unless searched?(:month)
+      return unless found?(:month)
+
+      month = @date_parts[:month]
+
+      if config.month_num.match(month)
+        month.to_i
+      else
+        month_index = Quando::Config::MONTHS.find_index do |month_name|
+          month_name_rx = config.send(month_name)
+          month_name_rx.match(month)
+        end
+
+        month_index + 1 if month_index
+      end
+    end
+
+    # @return [Integer, nil]
+    def detect_day
+      return 1 unless searched?(:day)
+      return unless found?(:day)
+
+      day = @date_parts[:day].to_i
+      day if (1..31).include?(day)
+    end
+
+    # @param date_part [Symbol]
+    def found?(date_part)
+      !@date_parts[date_part.to_s].to_s.squeeze.empty?
+    end
+
+    # @param date_part [Symbol]
+    def searched?(date_part)
+      !!@current_format.named_captures[date_part.to_s]
+    end
+
+  end
+
+end

data/lib/quando/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Quando
+  VERSION = '0.0.1'
+end

data/lib/quando.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'quando/version'
+require 'quando/config'
+require 'quando/parser'
+
+module Quando
+
+  # @param opts [Hash]
+  # @param date [String]
+  # @return [Date, nil]
+  def self.parse(date, opts = {})
+    return if (date = date.to_s.strip).empty?
+
+    p = Parser.new
+
+    if opts[:matcher]
+      p.configure do |c|
+        c.formats = [opts[:matcher]]
+      end
+    end
+
+    p.parse(date)
+  end
+
+end

data/quando.gemspec

@@ -0,0 +1,24 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'quando/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'quando'
+  spec.version       = Quando::VERSION
+  spec.authors       = ['Sergey Konotopov']
+  spec.email         = ['werk@mail.ru']
+
+  spec.summary       = %q{Configurable date parser}
+  spec.description   = %q{Parse dates in any language and format by setting your own recognition patterns}
+  spec.homepage      = 'https://github.com/kinkou/quando'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.15'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'pry'
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: quando
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Sergey Konotopov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-10-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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'
+description: Parse dates in any language and format by setting your own recognition
+  patterns
+email:
+- werk@mail.ru
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".editorconfig"
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- lib/quando.rb
+- lib/quando/config.rb
+- lib/quando/parser.rb
+- lib/quando/version.rb
+- quando.gemspec
+homepage: https://github.com/kinkou/quando
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Configurable date parser
+test_files: []