An open API service indexing awesome lists of open source software.

https://github.com/linusu/node-alias

Mac OS aliases creation and reading from node.js
https://github.com/linusu/node-alias

Last synced: about 1 year ago
JSON representation

Mac OS aliases creation and reading from node.js

Awesome Lists containing this project

README

          

# node-alias

Mac OS aliases creation and reading from node.js

## Attention

This library does currently not handle the `book\0\0\0\0mark\0\0\0\0`-header. It only does manipulation on the raw alias data.

I intend to add something like `alias.write(buf, path)` and `alias.read(path)`.

## Installation

```sh
npm install macos-alias
```

## Usage

```javascript
var alias = require('macos-alias');
```

## API

### alias.create(target)

Create a new alias pointing to `target`, returns a buffer.

(This function performs blocking fs interaction)

### alias.decode(buf)

Decodes buffer `buf` and returns an object with info about the alias.

### alias.encode(info)

Encodes the `info`-object into an alias, returns a buffer.

### alias.isAlias(path)

Check if the file at `path` is an alias, returns a boolean.

(This function performs blocking fs interaction)

## Hacking

Clone the repo and start making changes, run `node-gyp` to build the project.

```sh
node-gyp rebuild
```

## Tests

```sh
mocha
```