js_dependency 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20217229c2c7f845d05b400f356240d4e2db4d46f9b4d1fc6662868bc1bac372
-  data.tar.gz: d74ccf10be4764621ff17bc2700c56b8947263b5dc35bccaab49101df90eea59
+  metadata.gz: 1c3c24ad458ab62df198ebb779c5a9142a7bff0aee92bb95a9bc88061192045c
+  data.tar.gz: e9d6e041aee4a8df90c3ebc850474f2c8f6ad808ac07368fdfc8bec009a7b463
 SHA512:
-  metadata.gz: a842902a4bf0331ea00352315682bf4efb8ac6891dfa2fcfedff0d5ecdfada5d8cf1240ebc6e02a5f8b8ac8a6df54d85c47e4140ac581601d43dbb7a16f3fb2d
-  data.tar.gz: 919130f6a767b0dc51533cacee935c810da0a8460ab74e86536704fea8614289fa45025c8b3d9edd62a48782bc463e632256b3c9868f849bcb93cf006859c035
+  metadata.gz: 2fdda6bc1addc027df2fcfdb802bd5fa2c413422e80bf7c89d99532cc0bdff1fd47fed2c17fdfb675662b5ea8fc545235e0764a804db67d1e8a49ebf66f76c19
+  data.tar.gz: 38923fd2655a8c60b2e844df0075256eb1e8bbb7d92bd07cc9330551846fbd730f3a7e1f75ac2a8a93f680c6beff8eafcec10f2b407f9a69c4df78ab160aad2d

data/.js_dependency.yml.sample

@@ -0,0 +1,8 @@
+src_path: ./src
+target_path: ./src/App.vue
+child_analyze_level: 2
+parent_analyze_level: 2
+name_level: 1
+output_path: ./mermaid.txt
+alias_paths:
+  "@": ./src

data/.rubocop_todo.yml

@@ -1,26 +1,41 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2022-07-18 12:42:10 UTC using RuboCop version 1.31.2.
+# on 2022-07-19 16:03:39 UTC using RuboCop version 1.31.2.
 # 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: 6
 # Configuration parameters: IgnoredMethods, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 20
+  Max: 30
 
 # Offense count: 3
+# Configuration parameters: IgnoredMethods.
+Metrics/CyclomaticComplexity:
+  Max: 13
+
+# Offense count: 8
 # Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
 Metrics/MethodLength:
-  Max: 17
+  Max: 20
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ModuleLength:
+  Max: 112
 
 # Offense count: 1
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
   Max: 8
 
+# Offense count: 3
+# Configuration parameters: IgnoredMethods.
+Metrics/PerceivedComplexity:
+  Max: 13
+
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 Style/IfUnlessModifier:

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.0] - 2022-07-19
+
+- Add CLI interface.
+
 ## [0.1.1] - 2022-07-19
 
 - Bug fix of double quotation mark.

data/Gemfile.lock

@@ -1,8 +1,10 @@
 PATH
   remote: .
   specs:
-    js_dependency (0.1.1)
+    js_dependency (0.2.0)
       pathname
+      thor
+      yaml
 
 GEM
   remote: https://rubygems.org/
@@ -74,11 +76,13 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.12.3)
     simplecov_json_formatter (0.1.4)
+    thor (1.2.1)
     trollop (2.9.10)
     unicode-display_width (2.2.0)
     unparser (0.6.5)
       diff-lcs (~> 1.3)
       parser (>= 3.1.0)
+    yaml (0.2.0)
     yarn (0.1.1)
       parslet (>= 1.2)
       rack (>= 1.3)

data/README.md

@@ -1,3 +1,5 @@
+[![codecov](https://codecov.io/gh/junara/js_dependency/branch/main/graph/badge.svg?token=GRdbS1xqUa)](https://codecov.io/gh/junara/js_dependency)
+
 # JsDependency
 
 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/js_dependency`. To experiment with that code, run `bin/console` for an interactive prompt.
@@ -15,6 +17,41 @@ If bundler is not being used to manage dependencies, install the gem by executin
     $ gem install js_dependency
 
 ## Usage
+### By Command Line
+
+Configuration file is `./.js_dependency.yml`. This file includes parameters for the analysis.
+
+```yaml
+src_path: ./src # Root folder
+target_path: ./src/App.vue # Target file tha you want to analyze
+child_analyze_level: 2 # Output level of child analyze
+parent_analyze_level: 2 # Output level of parent analyze
+name_level: 1 # Output name level
+output_path: ./mermaid.txt # Output file path
+alias_paths: # Alias path
+  "@": ./src
+```
+
+#### Export Mermaid Format
+
+```shell
+js_dependency -s ./src -t ./src/App.vue -o ./mermaid.txt -c 2 -p 2 -n 1
+```
+
+#### Export parents components list
+
+```shell
+js_dependency parents -s ./src -t ./src/App.vue -o ./parents.txt -p 2
+```
+
+#### Export children components list
+
+```shell
+js_dependency childrent -s ./src -t ./src/App.vue -o ./children.txt -c 2
+```
+
+
+### By ruby code
 If your javascript code is in `./src` and `./src/App.vue` is in the directory, you can analyze `./src/App.vue` dependency like this:
 
 ```ruby

data/exe/js_dependency

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "js_dependency"
+
+JsDependency::Cli.start(ARGV)

data/js_dependency.gemspec

@@ -31,7 +31,8 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "pathname"
-
+  spec.add_dependency "thor"
+  spec.add_dependency "yaml"
   spec.add_development_dependency "rspec"
   spec.add_development_dependency "rspec-parameterized"
   spec.add_development_dependency "rubocop"

data/lib/js_dependency/cli.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require "thor"
+require "yaml"
+
+module JsDependency
+  class Cli < Thor
+    default_command :export_mermaid
+
+    desc "export_mermaid", "Output mermaid flowchart string."
+    option :src_path, type: :string, aliases: "-s", desc: "Root folder."
+    option :target_path, type: :string, aliases: "-t", desc: "Target file that you want to analyze."
+    option :output_path, type: :string, aliases: "-o", desc: "Output file path"
+    option :child_analyze_level, type: :numeric, aliases: "-c", desc: "Output level of child dependency"
+    option :parent_analyze_level, type: :numeric, aliases: "-p", desc: "Output level of parent dependency"
+    option :name_level, type: :numeric, aliases: "-n", desc: "Output name level"
+    def export_mermaid
+      pathname = Pathname.new(".js_dependency.yml")
+      args = {}
+      args = YAML.safe_load(pathname.read) if pathname.exist?
+
+      src_path = options[:src_path] || args["src_path"]
+      target_path = options[:target_path] || args["target_path"]
+      child_analyze_level = options[:child_analyze_level] || args["child_analyze_level"] || 2
+      parent_analyze_level = options[:parent_analyze_level] || args["parent_analyze_level"] || 2
+      output_path = options[:output_path] || args["output_path"] || nil
+      alias_paths = args["alias_paths"] || nil
+      name_level = options[:name_level] || args["name_level"] || 1
+
+      str = JsDependency.export_mermaid(
+        src_path,
+        target_path,
+        child_analyze_level: child_analyze_level,
+        parent_analyze_level: parent_analyze_level,
+        output_path: output_path,
+        alias_paths: alias_paths,
+        name_level: name_level
+      )
+
+      puts str
+    end
+
+    desc "parents", "export parents list"
+    option :src_path, type: :string, aliases: "-s", desc: "Root folder."
+    option :target_path, type: :string, aliases: "-t", desc: "Target file that you want to analyze."
+    option :output_path, type: :string, aliases: "-o", desc: "Output file path"
+    option :parent_analyze_level, type: :numeric, aliases: "-p", desc: "Output level of parent dependency"
+    def parents
+      pathname = Pathname.new(".js_dependency.yml")
+      args = {}
+      args = YAML.safe_load(pathname.read) if pathname.exist?
+
+      src_path = options[:src_path] || args["src_path"]
+      target_path = options[:target_path] || args["target_path"]
+      parent_analyze_level = options[:parent_analyze_level] || args["parent_analyze_level"] || 1
+      output_path = options[:output_path] || args["output_path"] || nil
+      alias_paths = args["alias_paths"] || nil
+
+      str = JsDependency.parents(
+        src_path,
+        target_path,
+        parent_analyze_level: parent_analyze_level,
+        output_path: output_path,
+        alias_paths: alias_paths
+      ).sort.uniq.join("\n")
+
+      puts str
+    end
+
+    desc "children", "export children list"
+    option :src_path, type: :string, aliases: "-s", desc: "Root folder."
+    option :target_path, type: :string, aliases: "-t", desc: "Target file that you want to analyze."
+    option :output_path, type: :string, aliases: "-o", desc: "Output file path"
+    option :child_analyze_level, type: :numeric, aliases: "-c", desc: "Output level of child dependency"
+    def children
+      pathname = Pathname.new(".js_dependency.yml")
+      args = {}
+      args = YAML.safe_load(pathname.read) if pathname.exist?
+
+      src_path = options[:src_path] || args["src_path"]
+      target_path = options[:target_path] || args["target_path"]
+      child_analyze_level = options[:child_analyze_level] || args["child_analyze_level"] || 1
+      output_path = options[:output_path] || args["output_path"] || nil
+      alias_paths = args["alias_paths"] || nil
+
+      str = JsDependency.children(
+        src_path,
+        target_path,
+        child_analyze_level: child_analyze_level,
+        output_path: output_path,
+        alias_paths: alias_paths
+      ).sort.uniq.join("\n")
+
+      puts str
+    end
+  end
+end

data/lib/js_dependency/version.rb

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

data/lib/js_dependency.rb

@@ -3,6 +3,7 @@
 require_relative "js_dependency/version"
 require_relative "js_dependency/index_creator"
 require_relative "js_dependency/mermaid/root"
+require_relative "js_dependency/cli"
 require "pathname"
 
 module JsDependency
@@ -42,6 +43,42 @@ module JsDependency
     output
   end
 
+  def self.parents(src_path, target_path, alias_paths: nil, parent_analyze_level: 1, output_path: nil)
+    output_pathname = Pathname.new(output_path) if output_path
+    index = JsDependency::IndexCreator.call(src_path, alias_paths: alias_paths)
+
+    target_pathname = if Pathname.new(target_path).relative? && Pathname.new(target_path).exist?
+                        Pathname.new(target_path).realpath
+                      else
+                        Pathname.new(target_path)
+                      end
+    list = []
+    parents_paths(target_pathname, parent_analyze_level, index) do |parent_path, _child_path|
+      list << parent_path
+    end
+    output = list.uniq
+    output_pathname&.write(output)
+    output
+  end
+
+  def self.children(src_path, target_path, alias_paths: nil, child_analyze_level: 1, output_path: nil)
+    output_pathname = Pathname.new(output_path) if output_path
+    index = JsDependency::IndexCreator.call(src_path, alias_paths: alias_paths)
+
+    target_pathname = if Pathname.new(target_path).relative? && Pathname.new(target_path).exist?
+                        Pathname.new(target_path).realpath
+                      else
+                        Pathname.new(target_path)
+                      end
+    list = []
+    children_paths(target_pathname, child_analyze_level, index) do |_parent_path, child_path|
+      list << child_path
+    end
+    output = list.uniq
+    output_pathname&.write(output)
+    output
+  end
+
   # @param [String] target_path
   # @param [Hash] index
   # @return [Array]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: js_dependency
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - junara
@@ -24,6 +24,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yaml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -111,10 +139,12 @@ dependencies:
 description: Analyze dependency using import for JavaScript.
 email:
 - jun5araki@gmail.com
-executables: []
+executables:
+- js_dependency
 extensions: []
 extra_rdoc_files: []
 files:
+- ".js_dependency.yml.sample"
 - ".rspec"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
@@ -125,8 +155,10 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- exe/js_dependency
 - js_dependency.gemspec
 - lib/js_dependency.rb
+- lib/js_dependency/cli.rb
 - lib/js_dependency/extract_import_path.rb
 - lib/js_dependency/extract_script_tag.rb
 - lib/js_dependency/index_creator.rb