nodereport - npm Package Compare versions

Comparing version 1.0.4 to 1.0.5

CHANGES.md

@@ -0,1 +1,33 @@
[phone], Version 1.0.5
+=========================
+
+ * Fix for failure in fatal error (OOM) test (Richard Chamberlain)
+
+ * Add support for nodereport on AIX (Richard Chamberlain)
+
+ * Deleting AUTHORS file. (Richard Chamberlain)
+
+ * Correct Javascript to JavaScript in README.md (Richard Chamberlain)
+
+ * Correct upper-case NPM, should be lower-case (Richard Chamberlain)
+
+ * Remove specific URLs for NPM (Richard Chamberlain)
+
+ * Add MAINTAINER.md file to document NPM release procedure (Richard Chamberlain)
+
+ * Set/correct package metadata in package.json (Richard Chamberlain)
+
+ * README documentation improvements (Richard Chamberlain)
+
+ * .gitignore the test autorun log file (Sam Roberts)
+
+ * test: require this module using correct syntax (Sam Roberts)
+
+ * .npmignore: do not pack unnecessary files (Sam Roberts)
+
+ * .gitignore: ignore npm ephemera and node reports (Sam Roberts)
+
+ * Need to define __STDC_FORMAT_MACROS for some glibc versions (Richard Chamberlain)
+
+
 2016-10-28, Version 1.0.4
@@ -2,0 +34,0 @@ =========================

package.json

 {
   "name": "nodereport",
-  "main": "build/Release/nodereport.node",
-  "version": "1.0.4",
+  "main": "nodereport.node",
+  "version": "1.0.5",
   "description": "Diagnostic NodeReport",
-  "homepage": "https://github.com/nodejs/nodereport",
+  "homepage": "https://github.com/nodejs/nodereport#readme",
   "repository": {
@@ -18,5 +18,11 @@ "type": "git",
   "license": "MIT",
+  "contributors": [
+    "Richard Chamberlain <[e-mail]> (https://github.com/rnchamberlain)"
+  ],
   "scripts": {
     "test": "node test/autorun.js"
+  },
+  "bugs": {
+    "url": "https://github.com/nodejs/nodereport/issues"
   }
 }

README.md

 # nodereport
 
-nodereport is an add-on for Node.js, delivered as an NPM native module,
+nodereport is an add-on for Node.js, delivered as an npm native module,
 which provides a human-readable diagnostic summary report, written
 to file. The report is intended for development, test and production
 use, to capture and preserve information for problem determination.
-It includes Javascript and native stack traces, heap statistics,
+It includes JavaScript and native stack traces, heap statistics,
 platform information and resource usage etc. With the report enabled,
 reports can be triggered on unhandled exceptions, fatal errors, signals
-and calls to a Javascript API.
+and calls to a JavaScript API. The module supports Node.js v4, v6 and v7
+on Linux, MacOS, Windows and AIX.
 
 Usage:
 
-    npm install nodejs/nodereport
+    npm install nodereport
 
-    var nodereport = require('nodereport');
-
 By default, this will allow a NodeReport to be triggered via an API
-call from a JavaScript application. The filename of the NodeReport is
-returned. The default filename includes the date, time, PID and a
-sequence number. Alternatively a filename can be specified on the API call.
+call from a JavaScript application.
 
+    var nodereport = require('nodereport');
     nodereport.triggerReport();
 
-    var filename = nodereport.triggerReport();
+Content of the NodeReport consists of a header section containing the event
+type, date, time, PID and Node version, sections containing JavaScript and
+native stack traces, a section containing V8 heap information, a section
+containing libuv handle information and an OS platform information section
+showing CPU and memory usage and system limits. An example NodeReport can be
+triggered using the Node.js REPL:
 
+    C:\test>node
+    > nodereport = require('nodereport')
+    > nodereport.triggerReport()
+    Writing Node.js report to file: NodeReport.20161020.091102.8480.001.txt
+    Node.js report completed
+    >
+
+When a NodeReport is triggered, start and end messages are issued to stderr
+and the filename of the report is returned to the caller. The default filename
+includes the date, time, PID and a sequence number. Alternatively, a filename
+can be specified as a parameter on the triggerReport() call.
+
     nodereport.triggerReport("myReportName");
 
-Content of the NodeReport in the initial implementation consists of a
-header section containing the event type, date, time, PID and Node version,
-sections containing Javascript and native stack traces, a section containing
-V8 heap information, a section containing libuv handle information and an OS
-platform information section showing CPU and memory usage and system limits.
-The following messages are issued to stderr when a NodeReport is triggered:
+A NodeReport can also be triggered automatically on unhandled exceptions, fatal
+error events (for example out of memory errors), and signals (Linux/MacOS only).
+Triggering on these events can be enabled using the following API call:
 
-    Writing Node.js error report to file: NodeReport.201605113.145311.26249.001.txt
-    Node.js error report completed
+    nodereport.setEvents("exception+fatalerror+signal+apicall");
 
-A NodeReport can also be triggered on unhandled exception and fatal error
-events, and/or signals (Linux/OSX only). These and other options can be 
-enabled or disabled using the following APIs:
+Additional configuration is available using the following APIs:
 
-    nodereport.setEvents("exception+fatalerror+signal+apicall");
     nodereport.setSignal("SIGUSR2|SIGQUIT");
@@ -59,8 +67,9 @@ nodereport.setFileName("stdout|stderr|<filename>");
 
-Sample programs for triggering NodeReports are provided in the
-node_modules/nodereport/demo directory:
+To see examples of NodeReports generated from these events you can run the
+demonstration applications provided in the nodereport github repository. These are
+Node.js applications which will prompt you to trigger the required event.
 
-    api.js - NodeReport triggered by Javascript API call
-    exception.js - NodeReport triggered by unhandled exception
-    fatalerror.js - NodeReport triggered by fatal error on Javascript heap out of memory
-    loop.js - looping application, NodeReport triggered using kill -USR2 <pid>
+1. api.js - NodeReport triggered by JavaScript API call
+2. exception.js - NodeReport triggered by unhandled exception
+3. fatalerror.js - NodeReport triggered by fatal error on JavaScript heap out of memory
+4. loop.js - looping application, NodeReport triggered using kill -USR2 <pid>

New alerts

Empty package

Supply chain risk

Package does not contain any code. It may be removed, is name squatting, or the result of a faulty package publish.

Found 1 instance in 1 package

Fixed alerts

Network access

Supply chain risk

This module accesses the network.

Found 1 instance in 1 package

No contributors or author data

Maintenance

Package does not specify a list of contributors or an author in package.json.

Found 1 instance in 1 package

No bug tracker

Maintenance

Package does not have a linked bug tracker in package.json.

Found 1 instance in 1 package

Improved metrics

Number of low maintenance alerts

1

decreased by-66.67%

Number of lines in readme file

75

increased by13.64%

Number of medium supply chain risk alerts

2

decreased by-60%

Worsened metrics

Total package byte prevSize

55699

decreased by-7.29%

Number of package files

8

decreased by-50%

Lines of code

0

decreased by-100%

No dependency changes