dry-files 0.1.0

data/lib/dry/files/path.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module Dry
+  class Files
+    # Cross Operating System path
+    #
+    # It's used by the memory adapter to ensure that hardcoded string paths
+    # are transformed into portable paths that respect the Operating System
+    # directory separator.
+    module Path
+      # @since 0.1.0
+      # @api private
+      SEPARATOR = ::File::SEPARATOR
+
+      # @since 0.1.0
+      # @api private
+      EMPTY_TOKEN = ""
+      private_constant :EMPTY_TOKEN
+
+      class << self
+        # Transform the given path into a path that respect the Operating System
+        # directory separator.
+        #
+        # @param path [String,Pathname,Array<String,Pathname>] the path to transform
+        #
+        # @return [String] the resulting path
+        #
+        # @since 0.1.0
+        # @api private
+        #
+        # @example Portable Path
+        #   require "dry/files/path"
+        #
+        #   path = "path/to/file"
+        #
+        #   Dry::Files::Path.call(path)
+        #     # => "path/to/file" on UNIX based Operating System
+        #
+        #   Dry::Files::Path.call(path)
+        #     # => "path\to\file" on Windows Operating System
+        #
+        # @example Join Nested Tokens
+        #   require "dry/files/path"
+        #
+        #   path = ["path", ["to", ["nested", "file"]]]
+        #
+        #   Dry::Files::Path.call(path)
+        #     # => "path/to/nested/file" on UNIX based Operating System
+        #
+        #   Dry::Files::Path.call(path)
+        #     # => "path\to\nested\file" on Windows Operating System
+        #
+        # @example Separator path
+        #   require "dry/files/path"
+        #
+        #   path = ::File::SEPARATOR
+        #
+        #   Dry::Files::Path.call(path)
+        #     # => ""
+        def call(*path)
+          path = Array(path).flatten
+          tokens = path.map do |token|
+            split(token)
+          end
+
+          tokens
+            .flatten
+            .join(SEPARATOR)
+        end
+        alias_method :[], :call
+      end
+
+      # Split path according to the current Operating System directory separator
+      #
+      # @param path [String,Pathname] the path to split
+      #
+      # @return [Array<String>] the split path
+      #
+      # @since 0.1.0
+      # @api private
+      def self.split(path)
+        return EMPTY_TOKEN if path == SEPARATOR
+
+        path.to_s.split(%r{\\|/})
+      end
+
+      # Check if given path is absolute
+      #
+      # @param path [String,Pathname] the path to check
+      #
+      # @return [TrueClass,FalseClass] the result of the check
+      #
+      # @since 0.1.0
+      # @api private
+      def self.absolute?(path)
+        path.start_with?(SEPARATOR)
+      end
+
+      # Returns all the path, except for the last token
+      #
+      # @param path [String,Pathname] the path to extract directory name from
+      #
+      # @return [String] the directory name
+      #
+      # @since 0.1.0
+      # @api private
+      def self.dirname(path)
+        ::File.dirname(path)
+      end
+    end
+  end
+end

data/lib/dry/files/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Dry
+  class Files
+    VERSION = "0.1.0"
+  end
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: dry-files
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Luca Guidi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-05-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
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !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
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- dry-files.gemspec
+- lib/dry-files.rb
+- lib/dry/files.rb
+- lib/dry/files/adapter.rb
+- lib/dry/files/error.rb
+- lib/dry/files/file_system.rb
+- lib/dry/files/memory_file_system.rb
+- lib/dry/files/memory_file_system/node.rb
+- lib/dry/files/path.rb
+- lib/dry/files/version.rb
+homepage: https://dry-rb.org/gems/dry-files
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  changelog_uri: https://github.com/dry-rb/dry-files/blob/master/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: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key: 
+specification_version: 4
+summary: file utilities
+test_files: []