tmp

What is tmp?

The tmp npm package is used for creating temporary files and directories in a Node.js environment. It helps manage and clean up temporary files automatically.

What are tmp's main functionalities?

Temporary File Creation

This feature allows you to create a temporary file. The library provides a callback with the path and file descriptor, and a cleanup callback to remove the file when it's no longer needed.

const tmp = require('tmp');
tmp.file(function _tempFileCreated(err, path, fd, cleanupCallback) {
  if (err) throw err;
  console.log('File: ', path);
  console.log('Filedescriptor: ', fd);
  // If we don't need the file anymore we could manually call the cleanupCallback
  // But that is not necessary if we didn't pass the keep option because the library will clean after itself.
  cleanupCallback();
});

Temporary Directory Creation

This feature allows you to create a temporary directory. Similar to temporary file creation, it provides a path to the directory and a cleanup callback.

const tmp = require('tmp');
tmp.dir(function _tempDirCreated(err, path, cleanupCallback) {
  if (err) throw err;
  console.log('Dir: ', path);
  // Manual cleanup
  cleanupCallback();
});

Synchronous File Creation

This feature allows for synchronous creation of a temporary file name. It returns the name directly without the need for a callback.

const tmp = require('tmp');
const name = tmp.tmpNameSync();
console.log('Temporary filename: ', name);

Synchronous Directory Creation

This feature allows for synchronous creation of a temporary directory. It returns an object with the directory name.

const tmp = require('tmp');
const dir = tmp.dirSync();
console.log('Temporary directory: ', dir.name);

Other packages similar to tmp

temp

The 'temp' package is similar to 'tmp' and is also used for managing temporary files and directories. It provides automatic cleanup and tracking of temporary files, but it has not been updated as frequently as 'tmp'.

tempfile

The 'tempfile' package is a simpler alternative to 'tmp' that focuses on generating temporary file paths. It does not handle the creation or cleanup of the files.

temp-dir

The 'temp-dir' package provides the path to the system's default directory for temporary files, rather than creating temporary files or directories itself.

mktemp

The 'mktemp' package creates temporary files and directories in a way similar to the Unix command of the same name. It offers a lower-level API compared to 'tmp' and requires manual cleanup.

README

Tmp

A simple temporary file and directory creator for node.js.

About

The main difference between bruce's node-temp is that that mine more aggressively checks for the exitence of the newly created temporary file.

The API is slightly different, mine does not yet provide synchronous calls and all the parameters are optional. And you can even set whether you want to remove the temporary file on process exit or not.

How to install

npm install tmp

Usage

File creation

var tmp = require('tmp');

tmp.file(function _tempFileCreated(err, path, fd) {
  if (err) throw err;

  console.log("File: ", path);
  console.log("Filedescriptor: ", fd);
});

Directory creation

var tmp = require('tmp');

tmp.dir(function _tempDirCreated(err, path) {
  if (err) throw err;

  console.log("Dir: ", path);
});

Advanced usage

File creation

var tmp = require('tmp');

tmp.file({ mode: 0644, prefix: 'prefix-', postfix: '.txt' }, function _tempFileCreated(err, path, fd) {
  if (err) throw err;

  console.log("File: ", path);
  console.log("Filedescriptor: ", fd);
});

Directory creation

tmp.dir({ mode: 0750, prefix: 'myTmpDir_' }, function _tempDirCreated(err, path) {
  if (err) throw err;

  console.log("Dir: ", path);
});

mkstemps like

tmp.dir({ template: '/tmp/tmp-XXXXXX' }, function _tempDirCreated(err, path) {
  iff (err) throw err;

  console.log("Dir: ", path);
});

Options

All options are optional :)

• mode: the file mode to create with it fallbacks to 0600 on file creation and 0700 on directory creation
• prefix: the optional prefix, fallback to tmp- if not provided
• postfix: the optional postfix, fallbacks to .tmp on file creation
• template: mkstemps like filename template, no default
• dir: the optional temporary directory, fallbacks to system default (guesses from environment)
• tries: how many times should the function tries to get a unique filename before giving up, default 3