blob: 7bc759af686e1efe6d094dfdc7b1c05abf9eb2cd (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
# `time-require` @ [](http://oss.jaguard.com) [](http://gulpjs.com)
> Displays the execution time for Node.js modules loading by hooking and tracing all `require()` calls.
This module was inspired by [@sindresorhus](https://twitter.com/sindresorhus)'s [time-grunt](https://github.com/sindresorhus/time-grunt).
## Project status
- NPM version: [](https://www.npmjs.org/package/time-require)
- NPM downloads: [](https://www.npmjs.org/package/time-require)
- GitHub release: [](https://www.npmjs.org/package/time-require)
- Travis-CI build: [](http://travis-ci.org/jaguard/time-require)
- Drone.io build: [](https://github.com/jaguard/time-require)
- Dependencies: [](https://david-dm.org/jaguard/time-require#info=dependencies)
- Dev Dependencies: [](https://david-dm.org/jaguard/time-require#info=devDependencies)
Default usage (non-verbose) showing required modules in loaded order, above 1% treshold
Verbose (all) & sorted usage showing all required modules in sorted order
## Install
Install with [npm](https://npmjs.org/package/time-require)
```
npm install --save time-require
```
## Usage
1. Embeded usage, generally as first `require()` call in your main module.
```js
require("time-require");
```
2. External usage with `--require` preload supported by [Liftoff](https://github.com/tkellen/node-liftoff) driven CLI modules like [gulp.js](http://gulpjs.com/) or [Grunt-Next](https://github.com/gruntjs/grunt-next)
```
gulp --require time-require --sorted
```
3. If you're using [gulp.js](http://gulpjs.com/), use instead [gulpt](https://github.com/jaguard/gulpt), a `gulp` CLI wrapper that automatically preload `time-require`.
```
npm install -g gulpt
gulpt build --sorted
```
## Display layout
Modules loading that take less than `1%` of the total time are hidden to reduce clutter.
To show **all** the modules use the `--verbose` (or `--V`) flag on the running CLI.
To **sort** the modules according to the loading time (longest on top) use the `--sorted` (or `--s`) flag on the running CLI.
## Documentation
Detailed API documentation can be found in ['doc'](doc/api.md) folder.
## Development
Detailed development documentation can be found in ['doc'](doc/dev.md) folder.
## License
[MIT](https://github.com/jaguard/time-require/raw/master/LICENSE) © [Jaguard OSS](http://oss.jaguard.com)
## Changelog
- v0.1.2 (2014.04.20)
* README.md: add NPM downloads and GitHub release, add `gulpt` usage, remove BitBucket hosting/refs
* package.json: update dependencies
* .npmignore: remove all development-related files from NPM (clone the repo instead)
- v0.1.1 (2014.04.10)
* gulpfile.js: add `notifyError` for stream error notification, add `seqTask` for sequential task control, fix `project.js` config replacing `lib/` with `src/`
* README.md: detail project hosting [@BitBucket](https://bitbucket.org/jaguard/time-require) & mirror [@GitHub](https://github.com/jaguard/time-require).
* LICENSE.md renamed to LICENSE to keep it as a simple text file
* package.json: set the [GitHub](https://github.com/jaguard/time-require) mirror as repository, add `run-sequence` for task order control, add `gulp-notify` for notification support
- v0.1.0 (2014.04.10)
+ Added `.travis.yml` file for travis-ci.org build support
+ Published `time-require` module to [npm](https://www.npmjs.org/package/time-require)
* Include screenshoots as absolute links
- v0.0.1 (2014.03.10)
+ Initial release
|
