immosquare-yaml 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2841e06b484ab63541fde122db5b67873fed11ace07d10423eae10ac4eb32b0
-  data.tar.gz: ca15c7313768d2c70597370cf4121becd73d4afd32b70735d80572c66daabbbb
+  metadata.gz: 4ad1b77c2a0aa94cccc901f2095b51481bcb225a9930c863aab7ea5fa49ced69
+  data.tar.gz: c9cd9777e43963c3d2ff939b60fb1caf76dde884d7d28dee9357f1b9aad646c5
 SHA512:
-  metadata.gz: 89eafa27859e41e9a61ae861b746157dc010af7a29ecaffa8a42f0fc612d30c4637eea21aadad5293abafe670b5c5b317b861902fb7c2e8cbb858d40074fe5a8
-  data.tar.gz: 48b27854d7f28c95f98a4f5bdbe04674a08407699c4ae27f5623571ec1a98fb8751e70fba844bf1dfe3f423bd9fae16a30b497233cc0536f8ef965e3a91f40e9
+  metadata.gz: 79952197dbc28d89be6770eff07d3870332050acfd8e7c5897816a006d969d917f9500bc31540457ab43676324c7280a8dae9434033279c4c820bdccde714b87
+  data.tar.gz: db4d002fcd3086e86fde1b9d718f23223f6476d895a6973b49373798468ec5a1a39083e91f58ab33b410cfe9b39b7655b5dff48541145ece19d4e8edc9f73e18

data/lib/immosquare-yaml/delete.rb

@@ -0,0 +1,101 @@
+module ImmosquareYaml
+  ##============================================================##
+  ## Delete — removes one or more dot-paths from an i18n YAML
+  ## file and re-emits it through the standard dump pipeline
+  ## (sort, quoting, literal blocks). Empty parent Hashes left
+  ## behind by a deletion are pruned recursively so the YAML
+  ## doesn't keep dangling empty maps.
+  ##
+  ## Path quoting follows the same convention as flatten_keys /
+  ## parse_path : reserved (yes/no/true/...) and purely numeric
+  ## segments must be wrapped in "..." inside the dot-path.
+  ##============================================================##
+  class << self
+
+    ##============================================================##
+    ## delete_paths(file_path, paths, sort: true, output: file_path)
+    ##
+    ## paths : a single dot-path String or an Array<String>.
+    ##
+    ## Returns a Hash :
+    ##   { :deleted   => [paths actually removed],
+    ##     :not_found => [paths that did not exist in the file] }
+    ##
+    ## Returns false if the file cannot be parsed or if its root
+    ## node is not a Hash (i18n YAML files are always mappings).
+    ##
+    ## Note : the file is always rewritten through `dump`, even when
+    ## every path is reported as :not_found. This means calling
+    ## `delete_paths` doubles as a `clean` (sort + reformat) on the
+    ## target file. Use `:output => "..."` to write elsewhere.
+    ##============================================================##
+    def delete_paths(file_path, paths, **options)
+      options = {
+        :sort   => true,
+        :output => file_path
+      }.merge(options)
+
+      begin
+        raise("File not found") if !File.exist?(file_path)
+
+        parsed = parse(file_path, :sort => options[:sort])
+        return false if parsed == false || !parsed.is_a?(Hash)
+
+        paths     = Array(paths)
+        deleted   = []
+        not_found = []
+
+        ##============================================================##
+        ## Walk each dot-path, delete the leaf if present, prune
+        ## empty parents on the way back up.
+        ##============================================================##
+        paths.each do |dot_path|
+          segments = parse_path(dot_path)
+          if !segments.empty? && delete_at_segments(parsed, segments)
+            deleted << dot_path
+          else
+            not_found << dot_path
+          end
+        end
+
+        output = dump(parsed)
+        FileUtils.mkdir_p(File.dirname(options[:output]))
+        File.write(options[:output], output)
+
+        {:deleted => deleted, :not_found => not_found}
+      rescue StandardError => e
+        puts(e.message)
+        puts(e.backtrace)
+        false
+      end
+    end
+
+
+    private
+
+
+    ##============================================================##
+    ## Recursive segment walker. Returns true if a leaf was
+    ## actually removed. On the way back up, an intermediate Hash
+    ## that has become empty is pruned from its parent so the
+    ## final YAML doesn't keep dangling empty maps.
+    ##============================================================##
+    def delete_at_segments(hash, segments)
+      return false if !hash.is_a?(Hash)
+
+      head, *rest = segments
+      return false if !hash.key?(head)
+
+      if rest.empty?
+        hash.delete(head)
+        return true
+      end
+
+      child   = hash[head]
+      removed = delete_at_segments(child, rest)
+      hash.delete(head) if removed && child.is_a?(Hash) && child.empty?
+      removed
+    end
+
+  end
+end

data/lib/immosquare-yaml/version.rb

@@ -1,3 +1,3 @@
 module ImmosquareYaml
-  VERSION = "1.0.2".freeze
+  VERSION = "1.0.3".freeze
 end

data/lib/immosquare-yaml.rb

@@ -3,6 +3,7 @@ require          "fileutils"
 require          "immosquare-extensions"
 require_relative "immosquare-yaml/shared_methods"
 require_relative "immosquare-yaml/flatten"
+require_relative "immosquare-yaml/delete"
 
 ##============================================================##
 ## ImmosquareYaml — post-processeur Psych dédié aux fichiers

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: immosquare-yaml
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
 - immosquare
@@ -39,6 +39,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/immosquare-yaml.rb
+- lib/immosquare-yaml/delete.rb
 - lib/immosquare-yaml/flatten.rb
 - lib/immosquare-yaml/shared_methods.rb
 - lib/immosquare-yaml/version.rb