80 lines
1.7 KiB
Markdown
80 lines
1.7 KiB
Markdown
|
# tempy [](https://travis-ci.org/sindresorhus/tempy)
|
||
|
|
|
||
|
|
> Get a random temporary file or directory path
|
||
|
|
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
```
|
||
|
|
$ npm install tempy
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```js
|
||
|
|
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'
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## 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()
|
||
|
|
|
||
|
|
Get a temporary directory path. The directory is created for you.
|
||
|
|
|
||
|
|
### 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?
|
||
|
|
|
||
|
|
The operating system will clean up when needed. No point in us wasting resources and adding complexity.
|
||
|
|
|
||
|
|
|
||
|
|
## Related
|
||
|
|
|
||
|
|
- [temp-write](https://github.com/sindresorhus/temp-write) - Write string/buffer/stream to a random temp file
|
||
|
|
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
MIT © [Sindre Sorhus](https://sindresorhus.com)
|