<commit_before>INI
===
[![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Coverage Status][codecov-image]][codecov-url] [![Dependencies][dependencies-image]][dependencies-url]

> Reads the entire contents of an [INI](https://en.wikipedia.org/wiki/INI_file) file.


## Installation

``` bash
$ npm install utils-fs-read-ini
```


## Usage

``` javascript
var read = require( 'utils-fs-read-ini' );
```

#### read( path, [ options,] clbk )

Reads the entire contents of an [INI](https://en.wikipedia.org/wiki/INI_file) file.

``` javascript
read( '/path/to/data.ini', onData );

function onData( error, data ) {
	if ( error ) {
		console.error( error );
	} else {
		console.log( data );
	}
}
```

The `function` accepts the same options as [`properties#parse`](https://github.com/gagle/node-ini#parse), except

-	`path` is __always__ `true`.
-	`sections` is __always__ `true`.
-	`strict` is __always__ `true`.
-	`separators` is __always__ `'='`.
-	`comments`, by default, begin with `';'`.

``` javascript
var opts = {
	'comments': [ ';', '#' ]
};

read( '/path/to/data.ini', opts, onData );

function onData( error, data ) {
	if ( error ) {
		console.error( error );
	} else {
		console.log( data );
	}
}
```


#### read.sync( path[, options] )<commit_msg>Fixes broken link<commit_after>INI
===
[![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Coverage Status][codecov-image]][codecov-url] [![Dependencies][dependencies-image]][dependencies-url]

> Reads the entire contents of an [INI](https://en.wikipedia.org/wiki/INI_file) file.


## Installation

``` bash
$ npm install utils-fs-read-ini
```


## Usage

``` javascript
var read = require( 'utils-fs-read-ini' );
```

#### read( path, [ options,] clbk )

Reads the entire contents of an [INI](https://en.wikipedia.org/wiki/INI_file) file.

``` javascript
read( '/path/to/data.ini', onData );

function onData( error, data ) {
	if ( error ) {
		console.error( error );
	} else {
		console.log( data );
	}
}
```

The `function` accepts the same options as [`properties#parse`](https://github.com/gagle/node-properties#parse), except

-	`path` is __always__ `true`.
-	`sections` is __always__ `true`.
-	`strict` is __always__ `true`.
-	`separators` is __always__ `'='`.
-	`comments`, by default, begin with `';'`.

``` javascript
var opts = {
	'comments': [ ';', '#' ]
};

read( '/path/to/data.ini', opts, onData );

function onData( error, data ) {
	if ( error ) {
		console.error( error );
	} else {
		console.log( data );
	}
}
```


#### read.sync( path[, options] )
{'fraction_non_alphanumeric': 0.20641669887901043, 'fraction_numerical': 0.0, 'mean_word_length': 4.104536489151874, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 5, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '551548', 'n_tokens_mistral': 996, 'n_tokens_neox': 937, 'n_words': 212}