Repository navigation
Conversation
|
The bullet list doesn't render properly, I'm actually cloning locally to debug, will push a fix soon... |
a24a9da to
84d5ce7
Compare
| :ref:`tempfile-examples`). On completion of the context or | ||
| destruction of the file object the temporary file will be removed | ||
| from the filesystem. | ||
| The temporary file will be removed from the filesystem when the returned |
There was a problem hiding this comment.
This sentence is not quite grammatical. I'd suggest starting with "The temporary file will be removed from the file system under the following conditions:"
There was a problem hiding this comment.
Thanks, I addressed this in eb61e19. See what you think of that.
|
Hey @NickCrews -- Are you still interested in pushing this forward? If so, there's an outstanding suggestion to you from Jelle. |
|
This PR is stale because it has been open for 30 days with no activity. |
84d5ce7 to
eb61e19
Compare
|
@ryan-duve Thanks for the nudge, I had totally forgotten about this PR :) Just pushed a new version that addresses that feedback, let me know what you think. |
|
This PR is stale because it has been open for 90 days with no activity. |
|
@JelleZijlstra I think I addressed your feedback here, if you have a few minutes for a re review. Thanks! |
sirosen
left a comment
There was a problem hiding this comment.
I disagree with the decision to nest the fact that the TemporaryFile can be used as a context manager under details about cleanup and file deletion. Being a context manager is a first-class characteristic of an object, and determines whether or not it can be used with a unique syntactic form (the with statement).
I'm also not convinced that a bulleted list is the best way to present this information.
I've included a suggested rewrite (sorry it's the whole block of text! there's really only one conceptual change, but it touches the beginning and end), to move mention of being a context manager to the start. That intrinsically frees us up to make the cleanup details simpler.
|
This PR is stale because it has been open for 90 days with no activity. |
Documentation build overview
|

Lightly edit some prose. On my initial read of the docs, I was confused about when tempfiles are deleted. I think this PR would have helped me.
Now there are two paragraphs, the first one has to do with "creating a tempfile" and the second is "deleting a tempfile". I think this is a better way of organizing things than what it used to be.
Before, an entire paragraph was about "using as a context manager", which I think is less important than "when is a tempfile deleted". The first paragraph was "what happens when you make a tempfile and also here is one way of when it is closed"
tempfiledocumentation for conditions when files are removed #95484