Add filter, init as default, bump to v1.0.2

Author: doesdev

README.md

@@ -10,33 +10,38 @@ $ npm install --save-dev rollup-analyzer
 
 ## api
 
-### init(options)
+### rollupAnalyzer
+the default exported function is identical to init, and returns the same functions as export {init, formatted, analyze}. So, you can `require('rollup-analyzer')` or `require('rollup-analyzer')({limit: 5})` and use the same functions.
+
+### rollupAnalyzer.init(options)
 set options to use in analysis (this step is optional)
 - **options** *(Object)*
   - **limit** - *optional*
     - type: Number
     - default: `null`
     - description: Limit number of files to output analysis of, sorted by DESC size
+  - **filter** - *optional*
+    - type: Array | String
+    - default: `null`
+    - description: Filter to only show imports matching the specified name(s)
   - **root** - *optional*
     - type: String
     - default: `process.cwd()`
     - description: Application directory, used to display file paths relatively
 
-### formatted(bundle)
+### rollupAnalyzer.formatted(bundle)
 returns Promise which resolves with well formatted analysis string (for CLI printing)
 - **bundle** *(Rollup Bundle)* - *required*
 
-### analyze(bundle)
+### rollupAnalyzer.analyze(bundle)
 returns Promise which resolves with array of objects describing each imported file
 - **bundle** *(Rollup Bundle)* - *required*
 
 ## usage
 
 ```js
-const rollupAnalyzer = require('rollup-analyzer')
+const rollupAnalyzer = require('rollup-analyzer')({limit: 5})
 rollup.rollup({/*...*/}).then((bundle) => {
-  // init is an optional step that can be used to set options
-  rollupAnalyzer.init({limit: 5})
   // print console optimized analysis string
   rollupAnalyzer.formatted(bundle).then(console.log).catch(console.error)
 })

index-es6.js

@@ -6,7 +6,7 @@ const tab = '  '
 const borderX = `${Array(30).join('-')}\n`
 let proc = process
 let root = proc && proc.cwd ? proc.cwd() : null
-let limit
+let limit, filter
 
 // Helpers
 const formatBytes = (bytes) => {
@@ -19,15 +19,24 @@ const formatBytes = (bytes) => {
 }
 
 // Exports
-export {init, analyze, formatted}
+export default analyzer
 
 // Main
 function init (opts) {
   opts = opts || {}
   limit = opts.limit
+  filter = opts.filter
   root = opts.root || root
 }
 
+function analyzer (opts) {
+  init(opts)
+  return {init, formatted, analyze}
+}
+analyzer.init = init
+analyzer.formatted = formatted
+analyzer.analyze = analyze
+
 function formatted (bndl) { return analyze(bndl, true) }
 
 function analyze (bundle, format) {
@@ -38,13 +47,15 @@ function analyze (bundle, format) {
       let id = m.id.replace(root, '')
       let size = Buffer.byteLength(m.code, 'utf8') || 0
       bundleSize += size
+      if (Array.isArray(filter) && !filter.some((f) => id.match(f))) return null
+      if (filter && !id.match(filter)) return null
       m.dependencies.forEach((d) => {
         d = d.replace(root, '')
         deps[d] = deps[d] || []
         deps[d].push(id)
       })
       return {id, size}
-    })
+    }).filter((m) => m)
     modules.sort((a, b) => b.size - a.size)
     if (limit) modules = modules.slice(0, limit)
     modules.forEach((m) => {

index.js

@@ -1,14 +1,13 @@
 'use strict';
 
-Object.defineProperty(exports, '__esModule', { value: true });
-
 // Setup
 const buf = ' ';
 const tab = '  ';
 const borderX = `${Array(30).join('-')}\n`;
 let proc = process;
 let root = proc && proc.cwd ? proc.cwd() : null;
 let limit;
+let filter;
 
 // Helpers
 const formatBytes = (bytes) => {
@@ -24,9 +23,18 @@ const formatBytes = (bytes) => {
 function init (opts) {
   opts = opts || {};
   limit = opts.limit;
+  filter = opts.filter;
   root = opts.root || root;
 }
 
+function analyzer$1 (opts) {
+  init(opts);
+  return {init, formatted, analyze}
+}
+analyzer$1.init = init;
+analyzer$1.formatted = formatted;
+analyzer$1.analyze = analyze;
+
 function formatted (bndl) { return analyze(bndl, true) }
 
 function analyze (bundle, format) {
@@ -37,13 +45,15 @@ function analyze (bundle, format) {
       let id = m.id.replace(root, '');
       let size = Buffer.byteLength(m.code, 'utf8') || 0;
       bundleSize += size;
+      if (Array.isArray(filter) && !filter.some((f) => id.match(f))) return null
+      if (filter && !id.match(filter)) return null
       m.dependencies.forEach((d) => {
         d = d.replace(root, '');
         deps[d] = deps[d] || [];
         deps[d].push(id);
       });
       return {id, size}
-    });
+    }).filter((m) => m);
     modules.sort((a, b) => b.size - a.size);
     if (limit) modules = modules.slice(0, limit);
     modules.forEach((m) => {
@@ -68,6 +78,4 @@ function analyze (bundle, format) {
   })
 }
 
-exports.init = init;
-exports.analyze = analyze;
-exports.formatted = formatted;
+module.exports = analyzer$1;

package.json

@@ -1,6 +1,6 @@
 {
   "name": "rollup-analyzer",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Analyze file sizes of rollup bundled imports",
   "main": "index.js",
   "jsnext:main": "index-es6.js",