Initial commit

.gitattributes

@@ -0,0 +1,11 @@
+* text=auto
+
+*.jq text
+*.json text
+*.md text
+*.sh text
+
+./LICENSE* text
+
+.gitattributes text
+.gitignore text

.gitignore

@@ -0,0 +1 @@
+.jq/

LICENSE

@@ -0,0 +1,20 @@
+jq-ratio-buckets jq package. Counter buckets for the [0,1] range.
+Copyright (c) 2015 Joel Purra <http://joelpurra.com/>
+
+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.

README.md

@@ -0,0 +1,46 @@
+<p align="center">
+  <a href="https://github.com/joelpurra/jqnpm"><img src="https://rawgit.com/joelpurra/jqnpm/master/resources/logotype/penrose-triangle.svg" alt="jqnpm logotype, a Penrose triangle" width="100" border="0" /></a>
+</p>
+
+# [jq-ratio-buckets](https://github.com/joelpurra/jq-ratio-buckets)
+
+Counter buckets for the [0,1] range. Useful for having the normalized distribution of ratios 0.0-1.0 (percentages 0-100%) created from other sources.
+
+This is a package for the command-line JSON processor [`jq`](https://stedolan.github.io/jq/). Install the package in your jq project/package directory with [`jqnpm`](https://github.com/joelpurra/jqnpm):
+
+```bash
+jqnpm install joelpurra/jq-ratio-buckets
+```
+
+
+
+## Usage
+
+
+```jq
+import "joelpurra/jq-ratio-buckets" as RatioBuckets;
+
+# Create new ratio buckets.
+RatioBuckets::create                # [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]
+
+# Increment at 0 (0%)
+| RatioBuckets::increment(0; 99)    # [ 99, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]
+
+# Increment at 1/2 (0.5, 50%)
+| RatioBuckets::increment(1/2)      # [ 99, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]
+
+# Increment at 1 (100%)
+| RatioBuckets::increment(1)        # [ 99, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1 ]
+
+# It's not plain to see, but this is an excellent base for creating distribution graphs.
+```
+
+
+
+---
+
+## License
+Copyright (c) 2015 Joel Purra <http://joelpurra.com/>
+All rights reserved.
+
+When using **jq-ratio-buckets**, comply to the MIT license. Please see the LICENSE file for details.

jq.json

@@ -0,0 +1,30 @@
+{
+    "name": "ratio-buckets",
+    "version": "0.1.0",
+    "description": "Counter buckets for the [0,1] range.",
+    "homepage": "https://github.com/joelpurra/jq-ratio-buckets",
+    "bugs": "https://github.com/joelpurra/jq-ratio-buckets/issues",
+    "author": {
+        "name": "Joel Purra",
+        "url": "http://joelpurra.com/"
+    },
+    "main": "./jq/main.jq",
+    "repository": {
+        "type": "git",
+        "url": "git://github.com/joelpurra/jq-ratio-buckets.git"
+    },
+    "dependencies": {
+        "joelpurra/jq-counter-buckets": "^0.1.0"
+    },
+    "engines": {
+        "jq": "^1.5.0",
+        "jqnpm": "^1.0.0"
+    },
+    "licenses": [{
+        "type": "MIT",
+        "url": "http://opensource.org/licenses/MIT"
+    }],
+    "keywords": [
+        "jq-package"
+    ]
+}

jq/main.jq

@@ -0,0 +1,21 @@
+import "joelpurra/jq-counter-buckets" as CounterBucket;
+
+# TODO: create a math package.
+def asPercentageInteger:
+	. * 100
+	| tostring
+	| split(".")
+	| .[0]
+	| tonumber;
+
+def create:
+	# Assuming decimal numbers [0,1].
+	# 101 buckets because it's [0,100].
+	CounterBucket::create(101);
+
+def increment($ratio; $count):
+	($ratio | asPercentageInteger) as $index
+	| CounterBucket::increment($index; $count);
+
+def increment($ratio):
+	increment($ratio; 1);

tests/all.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+
+
+fileUnderTest="${BASH_SOURCE%/*}/../jq/main.jq"
+
+
+read -d '' fourLineTests <<-'EOF' || true
+asPercentageInteger: Can calculate integer 0.
+0
+asPercentageInteger
+0
+
+asPercentageInteger: Can calculate integer 50.
+0.5
+asPercentageInteger
+50
+
+asPercentageInteger: Can calculate integer 100.
+1
+asPercentageInteger
+100
+
+asPercentageInteger: Can calculate integer 110.
+1.1
+asPercentageInteger
+110
+
+create: Can create new ratio buckets.
+null
+create
+[ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]
+
+increment: Can increment 0.
+null
+create | increment(0)
+[ 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]
+
+increment: Can increment 0 twice.
+null
+create | increment(0) | increment(0)
+[ 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]
+
+increment: Can increment 0 by 10.
+null
+create | increment(0; 10)
+[ 10, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]
+
+increment: Can increment 0.5.
+null
+create | increment(1/2)
+[ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]
+
+increment: Can increment 1.
+null
+create | increment(1)
+[ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1 ]
+
+increment: Can't increment 1.1. (Throws error.)
+null
+create | increment(1.1)
+
+EOF
+
+function testAllFourLineTests () {
+	echo "$fourLineTests" | runAllFourLineTests
+}
+
+
+# Run tests above automatically.
+# Custom tests can be added by adding new function with a name that starts with "test": function testSomething () { some test code; }
+source "${BASH_SOURCE%/*}/test-runner.sh"

tests/test-runner.sh

@@ -0,0 +1,39 @@
+function runAllFourLineTests () {
+	DONE=false
+	until $DONE;
+	do
+		declare COLOR_WHITE=""
+		declare COLOR_NO_COLOR=""
+
+		local title
+		local description
+		local input
+		local code
+		local expected
+
+		IFS=':' read -d ':' title
+		read description
+		read input
+		read code
+		read expected
+
+		echo -ne "$COLOR_WHITE"
+		echo -nE "$title"
+		echo -ne "$COLOR_NO_COLOR"
+		echo -E ": $description"
+
+		local expectedFormatted=$(echo "$expected" | jq '.')
+
+		local output=$(echo "$input" | jqnpm execute -f <(echo "$code" | cat "$fileUnderTest" -))
+
+		assertEquals "${title}: ${description}" "$expectedFormatted" "$output"
+
+		read || DONE=true # Empty line between tests.
+	done
+}
+
+
+# Requires shUnit2.
+# https://code.google.com/p/shunit2/
+[[ -z $(which shunit2) ]] && { echo "shunit2 is required." >&2; exit 1; }
+source shunit2