lucarecord 0.2.15 → 0.2.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d7ac838f340b86b71208f40357ebbe7c4217b1ed6b69dcf012b773d8fa0a532
-  data.tar.gz: c0e706fe9e1eef4abbb5d9600a5100931cd9384d45459481142fb3c594dbfd32
+  metadata.gz: e2644c50f67e64dfe2502400e04eddb6278a314d00f82eb5a51a6489797f0b48
+  data.tar.gz: c6d286442884c6675f18340ad2eb3322cd76515992530cbf4fc8536b66a6bbad
 SHA512:
-  metadata.gz: 56f2f5575afb0a5e204a94ed66fa7b6ded3831316e9d71be17a02270f464b57551701c3938a447f479a4512255800d49bdc545e8f970f8d81f00c1be8caf5316
-  data.tar.gz: be5bf831649fb6d6ad74ca44ae18c9cbb4eabf26193926979776fb99f843c687a8dead90917dafeaa3e9289c2ec8eb83e78a2082fad50305df1f4b8bcaab96a9
+  metadata.gz: 0122e43160066ce33dad8478fc99cd4bc639abf232788852ebce74328f664f413756ea91c73a6f6372f4dce9648a9c6776dd7f7ee1f0971930b71f0816a2841b
+  data.tar.gz: '09c51366863747bfea0cdf829d0829be6d084b79cbc729c3cb51ecea7f07196ca2c7ff0eea8b52d834d0af476de9cb953ef50d9e1b7e620de0c6f5d51c64f158'

data/CHANGELOG.md

@@ -0,0 +1,17 @@
+## LucaRecord 0.2.20
+
+* UUID completion framework on prefix match
+
+## LucaRecord 0.2.19
+
+* `LucaSupport::Code.decode_id()`
+* `LucaSupport::Code.encode_term()` for multiple months search. Old `scan_term()` removed.
+
+## LucaRecord 0.2.18
+
+* `find()`, `create()`, `save()` now supports both of uuid / historical records. If specified `date:` keyword option to `create()`, then generate historical record. `find()`, `save()` identifies with 'id' attribute.
+
+## LucaRecord 0.2.17
+
+* Change internal number format to BigDecimal.
+* Number of Decimal is configurable through `decimal_number` in config.yml(default = 2). `country` setting can also affect.

data/lib/luca_record/dict.rb

@@ -20,7 +20,7 @@ module LucaRecord
     end
 
     def search(word, default_word = nil)
-      res = max_score_code(word)
+      res = max_score_code(word.gsub(/[[:space:]]/, ''))
       if res[1] > 0.4
         res[0]
       else
@@ -65,12 +65,14 @@ module LucaRecord
         config[:type] ||= 'invalid'
         config[:debit_value] = @config['debit_value'].to_i if @config.dig('debit_value')
         config[:credit_value] = @config['credit_value'].to_i if @config.dig('credit_value')
-        config[:note] = @config['note'].to_i if @config.dig('note')
+        config[:note] = @config['note'] if @config.dig('note')
         config[:encoding] = @config['encoding'] if @config.dig('encoding')
 
         config[:year] = @config['year'] if @config.dig('year')
         config[:month] = @config['month'] if @config.dig('month')
         config[:day] = @config['day'] if @config.dig('day')
+        config[:default_debit] = @config['default_debit'] if @config.dig('default_debit')
+        config[:default_credit] = @config['default_credit'] if @config.dig('default_credit')
       end
     end
 

data/lib/luca_record/io.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'bigdecimal'
 require 'csv'
 require 'date'
 require 'fileutils'
@@ -29,15 +30,15 @@ module LucaRecord # :nodoc:
 
       # find ID based record. Support uuid and encoded date.
       def find(id, basedir = @dirname)
-        return enum_for(:find, id, basedir) unless block_given?
+        return enum_for(:find, id, basedir).first unless block_given?
 
         if id.length >= 40
           open_hashed(basedir, id) do |f|
             yield load_data(f)
           end
-        elsif id.length >= 9
-          # TODO: need regexp match for more flexible coding(after AD9999)
-          open_records(basedir, id[0, 5], id[5, 6]) do |f, path|
+        elsif id.length >= 7
+          parts = id.split('/')
+          open_records(basedir, parts[0], parts[1]) do |f, path|
             yield load_data(f, path)
           end
         else
@@ -53,8 +54,22 @@ module LucaRecord # :nodoc:
       def asof(year, month = nil, day = nil, basedir = @dirname)
         return enum_for(:search, year, month, day, nil, basedir) unless block_given?
 
-        search(year, month, day, nil, basedir) do |data, path|
-          yield data, path
+        search(year, month, day, nil, basedir) { |data, path| yield data, path }
+      end
+
+      # scan ranging data on multiple months
+      #
+      def term(start_year, start_month, end_year, end_month, code = nil, basedir = @dirname)
+        return enum_for(:term, start_year, start_month, end_year, end_month, code, basedir) unless block_given?
+
+        LucaSupport::Code.encode_term(start_year, start_month, end_year, end_month).each do |subdir| 
+          open_records(basedir, subdir, nil, code) do |f, path|
+            if @record_type == 'raw'
+              yield f, path
+            else
+              yield load_data(f, path)
+            end
+          end
         end
       end
 
@@ -89,25 +104,48 @@ module LucaRecord # :nodoc:
       # of each concrete class.
       # ----------------------------------------------------------------
 
-      # create hash based record
-      def create(obj, basedir = @dirname)
-        id = LucaSupport::Code.issue_random_id
-        obj['id'] = id
-        open_hashed(basedir, id, 'w') do |f|
-          f.write(YAML.dump(obj.sort.to_h))
+      # create record both of uuid/date identified.
+      #
+      def create(obj, date: nil, codes: nil, basedir: @dirname)
+        validate_keys(obj)
+        if date
+          create_record(obj, date, codes, basedir)
+        else
+          obj['id'] = LucaSupport::Code.issue_random_id
+          open_hashed(basedir, obj['id'], 'w') do |f|
+            f.write(YAML.dump(LucaSupport::Code.readable(obj.sort.to_h)))
+          end
+          obj['id']
         end
-        id
       end
 
-      # define new transaction ID & write data at once
-      def create_record!(obj, date_obj, codes = nil, basedir = @dirname)
-        gen_record_file!(basedir, date_obj, codes) do |f|
-          f.write(YAML.dump(obj.sort.to_h))
+      # If multiple ID matched, return short ID and human readable label.
+      #
+      def id_completion(phrase, label: 'name', basedir: @dirname)
+        list = prefix_search(phrase, basedir: basedir)
+        case list.length
+        when 1
+          list
+        when 0
+          raise 'No match on specified phrase'
+        else
+          (3..list[0].length).each do |l|
+            if list.map { |id| id[0, l] }.uniq.length == list.length
+              return list.map { |id| { id: id[0, l], label: find(id).dig(label) } }
+            end
+          end
+        end
+      end
+
+      def prefix_search(phrase, basedir: @dirname)
+        glob_str = phrase.length <= 3 ? "#{phrase}*/*" : "#{id2path(phrase)}*"
+        Dir.chdir(abs_path(basedir)) do
+          Dir.glob(glob_str).to_a.map! { |path| path.gsub!('/', '') }
         end
       end
 
       def prepare_dir!(basedir, date_obj)
-        dir_name = (Pathname(basedir) + encode_dirname(date_obj)).to_s
+        dir_name = (Pathname(basedir) + LucaSupport::Code.encode_dirname(date_obj)).to_s
         FileUtils.mkdir_p(dir_name) unless Dir.exist?(dir_name)
         dir_name
       end
@@ -121,6 +159,49 @@ module LucaRecord # :nodoc:
         File.write(path, YAML.dump(origin.sort.to_h))
       end
 
+      # update file with obj['id']
+      def save(obj, basedir = @dirname)
+        if obj['id'].nil?
+          create(obj, basedir)
+        else
+          validate_keys(obj)
+          if obj['id'].length < 40
+            parts = obj['id'].split('/')
+            raise 'invalid ID' if parts.length != 2
+
+            open_records(basedir, parts[0], parts[1], nil, 'w') do |f, path|
+              f.write(YAML.dump(LucaSupport::Code.readable(obj.sort.to_h)))
+            end
+          else
+            open_hashed(basedir, obj['id'], 'w') do |f|
+              f.write(YAML.dump(LucaSupport::Code.readable(obj.sort.to_h)))
+            end
+          end
+        end
+        obj['id']
+      end
+
+      # delete file by id
+      def delete(id, basedir = @dirname)
+        FileUtils.rm(Pathname(abs_path(basedir)) / id2path(id))
+        id
+      end
+
+      # change filename with new code set
+      #
+      def change_codes(id, new_codes, basedir = @dirname)
+        raise 'invalid id' if id.split('/').length != 2
+
+        newfile = new_codes.empty? ? id : id + '-' + new_codes.join('-')
+        Dir.chdir(abs_path(basedir)) do
+          origin = Dir.glob("#{id}*")
+          raise 'duplicated files' if origin.length != 1
+
+          File.rename(origin.first, newfile)
+        end
+        newfile
+      end
+
       # ----------------------------------------------------------------
       # :section: Path Utilities
       # ----------------------------------------------------------------
@@ -161,10 +242,6 @@ module LucaRecord # :nodoc:
         end
       end
 
-      def encode_dirname(date_obj)
-        date_obj.year.to_s + LucaSupport::Code.encode_month(date_obj)
-      end
-
       # test if having required dirs/files under exec path
       def valid_project?(path = LucaSupport::Config::Pjdir)
         project_dir = Pathname(path)
@@ -177,6 +254,29 @@ module LucaRecord # :nodoc:
 
       private
 
+      # define new transaction ID & write data at once
+      # ID format is like '2020H/A001', which means record no.1 of 2020/10/10.
+      # Any data format can be written with block.
+      #
+      def create_record(obj, date_obj, codes = nil, basedir = @dirname)
+        FileUtils.mkdir_p(abs_path(basedir)) unless Dir.exist?(abs_path(basedir))
+        subdir = "#{date_obj.year}#{LucaSupport::Code.encode_month(date_obj)}"
+        filename = LucaSupport::Code.encode_date(date_obj) + new_record_id(basedir, date_obj)
+        obj['id'] = "#{subdir}/#{filename}" if obj.is_a? Hash
+        filename += '-' + codes.join('-') if codes
+        Dir.chdir(abs_path(basedir)) do
+          FileUtils.mkdir_p(subdir) unless Dir.exist?(subdir)
+            File.open(Pathname(subdir) / filename, 'w') do |f|
+              if block_given?
+                yield(f)
+              else
+                f.write(YAML.dump(LucaSupport::Code.readable(obj.sort.to_h)))
+              end
+            end
+        end
+        "#{subdir}/#{filename}"
+      end
+
       # open records with 'basedir/month/date-code' path structure.
       # Glob pattern can be specified like folloing examples.
       #
@@ -192,6 +292,7 @@ module LucaRecord # :nodoc:
 
         file_pattern = filename.nil? ? '*' : "#{filename}*"
         Dir.chdir(abs_path(basedir)) do
+          FileUtils.mkdir_p(subdir) if mode == 'w' && !Dir.exist?(subdir)
           Dir.glob("#{subdir}*/#{file_pattern}").sort.each do |subpath|
             next if skip_on_unmatch_code(subpath, code)
 
@@ -223,6 +324,17 @@ module LucaRecord # :nodoc:
         end
       end
 
+      # parse data dir and respond existing months
+      #
+      def scan_terms(query = nil, base_dir = @dirname)
+        pattern = query.nil? ? "*" : "#{query}*"
+        Dir.chdir(abs_path(base_dir)) do
+          Dir.glob(pattern).select { |dir|
+            FileTest.directory?(dir) && /^[0-9]/.match(dir)
+          }.sort.map { |str| decode_term(str) }
+        end
+      end
+
       # Decode basic format.
       # If specific decode is needed, override this method in each class.
       #
@@ -234,18 +346,18 @@ module LucaRecord # :nodoc:
         when 'json'
         # TODO: implement JSON parse
         else
-          YAML.load(io.read)
+          LucaSupport::Code.decimalize(YAML.load(io.read)).tap { |obj| validate_keys(obj) }
         end
       end
 
-      def gen_record_file!(basedir, date_obj, codes = nil)
-        d = prepare_dir!(abs_path(basedir), date_obj)
-        filename = LucaSupport::Code.encode_date(date_obj) + new_record_id(abs_path(basedir), date_obj)
-        if codes
-          filename += codes.inject('') { |fragment, code| "#{fragment}-#{code}" }
+      def validate_keys(obj)
+        return nil unless @required
+
+        keys = obj.keys
+        [].tap do |errors|
+          @required.each { |r| errors << r unless keys.include?(r) }
+          raise "Missing keys: #{errors.join(' ')}" unless errors.empty?
         end
-        path = Pathname(d) + filename
-        File.open(path.to_s, 'w') { |f| yield(f) }
       end
 
       # TODO: replace with data_dir method
@@ -265,8 +377,10 @@ module LucaRecord # :nodoc:
 
       # AUTO INCREMENT
       def new_record_no(basedir, date_obj)
-        dir_name = (Pathname(basedir) + encode_dirname(date_obj)).to_s
-        raise 'No target dir exists.' unless Dir.exist?(dir_name)
+        raise 'No target dir exists.' unless Dir.exist?(abs_path(basedir))
+
+        dir_name = (Pathname(abs_path(basedir)) / LucaSupport::Code.encode_dirname(date_obj)).to_s
+        return 1 unless Dir.exist?(dir_name)
 
         Dir.chdir(dir_name) do
           last_file = Dir.glob("#{LucaSupport::Code.encode_date(date_obj)}*").max
@@ -298,17 +412,6 @@ module LucaRecord # :nodoc:
       end
     end
 
-    # parse data dir and respond existing months
-    #
-    def scan_terms(base_dir, query = nil)
-      pattern = query.nil? ? "*" : "#{query}*"
-      Dir.chdir(base_dir) do
-        Dir.glob(pattern).select { |dir|
-          FileTest.directory?(dir) && /^[0-9]/.match(dir)
-        }.sort.map { |str| decode_term(str) }
-      end
-    end
-
     def load_config(path = nil)
       path = path.to_s
       if File.exist?(path)

data/lib/luca_record/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LucaRecord
-  VERSION = '0.2.15'
+  VERSION = '0.2.20'
 end

data/lib/luca_support/code.rb

@@ -3,12 +3,20 @@
 require 'date'
 require 'securerandom'
 require 'digest/sha1'
+require 'luca_support/config'
 
 # implement Luca IDs convention
 module LucaSupport
   module Code
     module_function
 
+    # Parse historical id into Array of date & transaction id.
+    #
+    def decode_id(id_str)
+      m = %r(^(?<year>[0-9]+)(?<month>[A-L])/?(?<day>[0-9A-V])(?<txid>[0-9A-Z]{,3})).match(id_str)
+      ["#{m[:year]}-#{decode_month(m[:month])}-#{decode_date(m[:day])}", decode_txid(m[:txid])]
+    end
+
     def encode_txid(num)
       txmap = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
       l = txmap.length
@@ -44,7 +52,12 @@ module LucaSupport
       num.to_s.reverse.gsub!(/(\d{3})(?=\d)/, '\1,').reverse!
     end
 
+    # encode directory name from year and month.
     #
+    def encode_dirname(date_obj)
+      date_obj.year.to_s + encode_month(date_obj)
+    end
+
     # Month to code conversion.
     # Date, DateTime, String, Integer is valid input. If nil, returns empty String for consistency.
     #
@@ -63,6 +76,16 @@ module LucaSupport
       '0ABCDEFGHIJKL'.index(char)
     end
 
+    # Generate globbing phrase like ["2020[C-H]"] for range search.
+    #
+    def encode_term(start_year, start_month, end_year, end_month)
+      (start_year..end_year).to_a.map do |y|
+        g1 = y == start_year ? encode_month(start_month) : encode_month(1)
+        g2 = y == end_year ? encode_month(end_month) : encode_month(12)
+        "#{y}[#{g1}-#{g2}]"
+      end
+    end
+
     def decode_term(char)
       m = /^([0-9]{4})([A-La-l])/.match(char)
       [m[1].to_i, decode_month(m[2])]
@@ -72,6 +95,37 @@ module LucaSupport
       Digest::SHA1.hexdigest(SecureRandom.uuid)
     end
 
+    def decimalize(obj)
+      case obj.class.name
+      when 'Array'
+        obj.map { |i| decimalize(i) }
+      when 'Hash'
+        obj.inject({}) { |h, (k, v)| h[k] = decimalize(v); h }
+      when 'Integer'
+        BigDecimal(obj.to_s)
+      when 'String'
+        /^[0-9\.]+$/.match(obj) ? BigDecimal(obj) : obj
+      when 'Float'
+        raise 'already float'
+      else
+        obj
+      end
+    end
+
+    def readable(obj, len = LucaSupport::Config::DECIMAL_NUM)
+      case obj.class.name
+      when 'Array'
+        obj.map { |i| readable(i) }
+      when 'Hash'
+        obj.inject({}) { |h, (k, v)| h[k] = readable(v); h }
+      when 'BigDecimal'
+        parts = obj.round(len).to_s('F').split('.')
+        len < 1 ? parts.first : "#{parts[0]}.#{parts[1][0, len]}"
+      else
+        obj
+      end
+    end
+
     #
     # convert effective/defunct data into current hash on @date.
     # not parse nested children.
@@ -97,7 +151,7 @@ module LucaSupport
     #
     def take_current(dat, item)
       target = dat.dig(item)
-      if target.class.name == 'Array' && target.map(&:keys).flatten.include?('effective')
+      if target.is_a?(Array) && target.map(&:keys).flatten.include?('effective')
         latest = target
                  .filter { |a| Date.parse(a.dig('effective').to_s) < @date }
                  .max { |a, b| Date.parse(a.dig('effective').to_s) <=> Date.parse(b.dig('effective').to_s) }

data/lib/luca_support/config.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'pathname'
+require 'yaml'
+
 #
 # startup config
 #
@@ -7,5 +10,11 @@ module LucaSupport
   module Config
     # Project top directory.
     Pjdir = ENV['LUCA_TEST_DIR'] || Dir.pwd.freeze
+    if File.exist?(Pathname(Pjdir) / 'config.yml')
+      # DECIMAL_NUM = YAML.load_file(Pathname(Pjdir) / 'config.yml', **{})['decimal_number']
+      COUNTRY = YAML.load_file(Pathname(Pjdir) / 'config.yml', **{})['country']
+      DECIMAL_NUM ||= 0 if COUNTRY == 'jp'
+    end
+    DECIMAL_NUM ||= 2
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lucarecord
 version: !ruby/object:Gem::Version
-  version: 0.2.15
+  version: 0.2.20
 platform: ruby
 authors:
 - Chuma Takahiro
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-11-05 00:00:00.000000000 Z
+date: 2020-11-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mail