dry-files 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b415a307ce621ab6601397d6cf2a772ef390210e1591b99f5ab40ccedac6108
-  data.tar.gz: c63b4c80401dccba0c095fa5a26d1b25c4e50d00f71978037e22b481a384c7db
+  metadata.gz: 73391c6f7e4e115941911686c45307707e68fa4ba0f4be5a7cebba14d7eeb042
+  data.tar.gz: dcd71ad5b06891df556f0146f2520e4b981024afa06291016e56b194a4f1fb2e
 SHA512:
-  metadata.gz: c4b93220b78ec92f7224d9d033d5055b0be5f5f34fc9e187227e3d5c8198f9b9f1e02316295525d04a47709dc3614c40d30e9d43d68f6bbaaaf69f27f442f47c
-  data.tar.gz: 7cf2972a9be4e35dfc2babaa8bfd3ad8f0ee5646c69b397eb6a334baba97c906d17e7a28177229814eacb99b84839062bdda0a2f5972778f8f498f911ede3d61
+  metadata.gz: 392bfc69636d993cd92e8462079079ad000ef6ebe60467eee72d30f9e2726fc04705f05ada482cfe0147320abab56afd91b6b782b25e9f3a042c563590d589fd
+  data.tar.gz: 7c3a4723b89339db36f532f7579f6574c593864e6a79cecfc5cc382280d421338fdd2700c1edffb6fb83b5d917102a2c5be63306f2833c555d5250f0a8d9c1da

data/CHANGELOG.md

@@ -1,11 +1,22 @@
 <!--- 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)
+- 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)

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.2"
+    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
     #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dry-files
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Luca Guidi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-03 00:00:00.000000000 Z
+date: 2023-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec