staticky-files 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff9719d82a9de8cde1777bad0d9c2bbcfc9b2aafd747cbdef4e550041a1b2ce9
-  data.tar.gz: 78d26cfd1220fd7ce8abde206d60f2f38d152ac35b9b45246f5a3026c302cb54
+  metadata.gz: ad0e4764cd0d5ab60c632d49209c6cd374948538c973224a900011142349bf3c
+  data.tar.gz: f86bc8ded9348bf8e140e5d8c5a547201dd53d4cddb805f6edc36a6ad362ae33
 SHA512:
-  metadata.gz: 7b60b8cf0c46b51fd200edeb6bf6441422318d6a7f4b9ddf2183758c5341ce03b9ac00596aaa2adb99026c928ebcdcd0593ccd990ab32fdbc95de12b787a001c
-  data.tar.gz: e7d118cf6aa846809deab019a02f538284e52ea77d5c99db88f4bab2063bceae676ba7cb76db86e363ed8ad61658b0be2aef42535b8d62686b83938b66031e88
+  metadata.gz: 3e16a18e11d0432dfdad9ffbcd74a0e89d2e25bb2c62f2d2ad30977d95088809e786ee54df2b8d2c2f7930ff24e60b59f8542b06fc489995208a9cc1d387582a
+  data.tar.gz: bdde8d06c9bcf7338ac7afc19f195ed302289523314f798ba06679c19717ac29947e1bbc0b5c8b19e26718a74dd3b57e6ed832f4512412e49b93320c543d4eed

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## 0.2.0 - 2025-10-09
+
+- Adds `#glob` for more directory file access
+- Implements permissions for `#write`, `#readlines`, `#mkdir`, `#mkdir_p` for
+  `MemoryFileSystem`
+
 ## [0.1.0] - 2024-08-14
 
 - Initial release

data/README.md

@@ -3,6 +3,7 @@
 This is a hard fork of `dry-files` that adds extensions for:
 
 - `entries` to walk entries in a directory
+- `glob` to search for a glob pattern
 
 ## Installation
 

data/lib/staticky/files/file_system.rb

@@ -312,6 +312,16 @@ module Staticky
         end
       end
 
+      # Returns an array of file paths that match the given pattern.
+      #
+      # @param pattern [String] the glob pattern to match
+      # @return [Array<String>] the matching file paths
+      def glob(pattern)
+        with_error_handling do
+          Dir.glob(pattern)
+        end
+      end
+
       private
 
       # Catch `SystemCallError` and re-raise a `Staticky::Files::IOError`.

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

@@ -20,15 +20,23 @@ module Staticky
         MODE_OTHERS_EXECUTE = 0b000000001
 
         # Default directory mode: 0755
-        DEFAULT_DIRECTORY_MODE = MODE_USER_READ | MODE_USER_WRITE | MODE_USER_EXECUTE |
-          MODE_GROUP_READ | MODE_GROUP_EXECUTE |
-          MODE_OTHERS_READ | MODE_GROUP_EXECUTE
+        DEFAULT_DIRECTORY_MODE = MODE_USER_READ |
+          MODE_USER_WRITE |
+          MODE_USER_EXECUTE |
+          MODE_GROUP_READ |
+          MODE_GROUP_EXECUTE |
+          MODE_OTHERS_READ |
+          MODE_GROUP_EXECUTE
 
         # Default file mode: 0644
-        DEFAULT_FILE_MODE = MODE_USER_READ | MODE_USER_WRITE | MODE_GROUP_READ | MODE_OTHERS_READ
+        DEFAULT_FILE_MODE = MODE_USER_READ |
+          MODE_USER_WRITE |
+          MODE_GROUP_READ |
+          MODE_OTHERS_READ
 
         MODE_BASE = 16
         ROOT_PATH = "/"
+        EMPTY_CONTENT = ""
 
         # Instantiate a root node
         #
@@ -132,12 +140,12 @@ module Staticky
         # @raise [Staticky::Files::NotMemoryFileError] if node isn't a file
         def write(content)
           content = case content
-                    when String
-                      content
-                    when Array
-                      array_to_string(content)
-                    when NilClass
-                      EMPTY_CONTENT
+          when String
+            content
+          when Array
+            array_to_string(content)
+          when NilClass
+            EMPTY_CONTENT
           end
 
           @content = StringIO.new(content)
@@ -155,8 +163,12 @@ module Staticky
         # Check if node is executable for user
         #
         # @return [TrueClass,FalseClass] the result of the check
+        def readable?
+          mode.anybits?(MODE_USER_READ)
+        end
+
         def executable?
-          (mode & MODE_USER_EXECUTE).positive?
+          mode.anybits?(MODE_USER_EXECUTE)
         end
 
         def array_to_string(content)

data/lib/staticky/files/memory_file_system.rb

@@ -59,13 +59,14 @@ module Staticky
       # @return [Array<String>] the file contents
       #
       # @raise [Staticky::Files::IOError] in case the target path is a directory
-      # or if the file cannot be found
+      # or if the file cannot be found, or if the file is not readable
       def readlines(path)
         path = Path[path]
         node = find(path)
 
         raise IOError, Errno::ENOENT.new(path.to_s) if node.nil?
         raise IOError, Errno::EISDIR.new(path.to_s) if node.directory?
+        raise IOError, Errno::EACCES.new(path.to_s) unless node.readable?
 
         node.readlines
       end
@@ -91,12 +92,17 @@ module Staticky
       #
       # @param path [String, Array<String>] the target path
       # @param content [String, Array<String>] the content to write
+      #
+      # @raise [Staticky::Files::IOError] in case the target path is a directory
       def write(path, *content)
         path = Path[path]
+        raise IOError, Errno::EISDIR.new(path.to_s) if directory?(path)
+
         node = @root
 
         for_each_segment(path) do |segment|
           node = node.set(segment)
+          raise IOError, Errno::EACCES.new(path.to_s) unless node.readable?
         end
 
         node.write(*content)
@@ -164,7 +170,7 @@ module Staticky
       # @param path [String,Array<String>] the directory to create
       #
       # @raise [Staticky::Files::IOError] in case path is an already existing
-      # file
+      # file, or the file system cannot be accessed
       def mkdir(path)
         path = Path[path]
         node = @root
@@ -172,6 +178,7 @@ module Staticky
         for_each_segment(path) do |segment|
           node = node.set(segment)
           raise IOError, Errno::EEXIST.new(path.to_s) if node.file?
+          raise IOError, Errno::EACCES.new(path.to_s) unless node.readable?
         end
       end
 
@@ -337,11 +344,31 @@ module Staticky
         [".", ".."] + Array(node.children&.keys)
       end
 
+      # Returns an array of file paths that match the given pattern.
+      #
+      # @param pattern [Pathname, String] the glob pattern to match
+      # @return [Array<String>] the matching file paths
+      def glob(pattern)
+        matches = []
+        traverse(@root, "/", pattern.to_s, matches)
+        matches
+      end
+
       private
 
-      def for_each_segment(path, &blk)
+      def traverse(node, current_path, pattern, matches)
+        if node.file? && File.fnmatch(pattern, current_path, File::FNM_PATHNAME)
+          matches << current_path
+        elsif node.directory?
+          node.children.each do |name, child|
+            traverse(child, File.join(current_path, name), pattern, matches)
+          end
+        end
+      end
+
+      def for_each_segment(path, &)
         segments = Path.split(path)
-        segments.each(&blk)
+        segments.each(&)
       end
 
       def find_directory(path)

data/lib/staticky/files/version.rb

@@ -2,6 +2,6 @@
 
 module Staticky
   class Files
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/staticky/files.rb

@@ -58,9 +58,10 @@ module Staticky
 
     # 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.
+    # 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
@@ -69,7 +70,7 @@ module Staticky
     def chmod(path, mode)
       unless mode.is_a?(Integer)
         raise Staticky::Files::Error,
-              "mode should be an integer (e.g. 0o755)"
+          "mode should be an integer (e.g. 0o755)"
       end
 
       adapter.chmod(path, mode)
@@ -128,8 +129,8 @@ module Staticky
     # @param blk [Proc] the code to execute with the target directory
     #
     # @raise [Staticky::Files::IOError] in case of I/O error
-    def chdir(path, &blk)
-      adapter.chdir(path, &blk)
+    def chdir(path, &)
+      adapter.chdir(path, &)
     end
 
     # Creates a directory for the given path.
@@ -837,12 +838,22 @@ module Staticky
     #
     # @raise [Staticky::Files::IOError] in case of I/O error
     #
-    # @since 1.0.1
+    # @since 0.1.0
     # @api public
     def entries(path)
       adapter.entries(path)
     end
 
+    # Reads files matching the given glob pattern
+    #
+    # @param pattern [String,Pathname] the glob pattern
+    #
+    # @since 0.1.0
+    # @api public
+    def glob(pattern)
+      adapter.glob(pattern)
+    end
+
     private
 
     class Delimiter
@@ -925,9 +936,9 @@ module Staticky
       delimiter,
       count_offset = 0
     )
-      blocks_count = content.count { |line|
+      blocks_count = content.count do |line|
         line.match?(delimiter.opening_matcher)
-      } + count_offset
+      end + count_offset
       matching_line = content.find do |line|
         blocks_count -= 1 if line.match?(delimiter.closing_matcher)
         line if blocks_count.zero?

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: staticky-files
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Nolan J Tait
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Better file management with adapters for testing and production
 email:
@@ -40,7 +39,6 @@ metadata:
   source_code_uri: https://github.com/nolantait/staticky-files
   changelog_uri: https://github.com/nolantait/staticky-files
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -55,8 +53,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Better file management with adapters for testing and production
 test_files: []