defmastership 1.0.17 → 1.0.18

data/lib/defmastership/csv_formatter.rb

@@ -8,7 +8,7 @@ require('defmastership/csv_formatter_header')
 module DefMastership
   # to export a CSV file
   class CSVFormatter
-    def initialize(doc, sep = ',')
+    def initialize(doc, sep)
       @doc = doc
       @sep = sep
     end
@@ -17,12 +17,16 @@ module DefMastership
       column_list = build_column_list
       CSV.open(output_file, 'w:ISO-8859-1', col_sep: @sep) do |csv|
         csv << header(column_list)
-        @doc.definitions.each { |definition| csv << body(definition, column_list) }
+        export_definitions_in(csv, column_list)
       end
     end
 
     private
 
+    def export_definitions_in(csv, column_list)
+      @doc.definitions.each { |definition| csv << body(definition, column_list) }
+    end
+
     def header(column_list)
       header_formatter = CSVFormatterHeader.new(@doc)
       header_line = column_list.map { |part| header_formatter.public_send(part) }
@@ -30,20 +34,20 @@ module DefMastership
     end
 
     def body(definition, column_list)
-      body_formatter = CSVFormatterBody.new(@doc)
-      body_line = column_list.map { |part| body_formatter.public_send(part, definition) }
+      body_formatter = CSVFormatterBody.new(@doc, definition)
+      body_line = column_list.map { |part| body_formatter.public_send(part) }
       body_line.flatten
     end
 
     def build_column_list
-      column_list = [:fixed]
-      column_list += [:wrong_explicit_checksum] if @doc.wrong_explicit_checksum?
-      column_list += [:explicit_version] if @doc.explicit_version?
-      column_list += [:labels] unless @doc.labels.empty?
-      column_list += [:eref] unless @doc.eref.empty?
-      column_list += [:iref] if @doc.iref
-      column_list += [:attributes] unless @doc.attributes.empty?
-      column_list
+      [
+        [:wrong_explicit_checksum, @doc.wrong_explicit_checksum?],
+        [:explicit_version, @doc.explicit_version?],
+        [:labels, !@doc.labels.empty?],
+        [:eref, !@doc.eref.empty?],
+        [:iref, @doc.iref],
+        [:attributes, !@doc.attributes.empty?]
+      ].reduce([:fixed]) { |acc, elem| acc + (elem.fetch(1) ? [elem.first] : []) }
     end
   end
 end

data/lib/defmastership/csv_formatter_body.rb

@@ -3,41 +3,44 @@
 
 require('csv')
 
+require('defmastership/set_join_hack')
+
 module DefMastership
   # format lines per definition
   class CSVFormatterBody
-    def initialize(doc)
+    def initialize(doc, definition)
       @doc = doc
+      @definition = definition
     end
 
-    def fixed(definition)
-      [definition.type, definition.reference, definition.value, definition.sha256]
+    def fixed
+      [@definition.type, @definition.reference, @definition.value, @definition.sha256_short]
     end
 
-    def wrong_explicit_checksum(definition)
-      wrong_explicit_checksum = definition.wrong_explicit_checksum
+    def wrong_explicit_checksum
+      wrong_explicit_checksum = @definition.wrong_explicit_checksum
       wrong_explicit_checksum ? [wrong_explicit_checksum] : ['']
     end
 
-    def explicit_version(definition)
-      explicit_version = definition.explicit_version
+    def explicit_version
+      explicit_version = @definition.explicit_version
       explicit_version ? [explicit_version] : ['']
     end
 
-    def labels(definition)
-      [definition.labels.to_a.join("\n")]
+    def labels
+      [@definition.labels.join("\n")]
     end
 
-    def eref(definition)
-      @doc.eref.map { |key, _| definition.eref[key].join("\n") }
+    def eref
+      @doc.eref.map { |key,| @definition.eref.fetch(key, []).join("\n") }
     end
 
-    def iref(definition)
-      [definition.iref.join("\n")]
+    def iref
+      [@definition.iref.join("\n")]
     end
 
-    def attributes(definition)
-      @doc.attributes.map { |key, _| definition.attributes[key] }
+    def attributes
+      @doc.attributes.map { |key,| @definition.attributes.fetch(key, '') }
     end
   end
 end

data/lib/defmastership/csv_formatter_header.rb

@@ -27,7 +27,7 @@ module DefMastership
     end
 
     def eref
-      @doc.eref.map { |_, ref| ref[:prefix] }
+      @doc.eref.map { |_, ref| ref.fetch(:prefix) }
     end
 
     def iref

data/lib/defmastership/definition.rb

@@ -3,51 +3,90 @@
 
 require 'digest'
 
+# Contains the content of a DefMastership definition
 module DefMastership
+  BUILD_FROM_MATCH = {
+    type: ->(match) { match[:type] },
+    reference: ->(match) { match[:reference] },
+    lines: ->(_) { [] },
+    labels: lambda do |match|
+      labels = Set.new
+      labels.merge(match[:labels].split(/\s*,\s*/).to_set) if match[:labels]
+      labels
+    end,
+    eref: ->(_) { Hash.new([]) },
+    iref: ->(_) { [] },
+    attributes: ->(_) { {} },
+    explicit_checksum: ->(match) { match[:explicit_checksum] },
+    explicit_version: ->(match) { match[:explicit_version] }
+  }.freeze
+
+  private_constant :BUILD_FROM_MATCH
+
+  # Class to host data of Definition class
+  DefinitionData = Struct.new(
+    :type,
+    :reference,
+    :lines,
+    :labels,
+    :eref,
+    :iref,
+    :attributes,
+    :explicit_checksum,
+    :explicit_version
+  )
+
+  private_constant :DefinitionData
+
   # DefMastership definition: contains all data of a definition
   class Definition
-    attr_reader :type, :reference, :lines, :labels, :eref, :iref, :attributes, :explicit_version
+    extend Forwardable
+    def_delegators :@data,
+                   :type,
+                   :reference,
+                   :lines,
+                   :labels,
+                   :eref,
+                   :iref,
+                   :attributes,
+                   :explicit_checksum,
+                   :explicit_version
 
     def initialize(match)
-      @type = match[:type]
-      @reference = match[:reference]
-      @lines = []
-      @labels = Set.new
-      @labels.merge(match[:labels].split(/\s*,\s*/).to_set) if match[:labels]
-      @eref = Hash.new([])
-      @iref = []
-      @attributes = {}
-      @explicit_checksum = match[:explicit_checksum]
-      @explicit_version = match[:explicit_version]
+      @data = DefinitionData.new(
+        *BUILD_FROM_MATCH.transform_values { |lamb| lamb.call(match) }
+           .fetch_values(*DefinitionData.members)
+      )
     end
 
     def <<(new_line)
-      @lines << new_line
+      lines << new_line
       self
     end
 
     def value
-      @lines.join("\n")
+      lines.join("\n")
     end
 
-    def sha256
-      "~#{Digest::SHA2.new(256).hexdigest(value).chars.last(8).join}"
+    def sha256_short
+      "~#{Digest::SHA2.hexdigest(value).chars.last(8).join}"
     end
 
     def wrong_explicit_checksum
-      @explicit_checksum if @explicit_checksum != sha256
+      explicit_checksum unless explicit_checksum.eql?(sha256_short)
     end
 
     def add_eref(refname, extrefs)
-      @eref[refname] = extrefs.strip.split(/\s*,\s*/)
+      eref[refname] = extrefs.strip.split(/\s*,\s*/)
     end
 
     def add_iref(ref)
-      @iref << ref
+      iref << ref
     end
 
     def set_attribute(key, value)
-      @attributes[key] = value
+      attributes[key] = value
     end
   end
+  public_constant :Definition
 end

data/lib/defmastership/document.rb

@@ -2,21 +2,87 @@
 # frozen_string_literal: true
 
 require('asciidoctor')
+require('defmastership/matching_line')
 
+# Contains the content of a DefMastership document: mainly definitions
 module DefMastership
-  # Contains the content of a DefMastership document: mainly definitions
+  # Class to host data of Document class
+  DocumentData = Struct.new(
+    :definitions,
+    :labels,
+    :eref,
+    :iref,
+    :attributes,
+    :variables
+  )
+
+  private_constant :DocumentData
+
+  PARSER_ACTIONS = {
+    add_new_definition: lambda { |matching_line|
+      definition = Definition.new(matching_line.match)
+      labels.merge(definition.labels)
+      definitions << definition
+      matching_line.line
+    },
+    add_line: lambda { |matching_line|
+      line = matching_line.line
+      definitions.last << line
+      line
+    },
+    new_eref_setup: lambda { |matching_line|
+      refname = matching_line[:refname].to_sym
+      eref[refname] ||= {}
+      eref[refname][matching_line[:symb].to_sym] = matching_line[:value]
+      matching_line.line
+    },
+    new_eref_def: lambda { |matching_line|
+      definitions.last.add_eref(matching_line[:refname].to_sym, matching_line[:extrefs])
+      matching_line.line
+    },
+    new_iref_def: lambda { |matching_line|
+      self.iref = true
+      line = matching_line.line
+      line.scan(DMRegexp::IREF_DEF) do |_|
+        definitions.last.add_iref(Regexp.last_match[:intref])
+      end
+      line
+    },
+    new_attribute_conf: lambda { |matching_line|
+      attributes[matching_line[:attr].to_sym] = matching_line[:prefix]
+      matching_line.line
+    },
+    new_attribute_value: lambda { |matching_line|
+      definitions.last.set_attribute(matching_line[:attr].to_sym, matching_line[:value])
+      matching_line.line
+    },
+    new_variable_def: lambda { |matching_line|
+      variables[matching_line[:varname].to_sym] = matching_line[:value]
+      matching_line.line
+    },
+    new_variable_use: lambda { |matching_line|
+      line = matching_line.line
+      line.scan(DMRegexp::VARIABLE_USE) do |_|
+        varname = Regexp.last_match[:varname]
+        value = variables[varname.to_sym]
+
+        next unless value
+
+        line = line.gsub("{#{varname}}", value)
+      end
+      line
+    }
+  }.freeze
+
+  private_constant :PARSER_ACTIONS
 
   # Reflects document structure from a definition point of view
   class Document
-    attr_reader :definitions, :labels, :eref, :iref, :attributes, :variables
+    extend Forwardable
+    def_delegators :@data, :definitions, :labels, :eref, :iref, :attributes, :variables
 
     def initialize
-      @definitions   = []
-      @labels        = Set.new
-      @eref          = {}
-      @iref          = false
-      @attributes    = {}
-      @variables     = {}
+      @data = DocumentData.new([], Set.new, {}, false, {}, {})
       @parsing_state = ParsingState.new
       @definition_parser = DefinitionParser.new(self)
     end
@@ -26,7 +92,7 @@ module DefMastership
         if @parsing_state.enabled?(line)
           apply_filters(line)
         else
-          generate_event(:new_line, nil, line)
+          generate_event(:new_line, MatchingLine.new(nil, line))
         end
       end
     end
@@ -36,96 +102,65 @@ module DefMastership
     end
 
     def wrong_explicit_checksum?
-      @definitions.reduce(false) do |res, definition|
-        res || !definition.wrong_explicit_checksum.nil?
+      definitions.reduce(false) do |res, definition|
+        res || !!definition.wrong_explicit_checksum
       end
     end
 
     def explicit_version?
-      @definitions.reduce(false) do |res, definition|
-        res || !definition.explicit_version.nil?
+      definitions.reduce(false) do |res, definition|
+        res || !!definition.explicit_version
       end
     end
 
-    def add_new_definition(match, line)
-      definition = Definition.new(match)
-      @labels.merge(definition.labels)
-      @definitions << definition
-      line
-    end
-
-    def ref_to_def(ref)
-      @definitions.find { |definition| definition.reference == ref }
-    end
+    def method_missing(method_name, *args)
+      action = PARSER_ACTIONS[method_name]
+      return instance_exec(*args, &action) if action
 
-    def add_line(_match, line)
-      @definitions.last << line
-      line
+      super
     end
 
-    def new_eref_setup(match, line)
-      @eref[match[:refname].to_sym] ||= {}
-      @eref[match[:refname].to_sym][match[:symb].to_sym] = match[:value]
-      line
+    # This method smells of :reek:UtilityFunction
+    def respond_to_missing?(method_name, *_args)
+      PARSER_ACTIONS.key?(method_name)
     end
 
-    def new_eref_def(match, line)
-      @definitions.last.add_eref(match[:refname].to_sym, match[:extrefs])
-      line
-    end
-
-    def new_iref_def(_match, line)
-      @iref = true
-      line.scan(DMRegexp::IREF_DEF) do |_|
-        @definitions.last.add_iref(Regexp.last_match[:intref])
-      end
-      line
+    def ref_to_def(ref)
+      definitions.find { |definition| definition.reference == ref }
     end
 
-    def new_attribute_conf(match, line)
-      @attributes[match[:attr].to_sym] = match[:prefix]
-      line
+    def iref=(value)
+      @data.iref = value
     end
 
-    def new_attribute_value(match, line)
-      @definitions.last.set_attribute(match[:attr].to_sym, match[:value])
-      line
-    end
+    private
 
-    def new_variable_def(match, line)
-      @variables[match[:varname].to_sym] = match[:value]
-      line
+    def apply_filters(line)
+      Helper.reduce_filters_until_consumed(line) do |event, match, updated_line|
+        generate_event(event, MatchingLine.new(match, updated_line))
+      end
     end
 
-    def new_variable_use(_match, line)
-      line.scan(DMRegexp::VARIABLE_USE) do |_|
-        varname = Regexp.last_match[:varname]
-        next if @variables[varname.to_sym].nil?
-
-        line = line.gsub("{#{varname}}", @variables[varname.to_sym])
+    def generate_event(event, matching_line)
+      if PARSER_ACTIONS.key?(event)
+        public_send(event, matching_line)
+      else
+        @definition_parser.public_send(event, matching_line)
       end
-      line
     end
 
-    private
-
-    def apply_filters(line)
-      FILTERS.each do |filter|
-        next unless line.match(filter.regexp)
+    # Helper functions
+    module Helper
+      def self.reduce_filters_until_consumed(line)
+        FILTERS.reduce(line) do |res, filter|
+          next res unless line.match(filter.regexp)
 
-        line = generate_event(filter.event, Regexp.last_match, line)
+          res = yield(filter.event, Regexp.last_match, res)
+          break if filter.consumed_line
 
-        break if filter.consumed_line
-      end
-    end
-
-    def generate_event(event, match, line)
-      if respond_to?(event)
-        line = public_send(event, match, line)
-      else
-        @definition_parser.public_send(event, match, line)
+          res
+        end
       end
-      line
     end
   end
 end

data/lib/defmastership/matching_line.rb

@@ -0,0 +1,17 @@
+# Copyright (c) 2020 Jerome Arbez-Gindre
+# frozen_string_literal: true
+
+module DefMastership
+  # a composite class
+  MatchingLine =
+    Struct.new(:match, :line) do
+      def [](key)
+        value = match[key]
+        return value if value
+
+        super
+      end
+    end
+
+  public_constant :MatchingLine
+end

data/lib/defmastership/modifier.rb

@@ -0,0 +1,42 @@
+# Copyright (c) 2020 Jerome Arbez-Gindre
+# frozen_string_literal: true
+
+module DefMastership
+  # define methods for line modifiers
+  module Modifier
+    attr_reader :config, :changes
+
+    def setup_modifier_module(config)
+      @config = self.class.default_config.merge(config)
+      @changes = []
+    end
+
+    def method_missing(method_name, *args)
+      config_method_name = config[method_name]
+      return config_method_name if config_method_name
+
+      super
+    end
+
+    def respond_to_missing?(method_name, *args)
+      config.key?(method_name) || super
+    end
+
+    def apply_to_all(texts, method)
+      texts.transform_values do |text|
+        apply_to_one(text, method)
+      end
+    end
+
+    def apply_to_one(text, method)
+      text.lines.map { |line| public_send(method, line) }
+          .join
+    end
+
+    def do_modifications(adoc_sources)
+      self.class.replacement_methods.reduce(adoc_sources) do |texts, method|
+        apply_to_all(texts, method)
+      end
+    end
+  end
+end

data/lib/defmastership/modifier_factory.rb

@@ -0,0 +1,12 @@
+# Copyright (c) 2023 Jerome Arbez-Gindre
+# frozen_string_literal: true
+
+module DefMastership
+  # build midifers from a piece of configuration
+  module ModifierFactory
+    def self.from_config(config)
+      class_name = "#{config.fetch(:type).split('_').map(&:capitalize).join}Modifier"
+      DefMastership.const_get(class_name).new(config.fetch(:config))
+    end
+  end
+end

data/lib/defmastership/parsing_state.rb

@@ -4,22 +4,28 @@
 module DefMastership
   # Allow to know if we need to parse the line or simply ignore it
   class ParsingState
+    # mutant:disable (for mutant, aatribute initialization is useless)
     def initialize
       @last_disabling_line = nil
     end
 
     def enabled?(line)
-      return false if line.match(DMRegexp::SINGLE_LINE_COMMENT)
+      return false if line.match?(DMRegexp::SINGLE_LINE_COMMENT)
 
-      line = line.dup.chomp
-      if ['....', '----', '////'].include?(line)
-        if @last_disabling_line == line
-          @last_disabling_line = nil
-        elsif @last_disabling_line.nil?
-          @last_disabling_line = line
-        end
+      line = line.chomp
+      possibly_invert_last_disabling_line(line) if ['....', '----', '////'].include?(line)
+
+      !@last_disabling_line
+    end
+
+    private
+
+    def possibly_invert_last_disabling_line(line)
+      if @last_disabling_line == line
+        @last_disabling_line = nil
+      elsif !@last_disabling_line
+        @last_disabling_line = line
       end
-      @last_disabling_line.nil?
     end
   end
 end