touch(1) for node
JavaScript
Clone or download
Latest commit 7706a0d Jun 30, 2017
Permalink
Failed to load latest commit information.
bin remove nopt, test bin, fix things Jun 30, 2017
test remove nopt, test bin, fix things Jun 30, 2017
.gitignore ignores Jul 17, 2015
.travis.yml travis Jun 27, 2017
LICENSE isc license Jan 25, 2014
README.md doc that there is a cli Jun 30, 2017
index.js remove nopt, test bin, fix things Jun 30, 2017
package-lock.json v3.1.0 Jun 30, 2017
package.json v3.1.0 Jun 30, 2017

README.md

node-touch

For all your node touching needs.

Installing

npm install touch

CLI Usage:

See man touch

This package exports a binary called nodetouch that works mostly like the unix builtin touch(1).

API Usage:

var touch = require("touch")

Gives you the following functions:

  • touch(filename, options, cb)
  • touch.sync(filename, options)
  • touch.ftouch(fd, options, cb)
  • touch.ftouchSync(fd, options)

All the options objects are optional.

All the async functions return a Promise. If a callback function is provided, then it's attached to the Promise.

Options

  • force like touch -f Boolean
  • time like touch -t <date> Can be a Date object, or any parseable Date string, or epoch ms number.
  • atime like touch -a Can be either a Boolean, or a Date.
  • mtime like touch -m Can be either a Boolean, or a Date.
  • ref like touch -r <file> Must be path to a file.
  • nocreate like touch -c Boolean

If neither atime nor mtime are set, then both values are set. If one of them is set, then the other is not.

cli

This package creates a nodetouch command line executable that works very much like the unix builtin touch(1)