Test with The Ruby Spec Suite

Adds The Ruby Spec Suite as a submodule and configures for running with
the FasterPath monkey patches.

.gitignore

@@ -12,3 +12,4 @@ mkmf.log
 **/*.swp
 **/*.gem
 .idea
+/rubyspec_temp/

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "spec/ruby_spec"]
+	path = spec/ruby_spec
+	url = https://github.com/ruby/spec

Gemfile

@@ -1,4 +1,7 @@
-source 'https://rubygems.org'
+source 'https://rubygems.org' do
+  # Specify your gem's dependencies in faster_path.gemspec
+  gemspec
+end
 
-# Specify your gem's dependencies in faster_path.gemspec
-gemspec
+# https://github.com/ruby/spec dependencies
+eval_gemfile File.expand_path('spec/ruby_spec/Gemfile', File.dirname(__FILE__))

README.md

@@ -117,7 +117,7 @@ And then execute:
 Or install it yourself as:
 
     $ gem install faster_path
-    
+
 **MAC USERS:** At the moment Mac users need to install the extension manualy.  Go to the gem directory and run `cargo build --release` .  There is an issue opened for this and I'm looking for people who have Macs to help on this.
 
 ## Usage
@@ -136,7 +136,7 @@ Current methods implemented:
 | `FasterPath.extname` | `File#extname` | 11.2% |
 
 You may choose to use the methods directly, or scope change to rewrite behavior on the
-standard library with the included refinements, or even call a method to monkeypatch 
+standard library with the included refinements, or even call a method to monkeypatch
 everything everywhere.
 
 **Note:** `Pathname#chop_basename` in Ruby STDLIB has a bug with blank strings, that is the
@@ -184,6 +184,42 @@ Then, run `rake test` to run the tests, and `rake bench` for benchmarks.
 
 Learn and share performance tips on the [wiki](https://github.com/danielpclark/faster_path/wiki)!
 
+### Building and running tests
+
+First, bundle the gem's development dependencies by running `bundle`.
+
+Then, build the rust code:
+
+```sh
+rake build_src
+```
+
+FasterPath is tested with [The Ruby Spec Suite](https://github.com/ruby/spec) to ensure it is compatible with the
+native implementation, and also has its own test suite testing its monkey-patching and refinements functionality.
+
+To run all the tests at once, simply run `rake`.
+To run all the ruby spec tests, run `mspec`.
+
+To run an individual test or benchmark from FasterPath's own suite:
+
+```sh
+# An individual test file:
+ruby -I lib:test test/benches/absolute_benchmark.rb
+# All tests:
+rake minitest
+```
+
+To run an individual ruby spec test, run `mspec` with a path relative to `spec/ruby_spec`, e.g.:
+
+```sh
+# A path to a file or a directory:
+mspec core/file/basename_spec.rb
+# Tests most relevant to FasterPath:
+mspec core/file library/pathname
+# All tests:
+mspec
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/danielpclark/faster_path.

Rakefile

@@ -27,12 +27,16 @@ task :build_lib => [:build_src, :clean_src] do
   puts "Completed build!"
 end
 
-Rake::TestTask.new(:test) do |t|
+Rake::TestTask.new(:minitest) do |t|
   t.libs << "test"
   t.libs << "lib"
   t.test_files = FileList['test/**/*_test.rb']
 end
 
+task :test => :minitest do |t|
+  exec 'mspec core/file library/pathname'
+end
+
 Rake::TestTask.new(:bench) do |t|
   t.libs = %w(lib test)
   t.pattern = 'test/**/*_benchmark.rb'

lib/faster_path/optional/monkeypatches.rb

@@ -1,3 +1,5 @@
+require 'pathname'
+
 module FasterPath
   def self.sledgehammer_everything!
     ::File.class_eval do

spec/default.mspec

@@ -0,0 +1,8 @@
+load 'spec/ruby_spec/default.mspec'
+
+class MSpecScript
+  set :requires, ["-r#{File.expand_path('init', File.dirname(__FILE__))}"]
+  set :prefix, 'spec/ruby_spec'
+end
+
+MSpec.disable_feature :encoding

spec/init.rb

@@ -0,0 +1,5 @@
+ENV['BUNDLE_GEMFILE'] = File.expand_path('../Gemfile', File.dirname(__FILE__))
+$LOAD_PATH.unshift File.expand_path('../lib', File.dirname(__FILE__))
+require 'faster_path'
+require 'faster_path/optional/monkeypatches'
+FasterPath.sledgehammer_everything!