Sunbeam Studios

Our open-source projects, here for you!

Portugal

https://sunbeam.pt

Repositories

20

Projects Packages

tempfile (3.27.0)

Published 2026-03-26 10:35:45 +00:00 by siennathesane

Installation

Set up this registry in the Cargo configuration file (for example ~/.cargo/config.toml):

[registry]
default = "gitea"

[registries.gitea]
index = "sparse+" # Sparse index
# index = "" # Git

[net]
git-fetch-with-cli = true

To install the package using Cargo, run the following command:

cargo add tempfile@3.27.0

For more information on the Cargo registry, see the documentation.

About this package

A library for managing temporary files and directories.

tempfile

A secure, cross-platform, temporary file library for Rust. In addition to creating temporary files, this library also allows users to securely open multiple independent references to the same temporary file (useful for consumer/producer patterns and surprisingly difficult to implement securely).

Documentation

Usage

Minimum required Rust version: 1.63.0

Add this to your Cargo.toml:

[dependencies]
tempfile = "3"

Supported Platforms

This crate supports all major operating systems:

• Linux
• Android
• MacOS
• Windows
• FreeBSD (likely other BSDs but we don't have CI for them)
• RedoxOS
• Wasm (build and link only, Wasm doesn't have a filesystem)
• WASI P1 & P2.

However:

• Android, RedoxOS, Wasm, and WASI targets all require the latest stable rust compiler.
• WASI P1/P2 does not define a default temporary directory. You'll need to explicitly call tempfile::env::override_temp_dir with a valid directory or temporary file creation will panic on this platform.
• WASI P1/P2 does not have file permissions.
• You may need to override the temporary directory in Android as well to point at your application's per-app cache directory.

Example

use std::fs::File;
use std::io::{Write, Read, Seek, SeekFrom};

fn main() {
    // Write
    let mut tmpfile: File = tempfile::tempfile().unwrap();
    write!(tmpfile, "Hello World!").unwrap();

    // Seek to start
    tmpfile.seek(SeekFrom::Start(0)).unwrap();

    // Read
    let mut buf = String::new();
    tmpfile.read_to_string(&mut buf).unwrap();
    assert_eq!("Hello World!", buf);
}

Dependencies

ID	Version
fastrand	^2.1.1
once_cell	^1.19.0
doc-comment	^0.3
rustix	^1.1.4
getrandom	>=0.3.0, <0.5
windows-sys	>=0.52, <0.62

Keywords

tempfile tmpfile filesystem

Details

Cargo

2026-03-26 10:35:45 +00:00

0

Steven Allen <steven@stebalien.com>

The Rust Project Developers

Ashley Mannix <ashleymannix@live.com.au>

Jason White <me@jasonwhite.io>

Project Site

Repository Site

Documentation Site

MIT OR Apache-2.0

44 KiB

Assets (1)

tempfile-3.27.0.crate 44 KiB

Versions (1) View all

3.27.0 2026-03-26