# grunt-complexity

> Evaluates code maintainability using Halstead and Cyclomatic metrics.

Latest version **1.1.0** (published 2017-05-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install grunt-complexity
pnpm add grunt-complexity
yarn add grunt-complexity
bun add grunt-complexity
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2017-05-10 |
| First published | 2013-01-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Nate Hunzaker |
| Maintainers | lawson, nhunzaker |
| Keywords | gruntplugin, complexity, halstead, cyclomatic |

## Links

- npm: https://www.npmjs.com/package/grunt-complexity
- Repository: https://github.com/vigetlabs/grunt-complexity
- Homepage: https://github.com/vigetlabs/grunt-complexity.git
- Issues: https://github.com/vigetlabs/grunt-complexity/issues
- npm.io page: https://npm.io/package/grunt-complexity

## Dependencies (4)

- [grunt](https://npm.io/package/grunt.md) >=0.4.x
- [lodash](https://npm.io/package/lodash.md) ^4.15.0
- [fs-extra](https://npm.io/package/fs-extra.md) ~0.30.0
- [typhonjs-escomplex](https://npm.io/package/typhonjs-escomplex.md) 0.0.12

## Recent versions

- 1.1.0 (latest) — 2017-05-10
- 1.1.0-beta (beta) — 2017-05-05
- 1.0.1 — 2016-08-25
- 1.0.0 — 2016-08-18
- 1.0.0-rc2 — 2016-08-18
- 1.0.0-rc — 2016-08-18
- 1.0.0-alpha — 2016-08-18
- 0.4.0 — 2016-08-18
- 0.3.1 — 2016-08-18
- 0.3.0 — 2015-01-20
- 0.2.0 — 2014-06-23
- 0.1.71 — 2014-06-12
- 0.1.7 — 2014-05-29
- 0.1.6 — 2014-04-24
- 0.1.51 — 2014-03-31
- … 12 more at https://npm.io/package/grunt-complexity/versions

## README

# Grunt-Complexity

[![Build Status](https://travis-ci.org/vigetlabs/grunt-complexity.svg)](https://travis-ci.org/vigetlabs/grunt-complexity)

A [grunt](http://github.com/gruntjs/grunt/) task that utilizes
[complexity-report](https://github.com/philbooth/complexityReport.js)
to evaluate the complexity and maintainability of code.

## Versions

- Use version 0.0.7 for Grunt 0.3.x
- Use versions 0.1.x for Grunt 0.4.x

![screenshot](https://raw.github.com/vigetlabs/grunt-complexity/master/example.png)
![screenshot](https://raw.github.com/vigetlabs/grunt-complexity/master/complexity.png)

## Usage

```bash
npm install grunt-complexity --save-dev
```

Within your grunt file:

```javascript
    // Project configuration.
	grunt.initConfig({

		complexity: {
			generic: {
				src: ['grunt.js', 'tasks/grunt-complexity.js'],
				exclude: ['doNotTest.js'],
				options: {
					breakOnErrors: true,
					jsLintXML: 'report.xml',         // create XML JSLint-like report
					checkstyleXML: 'checkstyle.xml', // create checkstyle report
					pmdXML: 'pmd.xml',               // create pmd report
					errorsOnly: false,               // show only maintainability errors
					cyclomatic: [3, 7, 12],          // or optionally a single value, like 3
					halstead: [8, 13, 20],           // or optionally a single value, like 8
					maintainability: 100,
					hideComplexFunctions: false,     // only display maintainability
					broadcast: false                 // broadcast data over event-bus
				}
			}
		}


	});

	grunt.loadNpmTasks('grunt-complexity');
	grunt.registerTask('default', 'complexity');
```

## What is Cyclomatic and Halstead?

Documentation on this to come. For now, see [jscomplexity.org](http://jscomplexity.org/complexity)

## Reporter

Set the `broadcast` option to `true` to send the aggregated data over the
grunt-event bus.

Emitted events are:

* `grunt-complexity.start`
* `grunt-complexity.maintainability, payload`
* `grunt-complexity.end`

```js
// payload of grunt-complexity.maintainability
{
  filepath: /path/to/file,
  valid: true|false,
  maintainability: 123.42
}
```

## Contributing

This repo has a submodule, so after you `npm install`, you'll want to run:

```bash
git submodule init
git submodule update
cd test/grunt.0.4
npm install
cd ...
```

Tests can be run with `npm test`.

## License

`grunt-complexity` is released under the [MIT License](http://opensource.org/licenses/MIT).

## Contributors

- Nate Hunzaker([nhunzaker](https://github.com/nhunzaker))
- Golo Roden ([goloroden](https://github.com/goloroden))
- Tomasz Drwięga ([tomusdrw](https://github.com/tomusdrw))
- Doug Avery ([averyvery](https://github.com/averyvery))
- Jozsef Kozma ([jzsfkzm](https://github.com/jzsfkzm))
- Patrick Williams [(pwmckenna](https://github.com/pwmckenna))
- Luís Couto ([Couto](https://github.com/Couto))
- Roman Liutikov ([roman01la](https://github.com/roman01la))
- Nick Weingartner ([streetlight](https://github.com/streetlight))
- David Linse ([davidlinse](https://github.com/davidlinse))
- Tim Carry ([pixelastic](https://github.com/pixelastic))

***

<a href="http://code.viget.com">
  <img src="http://code.viget.com/github-banner.png" alt="Code At Viget">
</a>

Visit [code.viget.com](http://code.viget.com) to see more projects from [Viget.](https://viget.com)

---
_Source: https://npm.io/package/grunt-complexity · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._