win32-xpath 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: a356787d2a824c84435d4e0030d2332bc0e608c7
-  data.tar.gz: aa3c03d68d1cf089ec4cf98e459305d1b23e5f83
+SHA256:
+  metadata.gz: 3a5dc7b8cc4b32f0a194fd62a9c727ab8bed0eebf29b8923ff233de95230830a
+  data.tar.gz: 6259f5d6e3c91df4397946658d38a82c7dd3d3d862680819a15e87b0d3caffca
 SHA512:
-  metadata.gz: 319c66c30e057d2b7dfdc0fd92146981939e8231dc8337d8d6e8232ccc9ec49678de0713ea7ebcd631e33ffa95839b2bd0773c0bf665c6d8a47dd20ef5b57f27
-  data.tar.gz: 3d56bec08b78598926082214bed54e7631147c22e676d0f09fc794d5b05ef919d44263ad0d7a28e456dd426296a5e95c9419b831dcf8aecebce96dd1b09786c1
+  metadata.gz: babfea80ca48c92b191ec5179ebe3088a8f3a0a05b25191f67d1ea1f8ec4a29573dd347236e858ce7cd6a2515cc31729f19e38f4b944a7dba9b5ad93cca5ed81
+  data.tar.gz: 50468708592d798e43fb430eba9061ee40b8a9f01090eaa06095d2bd821fc931f62d09eb95515276bca79116d1509d87fbd719c2fd2d2bfcfdae674727169a98

data/CHANGES.md

@@ -0,0 +1,40 @@
+## 1.2.0 - 9-Jul-2022
+* Convert tests from test-unit to rspec, and update gemspec and Rakefile accordingly.
+
+## 1.1.2 - 8-Aug-2021
+* The relative path directory argument now accepts anything that responds
+  to the to_path method.
+* Now skips taint checking tests on Ruby 2.7+
+* Added a .gitignore file.
+
+## 1.1.1 - 3-Mar-2019
+* Switched RSTRING_PTR to StringValueCStr internally because apparently I
+  I didn't get the memo on null termination changes.
+* Fixed a warning caused by rb_funcall by switching it to rb_funcall2.
+* Fixed a bug where it would try to expand tildes for paths in 8.3 format.
+  Now tildes are only expanded if they are the first character in the path.
+* Updated the cert.
+* Updated the appveyor file to include Ruby 2.3, 2.4 and 2.5.
+* Added a win32-xpath.rb file for convenience.
+
+## 1.1.0 - 11-Jun-2016
+* Changed license to Apache 2.0.
+* Use PathCchXXX functions wherever I could that had not already been
+  put into place.
+* Removed the "futzing" directory and contents.
+* Added an appveyor.yml file.
+
+## 1.0.4 - 26-Nov-2015
+* This gem is now signed.
+
+## 1.0.3 - 3-Jul-2015
+* Use PathCchXXX functions where available to improve long path handling.
+
+## 1.0.2 - 17-Jun-2015
+* Deal with non-standard swprintf issues so that it works with mingw compiler.
+
+## 1.0.1 - 2-Apr-2015
+* Altered internal handling of native C function failures.
+
+## 1.0.0 - 26-Feb-2015
+* Initial release

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,177 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

data/MANIFEST.md

@@ -0,0 +1,14 @@
+* appveyor.yml
+* bench/bench_win32_xpath.rb
+* CHANGES.md
+* certs/djberg96_pub.pem
+* ext/extconf.rb
+* ext/win32/xpath.c
+* Gemfile
+* lib/win32-xpath.rb
+* LICENSE
+* MANIFEST.md
+* Rakefile
+* README.md
+* test/test_win32_xpath.rb
+* win32-xpath.gemspec

data/README.md

@@ -0,0 +1,67 @@
+## Description
+A custom `File.expand_path` method for Ruby on Windows that's much faster and works better.
+
+## Installation
+`gem install win32-xpath`
+
+## Adding the Trusted Cert
+`gem cert --add <(curl -Ls https://raw.githubusercontent.com/djberg96/win32-xpath/main/certs/djberg96_pub.pem)`
+
+## Synopsis
+```ruby
+require 'win32/xpath'
+
+# That's it, you are now using this library when you call File.expand_path
+```
+
+## Features
+* A 5x average performance boost over MRI's current method.
+* Support for ~user expansion.
+
+## Known Issues
+* This library does not support drive-current paths for the 2nd argument.
+* This library does not support alt-stream name autocorrection.
+* This library does not convert short paths to long paths.
+
+It is very unlikely you will ever be affected by any of these things.
+Drive-current paths are a relic of DOS 1.0, but even so this library
+will handle them in the first argument.
+
+I don't support alt-stream mangling because I don't believe it's the
+job of this method to peform autocorrection. Even in MRI it only works
+for the default $DATA stream, and then only for a certain type of
+syntax error. I do not know when or why it was added.
+
+Failure to convert short paths to long paths is irrelevant since that
+has nothing to do with relative versus absolute paths.
+
+One possible "real" issue is that on Windows 7 or earlier you will be
+limited to 260 character paths. This is a limitation of the shlwapi.h
+functions that I use internally.
+
+If you discover any other issues, please report them on the project
+page at https://github.com/djberg96/win32-xpath.
+
+## Mingw and Devkit
+Make sure you have a recent version of the Devkit installed if you're
+using the one-click installer. If you see this warning then you need
+to upgrade your Devkit.
+
+`"implicit declaration of function 'ConvertSidToStringSidW'"`
+
+## Acknowledgements
+Park Heesob for encoding advice and help.
+
+## License
+Apache-2.0
+
+## Copyright
+(C) 2003-2022 Daniel J. Berger, All Rights Reserved
+    
+## Warranty
+This package is provided "as is" and without any express or
+implied warranties, including, without limitation, the implied
+warranties of merchantability and fitness for a particular purpose.
+
+## Author
+Daniel Berger

data/Rakefile

@@ -1,12 +1,13 @@
 require 'rake'
 require 'rake/clean'
-require 'rake/testtask'
 require 'rbconfig'
+require 'rspec/core/rake_task'
 include RbConfig
 
 CLEAN.include(
   '**/*.gem',               # Gem files
   '**/*.rbc',               # Rubinius
+  '**/*.lock',              # Bundler
   '**/*.o',                 # C object file
   '**/*.log',               # Ruby extension build log
   '**/Makefile',            # C Makefile
@@ -35,9 +36,9 @@ namespace :gem do
   desc "Build the win32-xpath gem"
   task :create => [:clean] do
     require 'rubygems/package'
-    spec = eval(IO.read('win32-xpath.gemspec'))
+    spec = Gem::Specification.load('win32-xpath.gemspec')
     spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
-    Gem::Package.build(spec, true)
+    Gem::Package.build(spec)
   end
 
   task "Install the win32-xpath gem"
@@ -47,15 +48,14 @@ namespace :gem do
   end
 end
 
-Rake::TestTask.new do |t|
-  task :test => [:build]
-  t.test_files = FileList['test/*']
-  t.libs << 'ext'
-end
-
 desc "Run benchmarks"
 task :bench => [:build] do
   ruby "-Iext bench/bench_win32_xpath.rb"
 end
 
-task :default => :test
+desc "Run the test suite"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = '-Iext'
+end
+
+task :default => [:build, :spec]

data/appveyor.yml

@@ -2,17 +2,18 @@ version: '{build}'
 branches:
   only:
   - master
+  - appveyor
 skip_tags: true
 environment:
   matrix:
-  - ruby_version: 21
-    ruby_dir: 2.1.0
-  - ruby_version: 21-x64
-    ruby_dir: 2.1.0
-  - ruby_version: 22
-    ruby_dir: 2.2.0
   - ruby_version: 22-x64
     ruby_dir: 2.2.0
+  - ruby_version: 23-x64
+    ruby_dir: 2.3.0
+  - ruby_version: 24-x64
+    ruby_dir: 2.4.0
+  - ruby_version: 25-x64
+    ruby_dir: 2.5.0
 install:
 - ps: >-
     $env:path = "C:\Ruby" + $env:ruby_version + "\bin;" + $env:path
@@ -25,10 +26,10 @@ install:
 
     if ((gem query -i test-unit -v ">= 3.0") -eq $False){ gem install test-unit --no-document }
 cache:
-- C:\Ruby21\lib\ruby\gems\2.1.0
-- C:\Ruby21-x64\lib\ruby\gems\2.1.0
-- C:\Ruby22\lib\ruby\gems\2.2.0
 - C:\Ruby22-x64\lib\ruby\gems\2.2.0
+- C:\Ruby23-x64\lib\ruby\gems\2.3.0
+- C:\Ruby24-x64\lib\ruby\gems\2.4.0
+- C:\Ruby25-x64\lib\ruby\gems\2.5.0
 build: off
 test_script:
 - cmd: rake

data/bench/bench_win32_xpath.rb

@@ -1,6 +1,6 @@
 require 'benchmark'
 
-MAX = 100000
+MAX = 400000
 puts "\nOld File.expand_path"
 
 Benchmark.bm(30) do |x|

data/certs/djberg96_pub.pem

@@ -1,21 +1,26 @@
 -----BEGIN CERTIFICATE-----
-MIIDcDCCAligAwIBAgIBATANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAhkamJl
+MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
 cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
-MB4XDTE1MDkwMjIwNDkxOFoXDTE2MDkwMTIwNDkxOFowPzERMA8GA1UEAwwIZGpi
+MB4XDTE4MDMxODE1MjIwN1oXDTI4MDMxNTE1MjIwN1owPzERMA8GA1UEAwwIZGpi
 ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
-bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMyTkvXqRp6hLs9eoJOS
-Hmi8kRYbq9Vkf15/hMxJpotYMgJVHHWrmDcC5Dye2PbnXjTkKf266Zw0PtT9h+lI
-S3ts9HO+vaCFSMwFFZmnWJSpQ3CNw2RcHxjWkk9yF7imEM8Kz9ojhiDXzBetdV6M
-gr0lV/alUr7TNVBDngbXEfTWscyXh1qd7xZ4EcOdsDktCe5G45N/o3662tPQvJsi
-FOF0CM/KuBsa/HL1/eoEmF4B3EKIRfTHrQ3hu20Kv3RJ88QM4ec2+0dd97uX693O
-zv6981fyEg+aXLkxrkViM/tz2qR2ZE0jPhHTREPYeMEgptRkTmWSKAuLVWrJEfgl
-DtkCAwEAAaN3MHUwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFEwe
-nn6bfJADmuIDiMSOzedOrL+xMB0GA1UdEQQWMBSBEmRqYmVyZzk2QGdtYWlsLmNv
-bTAdBgNVHRIEFjAUgRJkamJlcmc5NkBnbWFpbC5jb20wDQYJKoZIhvcNAQEFBQAD
-ggEBAHmNOCWoDVD75zHFueY0viwGDVP1BNGFC+yXcb7u2GlK+nEMCORqzURbYPf7
-tL+/hzmePIRz7i30UM//64GI1NLv9jl7nIwjhPpXpf7/lu2I9hOTsvwSumb5UiKC
-/sqBxI3sfj9pr79Wpv4MuikX1XPik7Ncb7NPsJPw06Lvyc3Hkg5X2XpPtLtS+Gr2
-wKJnmzb5rIPS1cmsqv0M9LPWflzfwoZ/SpnmhagP+g05p8bRNKjZSA2iImM/GyYZ
-EJYzxdPOrx2n6NYR3Hk+vHP0U7UBSveI6+qx+ndQYaeyCn+GRX2PKS9h66YF/Q1V
-tGSHgAmcLlkdGgan182qsE/4kKM=
+bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBALgfaroVM6CI06cxr0/h
+A+j+pc8fgpRgBVmHFaFunq28GPC3IvW7Nvc3Y8SnAW7pP1EQIbhlwRIaQzJ93/yj
+u95KpkP7tA9erypnV7dpzBkzNlX14ACaFD/6pHoXoe2ltBxk3CCyyzx70mTqJpph
+75IB03ni9a8yqn8pmse+s83bFJOAqddSj009sGPcQO+QOWiNxqYv1n5EHcvj2ebO
+6hN7YTmhx7aSia4qL/quc4DlIaGMWoAhvML7u1fmo53CYxkKskfN8MOecq2vfEmL
+iLu+SsVVEAufMDDFMXMJlvDsviolUSGMSNRTujkyCcJoXKYYxZSNtIiyd9etI0X3
+ctu0uhrFyrMZXCedutvXNjUolD5r9KGBFSWH1R9u2I3n3SAyFF2yzv/7idQHLJJq
+74BMnx0FIq6fCpu5slAipvxZ3ZkZpEXZFr3cIBtO1gFvQWW7E/Y3ijliWJS1GQFq
+058qERadHGu1yu1dojmFRo6W2KZvY9al2yIlbkpDrD5MYQIDAQABo3cwdTAJBgNV
+HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUFZsMapgzJimzsbaBG2Tm8j5e
+AzgwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAW2tnYixXQtKxgGXq
+/3iSWG2bLwvxS4go3srO+aRXZHrFUMlJ5W0mCxl03aazxxKTsVVpZD8QZxvK91OQ
+h9zr9JBYqCLcCVbr8SkmYCi/laxIZxsNE5YI8cC8vvlLI7AMgSfPSnn/Epq1GjGY
+6L1iRcEDtanGCIvjqlCXO9+BmsnCfEVehqZkQHeYczA03tpOWb6pon2wzvMKSsKH
+ks0ApVdstSLz1kzzAqem/uHdG9FyXdbTAwH1G4ZPv69sQAFAOCgAqYmdnzedsQtE
+1LQfaQrx0twO+CZJPcRLEESjq8ScQxWRRkfuh2VeR7cEU7L7KqT10mtUwrvw7APf
+DYoeCY9KyjIBjQXfbj2ke5u1hZj94Fsq9FfbEQg8ygCgwThnmkTrrKEiMSs3alYR
+ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
+WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
 -----END CERTIFICATE-----

data/ext/win32/xpath.c

@@ -201,12 +201,16 @@ static VALUE rb_xpath(int argc, VALUE* argv, VALUE self){
   rb_scan_args(argc, argv, "11", &v_path_orig, &v_dir_orig);
 
   if (rb_respond_to(v_path_orig, rb_intern("to_path")))
-    v_path_orig = rb_funcall(v_path_orig, rb_intern("to_path"), 0, NULL);
+    v_path_orig = rb_funcall2(v_path_orig, rb_intern("to_path"), 0, NULL);
 
   SafeStringValue(v_path_orig);
 
-  if (!NIL_P(v_dir_orig))
+  if (!NIL_P(v_dir_orig)){
+    if (rb_respond_to(v_dir_orig, rb_intern("to_path")))
+      v_dir_orig = rb_funcall2(v_dir_orig, rb_intern("to_path"), 0, NULL);
+
     SafeStringValue(v_dir_orig);
+  }
 
   // Dup and prep string for modification
   path_encoding = rb_enc_get(v_path_orig);
@@ -223,10 +227,10 @@ static VALUE rb_xpath(int argc, VALUE* argv, VALUE self){
   rb_str_modify_expand(v_path, MAX_WPATH);
 
   // Make our path a wide string for later functions
-  length = MultiByteToWideChar(CP_UTF8, 0, RSTRING_PTR(v_path), -1, NULL, 0);
+  length = MultiByteToWideChar(CP_UTF8, 0, StringValueCStr(v_path), -1, NULL, 0);
   path = (wchar_t*)ruby_xmalloc(length * sizeof(wchar_t));
 
-  if(!MultiByteToWideChar(CP_UTF8, 0, RSTRING_PTR(v_path), -1, path, length)){
+  if(!MultiByteToWideChar(CP_UTF8, 0, StringValueCStr(v_path), -1, path, length)){
     ruby_xfree(path);
     rb_raise_syserr("MultibyteToWideChar", GetLastError());
   }
@@ -235,8 +239,8 @@ static VALUE rb_xpath(int argc, VALUE* argv, VALUE self){
   while(wcsstr(path, L"/"))
     path[wcscspn(path, L"/")] = L'\\';
 
-  // Handle ~ expansion.
-  if (ptr = wcschr(path, L'~')){
+  // Handle ~ expansion if first character.
+  if ( (ptr = wcschr(path, L'~')) && ((int)(ptr - path) == 0) ){
     wchar_t* home;
 
     // Handle both ~/user and ~user syntax
@@ -291,10 +295,10 @@ static VALUE rb_xpath(int argc, VALUE* argv, VALUE self){
     // Prep string for modification
     rb_str_modify_expand(v_dir, MAX_WPATH);
 
-    length = MultiByteToWideChar(CP_UTF8, 0, RSTRING_PTR(v_dir), -1, NULL, 0);
+    length = MultiByteToWideChar(CP_UTF8, 0, StringValueCStr(v_dir), -1, NULL, 0);
     dir = (wchar_t*)ruby_xmalloc(MAX_WPATH * sizeof(wchar_t));
 
-    if (!MultiByteToWideChar(CP_UTF8, 0, RSTRING_PTR(v_dir), -1, dir, length)){
+    if (!MultiByteToWideChar(CP_UTF8, 0, StringValueCStr(v_dir), -1, dir, length)){
       ruby_xfree(dir);
       rb_raise_syserr("MultibyteToWideChar", GetLastError());
     }
@@ -302,7 +306,8 @@ static VALUE rb_xpath(int argc, VALUE* argv, VALUE self){
     while (wcsstr(dir, L"/"))
       dir[wcscspn(dir, L"/")] = L'\\';
 
-    if (ptr = wcschr(dir, L'~')){
+    // Check for tilde in first character
+    if ( (ptr = wcschr(dir, L'~')) && ((int)(ptr - dir) == 0) ){
       if (ptr[1] && ptr[1] != L'\\'){
         dir = find_user(++ptr);
       }

data/lib/win32-xpath.rb

@@ -0,0 +1 @@
+require 'win32/xpath'

data/spec/win32_xpath_spec.rb

@@ -0,0 +1,213 @@
+require 'rspec'
+require 'tmpdir'
+require 'win32/xpath'
+require 'etc'
+
+RSpec.describe 'win32-xpath' do  
+  let!(:login) { Etc.getlogin }
+  let!(:env){ ENV.to_h }
+
+  before do
+    @pwd = Dir.pwd
+    @tmp = 'C:/Temp'
+    @root =  'C:/'
+    @drive = env['HOMEDRIVE']
+    @home = env['HOME'].tr('\\', '/')
+    @unc = "//foo/bar"
+    ENV['HOME'] = env['USERPROFILE'] || Dir.home
+  end
+
+  after do
+    ENV.replace(env)
+  end
+
+  example "converts an empty pathname into absolute current pathname" do
+    expect(File.expand_path('')).to eq(@pwd)
+  end
+
+  example "converts '.' into absolute pathname using current directory" do
+    expect(File.expand_path('.')).to eq(@pwd)
+  end
+
+  example "converts relative path into absolute pathname using current directory" do
+    expect(File.expand_path('foo')).to eq(File.join(@pwd, 'foo'))
+  end
+
+  example "converts relative path into absolute pathname ignoring nil dir" do
+    expect(File.expand_path('foo', nil)).to eq(File.join(@pwd, 'foo'))
+  end
+
+  example "converts relative path and directory into the expected absolute pathname" do
+    expect(File.expand_path('foo', 'bar')).to eq(File.join(@pwd, 'bar', 'foo'))
+  end
+
+  example "converts relative edge case pathnames into absolute pathnames" do
+    expect(File.expand_path('a.')).to eq(File.join(@pwd, 'a'))
+    expect(File.expand_path('.a')).to eq(File.join(@pwd, '.a'))
+    expect(File.expand_path('..a')).to eq(File.join(@pwd, '..a'))
+    expect(File.expand_path('a../b')).to eq(File.join(@pwd, 'a../b'))
+  end
+
+  example "converts a double dot pathname into the expected absolute pathname" do
+    expect( File.expand_path('a..')).to eq(File.join(@pwd, 'a'))
+  end
+
+  example "converts a pathname to an absolute pathname using a complete path" do
+    expect(File.expand_path('', @tmp)).to eq(@tmp)
+    expect(File.expand_path('a', @tmp)).to eq(File.join(@tmp, 'a'))
+    expect(File.expand_path('../a', "#{@tmp}/xxx")).to eq(File.join(@tmp, 'a'))
+    expect(File.expand_path('.', @root)).to eq(@root)
+  end
+
+  example "ignores supplied dir if path contains a drive letter" do
+    expect(File.expand_path(@root, "D:/")).to eq(@root)
+  end
+
+  example "removes trailing slashes from absolute path" do
+    expect(File.expand_path("#{@root}foo/")).to eq(File.join(@root, 'foo'))
+    expect(File.expand_path("#{@root}foo.rb/")).to eq(File.join(@root, 'foo.rb'))
+  end
+
+  example "removes trailing slashes from relative path" do
+    expect(File.expand_path("foo/")).to eq(File.join(@pwd, 'foo'))
+    expect(File.expand_path("foo//")).to eq(File.join(@pwd, 'foo'))
+    expect(File.expand_path("foo\\\\\\")).to eq(File.join(@pwd, 'foo'))
+  end
+
+  example "removes trailing spaces from absolute path" do
+    expect(File.expand_path("#{@root}foo  ")).to eq(File.join(@root, 'foo'))
+  end
+
+  example "removes trailing dots from absolute path" do
+    expect(File.expand_path("#{@root}a.")).to eq(File.join(@root, 'a'))
+  end
+
+  example "converts a pathname with a drive letter but no slash" do
+    expect(File.expand_path("c:")).to match(/\Ac:\//i)
+  end
+
+  example "converts a pathname with a drive letter ignoring different drive dir" do
+    expect(File.expand_path("c:foo", "d:/bar")).to match(/\Ac:\//i)
+  end
+
+  example "converts a pathname which starts with a slash using current drive" do
+    expect(File.expand_path('/foo')).to match(/\A#{@drive}\/foo\z/i)
+  end
+
+  example "returns tainted strings or not" do
+    skip "Skipping on Ruby 2.7+" if RUBY_VERSION.to_f >= 2.7
+    expect(File.expand_path('foo').tainted?).to be true
+    expect(File.expand_path('foo'.taint).tainted?).to be true
+    expect(File.expand_path('/foo').tainted?).to be true
+    expect(File.expand_path('/foo'.taint).tainted?).to be true
+    expect(File.expand_path('C:/foo'.taint).tainted?).to be true
+    expect(File.expand_path('C:/foo').tainted?).to be false
+    expect(File.expand_path('//foo').tainted?).to be false
+  end
+
+  example "converts a pathname to an absolute pathname using tilde as base" do
+    expect(File.expand_path('~')).to eq(@home)
+    expect(File.expand_path('~/foo')).to eq("#{@home}/foo")
+    expect(File.expand_path('~/.foo')).to eq("#{@home}/.foo")
+  end
+
+  example "converts a pathname to an absolute pathname using tilde for UNC path" do
+    ENV['HOME'] = @unc
+    expect(File.expand_path('~')).to eq(@unc)
+  end
+
+  example "converts a tilde to path if used for dir argument" do
+    expect(File.expand_path('', '~')).to eq(@home)
+    expect(File.expand_path('', '~/foo')).to eq("#{@home}/foo")
+    expect(File.expand_path('foo', '~')).to eq("#{@home}/foo")
+  end
+
+  example "doesn't attempt to expand a tilde unless it's the first character" do
+    expect(File.expand_path("C:/Progra~1")).to eq("C:/Progra~1")
+    expect(File.expand_path("C:/Progra~1", "C:/Progra~1")).to eq("C:/Progra~1")
+  end
+
+  example "does not modify a HOME string argument" do
+    str = "~/a"
+    expect(File.expand_path(str)).to eq("#{@home}/a")
+    expect(str).to eq("~/a")
+  end
+
+  example "defaults to HOMEDRIVE + HOMEPATH if HOME or USERPROFILE are nil" do
+    ENV['HOME'] = nil  
+    ENV['USERPROFILE'] = nil
+    ENV['HOMEDRIVE'] = "C:"
+    ENV['HOMEPATH'] = "\\Users\\foo"
+    expect(File.expand_path("~/bar")).to eq("C:/Users/foo/bar")
+  end
+
+  example "raises ArgumentError when HOME is nil" do
+    ENV['HOME'] = nil
+    ENV['USERPROFILE'] = nil
+    ENV['HOMEDRIVE'] = nil
+    expect{ File.expand_path('~') }.to raise_error(ArgumentError)
+  end
+
+  example "raises ArgumentError if HOME is relative" do
+    ENV['HOME'] = '.'
+    expect{ File.expand_path('~') }.to raise_error(ArgumentError)
+  end
+
+  example "raises ArgumentError if relative HOME path with tilde + user is provided" do
+    ENV['HOME'] = 'whatever'
+    expect{ File.expand_path('~anything') }.to raise_error(ArgumentError)
+  end
+
+  example "raises an ArgumentError if a bogus username is supplied" do
+    expect{ File.expand_path('~anything') }.to raise_error(ArgumentError)
+  end
+
+  example "converts a tilde plus username as expected" do
+    expect(File.expand_path("~#{login}")).to eq("C:/Users/#{login}")
+    expect(File.expand_path("~#{login}/foo")).to eq("C:/Users/#{login}/foo")
+  end
+
+  example "raises a TypeError if not passed a string" do
+    expect{ File.expand_path(1) }.to raise_error(TypeError)
+    expect{ File.expand_path(nil) }.to raise_error(TypeError)
+    expect{ File.expand_path(true) }.to raise_error(TypeError)
+  end
+
+  example "canonicalizes absolute path" do
+    expect(File.expand_path("C:/./dir")).to eq("C:/dir")
+  end
+
+  example "does not modify its argument" do
+    str = "./a/b/../c"
+    expect(File.expand_path(str, @home)).to eq("#{@home}/a/c")
+    expect(str).to eq("./a/b/../c")
+  end
+
+  example "accepts objects that have a to_path method" do
+    klass = Class.new{ def to_path; "a/b/c"; end }
+    obj = klass.new
+    expect(File.expand_path(obj)).to eq("#{@pwd}/a/b/c")
+  end
+
+  example "accepts objects that have a to_path method for relative dir argument" do
+    klass = Class.new{ def to_path; "bar"; end }
+    obj = klass.new
+    expect(File.expand_path('foo', obj)).to eq("#{@pwd}/bar/foo")
+  end
+
+  example "works with unicode characters" do
+    expect( File.expand_path("Ελλάσ")).to eq("#{@pwd}/Ελλάσ")
+  end
+
+  # The +1 below is for the slash trailing @pwd that's appended.
+  example "handles paths longer than 260 (MAX_PATH) characters" do
+    expect{ File.expand_path("a" * 261) }.not_to raise_error
+    expect{ File.expand_path("a" * 1024) }.not_to raise_error
+    expect(File.expand_path("a" * 1024).size).to eq(@pwd.size + 1024 + 1)
+  end
+
+  example "handles very long paths with tilde" do
+    path = "a * 1024"
+    expect{ File.expand_path("~/#{path}") }.not_to raise_error
+  end
+end

data/win32-xpath.gemspec

@@ -2,21 +2,29 @@ require 'rubygems'
 
 Gem::Specification.new do |spec|
   spec.name       = 'win32-xpath'
-  spec.version    = '1.1.0'
+  spec.version    = '1.2.0'
   spec.author     = 'Daniel J. Berger'
-  spec.license    = 'Apache 2.0'
+  spec.license    = 'Apache-2.0'
   spec.email      = 'djberg96@gmail.com'
   spec.homepage   = 'http://github.com/djberg96/win32-xpath'
   spec.summary    = 'Revamped File.expand_path for Windows'
-  spec.test_file  = 'test/test_win32_xpath.rb'
+  spec.test_file  = 'spec/win32_xpath_spec.rb'
   spec.files      = Dir['**/*'].reject{ |f| f.include?('git') }
   spec.cert_chain = Dir['certs/*']
 
-  spec.extra_rdoc_files  = ['README', 'CHANGES', 'MANIFEST']
-
   spec.extensions = ['ext/extconf.rb']
   spec.add_development_dependency('rake')
-  spec.add_development_dependency('test-unit', '>= 3.0.0')
+  spec.add_development_dependency('rspec', '~> 3.11')
+
+  spec.metadata = {
+    'homepage_uri'          => 'https://github.com/djberg96/win32-xpath',
+    'bug_tracker_uri'       => 'https://github.com/djberg96/win32-xpath/issues',
+    'changelog_uri'         => 'https://github.com/djberg96/win32-xpath/blob/main/CHANGES.md',
+    'documentation_uri'     => 'https://github.com/djberg96/win32-xpath/wiki',
+    'source_code_uri'       => 'https://github.com/djberg96/win32-xpath',
+    'wiki_uri'              => 'https://github.com/djberg96/win32-xpath/wiki',
+    'rubygems_mfa_required' => 'true'
+  }
 
   spec.description = <<-EOF
     The win32-xpath library provides a revamped File.expand_path method

metadata

@@ -1,36 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: win32-xpath
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Daniel J. Berger
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIDcDCCAligAwIBAgIBATANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAhkamJl
+  MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
   cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
-  MB4XDTE1MDkwMjIwNDkxOFoXDTE2MDkwMTIwNDkxOFowPzERMA8GA1UEAwwIZGpi
+  MB4XDTE4MDMxODE1MjIwN1oXDTI4MDMxNTE1MjIwN1owPzERMA8GA1UEAwwIZGpi
   ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
-  bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMyTkvXqRp6hLs9eoJOS
-  Hmi8kRYbq9Vkf15/hMxJpotYMgJVHHWrmDcC5Dye2PbnXjTkKf266Zw0PtT9h+lI
-  S3ts9HO+vaCFSMwFFZmnWJSpQ3CNw2RcHxjWkk9yF7imEM8Kz9ojhiDXzBetdV6M
-  gr0lV/alUr7TNVBDngbXEfTWscyXh1qd7xZ4EcOdsDktCe5G45N/o3662tPQvJsi
-  FOF0CM/KuBsa/HL1/eoEmF4B3EKIRfTHrQ3hu20Kv3RJ88QM4ec2+0dd97uX693O
-  zv6981fyEg+aXLkxrkViM/tz2qR2ZE0jPhHTREPYeMEgptRkTmWSKAuLVWrJEfgl
-  DtkCAwEAAaN3MHUwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFEwe
-  nn6bfJADmuIDiMSOzedOrL+xMB0GA1UdEQQWMBSBEmRqYmVyZzk2QGdtYWlsLmNv
-  bTAdBgNVHRIEFjAUgRJkamJlcmc5NkBnbWFpbC5jb20wDQYJKoZIhvcNAQEFBQAD
-  ggEBAHmNOCWoDVD75zHFueY0viwGDVP1BNGFC+yXcb7u2GlK+nEMCORqzURbYPf7
-  tL+/hzmePIRz7i30UM//64GI1NLv9jl7nIwjhPpXpf7/lu2I9hOTsvwSumb5UiKC
-  /sqBxI3sfj9pr79Wpv4MuikX1XPik7Ncb7NPsJPw06Lvyc3Hkg5X2XpPtLtS+Gr2
-  wKJnmzb5rIPS1cmsqv0M9LPWflzfwoZ/SpnmhagP+g05p8bRNKjZSA2iImM/GyYZ
-  EJYzxdPOrx2n6NYR3Hk+vHP0U7UBSveI6+qx+ndQYaeyCn+GRX2PKS9h66YF/Q1V
-  tGSHgAmcLlkdGgan182qsE/4kKM=
+  bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBALgfaroVM6CI06cxr0/h
+  A+j+pc8fgpRgBVmHFaFunq28GPC3IvW7Nvc3Y8SnAW7pP1EQIbhlwRIaQzJ93/yj
+  u95KpkP7tA9erypnV7dpzBkzNlX14ACaFD/6pHoXoe2ltBxk3CCyyzx70mTqJpph
+  75IB03ni9a8yqn8pmse+s83bFJOAqddSj009sGPcQO+QOWiNxqYv1n5EHcvj2ebO
+  6hN7YTmhx7aSia4qL/quc4DlIaGMWoAhvML7u1fmo53CYxkKskfN8MOecq2vfEmL
+  iLu+SsVVEAufMDDFMXMJlvDsviolUSGMSNRTujkyCcJoXKYYxZSNtIiyd9etI0X3
+  ctu0uhrFyrMZXCedutvXNjUolD5r9KGBFSWH1R9u2I3n3SAyFF2yzv/7idQHLJJq
+  74BMnx0FIq6fCpu5slAipvxZ3ZkZpEXZFr3cIBtO1gFvQWW7E/Y3ijliWJS1GQFq
+  058qERadHGu1yu1dojmFRo6W2KZvY9al2yIlbkpDrD5MYQIDAQABo3cwdTAJBgNV
+  HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUFZsMapgzJimzsbaBG2Tm8j5e
+  AzgwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+  YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAW2tnYixXQtKxgGXq
+  /3iSWG2bLwvxS4go3srO+aRXZHrFUMlJ5W0mCxl03aazxxKTsVVpZD8QZxvK91OQ
+  h9zr9JBYqCLcCVbr8SkmYCi/laxIZxsNE5YI8cC8vvlLI7AMgSfPSnn/Epq1GjGY
+  6L1iRcEDtanGCIvjqlCXO9+BmsnCfEVehqZkQHeYczA03tpOWb6pon2wzvMKSsKH
+  ks0ApVdstSLz1kzzAqem/uHdG9FyXdbTAwH1G4ZPv69sQAFAOCgAqYmdnzedsQtE
+  1LQfaQrx0twO+CZJPcRLEESjq8ScQxWRRkfuh2VeR7cEU7L7KqT10mtUwrvw7APf
+  DYoeCY9KyjIBjQXfbj2ke5u1hZj94Fsq9FfbEQg8ygCgwThnmkTrrKEiMSs3alYR
+  ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
+  WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
   -----END CERTIFICATE-----
-date: 2016-06-12 00:00:00.000000000 Z
+date: 2022-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -47,19 +52,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: test-unit
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: '3.11'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: '3.11'
 description: |2
       The win32-xpath library provides a revamped File.expand_path method
       for MS Windows. It is significantly faster, and supports ~user
@@ -68,32 +73,34 @@ email: djberg96@gmail.com
 executables: []
 extensions:
 - ext/extconf.rb
-extra_rdoc_files:
-- README
-- CHANGES
-- MANIFEST
+extra_rdoc_files: []
 files:
+- CHANGES.md
+- Gemfile
+- LICENSE
+- MANIFEST.md
+- README.md
+- Rakefile
 - appveyor.yml
-- bench
 - bench/bench_win32_xpath.rb
-- certs
 - certs/djberg96_pub.pem
-- CHANGES
-- ext
 - ext/extconf.rb
-- ext/win32
 - ext/win32/xpath.c
-- MANIFEST
-- Rakefile
-- README
-- test
-- test/test_win32_xpath.rb
+- lib/win32-xpath.rb
+- spec/win32_xpath_spec.rb
 - win32-xpath.gemspec
 homepage: http://github.com/djberg96/win32-xpath
 licenses:
-- Apache 2.0
-metadata: {}
-post_install_message: 
+- Apache-2.0
+metadata:
+  homepage_uri: https://github.com/djberg96/win32-xpath
+  bug_tracker_uri: https://github.com/djberg96/win32-xpath/issues
+  changelog_uri: https://github.com/djberg96/win32-xpath/blob/main/CHANGES.md
+  documentation_uri: https://github.com/djberg96/win32-xpath/wiki
+  source_code_uri: https://github.com/djberg96/win32-xpath
+  wiki_uri: https://github.com/djberg96/win32-xpath/wiki
+  rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -108,10 +115,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.4
-signing_key: 
+rubygems_version: 3.3.17
+signing_key:
 specification_version: 4
 summary: Revamped File.expand_path for Windows
 test_files:
-- test/test_win32_xpath.rb
+- spec/win32_xpath_spec.rb

data/CHANGES

@@ -1,21 +0,0 @@
-= 1.1.0 - 11-Jun-2016
-* Changed license to Apache 2.0.
-* Use PathCchXXX functions wherever I could that had not already been
-  put into place.
-* Removed the "futzing" directory and contents.
-* Added an appveyor.yml file.
-
-= 1.0.4 - 26-Nov-2015
-* This gem is now signed.
-
-= 1.0.3 - 3-Jul-2015
-* Use PathCchXXX functions where available to improve long path handling.
-
-= 1.0.2 - 17-Jun-2015
-* Deal with non-standard swprintf issues so that it works with mingw compiler.
-
-= 1.0.1 - 2-Apr-2015
-* Altered internal handling of native C function failures.
-
-= 1.0.0 - 26-Feb-2015
-* Initial release

data/MANIFEST

@@ -1,10 +0,0 @@
-appveyor.yml
-bench/bench_win32_xpath.rb
-CHANGES
-certs/djberg96_pub.pem
-ext/extconf.rb
-ext/win32/xpath.c
-Rakefile
-README
-test/test_win32_xpath.rb
-win32-xpath.gemspec

data/README

@@ -1,59 +0,0 @@
-= Description
-  A custom File.expand_path method for Ruby on Windows that's much
-  faster and works better.
-
-= Installation
-  gem install win32-xpath
-
-= Synopsis
-  require 'win32/xpath'
-
-  # That's it, you are now using this library when you call File.expand_path
-
-= Features
-  * A 5x average performance boost over MRI's current method.
-  * Support for ~user expansion.
-
-= Known Issues
-  * This library does not support drive-current paths for the 2nd argument.
-  * This library does not support alt-stream name autocorrection.
-
-  It is very unlikely you will ever be affected by either of these things.
-  Drive-current paths are a relic of DOS 1.0, but even so this library
-  will handle them in the first argument.
-
-  I don't support alt-stream mangling because I don't believe it's the
-  job of this method to peform autocorrection. Even in MRI it only works
-  for the default $DATA stream, and then only for a certain type of
-  syntax error. I do not know when or why it was added.
-
-  One possible "real" issue is that on Windows 7 or earlier you will be
-  limited to 260 character paths. This is a limitation of the shlwapi.h
-  functions that I use internally.
-
-  If you discover any other issues, please report them on the project
-  page at https://github.com/djberg96/win32-xpath.
-
-= Mingw and Devkit
-  Make sure you have a recent version of the Devkit installed if you're
-  using the one-click installer. If you see this warning then you need
-  to upgrade your Devkit.
-
-  "implicit declaration of function 'ConvertSidToStringSidW'"
-
-= Acknowledgements
-  Park Heesob for encoding advice and help.
-
-== License
-  Apache 2.0
-
-== Copyright
-  (C) 2003-2016 Daniel J. Berger, All Rights Reserved
-    
-== Warranty
-  This package is provided "as is" and without any express or
-  implied warranties, including, without limitation, the implied
-  warranties of merchantability and fitness for a particular purpose.
-
-= Author
-  Daniel Berger

data/test/test_win32_xpath.rb

@@ -1,212 +0,0 @@
-require 'test-unit'
-require 'tmpdir'
-require 'win32/xpath'
-require 'etc'
-
-class Test_XPath < Test::Unit::TestCase
-  def self.startup
-    ENV['HOME'] ||= ENV['USERPROFILE']
-    @@login = Etc.getlogin
-  end
-
-  def setup
-    @pwd = Dir.pwd
-    @tmp = Dir.tmpdir
-    @root =  'C:/'
-    @drive = ENV['HOMEDRIVE']
-    @home = ENV['HOME'].tr('\\', '/')
-    @unc = "//foo/bar"
-  end
-
-  test "converts an empty pathname into absolute current pathname" do
-    assert_equal(@pwd, File.expand_path(''))
-  end
-
-  test "converts '.' into absolute pathname using current directory" do
-    assert_equal(@pwd, File.expand_path('.'))
-  end
-
-  test "converts 'foo' into absolute pathname using current directory" do
-    assert_equal(File.join(@pwd, 'foo'), File.expand_path('foo'))
-  end
-
-  test "converts 'foo' into absolute pathname ignoring nil dir" do
-    assert_equal(File.join(@pwd, 'foo'), File.expand_path('foo', nil))
-  end
-
-  test "converts 'foo' and 'bar' into absolute pathname" do
-    assert_equal(File.join(@pwd, "bar", "foo"), File.expand_path('foo', 'bar'))
-  end
-
-  test "converts a pathname into absolute pathname" do
-    assert_equal(File.join(@pwd, 'a'), File.expand_path('a.'))
-    assert_equal(File.join(@pwd, '.a'), File.expand_path('.a'))
-    assert_equal(File.join(@pwd, '..a'), File.expand_path('..a'))
-    assert_equal(File.join(@pwd, 'a../b'), File.expand_path('a../b'))
-  end
-
-  test "converts a pathname and make it valid" do
-    assert_equal(File.join(@pwd, 'a'), File.expand_path('a..'))
-  end
-
-  test "converts a pathname to an absolute pathname using a complete path" do
-    assert_equal(@tmp, File.expand_path('', @tmp))
-    assert_equal(File.join(@tmp, 'a'), File.expand_path('a', @tmp))
-    assert_equal(File.join(@tmp, 'a'), File.expand_path('../a', "#{@tmp}/xxx"))
-    assert_equal(@root, File.expand_path('.', @root))
-  end
-
-  test "ignores supplied dir if path contains a drive letter" do
-    assert_equal(@root, File.expand_path(@root, "D:/"))
-  end
-
-  test "removes trailing slashes from absolute path" do
-    assert_equal(File.join(@root, 'foo'), File.expand_path("#{@root}foo/"))
-    assert_equal(File.join(@root, 'foo.rb'), File.expand_path("#{@root}foo.rb/"))
-  end
-
-  test "removes trailing slashes from relative path" do
-    assert_equal(File.join(@pwd, 'foo'), File.expand_path("foo/"))
-    assert_equal(File.join(@pwd, 'foo'), File.expand_path("foo//"))
-    assert_equal(File.join(@pwd, 'foo'), File.expand_path("foo\\\\\\"))
-  end
-
-  test "removes trailing spaces from absolute path" do
-    assert_equal(File.join(@root, 'foo'), File.expand_path("#{@root}foo  "))
-  end
-
-  test "removes trailing dots from absolute path" do
-    assert_equal(File.join(@root, 'a'), File.expand_path("#{@root}a."))
-  end
-
-  test "converts a pathname with a drive letter but no slash" do
-    assert_match(/\Ac:\//i, File.expand_path("c:"))
-  end
-
-  test "converts a pathname with a drive letter ignoring different drive dir" do
-    assert_match(/\Ac:\//i, File.expand_path("c:foo", "d:/bar"))
-  end
-
-  test "converts a pathname which starts with a slash using current drive" do
-    assert_match(/\A#{@drive}\/foo\z/i, File.expand_path('/foo'))
-  end
-
-  test "returns tainted strings or not" do
-    assert_true(File.expand_path('foo').tainted?)
-    assert_true(File.expand_path('foo'.taint).tainted?)
-    assert_true(File.expand_path('/foo').tainted?)
-    assert_true(File.expand_path('/foo'.taint).tainted?)
-    assert_true(File.expand_path('C:/foo'.taint).tainted?)
-    assert_false(File.expand_path('C:/foo').tainted?)
-    assert_false(File.expand_path('//foo').tainted?)
-  end
-
-  test "converts a pathname to an absolute pathname using tilde as base" do
-    assert_equal(@home, File.expand_path('~'))
-    assert_equal("#{@home}/foo", File.expand_path('~/foo'))
-    assert_equal("#{@home}/.foo", File.expand_path('~/.foo'))
-  end
-
-  test "converts a pathname to an absolute pathname using tilde for UNC path" do
-    ENV['HOME'] = @unc
-    assert_equal(@unc, File.expand_path('~'))
-  end
-
-  test "converts a tilde to path if used for dir argument" do
-    assert_equal(@home, File.expand_path('', '~'))
-    assert_equal("#{@home}/foo", File.expand_path('', '~/foo'))
-    assert_equal("#{@home}/foo", File.expand_path('foo', '~'))
-  end
-
-  test "does not modify a HOME string argument" do
-    str = "~/a"
-    assert_equal("#{@home}/a", File.expand_path(str))
-    assert_equal("~/a", str)
-  end
-
-  test "defaults to HOMEDRIVE + HOMEPATH if HOME or USERPROFILE are nil" do
-    ENV['HOME'] = nil
-    ENV['USERPROFILE'] = nil
-    ENV['HOMEDRIVE'] = "C:"
-    ENV['HOMEPATH'] = "\\Users\\foo"
-    assert_equal("C:/Users/foo/bar", File.expand_path("~/bar"))
-  end
-
-  test "raises ArgumentError when HOME is nil" do
-    ENV['HOME'] = nil
-    ENV['USERPROFILE'] = nil
-    ENV['HOMEDRIVE'] = nil
-    assert_raise(ArgumentError){ File.expand_path('~') }
-  end
-
-  test "raises ArgumentError if HOME is relative" do
-    ENV['HOME'] = '.'
-    assert_raise(ArgumentError){ File.expand_path('~') }
-  end
-
-  test "raises ArgumentError if relative user is provided" do
-    ENV['HOME'] = '.'
-    assert_raise(ArgumentError){ File.expand_path('~anything') }
-  end
-
-  test "raises an ArgumentError if a bogus username is supplied" do
-    assert_raise(ArgumentError){ File.expand_path('~anything') }
-  end
-
-  test "converts a tilde plus username as expected" do
-    assert_equal("C:/Users/#{@@login}", File.expand_path("~#{@@login}"))
-    assert_equal("C:/Users/#{@@login}/foo", File.expand_path("~#{@@login}/foo"))
-  end
-
-  test "raises a TypeError if not passed a string" do
-    assert_raise(TypeError){ File.expand_path(1) }
-    assert_raise(TypeError){ File.expand_path(nil) }
-    assert_raise(TypeError){ File.expand_path(true) }
-  end
-
-  test "canonicalizes absolute path" do
-    assert_equal("C:/dir", File.expand_path("C:/./dir"))
-  end
-
-  test "does not modify its argument" do
-    str = "./a/b/../c"
-    assert_equal("#{@home}/a/c", File.expand_path(str, @home))
-    assert_equal("./a/b/../c", str)
-  end
-
-  test "accepts objects that have a to_path method" do
-    klass = Class.new{ def to_path; "a/b/c"; end }
-    obj = klass.new
-    assert_equal("#{@pwd}/a/b/c", File.expand_path(obj))
-  end
-
-  test "works with unicode characters" do
-    assert_equal("#{@pwd}/Ελλάσ", File.expand_path("Ελλάσ"))
-  end
-
-  # The +1 below is for the slash trailing @pwd that's appended.
-  test "handles paths longer than 260 (MAX_PATH) characters" do
-    assert_nothing_raised{ File.expand_path("a" * 261) }
-    assert_nothing_raised{ File.expand_path("a" * 1024) }
-    assert_equal(@pwd.size + 1024 + 1, File.expand_path("a" * 1024).size)
-  end
-
-  test "handles very long paths with tilde" do
-    path = "a * 1024"
-    assert_nothing_raised{ File.expand_path("~/#{path}") }
-  end
-
-  def teardown
-    @pwd = nil
-    @unc = nil
-    @dir = nil
-    @root = nil
-    @drive = nil
-
-    ENV['HOME'] = @home
-  end
-
-  def self.shutdown
-    @@login = nil
-  end
-end