Feature #1999

Improved Tempfile

Added by hongli (Hongli Lai) over 2 years ago. Updated about 1 year ago.

[ruby-core:25131]
Status:Closed Start date:08/26/2009
Priority:Normal Due date:
Assignee:- % Done:

0%

Category:lib
Target version:1.9.1 Release Candidate

Description

I've written an improved version of Tempfile. The changes are as follows:
- Much better documentation.
- A large unit test suite to prevent future regressions.
- Fixes a bug in the finalizer: if one calls #unlink on a Tempfile, then recreates the same file outside Ruby, and then runs the garbage collector, then the Tempfile's finalizer will delete the newly created file even when it's not supposed to:

  t = Tempfile.new('foo')
  path = t.path
  t.close
  t.unlink
  system("touch #{path}")
  exit  # Run finalizers
  # => The file as referred to by 'path' doesn't exist anymore.

The source code can be found here:

http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/lib/better/tempfile.rb

It's compatible with both 1.8 and 1.9.

The tests are here:
http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/test/tempfile_test.rb
http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/test/tempfile_unlink_on_exit_example.rb
http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/test/tempfile_explicit_unlink_example.rb
http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/test/tempfile_explicit_close_and_unlink_example.rb

tempfile-creation-error.diff (883 Bytes) hongli (Hongli Lai), 08/29/2009 02:49 am


Related issues

related to ruby-trunk - Feature #2166: Add CreationError Rejected 10/01/2009

Associated revisions

Revision 24667
Added by nobu (Nobuyoshi Nakada) over 2 years ago

* test/test_tempfile.rb: merged from Hongli Lai's fork. cf [ruby-core:25131].

Revision 24672
Added by naruse (Yui NARUSE) over 2 years ago

* lib/tempfile.rb: add documents from Hongli Lai's fork. cf [ruby-core:25131].

History

Updated by naruse (Yui NARUSE) over 2 years ago

nobu added your tests and I add your documents.

For addiotional changes, please see [ruby-core:25139].

Updated by hongli (Hongli Lai) over 2 years ago

Thanks. But revision 24666 should be reverted. It breaks the test_finalizer_does_not_unlink_if_already_unlinked test.

Updated by hongli (Hongli Lai) over 2 years ago

Sorry, please ignore my last message, I ran the test in a wrong way.

I'm working on some patches in the format as required by ruby-core:25139.

Updated by hongli (Hongli Lai) over 2 years ago

Here is a patch which implements the CreationError exception class, as documented in the Tempfile API documentation. However, I could not write a unit test for it because there seems to be no mocking/stubbing framework that I could use.

Updated by naruse (Yui NARUSE) over 2 years ago

  • Status changed from Open to Closed
Close this ticket and newly open #2166 for adding CreationError.

Updated by docwhat (Christian Höltje) over 2 years ago

I'm confused.  Was this newer Tempfile added?  If so, which version of ruby 1.9?  Why was it closed just for adding CreationError?

Updated by naruse (Yui NARUSE) over 2 years ago

  • Target version set to 1.9.1 Release Candidate
A patch must be well explained and include only one feature.
This principle should be universal, shouldn't it?

Hongli's proposal is not well explained.
We can't know why their changes are implemented as they are.

His files are not atomic patches.
They are only files.
Not for a patch for ruby-trunk and their changesets are not atomic.
We don't like mixed patch.


I didn't want to simply reject his proposal,
so I intended to show the way of suggesting a new feature in Ruby on #2166.
He seems not understand because of my poor introduction.

Updated by djberg96 (Daniel Berger) over 2 years ago

Hongli Lai wrote:
> Feature #1999: Improved Tempfile
> http://redmine.ruby-lang.org/issues/show/1999
> 
> Author: Hongli Lai
> Status: Open, Priority: Normal
> Category: lib
> 
> I've written an improved version of Tempfile. The changes are as follows:
> - Much better documentation.
> - A large unit test suite to prevent future regressions.
> - Fixes a bug in the finalizer: if one calls #unlink on a Tempfile, then recreates the same file outside Ruby, and then runs the garbage collector, then the Tempfile's finalizer will delete the newly created file even when it's not supposed to:
> 
>   t = Tempfile.new('foo')
>   path = t.path
>   t.close
>   t.unlink
>   system("touch #{path}")
>   exit  # Run finalizers
>   # => The file as referred to by 'path' doesn't exist anymore.
> 
> The source code can be found here:
> 
> http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/lib/better/tempfile.rb
> 
> It's compatible with both 1.8 and 1.9.
> 
> The tests are here:
> http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/test/tempfile_test.rb
> http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/test/tempfile_unlink_on_exit_example.rb
> http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/test/tempfile_explicit_unlink_example.rb
> http://github.com/FooBarWidget/better/blob/232a0a4f68dab7950c06390fddb940e7af1ff607/test/tempfile_explicit_close_and_unlink_example.rb

I ditched Tempfile altogether and wrote my own version:

http://github.com/djberg96/file-temp

Regards,

Dan

Updated by vvs (Vladimir Sizikov) over 2 years ago

On Thu, Nov 5, 2009 at 5:31 AM, Daniel Berger <djberg96@gmail.com> wrote:
> I ditched Tempfile altogether and wrote my own version:

In JRuby, we also provide our own, custom Java-based version of
Tempfile, so the actualy implementation in MRI is not that important
to us. *BUT*, what I really liked in Hongli Lai version is a better,
more extensive and precise documentation.

Thanks,
  --Vladimir

Also available in: Atom PDF