Skip to content

Commit

Permalink
Update docs and fix typo in util.js
Browse files Browse the repository at this point in the history
  • Loading branch information
Templarian committed May 19, 2018
1 parent b267bfc commit 8dc34da
Show file tree
Hide file tree
Showing 2 changed files with 62 additions and 3 deletions.
63 changes: 61 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,61 @@
# MaterialDesign-Util
Utils for Material Design Icons' Build scripts
# Material Design Icons - Util

Utility methods for Material Design Icons' Build scripts.

## Getting Started

The `@mdi/util` package relies on the `@mdi/svg` package. Any version of `@mdi/svg` can be used.

```
npm install @mdi/svg @mdi/util
```

- getVersion()
- getMeta([bool withPaths])
- write(file, data)
- read(file)
- exists(file)

### getVersion()

This returns the version of `@mdi/svg` referenced in the `package.json`.

**returns** semver string `major.minor.build`

### getMeta([bool withPaths])

The main use of this library is to get all the icon data from the `meta.json`. Since the `meta.json` does not contain the SVG path data this method optionally allows this to be added to the object.

Please reference [meta.json](https://github.com/Templarian/MaterialDesign-SVG/blob/master/meta.json) for more information.

**returns** icon array []

### write(file, data)

```
import { write } from '@mdi/util'
write('file.txt', 'Hello World!')
```

### read(file)

```
import { read } from '@mdi/util'
const foo = read('file.txt')
```

**returns** string of file contents

### exists(file)

```
import { exists } from '@mdi/util'
if (exits('file.txt')) {
// file exists!
}
```

**returns** bool `true`/`false` if file exists
2 changes: 1 addition & 1 deletion util.js
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ exports.write = (file, data) => {
fs.writeFileSync(file, data);
};

exports.read = (file, data) => {
exports.read = (file) => {
fs.readFileSync(file);
};

Expand Down

0 comments on commit 8dc34da

Please sign in to comment.