file-temp 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d67d648a504230473821894fe46b2a1cc1a620a446f56ddf5403948d897ec11
-  data.tar.gz: 20f597de400fbb8fc80303a15f8565407797ae55cc4fd2d8f10e5bde193a69ea
+  metadata.gz: ce8a520c1d613ad4044a606a3c261c6cd385cbc23c88e51b365584a36c3b24a5
+  data.tar.gz: 4ea26edf5dbb7b5b99defd3ebc07eba370be758dcf81b0f9cfa0aa8c2ddb186a
 SHA512:
-  metadata.gz: a5c7833e5672b2cfa8a2809c3d47d134a9230ae9c8442de88b46b8b7c7eb9ebccf598b5e3f9e5b116fa5d1b77094cc31b63c538a65bb338153242baebd44b070
-  data.tar.gz: a0da5760dfdb59be495b1292eac93315c8de30ccb0c8a7c98c976f1028757bfde8cb6c09a47adc26ca0ac556b0690b5d2190f50272989308a4ec1e4551b3ad34
+  metadata.gz: 94e3bb9b16f1d4ee0eb582dc8e4e58d4e1d5fab1fd5ac8659abc261a60027176b24f7c5b6dd344499dd1557ef7af594c8e0326fb62b841bf4bafeafb7dd3a7a0
+  data.tar.gz: 9cc54ec10d6a437a4fc41cb7ac0cbbc2436f8673ffde4b5a48cff844a9a369d66df60174c3856fc060b11ef3cec10883b4168528f80b341e285ee9d920cb4b52

data/{CHANGES → CHANGES.rdoc}

@@ -1,3 +1,11 @@
+= 1.5.0 - 8-May-2020
+* Switched to keyword arguments.
+* Added the ability to specify a tmp directory.
+* Updates to the JRuby version, removed some code that no longer worked, and
+  added support for specifying your own directory.
+* Added a LICENSE file to the distro as part of the Apache-2.0 requirement.
+* Added explicit .rdoc extensions to the README, CHANGES and MANIFEST files.
+
 = 1.4.0 - 12-Oct-2019
 * Changed license to Apache-2.0.
 * VERSION constant now lives in a single place, and is frozen.

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 → MANIFEST.rdoc}

@@ -1,4 +1,5 @@
 * CHANGES
+* LICENSE
 * MANIFEST
 * README
 * Rakefile

data/README.rdoc

@@ -0,0 +1,66 @@
+== Description
+The file-temp library is an alternate way to handle tempfile generation.
+
+== Requirements
+* ffi 1.0.0 or later
+
+== Installation
+   gem install file-temp
+
+== Synopsis
+   require 'file/temp'
+
+   fh = File::Temp.new
+   fh.puts "hello"
+   fh.close # => Tempfile automatically deleted
+
+   fh = File::Temp.new(delete: false)
+   fh.puts "world"
+   fh.close # => Tempfile still on your filesystem
+
+== Motivation
+Unlike the tempfile library that ships with Ruby's standard library, this
+library uses your system's native +tmpfile+ or +mkstemp+ functions.
+   
+This library is also more secure because it restricts file permission via
++umask+ for files created with +mkstemp+.
+
+Finally, this library subclasses the File class. This means you get almost
+exactly the same interface as the File class. The only difference is the
+constructor.
+
+Note that my original motivation was a problem with race conditions in
+the tempfile library, but that was a very long time ago, and my assumption
+at this point is that it's no longer true. But, I still prefer this version
+to the one in the Ruby standard library.
+
+== JRuby
+The implementation for JRuby uses the Java API, not the C API. The
+temporary file name generated by Java is different than the C version,
+since it uses a GUID instead of the 'XXXXXX' template, but the
+interface is otherwise identical.
+
+== MS Windows
+You may need to use the mingw build in order to use this library.
+
+Also, there was a bug with the +GetTempFileName+ function on certain versions
+of MS Windows that may cause a failure. However, if you'r patched up you
+should not see it. 
+
+== License
+Apache-2.0
+
+== Copyright
+(C) 2007-2020 Daniel J. Berger
+All Rights Reserved
+
+== Warranty
+This library 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 J. Berger
+
+== See also
+tmpfile(), mkstemp(), tmpnam()

data/file-temp.gemspec

@@ -2,7 +2,7 @@ require 'rubygems'
 
 Gem::Specification.new do |spec|
   spec.name       = 'file-temp'
-  spec.version    = '1.4.0'
+  spec.version    = '1.5.0'
   spec.author     = 'Daniel J. Berger'
   spec.license    = 'Apache-2.0'
   spec.email      = 'djberg96@gmail.com'
@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.files      = Dir['**/*'].delete_if{ |item| item.include?('git') }
   spec.cert_chain = Dir['certs/*']
 
-  spec.extra_rdoc_files = ['CHANGES', 'README', 'MANIFEST']
+  spec.extra_rdoc_files = ['CHANGES.rdoc', 'README.rdoc', 'MANIFEST.rdoc']
 
   spec.add_dependency('ffi', '>= 1.0.0')
   spec.add_development_dependency('test-unit')

data/lib/file/java/temp.rb

@@ -8,8 +8,8 @@ class File::Temp < File
   # The name of the temporary file.
   attr_reader :path
 
-  # Creates a new, anonymous, temporary file in your File::Temp::TMPDIR
-  # directory.
+  # Creates a new, anonymous, temporary file in your system's temporary
+  # directory, or whichever directory you specify.
   #
   # If the +delete+ option is set to true (the default) then the temporary file
   # will be deleted automatically as soon as all references to it are closed.
@@ -27,11 +27,11 @@ class File::Temp < File
   #
   # Example:
   #
-  #    fh = File::Temp.new(true, 'rb_file_temp_XXXXXX') => file
+  #    fh = File::Temp.new(delete: true, template: 'rb_file_temp_XXXXXX')
   #    fh.puts 'hello world'
   #    fh.close
   #
-  def initialize(delete = true, template = 'rb_file_temp_XXXXXX')
+  def initialize(delete: true, template: 'rb_file_temp_XXXXXX', directory: TMPDIR)
     raise TypeError unless template.is_a?(String)
 
     # Since Java uses a GUID extension to generate a unique file name
@@ -41,7 +41,7 @@ class File::Temp < File
     # For consistency between implementations, convert errors here
     # to Errno::EINVAL.
     begin
-      @file = java.io.File.createTempFile(template, nil)
+      @file = java.io.File.createTempFile(template, nil, java.io.File.new(directory))
     rescue NativeException => err
       raise SystemCallError.new(22), template # 22 is EINVAL
     end
@@ -54,14 +54,13 @@ class File::Temp < File
     @path = path unless delete
   end
 
-  # Generates a unique file name.
+  # Generates a unique file name based on your tmpdir, or whichever
+  # directory you specify.
   #
-  def self.temp_name
-    file = java.io.File.createTempFile('rb_file_temp_', nil)
+  def self.temp_name(directory = TMPDIR)
+    file = java.io.File.createTempFile('rb_file_temp_', nil, java.io.File.new(directory))
     file.deleteOnExit
-    name = file.getName
-    file.finalize
-    name
+    directory + file.getName
   end
 
   # Identical to the File#close method except that we also finalize

data/lib/file/temp.rb

@@ -1,6 +1,6 @@
 class File::Temp < File
   # The version of the file-temp library
-  VERSION = '1.4.0'.freeze
+  VERSION = '1.5.0'.freeze
 end
 
 if RUBY_PLATFORM == 'java'

data/lib/file/unix/temp.rb

@@ -23,19 +23,19 @@ class File::Temp < File
 
   # :startdoc:
 
-  # The temporary directory used on MS Windows or Unix.
+  # The temporary directory used on MS Windows or Unix by default.
   TMPDIR = ENV['TEMP'] || ENV['TMP'] || ENV['TMPDIR'] || Dir.tmpdir
 
   # The name of the temporary file. Set to nil if the +delete+ option to the
   # constructor is true.
   attr_reader :path
 
-  # Creates a new, anonymous, temporary file in your File::Temp::TMPDIR
-  # directory
+  # Creates a new, anonymous, temporary file in your tmpdir, or whichever
+  # directory you specifiy.
   #
   # If the +delete+ option is set to true (the default) then the temporary file
   # will be deleted automatically as soon as all references to it are closed.
-  # Otherwise, the file will live on in your File::Temp::TMPDIR path.
+  # Otherwise, the file will live on in your tmpdir path.
   #
   # If the +delete+ option is set to false, then the file is not deleted. In
   # addition, you can supply a string +template+ that the system replaces with
@@ -47,29 +47,28 @@ class File::Temp < File
   #
   # Example:
   #
-  #    fh = File::Temp.new(true, 'rb_file_temp_XXXXXX') => file
+  #    fh = File::Temp.new(delete: true, template: 'rb_file_temp_XXXXXX') => file
   #    fh.puts 'hello world'
   #    fh.close
   #
-  def initialize(delete = true, template = 'rb_file_temp_XXXXXX')
+  def initialize(delete: true, template: 'rb_file_temp_XXXXXX', directory: TMPDIR)
     @fptr = nil
 
     if delete
       @fptr = tmpfile()
+      raise SystemCallError.new('tmpfile', FFI.errno) if @fptr.null?
       fd = _fileno(@fptr)
     else
       begin
         omask = File.umask(077)
-
         ptr = FFI::MemoryPointer.from_string(template)
-
         str = mktemp(ptr)
 
         if str.nil? || str.empty?
           raise SystemCallError.new('mktemp', FFI.errno)
         end
 
-        @path = File.join(TMPDIR, ptr.read_string)
+        @path = File.join(directory, ptr.read_string)
       ensure
         File.umask(omask)
       end
@@ -82,13 +81,17 @@ class File::Temp < File
     end
   end
 
-  # The close method was overridden to ensure the internal file pointer we
-  # created in the constructor is closed. It is otherwise identical to the
-  # File#close method.
+  # The close method was overridden to ensure the internal file pointer that we
+  # potentially created in the constructor is closed. It is otherwise identical
+  # to the File#close method.
+  #--
+  # This is probably unnecessary since Ruby will close the fd, and in reality
+  # the fclose function probably fails with an Errno::EBADF. Consequently
+  # I will let it silently fail as a no-op.
   #
   def close
     super
-    fclose(@fptr) if @fptr
+    fclose(@fptr) if @fptr && !@fptr.null?
   end
 
   # Generates a unique file name.

data/lib/file/windows/temp.rb

@@ -53,7 +53,7 @@ class File::Temp < File
 
   # :startdoc:
 
-  # The temporary directory used on MS Windows or Unix.
+  # The temporary directory used on MS Windows or Unix by default.
   TMPDIR = ENV['TEMP'] || ENV['TMP'] || ENV['USERPROFILE'] || Dir.tmpdir
 
   # The name of the temporary file. Set to nil if the +delete+ option to the
@@ -61,7 +61,7 @@ class File::Temp < File
   attr_reader :path
 
   # Creates a new, anonymous, temporary file in your File::Temp::TMPDIR
-  # directory
+  # directory, or whichever directory you specify.
   #
   # If the +delete+ option is set to true (the default) then the temporary file
   # will be deleted automatically as soon as all references to it are closed.
@@ -77,11 +77,11 @@ class File::Temp < File
   #
   # Example:
   #
-  #    fh = File::Temp.new(true, 'rb_file_temp_XXXXXX') => file
+  #    fh = File::Temp.new(delete: true, template: 'rb_file_temp_XXXXXX')
   #    fh.puts 'hello world'
   #    fh.close
   #
-  def initialize(delete = true, template = 'rb_file_temp_XXXXXX')
+  def initialize(delete: true, template: 'rb_file_temp_XXXXXX', directory: TMPDIR)
     @fptr = nil
 
     if delete
@@ -90,14 +90,12 @@ class File::Temp < File
     else
       begin
         omask = File.umask(077)
-
         ptr = FFI::MemoryPointer.from_string(template)
-
         errno = mktemp_s(ptr, ptr.size)
 
         raise SystemCallError.new('mktemp_s', errno) if errno != 0
 
-        @path = File.join(TMPDIR, ptr.read_string)
+        @path = File.join(directory, ptr.read_string)
         @path.tr!(File::SEPARATOR, File::ALT_SEPARATOR)
       ensure
         File.umask(omask)
@@ -120,20 +118,21 @@ class File::Temp < File
     fclose(@fptr) if @fptr
   end
 
-  # Generates a unique file name.
+  # Generates a unique file name based on your default temporary directory,
+  # or whichever directory you specify.
   #
   # Note that a file is not actually generated on the filesystem.
   #--
   # NOTE: One quirk of the Windows function is that, after the first call, it
   # adds a file extension of sequential numbers in base 32, e.g. .1-.1vvvvvu.
   #
-  def self.temp_name
+  def self.temp_name(directory: TMPDIR)
     ptr = FFI::MemoryPointer.new(:char, 1024)
     errno = tmpnam_s(ptr, ptr.size)
 
     raise SystemCallError.new('tmpnam_s', errno) if errno != 0
 
-    TMPDIR + ptr.read_string + 'tmp'
+    directory + ptr.read_string + 'tmp'
   end
 
   private

data/test/test_file_temp.rb

@@ -22,7 +22,7 @@ class TC_File_Temp < Test::Unit::TestCase
   end
 
   test "library version is set to expected value" do
-    assert_equal('1.4.0', File::Temp::VERSION)
+    assert_equal('1.5.0', File::Temp::VERSION)
     assert_true(File::Temp::VERSION.frozen?)
   end
 
@@ -48,33 +48,33 @@ class TC_File_Temp < Test::Unit::TestCase
 
   test "constructor works as expected with false auto delete option" do
     assert_nothing_raised{
-      @fh = File::Temp.new(false)
+      @fh = File::Temp.new(:delete => false)
       @fh.print "hello"
       @fh.close
     }
   end
 
   test "constructor accepts and uses an optional template as expected" do
-    assert_nothing_raised{ File::Temp.new(false, 'temp_foo_XXXXXX').close }
+    assert_nothing_raised{ File::Temp.new(:delete => false, :template => 'temp_foo_XXXXXX').close }
     assert_true(Dir["#{@dir}/temp_foo*"].length >= 1)
   end
 
   test "constructor with false auto delete and block works as expected" do
-    assert_nothing_raised{ File::Temp.open(false, 'temp_foo_XXXXXX'){ |fh| fh.puts "hello" } }
+    assert_nothing_raised{ File::Temp.open(:delete => false, :template => 'temp_foo_XXXXXX'){ |fh| fh.puts "hello" } }
     assert_true(Dir["#{@dir}/temp_foo*"].length >= 1)
   end
 
-  test "second argument to constructor must be a string" do
-    assert_raise(TypeError, ArgumentError){ @fh = File::Temp.new(false, 1) }
+  test "template argument must be a string" do
+    assert_raise(TypeError, ArgumentError){ @fh = File::Temp.new(:delete => false, :template => 1) }
   end
 
   test "an error is raised if a custom template is invalid" do
     omit_if(OSX)
-    assert_raise(Errno::EINVAL){ File::Temp.new(false, 'xx') }
+    assert_raise(Errno::EINVAL){ File::Temp.new(:delete => false, :template => 'xx') }
   end
 
-  test "constructor accepts a maximum of two arguments" do
-    assert_raise(ArgumentError){ @fh = File::Temp.new(true, 'temp_bar_XXXXX', 1) }
+  test "constructor accepts a maximum of three arguments" do
+    assert_raise(ArgumentError){ @fh = File::Temp.new(:delete => true, :template => 'temp_bar_XXXXX', :directory => Dir.pwd, :bogus => 1) }
   end
 
   test "temp_name basic functionality" do
@@ -102,7 +102,7 @@ class TC_File_Temp < Test::Unit::TestCase
   end
 
   test "temp path is not nil if delete option is false" do
-    @fh = File::Temp.new(false)
+    @fh = File::Temp.new(delete: false)
     assert_not_nil(@fh.path)
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: file-temp
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -87,16 +87,14 @@ email: djberg96@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- CHANGES
-- README
-- MANIFEST
+- CHANGES.rdoc
+- README.rdoc
+- MANIFEST.rdoc
 files:
+- LICENSE
 - test
 - test/test_file_temp.rb
 - file-temp.gemspec
-- CHANGES
-- MANIFEST
-- README
 - Rakefile
 - certs
 - certs/djberg96_pub.pem
@@ -110,6 +108,9 @@ files:
 - lib/file/unix/temp.rb
 - lib/file/windows
 - lib/file/windows/temp.rb
+- CHANGES.rdoc
+- MANIFEST.rdoc
+- README.rdoc
 homepage: http://github.com/djberg96/file-temp
 licenses:
 - Apache-2.0
@@ -135,7 +136,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: An alternative way to generate temp files

data/README

@@ -1,65 +0,0 @@
-== Description
-   The file-temp library is an alternate way to handle tempfile generation.
-
-== Requirements
-   ffi 1.0.0 or later
-
-== Installation
-   gem install file-temp
-
-== Synopsis
-   require 'file/temp'
-
-   fh = File::Temp.new
-   fh.puts "hello"
-   fh.close # => Tempfile automatically deleted
-
-   fh = File::Temp.new(false)
-   fh.puts "world"
-   fh.close # => Tempfile still on your filesystem
-
-== Motivation
-   Ruby's tempfile.rb is overwrought and susceptible to race conditions.
-   This library uses your system's native tmpfile() or mkstemp() functions
-   instead of trying to handle race conditions manually via pure Ruby.
-   
-   This library is also more secure because it restricts file permission via
-   umask() for files created with mkstemp().
-
-   Finally, this library subclasses the File class. This means you get almost
-   exactly the same interface as the File class. The only difference is the
-   constructor.
-
-== JRuby
-   The implementation for JRuby uses the Java API, not the C API. The
-   temporary file name generated by Java is different than the C version,
-   since it uses a GUID instead of the 'XXXXXX' template, but the
-   interface is otherwise identical.
-
-   There is one test failure with JRuby (threaded tempfile creation). I am
-   not sure why, as sample code seems to work fine. Help wanted.
-
-== MS Windows
-   You may need to use the mingw build in order to use this library.
-
-   Also, there was a bug with GetTempFileName function on certain versions
-   of MS Windows that may cause a failure. However, if you'r patched up you
-   should not see it. 
-
-== License
-   Artistic 2.0
-
-== Copyright
-   (C) 2007-2016 Daniel J. Berger
-   All Rights Reserved
-
-== Warranty
-   This library 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 J. Berger
-
-== See also
-   tmpfile(), mkstemp(), tmpnam()