dry-files 0.2.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b04750013e1faf98db463c2c346a5f43ed63f3dca9053a881082b02ac4c6e2a
-  data.tar.gz: 1c3162ad5c735483ac4fbac02b588e111e55f92698682807dad68bf12503906a
+  metadata.gz: b9b554d01289fcefe3eb4159a0d832a55544de168d9df3d68db65d017526debd
+  data.tar.gz: cfe09c1716f6046421111bd848a81c9a0785b195f4a612c348c2054cdf6aa805
 SHA512:
-  metadata.gz: e8a0a61aba226cc8f1f7dc01fb06a8c21e8c2405c131cae4e45689e551996fe2d72deae4b99b0e9e677aad294bdef1eca53183a75386344a89c136afd243784d
-  data.tar.gz: d363a392c4427fe3b6b84349f5addcb839e7881bdcab9dcd7e6d32124632883ca490187d8e654b84ef0162a675cc25d2b928e9448504ef94132ad5076dc77110
+  metadata.gz: 2e6142b107d2deafc6bb1b98412fee75be75e05934e940fd8227abd8079cff9b4078d064a5e8ae90339b95a9852a189bab199d3ec5f4de5e6001e13b22be7cde
+  data.tar.gz: 53abdcbd822a4dbc78dac59308454fe46738e21448d3faeca7eae8e80d6a0725b06f7d614c4e736bba0107719c45229765a16ea84b529aad3a4445d882859500

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 <!--- DO NOT EDIT THIS FILE - IT'S AUTOMATICALLY GENERATED VIA DEVTOOLS --->
 
+## 1.0.0 2022-11-04
+
+
+### Changed
+
+- Bumped version to 1.0.0 (@solnic)
+
+[Compare v0.3.0...v1.0.0](https://github.com/dry-rb/dry-files/compare/v0.3.0...v1.0.0)
+
+## 0.3.0 2022-09-19
+
+
+### Added
+
+- Support for `inject_line_at_class_bottom` (via #13) (@jodosha)
+
+
+[Compare v0.2.0...v0.3.0](https://github.com/dry-rb/dry-files/compare/v0.2.0...v0.3.0)
+
 ## 0.2.0 2022-07-10
 
 

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2021 dry-rb team
+Copyright (c) 2015-2022 dry-rb team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

data/dry-files.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
-  spec.metadata["changelog_uri"]     = "https://github.com/dry-rb/dry-files/blob/master/CHANGELOG.md"
+  spec.metadata["changelog_uri"]     = "https://github.com/dry-rb/dry-files/blob/main/CHANGELOG.md"
   spec.metadata["source_code_uri"]   = "https://github.com/dry-rb/dry-files"
   spec.metadata["bug_tracker_uri"]   = "https://github.com/dry-rb/dry-files/issues"
 
@@ -30,7 +30,5 @@ Gem::Specification.new do |spec|
 
   # to update dependencies edit project.yml
 
-  spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.10"
-  spec.add_development_dependency "rubocop", "~> 1.12"
 end

data/lib/dry/files/file_system.rb

@@ -46,7 +46,7 @@ module Dry
       # @raise [Dry::Files::IOError] in case of I/O error
       #
       # @since 0.1.0
-      def open(path, mode = OPEN_MODE, *args, &blk)
+      def open(path, mode, *args, &blk)
         touch(path)
 
         with_error_handling do
@@ -345,16 +345,6 @@ module Dry
 
       private
 
-      # @since 0.1.0
-      # @api private
-      OPEN_MODE = ::File::RDWR
-      private_constant :OPEN_MODE
-
-      # @since 0.1.0
-      # @api private
-      WRITE_MODE = (::File::CREAT | ::File::WRONLY | ::File::TRUNC).freeze
-      private_constant :WRITE_MODE
-
       # Catch `SystemCallError` and re-raise a `Dry::Files::IOError`.
       #
       # `SystemCallError` is parent for all the `Errno::*` Ruby exceptions.

data/lib/dry/files/memory_file_system/node.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require "English"
 require "stringio"
 
 module Dry
@@ -215,8 +214,17 @@ module Dry
         #
         # @since 0.1.0
         # @api private
-        def write(*content)
-          @content = StringIO.new(content.join($RS))
+        def write(content)
+          content = case content
+                    when String
+                      content
+                    when Array
+                      array_to_string(content)
+                    when NilClass
+                      EMPTY_CONTENT
+                    end
+
+          @content = StringIO.new(content)
           @mode = DEFAULT_FILE_MODE
         end
 
@@ -240,6 +248,14 @@ module Dry
         def executable?
           (mode & MODE_USER_EXECUTE).positive?
         end
+
+        # @since 0.3.0
+        # @api private
+        def array_to_string(content)
+          content.map do |line|
+            line.sub(NEW_LINE_MATCHER, EMPTY_CONTENT)
+          end.join(NEW_LINE) + NEW_LINE
+        end
       end
     end
   end

data/lib/dry/files/memory_file_system.rb

@@ -11,7 +11,7 @@ module Dry
     class MemoryFileSystem
       # @since 0.1.0
       # @api private
-      EMPTY_CONTENT = nil
+      EMPTY_CONTENT = ""
       private_constant :EMPTY_CONTENT
 
       require_relative "./memory_file_system/node"
@@ -33,12 +33,18 @@ module Dry
       #
       # @param path [String] the target file
       # @yieldparam [Dry::Files::MemoryFileSystem::Node]
+      # @return [Dry::Files::MemoryFileSystem::Node]
       #
       # @since 0.1.0
       # @api private
-      def open(path, *, &blk)
+      def open(path, *)
         file = touch(path)
-        blk.call(file)
+
+        if block_given?
+          yield file
+        else
+          file
+        end
       end
 
       # Read file contents

data/lib/dry/files/version.rb

@@ -2,6 +2,6 @@
 
 module Dry
   class Files
-    VERSION = "0.2.0"
+    VERSION = "1.0.0"
   end
 end

data/lib/dry/files.rb

@@ -14,6 +14,14 @@ module Dry
     require_relative "files/error"
     require_relative "files/adapter"
 
+    # @since 0.3.0
+    # @api public
+    OPEN_MODE = ::File::RDWR
+
+    # @since 0.3.0
+    # @api public
+    WRITE_MODE = (::File::CREAT | ::File::WRONLY | ::File::TRUNC).freeze
+
     # Creates a new instance
     #
     # Memory file system is experimental
@@ -111,6 +119,22 @@ module Dry
       adapter.pwd
     end
 
+    # Opens (or creates) a new file for both read/write operations
+    #
+    # @param path [String] the target file
+    # @param mode [String,Integer] Ruby file open mode
+    # @param args [Array<Object>] ::File.open args
+    # @param blk [Proc] the block to yield
+    #
+    # @yieldparam [File,Dry::Files::MemoryFileSystem::Node] the opened file
+    #
+    # @return [File,Dry::Files::MemoryFileSystem::Node] the opened file
+    #
+    # @raise [Dry::Files::IOError] in case of I/O error
+    def open(path, mode = OPEN_MODE, *args, &blk)
+      adapter.open(path, mode, *args, &blk)
+    end
+
     # Temporary changes the current working directory of the process to the
     # given path and yield the given block.
     #
@@ -657,14 +681,92 @@ module Dry
     #   #   end
     #   # end
     def inject_line_at_block_bottom(path, target, *contents)
-      content  = adapter.readlines(path)
-      starting = index(content, path, target)
-      line     = content[starting]
-      size     = line[SPACE_MATCHER].bytesize
-      closing  = (SPACE * size) +
-                 (target.match?(INLINE_OPEN_BLOCK_MATCHER) ? INLINE_CLOSE_BLOCK : CLOSE_BLOCK)
-      ending   = starting + index(content[starting..-CONTENT_OFFSET], path, closing)
-      offset   = SPACE * (content[ending][SPACE_MATCHER].bytesize + INDENTATION)
+      content   = adapter.readlines(path)
+      starting  = index(content, path, target)
+      line      = content[starting]
+      delimiter = if line.match?(INLINE_OPEN_BLOCK_MATCHER)
+                    INLINE_BLOCK_DELIMITER
+                  else
+                    BLOCK_DELIMITER
+                  end
+      target    = content[starting..]
+      ending    = closing_block_index(target, starting, path, line, delimiter)
+      offset    = SPACE * (content[ending][SPACE_MATCHER].bytesize + INDENTATION)
+
+      contents = Array(contents).flatten
+      contents = _offset_block_lines(contents, offset)
+
+      content.insert(ending, contents)
+      write(path, content)
+    end
+
+    # Inject `contents` in `path` at the bottom of the Ruby class that matches `target`.
+    # The given `contents` will appear at the BOTTOM of the Ruby class.
+    #
+    # @param path [String,Pathname] the path to file
+    # @param target [String,Regexp] the target matcher for Ruby class
+    # @param contents [String,Array<String>] the contents to inject
+    #
+    # @raise [Dry::Files::IOError] in case of I/O error
+    # @raise [Dry::Files::MissingTargetError] if `target` cannot be found in `path`
+    #
+    # @since 0.4.0
+    # @api public
+    #
+    # @example Inject a single line
+    #   require "dry/files"
+    #
+    #   files = Dry::Files.new
+    #   path = "config/application.rb"
+    #
+    #   File.read(path)
+    #   # # frozen_string_literal: true
+    #   #
+    #   # class Application
+    #   # end
+    #
+    #   # inject a single line
+    #   files.inject_line_at_class_bottom(path, /Application/, %(attr_accessor :name))
+    #
+    #   File.read(path)
+    #   # # frozen_string_literal: true
+    #   #
+    #   # class Application
+    #   #   attr_accessor :name
+    #   # end
+    #
+    # @example Inject multiple lines
+    #   require "dry/files"
+    #
+    #   files = Dry::Files.new
+    #   path = "math.rb"
+    #
+    #   File.read(path)
+    #   # # frozen_string_literal: true
+    #   #
+    #   # class Math
+    #   # end
+    #
+    #   # inject multiple lines
+    #   files.inject_line_at_class_bottom(path,
+    #                                     /Math/,
+    #                                     ["def sum(a, b)", "  a + b", "end"])
+    #
+    #   File.read(path)
+    #   # # frozen_string_literal: true
+    #   #
+    #   # class Math
+    #   #   def sum(a, b)
+    #   #     a + b
+    #   #   end
+    #   # end
+    def inject_line_at_class_bottom(path, target, *contents)
+      content   = adapter.readlines(path)
+      starting  = index(content, path, target)
+      line      = content[starting]
+      target    = content[starting..]
+      ending    = closing_class_index(target, starting, path, line, BLOCK_DELIMITER)
+      offset    = SPACE * (content[ending][SPACE_MATCHER].bytesize + INDENTATION)
 
       contents = Array(contents).flatten
       contents = _offset_block_lines(contents, offset)
@@ -736,11 +838,38 @@ module Dry
 
     private
 
+    # @since 0.3.0
+    # @api private
+    class Delimiter
+      # @since 0.3.0
+      # @api private
+      attr_reader :opening, :closing
+
+      # @since 0.3.0
+      # @api private
+      def initialize(name, opening, closing)
+        @name = name
+        @opening = opening
+        @closing = closing
+        freeze
+      end
+    end
+
     # @since 0.1.0
     # @api private
     NEW_LINE = $/ # rubocop:disable Style/SpecialGlobalVars
     private_constant :NEW_LINE
 
+    # @since 0.3.0
+    # @api private
+    NEW_LINE_MATCHER = /#{NEW_LINE}\z/.freeze
+    private_constant :NEW_LINE_MATCHER
+
+    # @since 0.3.0
+    # @api private
+    EMPTY_LINE = /\A\z/.freeze
+    private_constant :EMPTY_LINE
+
     # @since 0.1.0
     # @api private
     CONTENT_OFFSET = 1
@@ -761,21 +890,42 @@ module Dry
     SPACE_MATCHER = /\A[[:space:]]*/.freeze
     private_constant :SPACE_MATCHER
 
-    # @since 0.1.0
+    # @since 0.3.0
     # @api private
-    INLINE_OPEN_BLOCK_MATCHER = "{"
-    private_constant :INLINE_OPEN_BLOCK_MATCHER
+    INLINE_OPEN_BLOCK = "{"
+    private_constant :INLINE_OPEN_BLOCK
 
     # @since 0.1.0
     # @api private
     INLINE_CLOSE_BLOCK = "}"
     private_constant :INLINE_CLOSE_BLOCK
 
+    # @since 0.3.0
+    # @api private
+    OPEN_BLOCK = "do"
+    private_constant :OPEN_BLOCK
+
     # @since 0.1.0
     # @api private
     CLOSE_BLOCK = "end"
     private_constant :CLOSE_BLOCK
 
+    # @since 0.1.0
+    # @api private
+    INLINE_OPEN_BLOCK_MATCHER = INLINE_CLOSE_BLOCK
+    private_constant :INLINE_OPEN_BLOCK_MATCHER
+
+    # @since 0.3.0
+    # @api private
+    INLINE_BLOCK_DELIMITER = Delimiter.new("InlineBlockDelimiter",
+                                           INLINE_OPEN_BLOCK, INLINE_CLOSE_BLOCK)
+    private_constant :INLINE_BLOCK_DELIMITER
+
+    # @since 0.3.0
+    # @api private
+    BLOCK_DELIMITER = Delimiter.new("BlockDelimiter", OPEN_BLOCK, CLOSE_BLOCK)
+    private_constant :BLOCK_DELIMITER
+
     # @since 0.1.0
     # @api private
     attr_reader :adapter
@@ -812,6 +962,25 @@ module Dry
         raise MissingTargetError.new(target, path)
     end
 
+    # @since 0.3.0
+    # @api private
+    def closing_block_index(content, starting, path, target, delimiter, count_offset = 0) # rubocop:disable Metrics/ParameterLists
+      blocks_count = content.count { |line| line.match?(delimiter.opening) } + count_offset
+      matching_line = content.find do |line|
+        blocks_count -= 1 if line.match?(delimiter.closing)
+        line if blocks_count.zero?
+      end
+
+      (content.index(matching_line) or
+        raise MissingTargetError.new(target, path)) + starting
+    end
+
+    # @since 0.4.0
+    # @api private
+    def closing_class_index(content, starting, path, target, delimiter)
+      closing_block_index(content, starting, path, target, delimiter, 1)
+    end
+
     # @since 0.1.0
     # @api private
     def _inject_line_before(path, target, contents, finder)
@@ -839,6 +1008,8 @@ module Dry
         if line.match?(NEW_LINE)
           line = line.split(NEW_LINE)
           _offset_block_lines(line, offset)
+        elsif line.match?(EMPTY_LINE)
+          line + NEW_LINE
         else
           offset + line + NEW_LINE
         end

metadata

@@ -1,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: dry-files
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Luca Guidi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-10 00:00:00.000000000 Z
+date: 2022-11-04 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -38,20 +24,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.10'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.12'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.12'
 description: file utilities
 email:
 - me@lucaguidi.com
@@ -77,7 +49,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  changelog_uri: https://github.com/dry-rb/dry-files/blob/master/CHANGELOG.md
+  changelog_uri: https://github.com/dry-rb/dry-files/blob/main/CHANGELOG.md
   source_code_uri: https://github.com/dry-rb/dry-files
   bug_tracker_uri: https://github.com/dry-rb/dry-files/issues
 post_install_message: