.. | ||
node_modules/type-fest | ||
index.d.ts | ||
index.js | ||
license | ||
package.json | ||
readme.md |
tempy
Get a random temporary file or directory path
Install
$ npm install tempy
Usage
const tempy = require('tempy');
tempy.file();
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/4f504b9edb5ba0e89451617bf9f971dd'
tempy.file({extension: 'png'});
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/a9fb0decd08179eb6cf4691568aa2018.png'
tempy.file({name: 'unicorn.png'});
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/f7f62bfd4e2a05f1589947647ed3f9ec/unicorn.png'
tempy.directory();
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/2f3d094aec2cb1b93bb0f4cffce5ebd6'
tempy.directory({prefix: 'name'});
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/name_3c085674ad31223b9653c88f725d6b41'
API
tempy.file(options?)
Get a temporary file path you can write to.
options
Type: object
You usually won't need either the extension
or name
option. Specify them only when actually needed.
extension
Type: string
File extension.
name
Type: string
Filename. Mutually exclusive with the extension
option.
tempy.directory([options])
Get a temporary directory path. The directory is created for you.
options
Type: Object
prefix
Type: string
Directory prefix.
Useful for testing by making it easier to identify cache directories that are created.
You usually won't need this option. Specify it only when actually needed.
tempy.write(fileContent, options?)
Write data to a random temp file.
fileContent
Type: string | Buffer | TypedArray | DataView | stream.Readable
Data to write to the temp file.
options
See options.
tempy.writeSync(fileContent, options?)
Synchronously write data to a random temp file.
fileContent
Type: string | Buffer | TypedArray | DataView
Data to write to the temp file.
options
See options.
tempy.root
Get the root temporary directory path. For example: /private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T
FAQ
Why doesn't it have a cleanup method?
Temp files will be periodically cleaned up on macOS. Most Linux distros will clean up on reboot. If you're generating a lot of temp files, it's recommended to use a complementary module like del
for cleanup.