js_dependency 0.3.11 → 0.3.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a61cec11e64fc475a0fb7838b11abf8ab6a1a0d8cfab0929e475eff2fcbef6c0
-  data.tar.gz: 461e0b8503aec5ab25f7b3508ae420af41f72022e39a4e1388a8ae8217858ac1
+  metadata.gz: 249f9142ce332c3874696fb62d0478365ed719caea8088c75b4059ade79931cb
+  data.tar.gz: cf44ea94425033c0905d29f496c65d0bbf32c45d7fc8d3681ad1d5a66e9762d0
 SHA512:
-  metadata.gz: c2e5483e130e608b4a21741ffccf44db1f812a6096b9f4c5df419cb97029f340c9c8ba770542133d528a213720f924282e9cd72bfd6cc135606904a594c20ed1
-  data.tar.gz: ae67a36c93fdb56ddc5a59c6244d78b7c58f08399d72a725a6d655e945f518c2a14f517c6253dde5cf26516c1cf30a5834ac77cc752e0a67a51301c13d2576e2
+  metadata.gz: a4427662cc2db7567b4bb041416aea5b7b5d60f16a7c112e215670de211c20b4457265f95d087647bc934d96a3f5fa1052e7078c610f056fb0dbf0525c6cc0d9
+  data.tar.gz: 2ee5a1db44106a777b7b583204db51fcc37315635101a995bf79110cc99a3e05c0fb1434c2e9a6c4becbd7615237facd0e9ed9b53ca1522d98a85c07bd490302

data/.rubocop_todo.yml

@@ -1,42 +1,42 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2022-08-13 05:13:43 UTC using RuboCop version 1.34.1.
+# on 2022-08-21 04:15:24 UTC using RuboCop version 1.35.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 3
+# Offense count: 2
 # Configuration parameters: AllowedMethods, AllowedPatterns, IgnoredMethods, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 29
+  Max: 31
 
-# Offense count: 3
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 118
+
+# Offense count: 2
 # Configuration parameters: AllowedMethods, AllowedPatterns, IgnoredMethods.
 Metrics/CyclomaticComplexity:
   Max: 15
 
-# Offense count: 8
+# Offense count: 10
 # Configuration parameters: CountComments, CountAsOne, ExcludedMethods, AllowedMethods, AllowedPatterns, IgnoredMethods.
 Metrics/MethodLength:
   Max: 19
 
-# Offense count: 3
+# Offense count: 4
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
   Max: 9
 
-# Offense count: 3
+# Offense count: 2
 # Configuration parameters: AllowedMethods, AllowedPatterns, IgnoredMethods.
 Metrics/PerceivedComplexity:
   Max: 15
 
 # Offense count: 1
-Style/MultilineBlockChain:
-  Exclude:
-    - 'lib/js_dependency/mermaid/root.rb'
-
-# Offense count: 8
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, IgnoredPatterns.
 # URISchemes: http, https

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## [Unreleased]
 
+## [0.3.14] - 2022-08-14
+
+- Add export_markdown_report cli. This will export the markdown report to a file for GitHub comment.
+
+## [0.3.13] - 2022-08-14
+
+- Add rspec test.
+
+## [0.3.12] - 2022-08-14
+
+- Add rspec test.
+- Fix script tag contents extraction if script tag has `src` like `<script src="">` .
+
 ## [0.3.11] - 2022-08-13
 
 - Add target_paths options in configuration file to use array.

data/Gemfile

@@ -10,6 +10,7 @@ gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
 
 gem "codecov", require: false, group: "test"
+gem "debug", ">= 1.0.0"
 gem "rubocop", "~> 1.21"
 gem "simplecov", require: false, group: :test
 gem "yarn"

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    js_dependency (0.3.11)
+    js_dependency (0.3.14)
       pathname
       thor
       yaml
@@ -14,8 +14,14 @@ GEM
     codecov (0.6.0)
       simplecov (>= 0.15, < 0.22)
     coderay (1.1.3)
+    debug (1.6.2)
+      irb (>= 1.3.6)
+      reline (>= 0.3.1)
     diff-lcs (1.5.0)
     docile (1.4.0)
+    io-console (0.5.11)
+    irb (1.4.1)
+      reline (>= 0.3.0)
     json (2.6.2)
     parallel (1.22.1)
     parser (3.1.2.1)
@@ -30,6 +36,8 @@ GEM
     rainbow (3.1.1)
     rake (13.0.6)
     regexp_parser (2.5.0)
+    reline (0.3.1)
+      io-console (~> 0.5)
     rexml (3.2.5)
     rspec (3.11.0)
       rspec-core (~> 3.11.0)
@@ -50,14 +58,14 @@ GEM
       rspec (>= 2.13, < 4)
       unparser
     rspec-support (3.11.0)
-    rubocop (1.34.1)
+    rubocop (1.35.0)
       json (~> 2.3)
       parallel (~> 1.10)
       parser (>= 3.1.2.1)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.20.0, < 2.0)
+      rubocop-ast (>= 1.20.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 3.0)
     rubocop-ast (1.21.0)
@@ -94,6 +102,7 @@ PLATFORMS
 
 DEPENDENCIES
   codecov
+  debug (>= 1.0.0)
   js_dependency!
   rake (~> 13.0)
   rspec (~> 3.0)

data/README.md

@@ -88,6 +88,70 @@ js_dependency -s ./src -t ./src/App.vue ./src/components/Sub.vue -o ./mermaid.tx
 js_dependency -s ./src -t ./src/App.vue -o ./mermaid.txt -c 2 -p 2 -n 1 -e excludeWord1 excludeWord2 -a @:./pages
 ```
 
+#### Export Markdown report
+
+```shell
+js_dependency export_markdown_report -s ./src -t ./src/App.vue -c 2 -p 2 -n 1 -a @:./pages --identifier your_uniq_identifier_for_upsert_report
+```
+
+Like this:
+
+```
+## JsDependency Reports
+
+### Orphan modules
+
+3 orphaned modules.
+
+* ``components/sub/Exclude.vue``
+* ``pages/app.js``
+* ``utils/calculation.js``
+
+### Module dependency
+
+\```mermaid
+flowchart LR
+components_Button["components/Button"] --> components_sub_Title.vue["sub/Title.vue"]
+components_Button["components/Button"] --> fixtures_index_creator_self_call_src_components_sub_Exclude["sub/Exclude"]
+components_New.vue["components/New.vue"] --> components_Button["components/Button"]
+components_New.vue["components/New.vue"] --> components_modal.js["components/modal.js"]
+pages_app.js["pages/app.js"] --> components_New.vue["components/New.vue"]
+utils_calculation.js["utils/calculation.js"] --> external_lib["external/lib"]
+style components_New.vue stroke:#f9f,stroke-width:4px
+style utils_calculation.js stroke:#f9f,stroke-width:4px
+\```
+
+<!-- identifier -->
+
+```
+
+## JsDependency Reports
+
+### Orphan modules
+
+3 orphaned modules.
+
+* ``components/sub/Exclude.vue``
+* ``pages/app.js``
+* ``utils/calculation.js``
+
+### Module dependency
+
+```mermaid
+flowchart LR
+components_Button["components/Button"] --> components_sub_Title.vue["sub/Title.vue"]
+components_Button["components/Button"] --> fixtures_index_creator_self_call_src_components_sub_Exclude["sub/Exclude"]
+components_New.vue["components/New.vue"] --> components_Button["components/Button"]
+components_New.vue["components/New.vue"] --> components_modal.js["components/modal.js"]
+pages_app.js["pages/app.js"] --> components_New.vue["components/New.vue"]
+utils_calculation.js["utils/calculation.js"] --> external_lib["external/lib"]
+style components_New.vue stroke:#f9f,stroke-width:4px
+style utils_calculation.js stroke:#f9f,stroke-width:4px
+```
+
+<!-- identifier -->
+
+
 #### Export parents components list
 
 ```shell

data/lib/js_dependency/cli.rb

@@ -109,5 +109,32 @@ module JsDependency
     def version
       puts JsDependency::VERSION
     end
+
+    desc "export_markdown_report", "Output markdown formatted report."
+    method_option :src_path, type: :string, aliases: "-s", desc: "Root folder."
+    method_option :target_paths, type: :array, aliases: "-t", desc: "Target file that you want to analyze."
+    method_option :output_path, type: :string, aliases: "-o", desc: "Output file path"
+    method_option :child_analyze_level, type: :numeric, aliases: "-c", desc: "Output level of child dependency"
+    method_option :parent_analyze_level, type: :numeric, aliases: "-p", desc: "Output level of parent dependency"
+    method_option :name_level, type: :numeric, aliases: "-n", desc: "Output name level"
+    method_option :excludes, type: :array, aliases: "-e", desc: "Exclude the word that is included in the path"
+    method_option :alias_paths, type: :hash, aliases: "-a", desc: "Alias paths by hash format."
+    method_option :file_config, type: :string, aliases: "-f", desc: "Configuration file path."
+    method_option :identifier, type: :string, desc: "Embed id in markdown."
+
+    def export_markdown_report
+      args = JsDependency::CliUtils::Yaml.new(path: options[:file_config]).args
+      config = JsDependency::CliUtils::Config.new(options, args)
+      puts JsDependency.export_markdown_report(
+        config.src_path,
+        config.target_paths,
+        child_analyze_level: config.child_analyze_level,
+        parent_analyze_level: config.parent_analyze_level,
+        alias_paths: config.alias_paths,
+        name_level: config.name_level,
+        excludes: config.excludes,
+        identifier: config.identifier
+      )
+    end
   end
 end

data/lib/js_dependency/cli_utils/config.rb

@@ -4,7 +4,7 @@ module JsDependency
   module CliUtils
     class Config
       attr_reader :src_path, :target_paths, :target_path, :child_analyze_level, :parent_analyze_level, :output_path,
-                  :alias_paths, :name_level, :excludes
+                  :alias_paths, :name_level, :excludes, :identifier
 
       # @param [Hash] options
       # @param [Hash] args
@@ -20,6 +20,7 @@ module JsDependency
         @alias_paths = options[:alias_paths] || args[:alias_paths] || {}
         @name_level = options[:name_level] || args[:name_level] || 1
         @excludes = calc_excludes(options[:excludes], args[:excludes])
+        @identifier = options[:identifier] || nil
       end
 
       private

data/lib/js_dependency/extractor/extract_script_tag.rb

@@ -15,6 +15,10 @@ module JsDependency
           list << Regexp.last_match(1)
         end
 
+        scripts += str.gsub(%r{<script.+src=".+">(.+)</script>}m).with_object([]) do |_, list|
+          list << Regexp.last_match(1)
+        end
+
         scripts.uniq.sort.join("\n")
       end
 

data/lib/js_dependency/mermaid/nodes_link.rb

@@ -26,10 +26,32 @@ module JsDependency
         mermaid_str(@child, level)
       end
 
+      # @param [String] src_path
+      # @return [JsDependency::Mermaid::NodesLink]
+      def relative_path_from(src_path)
+        NodesLink.new(
+          relative_parent_path(src_path),
+          relative_child_path(src_path)
+        )
+      end
+
       private
 
+      # @param [String] src_path
+      # @return [String]
+      def relative_parent_path(src_path)
+        parent.exist? ? parent.realpath.relative_path_from(Pathname.new(src_path).realpath.to_s).to_s : parent.to_s
+      end
+
+      # @param [String] src_path
+      # @return [String]
+      def relative_child_path(src_path)
+        child.exist? ? child.realpath.relative_path_from(Pathname.new(src_path).realpath.to_s).to_s : child.to_s
+      end
+
       # @param [Pathname] pathname
       # @param [Integer] level
+      # @return [String]
       def mermaid_str(pathname, level = 0)
         "#{parse(pathname).join("_")}[\"#{parse(pathname, level).join("/")}\"]"
       end

data/lib/js_dependency/mermaid/root.rb

@@ -5,6 +5,7 @@ module JsDependency
   module Mermaid
     class Root
       attr_accessor :orientation
+      attr_reader :list
 
       # @param [String] orientation
       def initialize(orientation = "LR")
@@ -35,18 +36,14 @@ module JsDependency
       # @return [Array<String>]
       def export_nodes(name_level: 1, src_path: nil)
         nodes_links = if src_path
-                        src_pathname = Pathname.new(src_path).realpath
-                        @list.map do |nodes_link|
-                          NodesLink.new(nodes_link.parent.exist? ? nodes_link.parent.relative_path_from(src_pathname.to_s) : nodes_link.parent.to_s,
-                                        nodes_link.child.exist? ? nodes_link.child.relative_path_from(src_pathname.to_s) : nodes_link.child.to_s)
-                        end
+                        @list.map { |nodes_link| nodes_link.relative_path_from(src_path) }
                       else
                         @list
                       end
-        nodes_links.uniq do |link|
-          "#{link.parent}__#{link.child}"
-        end.sort_by { |link| "#{link.parent}__#{link.child}" }.map do |link|
-          "#{link.parent_module_name(name_level)} --> #{link.child_module_name(name_level)}"
+        nodes_links = nodes_links.uniq { |nodes_link| "#{nodes_link.parent}__#{nodes_link.child}" }
+        nodes_links = nodes_links.sort_by { |nodes_link| "#{nodes_link.parent}__#{nodes_link.child}" }
+        nodes_links.map do |nodes_link|
+          "#{nodes_link.parent_module_name(name_level)} --> #{nodes_link.child_module_name(name_level)}"
         end
       end
     end

data/lib/js_dependency/report/markdown.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module JsDependency
+  module Report
+    class Markdown
+      attr_reader :orphan_list, :mermaid_markdown, :identifier
+
+      # @param [Array] orphan_list
+      # @param [String] mermaid_markdown
+      # @param [nil, String] identifier
+      def initialize(orphan_list, mermaid_markdown, identifier: nil)
+        @orphan_list = orphan_list || []
+        @mermaid_markdown = mermaid_markdown || ""
+        @identifier = identifier || "js_dependency_report_identifier"
+      end
+
+      # @return [String]
+      def export
+        markdown = <<~"MAKRDOWNTEXT"
+          ## JsDependency Reports
+
+          ### Orphan modules
+
+        MAKRDOWNTEXT
+
+        if @orphan_list.empty?
+          markdown += "No orphaned module !\n\n"
+        else
+          markdown += "#{@orphan_list.size} orphaned modules.\n\n"
+          markdown += "#{@orphan_list.map { |str| "* ``#{str}``" }.join("\n")}\n\n"
+        end
+
+        markdown += <<~"MAKRDOWNTEXT"
+          ### Module dependency
+
+          ```mermaid
+        MAKRDOWNTEXT
+        markdown += @mermaid_markdown.to_s
+
+        markdown += <<~"MAKRDOWNTEXT"
+          ```
+
+        MAKRDOWNTEXT
+
+        markdown += "<!-- #{@identifier} -->"
+        markdown
+      end
+    end
+  end
+end

data/lib/js_dependency/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JsDependency
-  VERSION = "0.3.11"
+  VERSION = "0.3.14"
 end

data/lib/js_dependency.rb

@@ -9,6 +9,7 @@ require_relative "js_dependency/mermaid/target_pathname"
 require_relative "js_dependency/source_analysis/leave"
 require_relative "js_dependency/source_analysis/orphan"
 require_relative "js_dependency/pathname_utility"
+require_relative "js_dependency/report/markdown"
 require_relative "js_dependency/cli_utils/yaml"
 require_relative "js_dependency/cli_utils/config"
 require "pathname"
@@ -71,7 +72,7 @@ module JsDependency
       nodes += mermaid_root.export_nodes(name_level: name_level, src_path: src_path)
     end
 
-    output = (["flowchart LR"] + nodes.uniq + styles.uniq).join("\n")
+    output = "#{(["flowchart LR"] + nodes.uniq + styles.uniq).join("\n")}\n"
     output_pathname&.write(output)
     output
   end
@@ -123,4 +124,33 @@ module JsDependency
     output_pathname&.write(output.sort.join("\n"))
     output
   end
+
+  # @param [String] src_path
+  # @param [Array<String>] target_paths
+  # @param [String] orientation
+  # @param [Hash, nil] alias_paths
+  # @param [Integer] child_analyze_level
+  # @param [Integer] parent_analyze_level
+  # @param [Integer] name_level
+  # @param [String, nil] output_path
+  # @param [Array, nil] excludes
+  # @param [String, nil] identifier
+  # @return [String]
+  def self.export_markdown_report(src_path, target_paths, orientation: "LR", alias_paths: nil, child_analyze_level: 1,
+                                  parent_analyze_level: 1, name_level: 1, excludes: nil, identifier: nil)
+    mermaid_markdown = JsDependency.export_mermaid(
+      src_path,
+      target_paths,
+      orientation: orientation,
+      alias_paths: alias_paths,
+      child_analyze_level: child_analyze_level,
+      parent_analyze_level: parent_analyze_level,
+      name_level: name_level,
+      excludes: excludes
+    )
+
+    orphan_list = JsDependency.orphan(src_path, alias_paths: alias_paths)
+
+    JsDependency::Report::Markdown.new(orphan_list, mermaid_markdown, identifier: identifier).export
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: js_dependency
 version: !ruby/object:Gem::Version
-  version: 0.3.11
+  version: 0.3.14
 platform: ruby
 authors:
 - junara
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-08-13 00:00:00.000000000 Z
+date: 2022-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pathname
@@ -170,6 +170,7 @@ files:
 - lib/js_dependency/mermaid/target_pathname.rb
 - lib/js_dependency/pathname_utility.rb
 - lib/js_dependency/replace_path_alias.rb
+- lib/js_dependency/report/markdown.rb
 - lib/js_dependency/source_analysis/leave.rb
 - lib/js_dependency/source_analysis/orphan.rb
 - lib/js_dependency/target_pathname.rb