node_mutation 1.8.2 → 1.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be47289a83fa7295154056c8c6adc404f4f190d580a47dc78660dcfd082917d1
-  data.tar.gz: 15f40478c899eb9b4e8fd809edc4ebec139f8d85a98bd7573103fee2b62ebde6
+  metadata.gz: c83e3715de9de4bc244ddbcf4486f78c51bdff021735f291d797d7e2728d3369
+  data.tar.gz: 6dae070e5a2ad3977a53c08f312ee240d3a9164b353e257d61bdaff0c492c542
 SHA512:
-  metadata.gz: 25e98cb3610598d9a30de2f880c071a04020c4507c8700826aa047f48179b340ad0e8e258f2301738717c5a7dd809ed9b78d75f0f1b3f9b3f243371c3d132fa5
-  data.tar.gz: 0e615252351fa511f0e1be269c74fdd77bf1477ec97745bb5cfb747a9657356cdedde24357001fcfd4b879cb47b5daf603e7e3af0c82716156de1e531c68f2a3
+  metadata.gz: b10359865b08bbb672dcdcb567f27a1de4018e12f61615cb16fb4d9406af37be3443ccafafcd2d9347a0fab48f739fffa70e170eff13ad443272542a2148cfc8
+  data.tar.gz: 605c42f06b1b2f5d54c8714394f3874446e88f27016bcf361d2a067f36dad285db9056984fc1216d70c02237eb3e052799e16e9c065cf4e3fda14823734f0e6d

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # NodeMutation
 
+## 1.9.1 (2023-02-10)
+
+* Make sure `tab_width` is an Integer
+
+## 1.9.0 (2023-02-08)
+
+* Configure `tab_width`
+* Make use of `NodeMutation.tab_width`
+
 ## 1.8.2 (2023-01-17)
 
 * Drop `activesupport`

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    node_mutation (1.8.2)
+    node_mutation (1.9.1)
       erubis
 
 GEM

data/README.md

@@ -63,14 +63,34 @@ result.conflicted
 result.new_source
 ```
 
-## Write Adapter
+## Configuration
+
+### adapter
 
 Different parsers, like parse and ripper, will generate different AST nodes, to make NodeMutation work for them all,
 we define an [Adapter](https://github.com/xinminlabs/node-mutation-ruby/blob/main/lib/node_mutation/adapter.rb) interface,
 if you implement the Adapter interface, you can set it as NodeMutation's adapter.
 
-```typescript
-NodeMutation.configure({ adapter: ParserAdapter.new })
+```ruby
+NodeMutation.configure(adapter: ParserAdapter.new) // default is ParserAdapter
+```
+
+### strategy
+
+It provides 3 strategies to handle conflicts when processing actions:
+
+1. `Strategy.KEEP_RUNNING`: keep running and ignore the conflict action.
+2. `Strategy.THROW_ERROR`: throw error when conflict action is found.
+3. `Strategy.ALLOW_INSERT_AT_SAME_POSITION`: allow insert action at the same position.
+
+```ruby
+NodeMutation.configure(strategy: Strategy.KEEP_RUNNING | Strategy.ALLOW_INSERT_AT_SAME_POSITION); // default is Strategy.THROW_ERROR
+```
+
+### tab_width
+
+```ruby
+NodeMutation.configure(tab_width: 4); // default is 2
 ```
 
 ## Development

data/lib/node_mutation/action/append_action.rb

@@ -17,6 +17,6 @@ class NodeMutation::AppendAction < NodeMutation::Action
   # @param node [Parser::AST::Node]
   # @return [String] n times whitesphace
   def indent(node)
-    ' ' *  (NodeMutation.adapter.get_start_loc(node).column + DEFAULT_INDENT)
+    ' ' *  (NodeMutation.adapter.get_start_loc(node).column + NodeMutation.tab_width)
   end
 end

data/lib/node_mutation/action/prepend_action.rb

@@ -20,6 +20,6 @@ class NodeMutation::PrependAction < NodeMutation::Action
   # @param node [Parser::AST::Node]
   # @return [String] n times whitesphace
   def indent(node)
-    ' ' * (NodeMutation.adapter.get_start_loc(node).column + DEFAULT_INDENT)
+    ' ' * (NodeMutation.adapter.get_start_loc(node).column + NodeMutation.tab_width)
   end
 end

data/lib/node_mutation/action.rb

@@ -2,8 +2,6 @@
 
 # Action defines rewriter action, insert, replace or delete code.
 class NodeMutation::Action
-  DEFAULT_INDENT = 2
-
   # @!attribute [r] start
   #   @return [Integer] start position
   # @!attribute [r] end

data/lib/node_mutation/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class NodeMutation
-  VERSION = "1.8.2"
+  VERSION = "1.9.1"
 end

data/lib/node_mutation.rb

@@ -25,29 +25,42 @@ class NodeMutation
 
   attr_reader :actions
 
-  # Configure NodeMutation
-  # @param [Hash] options options to configure
-  # @option options [NodeMutation::Adapter] :adapter the adpater
-  def self.configure(options)
-    if options[:adapter]
-      @adapter = options[:adapter]
+  class <<self
+    # Configure NodeMutation
+    # @param [Hash] options options to configure
+    # @option options [NodeMutation::Adapter] :adapter the adpater
+    # @option options [NodeMutation::Strategy] :strategy the strategy
+    # @option options [Integer] :tab_width the tab width
+    def configure(options)
+      if options[:adapter]
+        @adapter = options[:adapter]
+      end
+      if options[:strategy]
+        @strategy = options[:strategy]
+      end
+      if options[:tab_width]
+        @tab_width = options[:tab_width].to_i
+      end
     end
-    if options[:strategy]
-      @strategy = options[:strategy]
+
+    # Get the adapter
+    # @return [NodeMutation::Adapter] current adapter, by default is {NodeMutation::ParserAdapter}
+    def adapter
+      @adapter ||= ParserAdapter.new
     end
-  end
 
-  # Get the adapter
-  # @return [NodeMutation::Adapter] current adapter, by default is {NodeMutation::ParserAdapter}
-  def self.adapter
-    @adapter ||= ParserAdapter.new
-  end
+    # Get the strategy
+    # @return [Integer] current strategy, could be {NodeMutation::Strategy::KEEP_RUNNING} or {NodeMutation::Strategy::THROW_ERROR},
+    # by default is {NodeMutation::Strategy::KEEP_RUNNING}
+    def strategy
+      @strategy ||= Strategy::KEEP_RUNNING
+    end
 
-  # Get the strategy
-  # @return [Integer] current strategy, could be {NodeMutation::Strategy::KEEP_RUNNING} or {NodeMutation::Strategy::THROW_ERROR},
-  # by default is {NodeMutation::Strategy::KEEP_RUNNING}
-  def self.strategy
-    @strategy ||= Strategy::KEEP_RUNNING
+    # Get tab width
+    # @return [Integer] tab width, by default is 2
+    def tab_width
+      @tab_width ||= 2
+    end
   end
 
   # Initialize a NodeMutation.

data/sig/node_mutation.rbs

@@ -13,12 +13,14 @@ module NodeMutation[T]
 
   attr_reader actions: Array[NodeMutation::Action]
 
-  def self.configure: (options: { adapter: NodeMutation::Adapter, strategy: Integer }) -> void
+  def self.configure: (options: { adapter: NodeMutation::Adapter, strategy: Integer, tab_width: Integer }) -> void
 
   def self.adapter: () -> NodeMutation::Adapter
 
   def self.strategy: () -> Integer
 
+  def self.tab_width: () -> Integer
+
   def initialize: (source: String) -> NodeMutation
 
   def append: (node: T, code: String) -> void

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: node_mutation
 version: !ruby/object:Gem::Version
-  version: 1.8.2
+  version: 1.9.1
 platform: ruby
 authors:
 - Richard Huang
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-01-17 00:00:00.000000000 Z
+date: 2023-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: erubis
@@ -82,7 +82,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
+rubygems_version: 3.4.6
 signing_key:
 specification_version: 4
 summary: ast node mutation apis