Name	Last modified	Size	Description
	Parent Directory		-
	bin/	2023-10-19 15:45	-
	LICENSE	2023-10-19 15:45	748	f0d2fc9 test post-receive hook [كارل مبارك]
	README.md	2023-10-19 15:45	1.2K	15de0e0 styling, texts [كارل مبارك]
	index.js	2023-10-19 15:45	4.9K	15de0e0 styling, texts [كارل مبارك]
	package.json	2023-10-19 15:45	654	120707f added node version q18.16 to dependincies [كارل مبارك]

# node-touch

For all your node touching needs.

## Installing

```bash
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:

```javascript
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)`