faster_path 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e04d827e927a1e405d74ccf0fe49946faaf67650c935ad1e5a5dec744254d27
-  data.tar.gz: '067897cef2171835830c97c8340397ad2d4a97ad1c72b15a88c0876bf58a1690'
+  metadata.gz: 9fb5780bd8ce8ea17d538b540ac69b1c023118d1351e167cde418ee48a4f8085
+  data.tar.gz: b12bc7a5ab8e4e26cfd46328bdb9e4b57eea367a9c40e76aeba74e12f06eb0e7
 SHA512:
-  metadata.gz: 16298d55d4cd08d92555ed02e995a55520430527e37d057d7372182e7b9f12758bbf730d2f5969740f806e4bc3221b32843e2a90a8aacb96a57d95500995e477
-  data.tar.gz: c09f83ba8f3687b3dc509536fbf985435528a160161795285baf612edf965f409bbac07f6b6de7075be3b5df29d23263de41176ad478d90ade20a567e1fb2a8d
+  metadata.gz: fa615d0278378e74432832369cf56b16147ecc0e5e27bd12b1fd90c2690fab41dc68fd3042e8dd7c92b8ebb7741f7d08e9db25bd0cec61b384b520f9bd8b400a
+  data.tar.gz: 905389671e4062ef0824e7fb7af8d05fefb1df0ad2a5919bc8a54a8506309ba77cea577859ea49da4e15616fd2fb4bf1d025e5082baef6e61bf18c0c9799d000

data/Cargo.lock

@@ -4,7 +4,7 @@ version = 4
 
 [[package]]
 name = "faster_path"
-version = "0.1.0"
+version = "0.5.0"
 dependencies = [
  "memchr",
  "rutie",
@@ -30,9 +30,9 @@ checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
 
 [[package]]
 name = "rutie"
-version = "0.10.2"
+version = "0.13.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a97641d6bd3731d263d914141e960a8b515bf5ff4ca6c961b25ca4b2694c6490"
+checksum = "30d1529470ad0b69b81a6d0224632d00c01b46ef671452e24407512165b7ed84"
 dependencies = [
  "lazy_static",
  "libc",

data/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "faster_path"
-version = "0.1.0"
+version = "0.5.0"
 authors = ["Daniel P. Clark <6ftdan@gmail.com>"]
 description = "Alternative to Pathname"
 homepage = "https://github.com/danielpclark/faster_path"
@@ -9,13 +9,10 @@ license = "MIT OR Apache-2.0"
 readme = "README.md"
 edition = "2021"
 
-[package.metadata.thermite]
-github_releases = true
-
 [lib]
 name = "faster_path"
 crate-type = ["cdylib"]
 
 [dependencies]
-rutie = "0.10.2"
+rutie = "0.13.1"
 memchr = "2"

data/README.md

@@ -3,7 +3,6 @@
 [![CI](https://github.com/danielpclark/faster_path/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/danielpclark/faster_path/actions/workflows/ci.yml)
 [![Latest Tag](https://img.shields.io/github/tag/danielpclark/faster_path.svg)](https://github.com/danielpclark/faster_path/tags)
 [![Commits Since Last Release](https://img.shields.io/github/commits-since/danielpclark/faster_path/v0.3.10.svg)](https://github.com/danielpclark/faster_path/pulse)
-[![Binary Release](https://img.shields.io/github/release/danielpclark/faster_path.svg)](https://github.com/danielpclark/faster_path/releases)
 [![Inline docs](http://inch-ci.org/github/danielpclark/faster_path.svg?branch=master)](http://inch-ci.org/github/danielpclark/faster_path)
 [![Code Triagers Badge](https://www.codetriage.com/danielpclark/faster_path/badges/users.svg)](https://www.codetriage.com/danielpclark/faster_path)
 
@@ -114,14 +113,15 @@ As mentioned earlier Sprockets, which handles assets, changed away from using `P
 
 ## Requirements
 
-* Ruby 2.5, 2.6 or 2.7 (the Rust extension is built with [Rutie](https://github.com/danielpclark/rutie) 0.10, which supports these)
-* Rust 1.71 or later
+* Ruby 3.2, 3.3 or 3.4 (the Rust extension is built with [Rutie](https://github.com/danielpclark/rutie) 0.13, which supports these)
+* Rust 1.71 or later: `gem install` builds the extension with Cargo (through the
+  [rutie](https://rubygems.org/gems/rutie) gem's Rake task) and keeps only the built library
 
 ## Installation
 
-Ensure Rust is installed:
+Ensure Rust is installed, with `cargo` on your `PATH`:
 
-[Rust Downloads](https://www.rust-lang.org/downloads.html)
+[Install Rust](https://www.rust-lang.org/tools/install)
 
 ```
 curl -sSf https://sh.rustup.rs | sh
@@ -130,7 +130,7 @@ curl -sSf https://sh.rustup.rs | sh
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'faster_path', '~> 0.4.0'
+gem 'faster_path', '~> 0.5.0'
 ```
 
 And then execute:
@@ -141,6 +141,12 @@ Or install it yourself as:
 
     $ gem install faster_path
 
+Installing compiles the Rust extension for the Ruby doing the installing ("Building native
+extensions. This could take a while..."), which takes about a minute the first time while Cargo
+fetches and builds the dependencies. If Rust is missing, the install fails at that step with
+Cargo not being found; install Rust and run it again. Nothing is downloaded from GitHub: there are
+no prebuilt binaries.
+
 ## Visual Benchmarks
 
 Benchmarks in Faster Path now produce visual graph charts of performance improvements.
@@ -159,25 +165,25 @@ require "faster_path"
 
 Current methods implemented:
 
-|FasterPath Rust Implementation|Ruby Implementation|Time Shaved Off (Ruby 2.7)|Time Shaved Off (Ruby 2.5)|
-|---|---|:---:|:---:|
-| `FasterPath.absolute?` | `Pathname#absolute?` | 95.7% | 96.7% |
-| `FasterPath.add_trailing_separator` | `Pathname#add_trailing_separator` | 85.4% | 83.0% |
-| `FasterPath.basename` | `File.basename` | 42.4% | 39.1% |
-| `FasterPath.children` | `Pathname#children` | 54.7% | 47.8% |
-| `FasterPath.chop_basename` | `Pathname#chop_basename` | 70.4% | 75.1% |
-| `FasterPath.cleanpath_aggressive` | `Pathname#cleanpath_aggressive` | 90.3% | 90.6% |
-| `FasterPath.cleanpath_conservative` | `Pathname#cleanpath_conservative` | 89.6% | 91.6% |
-| `FasterPath.del_trailing_separator` | `Pathname#del_trailing_separator` | 85.3% | 87.6% |
-| `FasterPath.directory?` | `Pathname#directory?` | 34.3% | 37.5% |
-| `FasterPath.dirname` | `File.dirname` | 56.8% | 54.7% |
-| `FasterPath.entries` | `Pathname#entries` | 38.0% | 33.9% |
-| `FasterPath.extname` | `File.extname` | 74.0% | 73.1% |
-| `FasterPath.has_trailing_separator?` | `Pathname#has_trailing_separator` | 88.5% | 89.1% |
-| `FasterPath.join` | `Pathname#join` | 88.1% | 90.3% |
-| `FasterPath.plus` | `Pathname#plus` | 91.7% | 93.4% |
-| `FasterPath.relative?` | `Pathname#relative?` | 92.8% | 95.2% |
-| `FasterPath.relative_path_from` | `Pathname#relative_path_from` | 92.5% | 93.6% |
+|FasterPath Rust Implementation|Ruby Implementation|Time Shaved Off (Ruby 3.4)|Time Shaved Off (Ruby 3.3)|Time Shaved Off (Ruby 3.2)|
+|---|---|:---:|:---:|:---:|
+| `FasterPath.absolute?` | `Pathname#absolute?` | 55.5% | 53.2% | 43.1% |
+| `FasterPath.add_trailing_separator` | `Pathname#add_trailing_separator` | 87.4% | 85.3% | 85.8% |
+| `FasterPath.basename` | `File.basename` | 30.7% | 22.2% | 27.5% |
+| `FasterPath.children` | `Pathname#children` | 65.0% | 55.1% | 55.4% |
+| `FasterPath.chop_basename` | `Pathname#chop_basename` | 75.3% | 73.5% | 72.8% |
+| `FasterPath.cleanpath_aggressive` | `Pathname#cleanpath_aggressive` | 92.4% | 92.2% | 92.4% |
+| `FasterPath.cleanpath_conservative` | `Pathname#cleanpath_conservative` | 91.4% | 91.3% | 91.8% |
+| `FasterPath.del_trailing_separator` | `Pathname#del_trailing_separator` | 89.1% | 87.9% | 87.8% |
+| `FasterPath.directory?` | `Pathname#directory?` | 41.5% | 39.9% | 44.2% |
+| `FasterPath.dirname` | `File.dirname` | 52.0% | 40.3% | 40.8% |
+| `FasterPath.entries` | `Pathname#entries` | 57.8% | 42.4% | 45.9% |
+| `FasterPath.extname` | `File.extname` | 69.4% | 66.7% | 69.2% |
+| `FasterPath.has_trailing_separator?` | `Pathname#has_trailing_separator` | 93.4% | 92.8% | 91.7% |
+| `FasterPath.join` | `Pathname#join` | 89.1% | 89.0% | 88.4% |
+| `FasterPath.plus` | `Pathname#plus` | 95.5% | 94.7% | 94.5% |
+| `FasterPath.relative?` | `Pathname#relative?` | 66.9% | 66.3% | 60.4% |
+| `FasterPath.relative_path_from` | `Pathname#relative_path_from` | 94.4% | 94.6% | 94.2% |
 
 See [Benchmarks](#benchmarks) for how these are measured.
 
@@ -205,10 +211,10 @@ FasterPath.sledgehammer_everything!
 
 These will **not** be included by default in monkey-patches.  To try them with monkeypatching use the environment flag of `WITH_REGRESSION`.  These methods are here to be improved upon.
 
-|FasterPath Implementation|Ruby Implementation|Time Shaved Off (Ruby 2.7)|Time Shaved Off (Ruby 2.5)|
-|---|---|:---:|:---:|
-| `FasterPath.entries_compat` | `Pathname.entries` | 16.8% | 9.2% |
-| `FasterPath.children_compat` | `Pathname.children` | 32.1% | 26.6% |
+|FasterPath Implementation|Ruby Implementation|Time Shaved Off (Ruby 3.4)|Time Shaved Off (Ruby 3.3)|Time Shaved Off (Ruby 3.2)|
+|---|---|:---:|:---:|:---:|
+| `FasterPath.entries_compat` | `Pathname.entries` | 35.7% | 22.0% | 15.9% |
+| `FasterPath.children_compat` | `Pathname.children` | 46.7% | 33.6% | 32.3% |
 
 It's been my observation (and some others) that the Rust implementation of the C code for `File` has similar results but
 performance seems to vary based on CPU cache on possibly 64bit/32bit system environments.  These are not included by default when the monkey patch method `FasterPath.sledgehammer_everything!` is executed.
@@ -216,13 +222,19 @@ performance seems to vary based on CPU cache on possibly 64bit/32bit system envi
 ## Benchmarks
 
 The "Time Shaved Off" figures come from the project's Pinch-bench (`rake pbench`, in
-`test/pbench`): each method runs against Ruby's own implementation, and the result is how much
-less time FasterPath took. They are the median of 3 runs of `LONG_RUN=10 rake pbench` (500,000
-calls of each method, 5 times) on Linux x86_64 with Ruby 2.7.8 and 2.5.7, built with Rust 1.97.
-Expect a few points of difference from run to run.
+`test/pbench`): each method runs against Ruby's own implementation, alternating with it round by
+round, and the result is how much less time FasterPath's best round took than Ruby's best round.
+They are the median of 3 runs of `LONG_RUN=30 rake pbench` (5 rounds of 300,000 calls of each
+method) on Linux x86_64, each run pinned to one CPU core, with Ruby 3.4.6, 3.3.6 and 3.2.9, built
+with Rust 1.97. The three runs agree within a few points for most methods; the ones that touch
+the filesystem (`children`, `directory?`, `entries`) vary the most.
+
+The figures are smaller than they were on Ruby 2 for the cheapest methods, `absolute?` and
+`relative?` above all: Ruby 3's own `Pathname#absolute?` is a single regexp match, where Ruby 2's
+walked the path with `chop_basename`, so there is less left to shave off.
 
 `rake pbench` is also the performance regression test: each method has a floor in
-`test/pbench/pbench_suite.rb` (about half of the improvement in the table above) and the task
+`test/pbench/pbench_suite.rb` (about half of its lowest figure in the table above) and the task
 fails when a method measures below it, so a change that makes a method slower shows up in
 `rake test`. On Windows, where `join` is currently slower than Ruby's
 ([#185](https://github.com/danielpclark/faster_path/issues/185)), the floors are reported but not
@@ -230,8 +242,10 @@ enforced.
 
 ### Before and after the Rutie 0.10 upgrade
 
-Measured the same way, alternating runs of the code before the upgrade (built with Rutie 0.6)
-and after it. Higher is better; the change is in percentage points.
+The last figures on Ruby 2, from the Rutie 0.10 upgrade (faster_path 0.4.0): Ruby 2.7.8 and
+2.5.7, alternating runs of the code before the upgrade (built with Rutie 0.6) and after it, with
+the benchmark then measuring the average of 5 rounds run one implementation after the other.
+Higher is better; the change is in percentage points.
 
 |Method|Ruby 2.7 before|Ruby 2.7 after|Change|Ruby 2.5 before|Ruby 2.5 after|Change|
 |---|:---:|:---:|:---:|:---:|:---:|:---:|
@@ -278,7 +292,9 @@ Rust method like `!absolute?` _(not absolute)_ drops 39% of the performance alre
 Whenever feasible implement it in Rust.
 
 After checking out the repo, make sure you have Rust installed, then run `bundle`.
-Run `rake test` to run the tests, and `rake bench` for benchmarks.
+Run `rake test` to run the tests, and `rake bench` for benchmarks. Both build the extension
+first (`rake rutie:build`, into `target/release`, which is where `require 'faster_path'` loads it
+from in a checkout).
 
 ### Building and running tests
 

data/Rakefile

@@ -1,7 +1,7 @@
 require 'bundler/gem_tasks'
 require 'rake/testtask'
-require 'thermite/tasks'
-require 'faster_path/thermite_initialize'
+require 'faster_path/version'
+require 'faster_path/build_task'
 
 desc 'System Details'
 task :sysinfo do
@@ -22,7 +22,7 @@ task :sysinfo do
   puts "RAKE\n   #{Rake::VERSION}"
 end
 
-thermite = Thermite::Tasks.new
+FasterPath::BuildTask.define
 
 desc "Generate Contriburs.md Manifest"
 task :contrib do
@@ -31,10 +31,8 @@ task :contrib do
 ' > Contributors.md;git shortlog -s -n -e | sed 's/^......./- /' >> Contributors.md"
 end
 
-desc 'Build + clean up Rust extension'
-task build_lib: 'thermite:build' do
-  thermite.run_cargo 'clean'
-end
+desc 'Build the Rust extension'
+task build_lib: 'rutie:build'
 
 desc 'Code Quality Check'
 task :lint do
@@ -92,10 +90,8 @@ Rake::TestTask.new(bench: :build_lib) do |t|
   t.pattern = 'test/**/*_benchmark.rb'
 end
 
+# LONG_RUN=<1..30> multiplies the calls per round, see test/pbench/pbench.rb
 Rake::TestTask.new(pbench: :build_lib) do |t|
-  if ARGV.last == '--long-run'
-    ENV['LONG_RUN'] = '10'
-  end
   t.libs = %w[lib test test/pbench]
   t.pattern = 'test/pbench/pbench_suite.rb'
 end

data/ext/Rakefile

@@ -1,8 +1,14 @@
-require 'thermite/tasks'
-require_relative '../lib/faster_path/thermite_initialize'
+require 'fileutils'
+require_relative '../lib/faster_path/build_task'
 
-project_toplevel_dir = File.dirname(__dir__)
-Thermite::Tasks.new(cargo_project_path: project_toplevel_dir,
-                    ruby_project_path: project_toplevel_dir)
+FasterPath::BuildTask.define
 
-task default: 'thermite:build'
+# Keeps the built library (in lib/faster_path, where FasterPath loads it from)
+# and removes the rest of Cargo's output from the installed gem.
+task install_library: 'rutie:build' do
+  FileUtils.mkdir_p(FasterPath::BuildTask::INSTALLED_LIBRARY_DIR)
+  FileUtils.cp(FasterPath::BuildTask.built_library, FasterPath::BuildTask::INSTALLED_LIBRARY_DIR)
+  Rake::Task['rutie:clean'].invoke
+end
+
+task default: :install_library

data/faster_path.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |spec|
   spec.files         = [
     'Cargo.lock', 'Cargo.toml', 'Gemfile', 'MIT-LICENSE.txt', 'README.md', 'Rakefile',
     'bin/console', 'bin/setup', 'ext/Rakefile', 'faster_path.gemspec', 'lib/faster_path.rb',
-    'lib/faster_path/version.rb', 'lib/faster_path/thermite_initialize.rb',
+    'lib/faster_path/version.rb', 'lib/faster_path/build_task.rb',
     'lib/faster_path/optional/monkeypatches.rb', 'lib/faster_path/optional/refinements.rb'
   ]
   spec.files += Dir['src/**/*']
@@ -24,17 +24,18 @@ Gem::Specification.new do |spec|
   spec.extensions    = ['ext/Rakefile']
   spec.require_paths = ['lib']
 
-  # Rutie 0.10, which the Rust extension is built with, supports Ruby 2.5 to 2.7
-  spec.required_ruby_version = ['>= 2.5', '< 3.0']
+  # Rutie 0.13, which the Rust extension is built with, supports Ruby 3.2 to 3.4
+  spec.required_ruby_version = ['>= 3.2', '< 3.5']
 
-  spec.add_dependency 'bundler', '>= 1.12'
+  # The extension is built at install time with Rutie's Rake task and loaded with Rutie
   spec.add_dependency 'rake', '>= 12.3'
-  spec.add_dependency 'thermite', '0.13.0'
+  spec.add_dependency 'rutie', '~> 0.0.5'
   spec.add_development_dependency 'read_source', '~> 0.2.6'
   spec.add_development_dependency 'minitest', '~> 5.11'
   spec.add_development_dependency 'minitest-reporters', '~> 1.1'
   spec.add_development_dependency 'color_pound_spec_reporter', '~> 0.0.9'
-  spec.add_development_dependency 'rubocop', '0.53'
+  spec.add_development_dependency 'rubocop', '~> 1.80'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.20'
   spec.add_development_dependency 'stop_watch', '~> 1.0'
   if !ENV['CI'] && ENV['GRAPH']
     spec.add_development_dependency 'gruff', '~> 0.7.0'

data/lib/faster_path/build_task.rb

@@ -0,0 +1,32 @@
+require 'rbconfig'
+require 'rutie'
+require 'rutie/rake_task'
+
+module FasterPath
+  # Defines `rutie:build` and `rutie:clean`, which build the Rust extension
+  # with Cargo. Used by the Rakefile and by ext/Rakefile when the gem is
+  # installed; both may run from another directory, so Cargo is pointed at
+  # the gem's Cargo.toml.
+  #
+  # The Rakefile leaves the library in target/release, where Rutie loads it
+  # from; ext/Rakefile moves it to lib/faster_path so that the installed gem
+  # keeps nothing else of the build.
+  module BuildTask
+    PROJECT_DIR = File.expand_path('../..', __dir__)
+    # Where `gem install` puts the built library
+    INSTALLED_LIBRARY_DIR = File.join(PROJECT_DIR, 'lib', 'faster_path')
+
+    def self.define
+      # Rutie's build script links the extension to the Ruby named by RUBY,
+      # or the first `ruby` on the PATH; make it the Ruby running Rake.
+      ENV['RUBY'] ||= File.join(RbConfig::CONFIG['bindir'],
+                                RbConfig::CONFIG['ruby_install_name'] + RbConfig::CONFIG['EXEEXT'])
+      Rutie::RakeTask.new(cargo_args: ['--manifest-path', File.join(PROJECT_DIR, 'Cargo.toml')])
+    end
+
+    # The library `rutie:build` builds, in the project's target/release
+    def self.built_library
+      Rutie.new(:faster_path).ffi_library(File.join(PROJECT_DIR, 'lib'))
+    end
+  end
+end

data/lib/faster_path/optional/monkeypatches.rb

@@ -24,10 +24,10 @@ module FasterPath
         end
 
         # @private :nodoc:
-        def self.dirname(pth)
+        def self.dirname(pth, level = 1)
           pth = pth.to_path if pth.respond_to? :to_path
           raise TypeError unless pth.is_a? String
-          FasterPath.dirname(pth)
+          FasterPath.dirname(pth, level)
         end
       end
     end

data/lib/faster_path/optional/refinements.rb

@@ -20,10 +20,10 @@ module FasterPath
       end
 
       # @private :nodoc:
-      def self.dirname(pth)
+      def self.dirname(pth, level = 1)
         pth = pth.to_path if pth.respond_to? :to_path
         raise TypeError unless pth.is_a? String
-        FasterPath.dirname(pth)
+        FasterPath.dirname(pth, level)
       end
     end
   end

data/lib/faster_path/version.rb

@@ -1,3 +1,3 @@
 module FasterPath
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/faster_path.rb

@@ -1,7 +1,6 @@
 require 'faster_path/version'
 require 'pathname'
-require 'thermite/config'
-require 'faster_path/thermite_initialize'
+require 'rutie'
 require 'fiddle'
 require 'fiddle/import'
 
@@ -14,16 +13,12 @@ require 'fiddle/import'
 # existing code ecosystem.  To do so you will need to
 # `require 'faster_path/optional/monkeypatches'` beforehand.
 module FasterPath
-  FFI_LIBRARY = begin
-    toplevel_dir = File.dirname(__dir__)
-    config = Thermite::Config.new(cargo_project_path: toplevel_dir,
-                                  ruby_project_path: toplevel_dir)
-    config.ruby_extension_path
-  end
-
-  Fiddle::Function.
-    new(Fiddle.dlopen(FFI_LIBRARY)['Init_faster_pathname'], [], Fiddle::TYPE_VOID).
-    call
+  # The Rust extension: in the project's target/release after `rake rutie:build`,
+  # or in lib/faster_path, where `gem install` puts it (see ext/Rakefile)
+  RUTIE = [Rutie.new(:faster_path), Rutie.new(:faster_path, lib_path: 'faster_path')].
+    find { |rutie| File.exist?(rutie.ffi_library(__dir__)) } || Rutie.new(:faster_path)
+  FFI_LIBRARY = RUTIE.ffi_library(__dir__)
+  RUTIE.init('Init_faster_pathname', __dir__)
 
   Public.class_eval do
     private_class_method :basename

data/src/pathname.rs

@@ -3,7 +3,7 @@ use std::ffi::OsStr;
 use std::fs;
 use std::io;
 
-use rutie::{AnyException, AnyObject, Array, Boolean, Class, NilClass, Object, RString};
+use rutie::{AnyException, AnyObject, Array, Boolean, Class, Integer, NilClass, Object, RString, Symbol};
 
 use crate::basename;
 use crate::chop_basename::{self, is_relative};
@@ -15,7 +15,7 @@ use crate::path_parsing::Rules;
 use crate::plus;
 use crate::relative_path_from::{self, RelativePathError};
 use crate::ruby::{
-  argument_error, check_max_arguments, error, new_pathname, path_like_to_string, pathname_class,
+  argument_error, check_max_arguments, error, inspect, new_pathname, path_like_to_string, pathname_class,
   truthy_argument, EncodingId, EncodingOf, PathArgument, PathString, RubyResult,
 };
 
@@ -152,11 +152,51 @@ pub fn pn_is_directory(arguments: &[AnyObject]) -> RubyResult {
   Ok(Boolean::new(is_directory).into())
 }
 
+// `File.dirname(path, level = 1)`: `level` is the number of trailing
+// components to remove (Ruby 3.1+).
 pub fn pn_dirname(arguments: &[AnyObject]) -> RubyResult {
-  check_max_arguments(arguments, 1)?;
+  check_max_arguments(arguments, 2)?;
   let argument = PathArgument::new(arguments, 0)?;
   let path = argument.path()?;
-  Ok(path.to_ruby(&dirname::dirname(RULES, path.bytes())).into())
+  let level = match arguments.get(1) {
+    Some(level) => level_argument(level)?,
+    None => 1,
+  };
+  let mut result: Cow<[u8]> = Cow::Borrowed(path.bytes());
+  for _ in 0..level {
+    let parent = dirname::dirname(RULES, &result);
+    if *parent == *result {
+      // The root ("/", "." or "C:/"), which is its own dirname
+      break;
+    }
+    result = Cow::Owned(parent.into_owned());
+  }
+  if result.is_empty() {
+    // `File.dirname("", 0)` is "." like `File.dirname("")`
+    result = Cow::Borrowed(b".");
+  }
+  Ok(path.to_ruby(&result).into())
+}
+
+// The `level` argument of `File.dirname`, converted like Ruby's `NUM2INT`.
+fn level_argument(object: &AnyObject) -> Result<usize, AnyException> {
+  let integer = match object.try_convert_to::<Integer>() {
+    Ok(integer) => integer,
+    Err(_) => {
+      let responds = object.protect_send("respond_to?", &[Symbol::new("to_int").into()])?;
+      if !responds.value().is_true() {
+        let class_name = object.protect_send("class", &[]).ok().and_then(|class| inspect(&class).ok()).unwrap_or_default();
+        return Err(error(&Class::type_error(), &format!("no implicit conversion of {} into Integer", class_name)));
+      }
+      let converted = object.protect_send("to_int", &[])?;
+      converted.try_convert_to::<Integer>()?
+    }
+  };
+  let level = integer.to_i64();
+  if level < 0 {
+    return Err(argument_error(&format!("negative level: {}", level)));
+  }
+  Ok(level as usize)
 }
 
 // Returns an array of `String`s
@@ -315,7 +355,7 @@ fn system_call_error(err: &io::Error, path: &AnyObject, func: &str) -> AnyExcept
   #[cfg(unix)]
   {
     if let Some(errno) = err.raw_os_error() {
-      let arguments = [path.clone(), rutie::Integer::new(errno.into()).into(), RString::new_utf8(func).into()];
+      let arguments = [path.clone(), Integer::new(errno.into()).into(), RString::new_utf8(func).into()];
       if let Ok(exception) = Class::system_call_error().protect_send("new", &arguments) {
         if let Ok(exception) = exception.try_convert_to::<AnyException>() {
           return exception;

metadata

@@ -1,29 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: faster_path
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Daniel P. Clark
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-07 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '1.12'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '1.12'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -39,19 +24,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '12.3'
 - !ruby/object:Gem::Dependency
-  name: thermite
+  name: rutie
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.13.0
+        version: 0.0.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.13.0
+        version: 0.0.5
 - !ruby/object:Gem::Dependency
   name: read_source
   requirement: !ruby/object:Gem::Requirement
@@ -112,16 +97,30 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.53'
+        version: '1.80'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.80'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.53'
+        version: '1.20'
 - !ruby/object:Gem::Dependency
   name: stop_watch
   requirement: !ruby/object:Gem::Requirement
@@ -155,9 +154,9 @@ files:
 - ext/Rakefile
 - faster_path.gemspec
 - lib/faster_path.rb
+- lib/faster_path/build_task.rb
 - lib/faster_path/optional/monkeypatches.rb
 - lib/faster_path/optional/refinements.rb
-- lib/faster_path/thermite_initialize.rb
 - lib/faster_path/version.rb
 - src/basename.rs
 - src/chop_basename.rs
@@ -177,7 +176,6 @@ homepage: https://github.com/danielpclark/faster_path
 licenses:
 - MIT OR Apache-2.0
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -185,18 +183,17 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '3.2'
   - - "<"
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Reimplementation of Pathname for better performance
 test_files: []

data/lib/faster_path/thermite_initialize.rb

@@ -1,22 +0,0 @@
-require 'rubygems'
-require 'rake/tasklib'
-require_relative './version'
-
-# @private :nodoc:
-module Thermite
-  # @private :nodoc:
-  class Config
-    # @private :nodoc:
-    def ruby_version
-      "ruby#{RUBY_VERSION}"
-    end
-  end
-
-  # @private :nodoc:
-  class Tasks < Rake::TaskLib
-    # @private :nodoc:
-    def github_download_uri(_tag, version)
-      "#{github_uri}/releases/download/v#{FasterPath::VERSION}/#{config.tarball_filename(version)}"
-    end
-  end
-end