aboutsummaryrefslogtreecommitdiff
path: root/node_modules/tmp/README.md
diff options
context:
space:
mode:
authorFlorian Dold <florian.dold@gmail.com>2017-05-27 17:36:13 +0200
committerFlorian Dold <florian.dold@gmail.com>2017-05-27 17:36:13 +0200
commit5f466137ad6ac596600e3ff53c9b786815398445 (patch)
treef914c221874f0b16bf3def7ac01d59d1a99a3b0b /node_modules/tmp/README.md
parentc9f5ac8e763eda19aa0564179300cfff76785435 (diff)
node_modules, clean up package.json
Diffstat (limited to 'node_modules/tmp/README.md')
-rw-r--r--node_modules/tmp/README.md268
1 files changed, 0 insertions, 268 deletions
diff --git a/node_modules/tmp/README.md b/node_modules/tmp/README.md
deleted file mode 100644
index 804bf3395..000000000
--- a/node_modules/tmp/README.md
+++ /dev/null
@@ -1,268 +0,0 @@
-# Tmp
-
-A simple temporary file and directory creator for [node.js.][1]
-
-[![Build Status](https://travis-ci.org/raszi/node-tmp.svg?branch=master)](https://travis-ci.org/raszi/node-tmp)
-[![Dependencies](https://david-dm.org/raszi/node-tmp.svg)](https://david-dm.org/raszi/node-tmp)
-[![npm version](https://badge.fury.io/js/tmp.svg)](https://badge.fury.io/js/tmp)
-
-## About
-
-This is a [widely used library][2] to create temporary files and directories
-in a [node.js][1] environment.
-
-Tmp offers both an asynchronous and a synchronous API. For all API calls, all
-the parameters are optional.
-
-Tmp uses crypto for determining random file names, or, when using templates,
-a six letter random identifier. And just in case that you do not have that much
-entropy left on your system, Tmp will fall back to pseudo random numbers.
-
-You can set whether you want to remove the temporary file on process exit or
-not, and the destination directory can also be set.
-
-## How to install
-
-```bash
-npm install tmp
-```
-
-## Usage
-
-### Asynchronous file creation
-
-Simple temporary file creation, the file will be closed and unlinked on process exit.
-
-```javascript
-var 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();
-});
-```
-
-### Synchronous file creation
-
-A synchronous version of the above.
-
-```javascript
-var tmp = require('tmp');
-
-var tmpobj = tmp.fileSync();
-console.log("File: ", tmpobj.name);
-console.log("Filedescriptor: ", tmpobj.fd);
-
-// If we don't need the file anymore we could manually call the removeCallback
-// But that is not necessary if we didn't pass the keep option because the library
-// will clean after itself.
-tmpobj.removeCallback();
-```
-
-Note that this might throw an exception if either the maximum limit of retries
-for creating a temporary name fails, or, in case that you do not have the permission
-to write to the directory where the temporary file should be created in.
-
-### Asynchronous directory creation
-
-Simple temporary directory creation, it will be removed on process exit.
-
-If the directory still contains items on process exit, then it won't be removed.
-
-```javascript
-var tmp = require('tmp');
-
-tmp.dir(function _tempDirCreated(err, path, cleanupCallback) {
- if (err) throw err;
-
- console.log("Dir: ", path);
-
- // Manual cleanup
- cleanupCallback();
-});
-```
-
-If you want to cleanup the directory even when there are entries in it, then
-you can pass the `unsafeCleanup` option when creating it.
-
-### Synchronous directory creation
-
-A synchronous version of the above.
-
-```javascript
-var tmp = require('tmp');
-
-var tmpobj = tmp.dirSync();
-console.log("Dir: ", tmpobj.name);
-// Manual cleanup
-tmpobj.removeCallback();
-```
-
-Note that this might throw an exception if either the maximum limit of retries
-for creating a temporary name fails, or, in case that you do not have the permission
-to write to the directory where the temporary directory should be created in.
-
-### Asynchronous filename generation
-
-It is possible with this library to generate a unique filename in the specified
-directory.
-
-```javascript
-var tmp = require('tmp');
-
-tmp.tmpName(function _tempNameGenerated(err, path) {
- if (err) throw err;
-
- console.log("Created temporary filename: ", path);
-});
-```
-
-### Synchronous filename generation
-
-A synchronous version of the above.
-
-```javascript
-var tmp = require('tmp');
-
-var name = tmp.tmpNameSync();
-console.log("Created temporary filename: ", name);
-```
-
-## Advanced usage
-
-### Asynchronous file creation
-
-Creates a file with mode `0644`, prefix will be `prefix-` and postfix will be `.txt`.
-
-```javascript
-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);
-});
-```
-
-### Synchronous file creation
-
-A synchronous version of the above.
-
-```javascript
-var tmp = require('tmp');
-
-var tmpobj = tmp.fileSync({ mode: 0644, prefix: 'prefix-', postfix: '.txt' });
-console.log("File: ", tmpobj.name);
-console.log("Filedescriptor: ", tmpobj.fd);
-```
-
-### Asynchronous directory creation
-
-Creates a directory with mode `0755`, prefix will be `myTmpDir_`.
-
-```javascript
-var tmp = require('tmp');
-
-tmp.dir({ mode: 0750, prefix: 'myTmpDir_' }, function _tempDirCreated(err, path) {
- if (err) throw err;
-
- console.log("Dir: ", path);
-});
-```
-
-### Synchronous directory creation
-
-Again, a synchronous version of the above.
-
-```javascript
-var tmp = require('tmp');
-
-var tmpobj = tmp.dirSync({ mode: 0750, prefix: 'myTmpDir_' });
-console.log("Dir: ", tmpobj.name);
-```
-
-### mkstemp like, asynchronously
-
-Creates a new temporary directory with mode `0700` and filename like `/tmp/tmp-nk2J1u`.
-
-```javascript
-var tmp = require('tmp');
-
-tmp.dir({ template: '/tmp/tmp-XXXXXX' }, function _tempDirCreated(err, path) {
- if (err) throw err;
-
- console.log("Dir: ", path);
-});
-```
-
-### mkstemp like, synchronously
-
-This will behave similarly to the asynchronous version.
-
-```javascript
-var tmp = require('tmp');
-
-var tmpobj = tmp.dirSync({ template: '/tmp/tmp-XXXXXX' });
-console.log("Dir: ", tmpobj.name);
-```
-
-### Asynchronous filename generation
-
-The `tmpName()` function accepts the `prefix`, `postfix`, `dir`, etc. parameters also:
-
-```javascript
-var tmp = require('tmp');
-
-tmp.tmpName({ template: '/tmp/tmp-XXXXXX' }, function _tempNameGenerated(err, path) {
- if (err) throw err;
-
- console.log("Created temporary filename: ", path);
-});
-```
-
-### Synchronous filename generation
-
-The `tmpNameSync()` function works similarly to `tmpName()`.
-
-```javascript
-var tmp = require('tmp');
-var tmpname = tmp.tmpNameSync({ template: '/tmp/tmp-XXXXXX' });
-console.log("Created temporary filename: ", tmpname);
-```
-
-## Graceful cleanup
-
-One may want to cleanup the temporary files even when an uncaught exception
-occurs. To enforce this, you can call the `setGracefulCleanup()` method:
-
-```javascript
-var tmp = require('tmp');
-
-tmp.setGracefulCleanup();
-```
-
-## 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, fallbacks to `tmp-` if not provided
- * `postfix`: the optional postfix, fallbacks to `.tmp` on file creation
- * `template`: [`mkstemp`][3] like filename template, no default
- * `dir`: the optional temporary directory, fallbacks to system default (guesses from environment)
- * `tries`: how many times should the function try to get a unique filename before giving up, default `3`
- * `keep`: signals that the temporary file or directory should not be deleted on exit, default is `false`, means delete
- * Please keep in mind that it is recommended in this case to call the provided `cleanupCallback` function manually.
- * `unsafeCleanup`: recursively removes the created temporary directory, even when it's not empty. default is `false`
-
-[1]: http://nodejs.org/
-[2]: https://www.npmjs.com/browse/depended/tmp
-[3]: http://www.kernel.org/doc/man-pages/online/pages/man3/mkstemp.3.html