dry-files 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aeceff289982d160ec9a1687677a09ce2d204b4ee1c1f724361ebca4afbf2a5e
-  data.tar.gz: b667c59ffa7e9b74f0a4fb2a63f1b8a8e1e4018f2ee150c310fd0e9fb1f82612
+  metadata.gz: 73391c6f7e4e115941911686c45307707e68fa4ba0f4be5a7cebba14d7eeb042
+  data.tar.gz: dcd71ad5b06891df556f0146f2520e4b981024afa06291016e56b194a4f1fb2e
 SHA512:
-  metadata.gz: 4faeaa5354a10101957a33a1434ec943c872d06c5dc4ccffceec78cb905c70e322ce579537ec612de5f0796db4d6e85ddeabbb92269c9e17eed4cf8e1ced336a
-  data.tar.gz: 510106844dbb56009e77c8c1570c8d83e55257d7f22cbbd5d4d351eae9ebe1dec76d4736049e84bc647467d222313922acf745b6ee1443284e632afdd263d2bd
+  metadata.gz: 392bfc69636d993cd92e8462079079ad000ef6ebe60467eee72d30f9e2726fc04705f05ada482cfe0147320abab56afd91b6b782b25e9f3a042c563590d589fd
+  data.tar.gz: 7c3a4723b89339db36f532f7579f6574c593864e6a79cecfc5cc382280d421338fdd2700c1edffb6fb83b5d917102a2c5be63306f2833c555d5250f0a8d9c1da

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 <!--- DO NOT EDIT THIS FILE - IT'S AUTOMATICALLY GENERATED VIA DEVTOOLS --->
 
+## 1.1.0 2023-10-18
+
+
+### Added
+
+- Add `Dry::Files#chmod(path, mode)` to modify file permissions. Provide the mode as an integer
+to match UNIX octal permissions, such as `0o755`. (@timriley in #18)
+
+
+[Compare v1.0.2...v1.1.0](https://github.com/dry-rb/dry-files/compare/v1.0.2...v1.1.0)
+
+## 1.0.2 2023-10-03
+
+
+### Fixed
+
+- Ensure `Dry::Files#inject_line_at_block_bottom` to not match false positive closing blocks (@jodosha in #17)
+
+
+[Compare v1.0.1...v1.0.2](https://github.com/dry-rb/dry-files/compare/v1.0.1...v1.0.2)
+
 ## 1.0.1 2022-11-21
 
 

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2022 dry-rb team
+Copyright (c) 2015-2023 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/README.md

@@ -1,29 +1,21 @@
 <!--- this file is synced from dry-rb/template-gem project -->
 [gem]: https://rubygems.org/gems/dry-files
 [actions]: https://github.com/dry-rb/dry-files/actions
-[codacy]: https://www.codacy.com/gh/dry-rb/dry-files
-[chat]: https://dry-rb.zulipchat.com
-[inchpages]: http://inch-ci.org/github/dry-rb/dry-files
 
-# dry-files [![Join the chat at https://dry-rb.zulipchat.com](https://img.shields.io/badge/dry--rb-join%20chat-%23346b7a.svg)][chat]
-
-[![Gem Version](https://badge.fury.io/rb/dry-files.svg)][gem]
-[![CI Status](https://github.com/dry-rb/dry-files/workflows/ci/badge.svg)][actions]
-[![Codacy Badge](https://api.codacy.com/project/badge/Grade/71200ee8d70b412c9e21c20b8b3b3688)][codacy]
-[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/71200ee8d70b412c9e21c20b8b3b3688)][codacy]
-[![Inline docs](http://inch-ci.org/github/dry-rb/dry-files.svg?branch=main)][inchpages]
+# dry-files [![Gem Version](https://badge.fury.io/rb/dry-files.svg)][gem] [![CI Status](https://github.com/dry-rb/dry-files/workflows/ci/badge.svg)][actions]
 
 ## Links
 
 * [User documentation](https://dry-rb.org/gems/dry-files)
 * [API documentation](http://rubydoc.info/gems/dry-files)
+* [Forum](https://discourse.dry-rb.org)
 
 ## Supported Ruby versions
 
 This library officially supports the following Ruby versions:
 
-* MRI `>= 2.7.0`
-* jruby `>= 9.3` (postponed until 2.7 is supported)
+* MRI `>= 3.0.0`
+* jruby `>= 9.4` (not tested on CI)
 
 ## License
 

data/lib/dry/files/file_system.rb

@@ -131,6 +131,25 @@ module Dry
         end
       end
 
+      # Sets UNIX permissions of the file at the given path.
+      #
+      # Accepts permissions in numeric mode only, best provided as octal numbers matching the
+      # standard UNIX octal permission modes, such as `0o544` for a file writeable by its owner and
+      # readable by others, or `0o755` for a file writeable by its owner and executable by everyone.
+      #
+      # @param path [String,Pathname] the path to the file
+      # @param mode [Integer] the UNIX permissions mode
+      #
+      # @raise [Dry::Files::IOError] in case of I/O error
+      #
+      # @since 1.1.0
+      # @api private
+      def chmod(path, mode)
+        with_error_handling do
+          file_utils.chmod(mode, path)
+        end
+      end
+
       # Returns a new string formed by joining the strings using Operating
       # System path separator
       #

data/lib/dry/files/version.rb

@@ -2,6 +2,6 @@
 
 module Dry
   class Files
-    VERSION = "1.0.1"
+    VERSION = "1.1.0"
   end
 end

data/lib/dry/files.rb

@@ -82,6 +82,25 @@ module Dry
       adapter.write(path, *content)
     end
 
+    # Sets UNIX permissions of the file at the given path.
+    #
+    # Accepts permissions in numeric mode only, best provided as octal numbers matching the
+    # standard UNIX octal permission modes, such as `0o544` for a file writeable by its owner and
+    # readable by others, or `0o755` for a file writeable by its owner and executable by everyone.
+    #
+    # @param path [String,Pathname] the path to the file
+    # @param mode [Integer] the UNIX permissions mode
+    #
+    # @raise [Dry::Files::IOError] in case of I/O error
+    #
+    # @since 1.1.0
+    # @api public
+    def chmod(path, mode)
+      raise Dry::Files::Error, "mode should be an integer (e.g. 0o755)" unless mode.is_a?(Integer)
+
+      adapter.chmod(path, mode)
+    end
+
     # Returns a new string formed by joining the strings using Operating
     # System path separator
     #
@@ -841,6 +860,11 @@ module Dry
     # @since 0.3.0
     # @api private
     class Delimiter
+      # @since 1.0.2
+      # @api private
+      SPACE_MATCHER_GENERAL = /[[:space:]]*/
+      private_constant :SPACE_MATCHER_GENERAL
+
       # @since 0.3.0
       # @api private
       attr_reader :opening, :closing
@@ -853,6 +877,26 @@ module Dry
         @closing = closing
         freeze
       end
+
+      # @since 1.0.2
+      # @api private
+      def opening_matcher
+        matcher(opening)
+      end
+
+      # @since 1.0.2
+      # @api private
+      def closing_matcher
+        matcher(closing)
+      end
+
+      private
+
+      # @since 1.0.2
+      # @api private
+      def matcher(delimiter)
+        /#{SPACE_MATCHER_GENERAL}\b#{delimiter}\b(?:#{SPACE_MATCHER_GENERAL}|#{NEW_LINE_MATCHER})/
+      end
     end
 
     # @since 0.1.0
@@ -862,12 +906,12 @@ module Dry
 
     # @since 0.3.0
     # @api private
-    NEW_LINE_MATCHER = /#{NEW_LINE}\z/.freeze
+    NEW_LINE_MATCHER = /#{NEW_LINE}\z/
     private_constant :NEW_LINE_MATCHER
 
     # @since 0.3.0
     # @api private
-    EMPTY_LINE = /\A\z/.freeze
+    EMPTY_LINE = /\A\z/
     private_constant :EMPTY_LINE
 
     # @since 0.1.0
@@ -887,7 +931,7 @@ module Dry
 
     # @since 0.1.0
     # @api private
-    SPACE_MATCHER = /\A[[:space:]]*/.freeze
+    SPACE_MATCHER = /\A[[:space:]]*/
     private_constant :SPACE_MATCHER
 
     # @since 0.3.0
@@ -967,9 +1011,9 @@ module Dry
     # @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
+      blocks_count = content.count { |line| line.match?(delimiter.opening_matcher) } + count_offset
       matching_line = content.find do |line|
-        blocks_count -= 1 if line.match?(delimiter.closing)
+        blocks_count -= 1 if line.match?(delimiter.closing_matcher)
         line if blocks_count.zero?
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dry-files
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Luca Guidi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-11-21 00:00:00.000000000 Z
+date: 2023-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -67,7 +67,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.3.26
 signing_key: 
 specification_version: 4
 summary: file utilities