Release 0.11.0

.github/workflows/release.yml

@@ -0,0 +1,20 @@
+name: Create Release
+on:
+  release:
+    types: [published]
+jobs:
+  build:
+    name: Create Release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      # Setup .npmrc file to publish to npm
+      - uses: actions/setup-node@v1
+        with:
+          node-version: '14.0'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm install
+      # Publish to npm
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/test.yml

@@ -0,0 +1,37 @@
+# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
+
+name: Node.js CI
+
+on:
+  [push, pull_request]
+
+jobs:
+  test-execution:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: 
+          - "14.0"
+          - "10.0"
+        splunk-version:
+          - latest
+          - "8.0"
+    services:
+      splunk:
+        image: splunk/splunk:${{matrix.splunk-version}}
+        env:
+          SPLUNK_START_ARGS: --accept-license
+          SPLUNK_PASSWORD: changed!
+        ports:
+          - 8088:8088
+          - 8089:8089
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v2
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - name: Test Execution
+      run: npm test

.jshintrc

@@ -34,6 +34,7 @@
     "es5"           : false,     // Allow EcmaScript 5 syntax.
     "strict"        : false,    // Require `use strict` pragma  in every file.
     "globalstrict"  : false,    // Allow global "use strict" (also enables 'strict').
+    "esversion"     : 6,
 
 
     // The Good Parts.

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Splunk logging for JavaScript
 
+## v0.11.0
+
+### New features & APIs
+
+* Replaced client implementation to use `needle` in lieu of deprecated `request`
+* Replaced client implementation to use `nyc` in lieu of deprecated `istanbul`
+
+### Minor changes
+
+* Converted CI from Travis to Github Actions and added CD
+* Upgrade version of jsdoc to 3.6.7.
+* Upgrade version of jshint to 2.12.0.
+* Upgrade version of mocha to 8.4.0.
+
 ## v0.10.1
 
 ### Minor changes

CONTRIBUTING.md

@@ -2,21 +2,17 @@
 
 ## How to contribute
 
-If you would like to contribute to this project, go here for more information:
-
-* [Splunk and open source][contributions]
-* [Individual contributions][indivcontrib]
-* [Company contributions][companycontrib]
+If you would like to contribute to this project, see [Contributions to Splunk][indivcontrib] for more information.
 
 ## Issues & Bug Reports
 
 If you're seeing some unexpected behavior with this project, please create an [issue on GitHub][issues] with the following information:
 
-0. Version of this project you're using (ex: 0.8.0)
-0. Platform version (ex: Windows Server 2012)
-0. Framework version (ex: Node.js 0.10.37)
-0. Splunk version (ex: 6.3.0)
-0. Other relevant information (ex: local/remote environment, Splunk network configuration)
+1. Version of this project you're using (ex: 0.8.0)
+1. Platform version (ex: Windows Server 2012)
+1. Framework version (ex: Node.js 0.10.37)
+1. Splunk version (ex: 6.3.0)
+1. Other relevant information (ex: local/remote environment, Splunk network configuration)
 
 Alternatively, if you have a Splunk question please ask on [Splunk Answers][answers]
 
@@ -26,14 +22,14 @@ We love to see pull requests!
 
 To create a pull request:
 
-0. Fill out the [Individual Contributor Agreement][indivcontrib].
-0. Fork [the repository][repo].
-0. Make changes to the **`develop`** branch, preferably with tests.
-0. Create a [pull request][pulls] against the **`develop`** branch.
+1. Fill out the [Individual Contributor Agreement][indivcontrib].
+1. Fork [the repository][repo].
+1. Make changes to the **`develop`** branch, preferably with tests.
+1. Create a [pull request][pulls] against the **`develop`** branch.
 
 ## Contact us
 
-You can reach Splunk support at [email protected]_ if you have Splunk related questions.
+You can [contact support][contact] if you have Splunk related questions.
 
 You can reach the Developer Platform team at [email protected]_.
 
@@ -43,4 +39,5 @@ You can reach the Developer Platform team at [email protected]_.
 [answers]:                  http://answers.splunk.com/
 [repo]:                     https://github.com/splunk/splunk-logging-javascript
 [issues]:                   https://github.com/splunk/splunk-logging-javascript/issues
-[pulls]:                    https://github.com/splunk/splunk-logging-javascript/pulls
+[pulls]:                    https://github.com/splunk/splunk-logging-javascript/pulls
+[contact]:                  https://www.splunk.com/en_us/support-and-services.html

CREDITS.md

@@ -0,0 +1,7 @@
+# Third-party software credits
+
+Some of the components included in the Splunk logging for JavaScript are licensed under free or open source licenses. We wish to thank the contributors to those projects.
+
+| Contributor | Description | License |
+|:----------- |:----------- |:------- |
+| [needle](https://github.com/tomas/needle) | Node.js http client | [MIT](https://github.com/splunk/splunk-javascript-logging/blob/master/licenses/LICENSE-NEEDLE) |

Makefile

@@ -0,0 +1,47 @@
+# text reset
+NO_COLOR=\033[0m
+# green
+OK_COLOR=\033[32;01m
+# red
+ERROR_COLOR=\033[31;01m
+# cyan
+WARN_COLOR=\033[36;01m
+# yellow
+ATTN_COLOR=\033[33;01m
+
+ROOT_DIR := $(shell git rev-parse --show-toplevel)
+
+VERSION := `git describe --tags --dirty 2>/dev/null`
+COMMITHASH := `git rev-parse --short HEAD 2>/dev/null`
+DATE := `date "+%FT%T%z"`
+
+.PHONY: all
+all: init test
+
+init:
+	@echo "$(ATTN_COLOR)==> init $(NO_COLOR)"
+
+.PHONY: test
+test:
+	@echo "$(ATTN_COLOR)==> test $(NO_COLOR)"
+	@npm test
+
+.PHONY: test_specific
+test_specific:
+	@echo "$(ATTN_COLOR)==> test_specific $(NO_COLOR)"
+	@sh ./scripts/test_specific.sh
+
+.PHONY: up
+up:
+	@echo "$(ATTN_COLOR)==> up $(NO_COLOR)"
+	@docker-compose up -d
+
+.PHONY: wait_up
+wait_up:
+	@echo "$(ATTN_COLOR)==> wait_up $(NO_COLOR)"
+	@for i in `seq 0 180`; do if docker exec -it splunk /sbin/checkstate.sh &> /dev/null; then break; fi; printf "\rWaiting for Splunk for %s seconds..." $$i; sleep 1; done
+
+.PHONY: down
+down:
+	@echo "$(ATTN_COLOR)==> down $(NO_COLOR)"
+	@docker-compose stop

README.md

@@ -1,13 +1,13 @@
 # Splunk logging for JavaScript
 
-#### Version 0.10.1
+#### Version 0.11.0
 
 This project provides a simple JavaScript interface for logging to HTTP Event Collector in Splunk Enterprise and Splunk Cloud.
 
 ## Requirements
 
-* Node.js v4 or later.
-* Splunk Enterprise 6.3.0 or later, or Splunk Cloud.
+* Node.js v4 or later. Splunk logging for Javascript is tested with Node.js v10.0 and v14.0.
+* Splunk Enterprise 6.3.0 or later, or Splunk Cloud. Splunk logging for Javascript is tested with Splunk Enterprise 8.0 and 8.2.0.
 * An HTTP Event Collector token from your Splunk Enterprise server.
 
 ## Installation

docker-compose.yml

@@ -0,0 +1,18 @@
+version: '3.8'
+
+services:
+    splunk:
+        image: "splunk/splunk:latest"
+        container_name: splunk
+        environment:
+            - SPLUNK_START_ARGS=--accept-license
+            - SPLUNK_PASSWORD=changed!
+        ports:
+            - 8000:8000
+            - 8088:8088
+            - 8089:8089
+        healthcheck:
+            test: ['CMD', 'curl', '-f', 'https://localhost:8000']
+            interval: 5s
+            timeout: 5s
+            retries: 20

licenses/LICENSE-NEEDLE

@@ -0,0 +1,19 @@
+Copyright (c) Fork, Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.