pathspec 0.1.2 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f259b8f0d32109d62b9bbc1a0f6a96c34f607cf9
-  data.tar.gz: 551a347443c3e6017eccee1b3ce7ca9cf1e51339
+SHA256:
+  metadata.gz: f31eacbf6d689413b94c4607b34f617d2ebee3a9458920ff5435a9e66232d976
+  data.tar.gz: 5eab0a8a120d842f5153d186a60e15a632d7fda9f3d67c418297ff755d68f014
 SHA512:
-  metadata.gz: df440335455b0deea4f7ca6f8b3566868d7d58f62be038217413628931b68acc3feb8899b38bd83b219676fa70aa8ad25d2e7e57d8ba65a6e56cc1bb908a0986
-  data.tar.gz: 1f20ff703cf2b7f725cf744139ec26c73e60a496014a929b8ff06dceb8794dea03a73e3884036be57c4dd0d04fc122f23701c7545a160a9756d9e89c7858ced0
+  metadata.gz: 220bfd684bc5b278bf1c4c40fbf85dbb515336ad561a334544fa257f8da810efb2bf4c2a3533610dade922d296cd003ede1125ee84e1e1231667c344c805f81d
+  data.tar.gz: b042eeb99b7f38c663cb0df25cc6e50490e640eb6644648765ed35df312ce8efd086548602d064b5c928399cd4a19f19d7967cbe7b19645f09c24b2e66c457ee

data/CHANGELOG.md

@@ -1,16 +1,24 @@
 # pathspec-ruby CHANGELOG
 
-## 0.1.2
+## 0.2.0 (Minor Release)
+- (Feature) A CLI tool, pathspec-rb, is now provided with the gem.
+- (API Change) New namespace for gem: `PathSpec`: Everything is now namespaced under `PathSpec`, to prevent naming collisions with other libraries. Thanks @tenderlove!
+- (License) License version updated to Apache 2. Thanks @kytrinyx!
+- (Maint) Pruned Supported Ruby Versions. We now test: 2.2.9, 2.3.6 and 2.4.3.
+- (Maint) Ruby 2.5.0 testing is blocked on Travis, but should work locally. Thanks @SumLare!
+- (Maint) Added Rubocop and made some corrections
+
+## 0.1.2 (Patch/Bug Fix Release)
 - Fix for regexp matching Thanks @incase! #16
 - File handling cleanup Thanks @martinandert! #13
 - `from_filename` actually works now! Thanks @martinandert! #12
 
-## 0.1.0
+## 0.1.0 (Minor Release)
 - Port new edgecase handling from [python-path-specification](https://github.com/cpburnz/python-path-specification/pull/8). Many thanks to @jdpace! :)
 - Removed EOL Ruby support
 - Added current Ruby stable to Travis testing
 
-## 0.0.2
+## 0.0.2 (Patch/Bug Fix Release)
 - Fixed issues with Ruby 1.8.7/2.1.1
 - Added more testing scripts
 - Fixed Windows path related issues

data/README.md

@@ -1,12 +1,13 @@
 pathspec-ruby
 =============
 
-[![Build Status](https://travis-ci.org/highb/pathspec-ruby.svg?branch=master)](https://travis-ci.org/highb/pathspec-ruby) [![codecov](https://codecov.io/gh/highb/pathspec-ruby/branch/master/graph/badge.svg)](https://codecov.io/gh/highb/pathspec-ruby)
+[![Gem Version](https://badge.fury.io/rb/pathspec.svg)](https://badge.fury.io/rb/pathspec) [![Build Status](https://travis-ci.org/highb/pathspec-ruby.svg?branch=master)](https://travis-ci.org/highb/pathspec-ruby) [![Maintainability](https://api.codeclimate.com/v1/badges/4f3b5917e01fb34f790d/maintainability)](https://codeclimate.com/github/highb/pathspec-ruby/maintainability)
 
-Supported Rubies:
-- 2.2.7 (Maintenance)
-- 2.3.4 (Stable)
-- 2.4.1 (Stable)
+[Supported Rubies](https://www.ruby-lang.org/en/downloads/):
+- 2.2.9 (Maintenance)
+- 2.3.6 (Stable)
+- 2.4.3 (Stable)
+- 2.5.0 (Stable) [Disabled in Travis](https://github.com/travis-ci/travis-ci/issues/8969)
 
 Match Path Specifications, such as .gitignore, in Ruby!
 
@@ -19,6 +20,26 @@ Follows .gitignore syntax defined on [gitscm](http://git-scm.com/docs/gitignore)
 gem install pathspec
 ```
 
+## CLI Usage
+```bash
+➜  test-pathspec cat .gitignore
+*.swp
+/coverage/
+➜  test-pathspec be pathspec-rb specs_match "coverage/foo"
+/coverage/
+➜  test-pathspec be pathspec-rb specs_match "file.swp"
+*.swp
+➜ test-pathspec be pathspec-rb match "file.swp"
+➜ test-pathspec echo $?
+0
+➜  test-pathspec ls
+Gemfile      Gemfile.lock coverage     file.swp     source.rb
+➜  test-pathspec be pathspec-rb tree .
+./coverage
+./coverage/index.html
+./file.swp
+```
+
 ## Usage
 ```ruby
 require 'pathspec'
@@ -26,7 +47,7 @@ require 'pathspec'
 # Create a .gitignore-style Pathspec by giving it newline separated gitignore
 # lines, an array of gitignore lines, or any other enumable object that will
 # give strings matching the .gitignore-style (File, etc.)
-gitignore = Pathspec.new File.read('.gitignore', 'r')
+gitignore = Pathspec.from_filename('spec/files/gitignore_readme')
 
 # Our .gitignore in this example contains:
 # !**/important.txt
@@ -34,18 +55,22 @@ gitignore = Pathspec.new File.read('.gitignore', 'r')
 
 # true, matches "abc/**"
 gitignore.match 'abc/def.rb'
+# CLI equivalent: pathspec.rb -f spec/files/gitignore_readme match 'abc/def.rb'
 
 # false, because it has been negated using the line "!**/important.txt"
 gitignore.match 'abc/important.txt'
+# CLI equivalent: pathspec.rb -f spec/files/gitignore_readme match 'abc/important.txt'
 
 # Give a path somewhere in the filesystem, and the Pathspec will return all
 # matching files underneath.
 # Returns ['/src/repo/abc/', '/src/repo/abc/123']
 gitignore.match_tree '/src/repo'
+# CLI equivalent: pathspec.rb -f spec/files/gitignore_readme tree /src/repo
 
 # Give an enumerable of paths, and Pathspec will return the ones that match.
 # Returns ['/abc/123', '/abc/']
 gitignore.match_paths ['/abc/123', '/abc/important.txt', '/abc/']
+# There is no CLI equivalent to this.
 ```
 
 ## Building/Installing from Source

data/bin/pathspec-rb

@@ -0,0 +1,93 @@
+#!/usr/bin/env ruby
+
+require 'optionparser'
+require 'pathspec'
+options = { 
+  spec_type: :git,
+  spec_filename: '.gitignore'
+}
+
+optparser = OptionParser.new do |opts|
+  opts.banner = %q{Usage: pathspec-rb [options] [subcommand] [path]
+Subcommands:
+  specs_match: Finds all specs matching path.
+  tree: Finds all files under path matching the spec.
+  match: Checks if the path matches any spec.
+
+EXIT STATUS:
+  0   Matches found.
+  1   No matches found.
+  >1  An error occured.
+
+}
+  opts.on('-f', '--file FILENAME', String, 
+          'A spec file to load. Default: .gitignore') do |filename|
+    unless File.readable?(filename)
+      puts "Error: I couldn't read #{filename}"
+      exit 2
+    end
+
+    options[:spec_filename] = filename
+  end
+  opts.on('-t', '--type [git|regex]', %i[git regex],
+          'Spec file type in FILENAME. Default: git. Available: git and regex.') do |type|
+    options[:spec_type] = type
+  end
+  opts.on('-v', '--verbose', 'Only output if there are matches.') do |verbose|
+    options[:verbose] = true
+  end
+end
+
+optsparsed = optparser.parse!
+
+command = ARGV[0]
+path = ARGV[1]
+if path
+  spec = PathSpec.from_filename(options[:spec_filename], options[:spec_type])
+else
+  puts optparser.help
+  exit 2
+end
+
+case command
+when 'specs_match'
+  if spec.match(path)
+    if options[:verbose]
+      puts "#{path} matches the following specs from #{options[:spec_filename]}:"
+    end
+    puts spec.specs_matching(path)
+  else
+    if options[:verbose]
+      puts "#{path} does not match any specs from #{options[:spec_filename]}"
+    end
+    exit 1
+  end
+when 'tree'
+  tree_matches = spec.match_tree(path)
+  if tree_matches.size > 0
+    if options[:verbose]
+      puts "Files in #{path} that match #{options[:spec_filename]}"
+    end
+    puts tree_matches
+  else
+    if options[:verbose]
+      puts "No file in #{path} matched #{options[:spec_filename]}"
+    end
+    exit 1
+  end
+when 'match', ''
+  if spec.match(path)
+    if options[:verbose]
+      puts "#{path} matches a spec in #{options[:spec_filename]}"
+    end
+  else
+    if options[:verbose]
+      puts "#{path} does not match any specs in #{options[:spec_filename]}"
+    end
+    exit 1
+  end
+else
+  puts "Unknown sub-command #{command}."
+  puts optparser.help
+  exit 2
+end

data/lib/pathspec.rb

@@ -3,15 +3,14 @@ require 'pathspec/regexspec'
 require 'find'
 require 'pathname'
 
+# Main PathSpec class, provides interfaces to various spec implementations
 class PathSpec
   attr_reader :specs
 
-  def initialize(lines=nil, type=:git)
+  def initialize(lines = nil, type = :git)
     @specs = []
 
-    if lines
-      add(lines, type)
-    end
+    add(lines, type) if lines
 
     self
   end
@@ -26,9 +25,7 @@ class PathSpec
 
   def specs_matching(path)
     @specs.select do |spec|
-      if spec.match(path)
-        spec
-      end
+      spec if spec.match(path)
     end
   end
 
@@ -41,58 +38,52 @@ class PathSpec
     Find.find(root) do |path|
       relpath = Pathname.new(path).relative_path_from(rootpath).to_s
       relpath += '/' if File.directory? path
-      if match(relpath)
-        matching << path
-      end
+      matching << path if match(relpath)
     end
 
     matching
   end
 
-  def match_path(path, root='/')
+  def match_path(path, root = '/')
     rootpath = Pathname.new(drive_letter_to_path(root))
     relpath = Pathname.new(drive_letter_to_path(path)).relative_path_from(rootpath).to_s
-    relpath = relpath + '/' if path[-1].chr == '/'
+    relpath += '/' if path[-1].chr == '/'
 
     match(relpath)
   end
 
-  def match_paths(paths, root='/')
+  def match_paths(paths, root = '/')
     matching = []
 
     paths.each do |path|
-      if match_path(path, root)
-        matching << path
-      end
+      matching << path if match_path(path, root)
     end
 
     matching
   end
 
   def drive_letter_to_path(path)
-    path.gsub(/^([a-zA-Z]):\//, '/\1/')
+    path.gsub(%r{^([a-zA-Z]):\/}, '/\1/')
   end
 
   # Generate specs from a filename, such as a .gitignore
-  def self.from_filename(filename, type=:git)
-    File.open(filename, 'r') { |io| self.from_lines(io, type) }
+  def self.from_filename(filename, type = :git)
+    File.open(filename, 'r') { |io| from_lines(io, type) }
   end
 
-  def self.from_lines(lines, type=:git)
-    self.new lines, type
+  def self.from_lines(lines, type = :git)
+    new lines, type
   end
 
   # Generate specs from lines of text
-  def add(obj, type=:git)
+  def add(obj, type = :git)
     spec_class = spec_type(type)
 
     if obj.respond_to?(:each_line)
       obj.each_line do |l|
         spec = spec_class.new(l.rstrip)
 
-        if !spec.regex.nil? && !spec.inclusive?.nil?
-          @specs << spec
-        end
+        @specs << spec if !spec.regex.nil? && !spec.inclusive?.nil?
       end
     elsif obj.respond_to?(:each)
       obj.each do |l|

data/lib/pathspec/gitignorespec.rb

@@ -1,170 +1,163 @@
-# encoding: utf-8
-
 require 'pathspec/regexspec'
 
-class GitIgnoreSpec < RegexSpec
-  attr_reader :regex
-
-  def initialize(pattern)
-    pattern = pattern.strip unless pattern.nil?
-
-    # A pattern starting with a hash ('#') serves as a comment
-    # (neither includes nor excludes files). Escape the hash with a
-    # back-slash to match a literal hash (i.e., '\#').
-    if pattern.start_with?('#')
-      @regex = nil
-      @inclusive = nil
-
-    # A blank pattern is a null-operation (neither includes nor
-    # excludes files).
-    elsif pattern.empty?
-      @regex = nil
-      @inclusive = nil
-
-    # Patterns containing three or more consecutive stars are invalid and
-    # will be ignored.
-    elsif pattern =~ /\*\*\*+/
-      @regex = nil
-      @inclusive = nil
-
-    # EDGE CASE: According to git check-ignore (v2.4.1)), a single '/'
-    # does not match any file
-    elsif pattern == '/'
-      @regex = nil
-      @inclusive = nil
-
-    # We have a valid pattern!
-    else
-      # A pattern starting with an exclamation mark ('!') negates the
-      # pattern (exclude instead of include). Escape the exclamation
-      # mark with a back-slash to match a literal exclamation mark
-      # (i.e., '\!').
-      if pattern.start_with?('!')
-        @inclusive = false
-        # Remove leading exclamation mark.
-        pattern = pattern[1..-1]
+class PathSpec
+  # Class for parsing a .gitignore spec
+  class GitIgnoreSpec < RegexSpec
+    attr_reader :regex
+    attr_reader :pattern
+
+    def initialize(original_pattern)
+      pattern = original_pattern.strip unless original_pattern.nil?
+
+      # A pattern starting with a hash ('#') serves as a comment
+      # (neither includes nor excludes files). Escape the hash with a
+      # back-slash to match a literal hash (i.e., '\#').
+      if pattern.start_with?('#')
+        @regex = nil
+        @inclusive = nil
+
+        # A blank pattern is a null-operation (neither includes nor
+        # excludes files).
+      elsif pattern.empty?
+        @regex = nil
+        @inclusive = nil
+
+        # Patterns containing three or more consecutive stars are invalid and
+        # will be ignored.
+      elsif pattern =~ /\*\*\*+/
+        @regex = nil
+        @inclusive = nil
+
+        # EDGE CASE: According to git check-ignore (v2.4.1)), a single '/'
+        # does not match any file
+      elsif pattern == '/'
+        @regex = nil
+        @inclusive = nil
+
+        # We have a valid pattern!
       else
-        @inclusive = true
-      end
-
-      # Remove leading back-slash escape for escaped hash ('#') or
-      # exclamation mark ('!').
-      if pattern.start_with?('\\')
-        pattern = pattern[1..-1]
-      end
-
-      # Split pattern into segments. -1 to allow trailing slashes.
-      pattern_segs = pattern.split('/', -1)
-
-      # Normalize pattern to make processing easier.
-
-      # A pattern beginning with a slash ('/') will only match paths
-      # directly on the root directory instead of any descendant
-      # paths. So, remove empty first segment to make pattern relative
-      # to root.
-      if pattern_segs[0].empty?
-        pattern_segs.shift
-      elsif pattern_segs.length == 1 ||
-        pattern_segs.length == 2 && pattern_segs[-1].empty?
-        # A pattern without a beginning slash ('/') will match any
-        # descendant path. This is equivilent to "**/{pattern}". So,
-        # prepend with double-asterisks to make pattern relative to
-        # root.
-        # EDGE CASE: This also holds for a single pattern with a
-        # trailing slash (e.g. dir/).
-        if pattern_segs[0] != '**'
-          pattern_segs.insert(0, '**')
+        # A pattern starting with an exclamation mark ('!') negates the
+        # pattern (exclude instead of include). Escape the exclamation
+        # mark with a back-slash to match a literal exclamation mark
+        # (i.e., '\!').
+        if pattern.start_with?('!')
+          @inclusive = false
+          # Remove leading exclamation mark.
+          pattern = pattern[1..-1]
+        else
+          @inclusive = true
         end
-      end
-
-      # A pattern ending with a slash ('/') will match all descendant
-      # paths of if it is a directory but not if it is a regular file.
-      # This is equivilent to "{pattern}/**". So, set last segment to
-      # double asterisks to include all descendants.
-      if pattern_segs[-1].empty? && pattern_segs.length > 1
-        pattern_segs[-1] = '**'
-      end
-
-      # Handle platforms with backslash separated paths
-      if File::SEPARATOR == '\\'
-        path_sep = '\\\\'
-      else
-        path_sep = '/'
-      end
 
+        # Remove leading back-slash escape for escaped hash ('#') or
+        # exclamation mark ('!').
+        pattern = pattern[1..-1] if pattern.start_with?('\\')
+
+        # Split pattern into segments. -1 to allow trailing slashes.
+        pattern_segs = pattern.split('/', -1)
+
+        # Normalize pattern to make processing easier.
+
+        # A pattern beginning with a slash ('/') will only match paths
+        # directly on the root directory instead of any descendant
+        # paths. So, remove empty first segment to make pattern relative
+        # to root.
+        if pattern_segs[0].empty?
+          pattern_segs.shift
+        elsif pattern_segs.length == 1 ||
+              pattern_segs.length == 2 && pattern_segs[-1].empty?
+          # A pattern without a beginning slash ('/') will match any
+          # descendant path. This is equivilent to "**/{pattern}". So,
+          # prepend with double-asterisks to make pattern relative to
+          # root.
+          # EDGE CASE: This also holds for a single pattern with a
+          # trailing slash (e.g. dir/).
+          pattern_segs.insert(0, '**') if pattern_segs[0] != '**'
+        end
 
-      # Build regular expression from pattern.
-      regex = '^'
-      need_slash = false
-      regex_end = pattern_segs.size - 1
-      pattern_segs.each_index do |i|
-        seg = pattern_segs[i]
-
-        if seg == '**'
-          # A pattern consisting solely of double-asterisks ('**')
-          # will match every path.
-          if i == 0 && i == regex_end
-            regex.concat('.+')
-
-          # A normalized pattern beginning with double-asterisks
-          # ('**') will match any leading path segments.
-          elsif i == 0
-            regex.concat("(?:.+#{path_sep})?")
-            need_slash = false
-
-          # A normalized pattern ending with double-asterisks ('**')
-          # will match any trailing path segments.
-          elsif i == regex_end
-            regex.concat("#{path_sep}.*")
-
-          # A pattern with inner double-asterisks ('**') will match
-          # multiple (or zero) inner path segments.
-          else
-            regex.concat("(?:#{path_sep}.+)?")
+        # A pattern ending with a slash ('/') will match all descendant
+        # paths of if it is a directory but not if it is a regular file.
+        # This is equivilent to "{pattern}/**". So, set last segment to
+        # double asterisks to include all descendants.
+        pattern_segs[-1] = '**' if pattern_segs[-1].empty? && pattern_segs.length > 1
+
+        # Handle platforms with backslash separated paths
+        path_sep = if File::SEPARATOR == '\\'
+                     '\\\\'
+                   else
+                     '/'
+                   end
+
+        # Build regular expression from pattern.
+        regex = '^'
+        need_slash = false
+        regex_end = pattern_segs.size - 1
+        pattern_segs.each_index do |i|
+          seg = pattern_segs[i]
+
+          if seg == '**'
+            # A pattern consisting solely of double-asterisks ('**')
+            # will match every path.
+            if i == 0 && i == regex_end
+              regex.concat('.+')
+
+              # A normalized pattern beginning with double-asterisks
+              # ('**') will match any leading path segments.
+            elsif i == 0
+              regex.concat("(?:.+#{path_sep})?")
+              need_slash = false
+
+              # A normalized pattern ending with double-asterisks ('**')
+              # will match any trailing path segments.
+            elsif i == regex_end
+              regex.concat("#{path_sep}.*")
+
+              # A pattern with inner double-asterisks ('**') will match
+              # multiple (or zero) inner path segments.
+            else
+              regex.concat("(?:#{path_sep}.+)?")
+              need_slash = true
+            end
+
+            # Match single path segment.
+          elsif seg == '*'
+            regex.concat(path_sep) if need_slash
+
+            regex.concat("[^#{path_sep}]+")
             need_slash = true
-          end
-
-        # Match single path segment.
-        elsif seg == '*'
-          if need_slash
-            regex.concat(path_sep)
-          end
 
-          regex.concat("[^#{path_sep}]+")
-          need_slash = true
+          else
+            # Match segment glob pattern.
+            regex.concat(path_sep) if need_slash
 
-        else
-          # Match segment glob pattern.
-          if need_slash
-            regex.concat(path_sep)
-          end
+            regex.concat(translate_segment_glob(seg))
 
-          regex.concat(translate_segment_glob(seg))
+            if i == regex_end && @inclusive
+              # A pattern ending without a slash ('/') will match a file
+              # or a directory (with paths underneath it).
+              # e.g. foo matches: foo, foo/bar, foo/bar/baz, etc.
+              # EDGE CASE: However, this does not hold for exclusion cases
+              # according to `git check-ignore` (v2.4.1).
+              regex.concat("(?:#{path_sep}.*)?")
+            end
 
-          if i == regex_end && @inclusive
-            # A pattern ending without a slash ('/') will match a file
-            # or a directory (with paths underneath it).
-            # e.g. foo matches: foo, foo/bar, foo/bar/baz, etc.
-            # EDGE CASE: However, this does not hold for exclusion cases
-            # according to `git check-ignore` (v2.4.1).
-            regex.concat("(?:#{path_sep}.*)?")
+            need_slash = true
           end
-
-          need_slash = true
         end
-      end
 
-      regex.concat('$')
-      super(regex)
+        regex.concat('$')
+        super(regex)
+        
+        # Copy original pattern
+        @pattern = original_pattern.dup
+      end
     end
-  end
 
-  def match(path)
-    super(path)
-  end
+    def match(path)
+      super(path)
+    end
 
-  def translate_segment_glob(pattern)
-    """
+    def translate_segment_glob(pattern)
+      ''"
     Translates the glob pattern to a regular expression. This is used in
     the constructor to translate a path segment glob pattern to its
     corresponding regular expression.
@@ -172,123 +165,116 @@ class GitIgnoreSpec < RegexSpec
     *pattern* (``str``) is the glob pattern.
 
     Returns the regular expression (``str``).
-    """
-    # NOTE: This is derived from `fnmatch.translate()` and is similar to
-    # the POSIX function `fnmatch()` with the `FNM_PATHNAME` flag set.
-
-    escape = false
-    regex = ''
-    i = 0
-
-    while i < pattern.size
-      # Get next character.
-      char = pattern[i].chr
-      i += 1
-
-      # Escape the character.
-      if escape
-        escape = false
-        regex += Regexp.escape(char)
-
-      # Escape character, escape next character.
-      elsif char == '\\'
-        escape = true
-
-      # Multi-character wildcard. Match any string (except slashes),
-      # including an empty string.
-      elsif char == '*'
-        regex += '[^/]*'
-
-      # Single-character wildcard. Match any single character (except
-      # a slash).
-      elsif char == '?'
-        regex += '[^/]'
-
-      # Braket expression wildcard. Except for the beginning
-      # exclamation mark, the whole braket expression can be used
-      # directly as regex but we have to find where the expression
-      # ends.
-      # - "[][!]" matchs ']', '[' and '!'.
-      # - "[]-]" matchs ']' and '-'.
-      # - "[!]a-]" matchs any character except ']', 'a' and '-'.
-      elsif char == '['
-        j = i
-        # Pass brack expression negation.
-        if j < pattern.size && pattern[j].chr == '!'
-          j += 1
-        end
-
-        # Pass first closing braket if it is at the beginning of the
-        # expression.
-        if j < pattern.size && pattern[j].chr == ']'
-          j += 1
-        end
-
-        # Find closing braket. Stop once we reach the end or find it.
-        while j < pattern.size && pattern[j].chr != ']'
-          j += 1
-        end
-
-
-        if j < pattern.size
-          expr = '['
-
-          # Braket expression needs to be negated.
-          if pattern[i].chr == '!'
-            expr += '^'
-            i += 1
-
-          # POSIX declares that the regex braket expression negation
-          # "[^...]" is undefined in a glob pattern. Python's
-          # `fnmatch.translate()` escapes the caret ('^') as a
-          # literal. To maintain consistency with undefined behavior,
-          # I am escaping the '^' as well.
-          elsif pattern[i].chr == '^'
-            expr += '\\^'
-            i += 1
-          end
-
-          # Escape brackets contained within pattern
-          if pattern[i].chr == ']' && i != j
-            expr += '\]'
-            i += 1
+      "''
+      # NOTE: This is derived from `fnmatch.translate()` and is similar to
+      # the POSIX function `fnmatch()` with the `FNM_PATHNAME` flag set.
+
+      escape = false
+      regex = ''
+      i = 0
+
+      while i < pattern.size
+        # Get next character.
+        char = pattern[i].chr
+        i += 1
+
+        # Escape the character.
+        if escape
+          escape = false
+          regex += Regexp.escape(char)
+
+          # Escape character, escape next character.
+        elsif char == '\\'
+          escape = true
+
+          # Multi-character wildcard. Match any string (except slashes),
+          # including an empty string.
+        elsif char == '*'
+          regex += '[^/]*'
+
+          # Single-character wildcard. Match any single character (except
+          # a slash).
+        elsif char == '?'
+          regex += '[^/]'
+
+          # Braket expression wildcard. Except for the beginning
+          # exclamation mark, the whole braket expression can be used
+          # directly as regex but we have to find where the expression
+          # ends.
+          # - "[][!]" matchs ']', '[' and '!'.
+          # - "[]-]" matchs ']' and '-'.
+          # - "[!]a-]" matchs any character except ']', 'a' and '-'.
+        elsif char == '['
+          j = i
+          # Pass brack expression negation.
+          j += 1 if j < pattern.size && pattern[j].chr == '!'
+
+          # Pass first closing braket if it is at the beginning of the
+          # expression.
+          j += 1 if j < pattern.size && pattern[j].chr == ']'
+
+          # Find closing braket. Stop once we reach the end or find it.
+          j += 1 while j < pattern.size && pattern[j].chr != ']'
+
+          if j < pattern.size
+            expr = '['
+
+            # Braket expression needs to be negated.
+            if pattern[i].chr == '!'
+              expr += '^'
+              i += 1
+
+              # POSIX declares that the regex braket expression negation
+              # "[^...]" is undefined in a glob pattern. Python's
+              # `fnmatch.translate()` escapes the caret ('^') as a
+              # literal. To maintain consistency with undefined behavior,
+              # I am escaping the '^' as well.
+            elsif pattern[i].chr == '^'
+              expr += '\\^'
+              i += 1
+            end
+
+            # Escape brackets contained within pattern
+            if pattern[i].chr == ']' && i != j
+              expr += '\]'
+              i += 1
+            end
+
+            # Build regex braket expression. Escape slashes so they are
+            # treated as literal slashes by regex as defined by POSIX.
+            expr += pattern[i..j].sub('\\', '\\\\')
+
+            # Add regex braket expression to regex result.
+            regex += expr
+
+            # Found end of braket expression. Increment j to be one past
+            # the closing braket:
+            #
+            #  [...]
+            #   ^   ^
+            #   i   j
+            #
+            j += 1
+            # Set i to one past the closing braket.
+            i = j
+
+            # Failed to find closing braket, treat opening braket as a
+            # braket literal instead of as an expression.
+          else
+            regex += '\['
           end
 
-
-          # Build regex braket expression. Escape slashes so they are
-          # treated as literal slashes by regex as defined by POSIX.
-          expr += pattern[i..j].sub('\\', '\\\\')
-
-          # Add regex braket expression to regex result.
-          regex += expr
-
-          # Found end of braket expression. Increment j to be one past
-          # the closing braket:
-          #
-          #  [...]
-          #   ^   ^
-          #   i   j
-          #
-          j += 1
-          # Set i to one past the closing braket.
-          i = j
-
-        # Failed to find closing braket, treat opening braket as a
-        # braket literal instead of as an expression.
+          # Regular character, escape it for regex.
         else
-          regex += '\['
+          regex << Regexp.escape(char)
         end
-
-      # Regular character, escape it for regex.
-      else
-        regex << Regexp.escape(char)
       end
-    end
 
-    regex
-  end
+      regex
+    end
 
-  def inclusive?
-    @inclusive
+    def inclusive?
+      @inclusive
+    end
   end
 end