V. 0.9.0

jsonstatslice added

Author: Xavier Badosa

README.md

@@ -13,6 +13,7 @@ Available commands:
 * [jsonstat2arrobj](#jsonstat2arrobj) - converts JSON-stat into an array of objects
 * [jsonstat2csv](#jsonstat2csv) - converts JSON-stat into CSV
 * [jsonstat2object](#jsonstat2object) - converts JSON-stat into an object
+* [jsonstatslice](#jsonstatslice) - creates a subset from JSON-stat
 
 ## Example
 
@@ -351,3 +352,29 @@ Boolean. Identifies categories by ID instead of label.
 ```
 jsonstat2object oecd.json oecd-object.json --cid
 ```
+
+## jsonstatslice
+
+Creates a JSON-stat subset from a JSON-stat dataset. A JSON-stat subset has the same dimensions as the original dataset but with some of them fixed for a certain category.
+
+```
+jsonstatslice oecd.json oecd-subset.json -f area=DE,year=2014
+```
+
+In the previous example, oecd-subset.json only contains data for Germany in 2014.
+
+#### --filter (-f)
+
+String. Specifies a filter. When no filter is specified, the original JSON-stat will be returned.
+
+A filter is a comma-separated list of selection criteria. Each criterion must follow the pattern *{dimension id}={category id}*. Because dimension ids and category ids are strings that can contain whitespaces, they should be double-quoted.
+
+```
+"area"="DE","year"="2014"
+```
+
+forces the subset to keep only category "DE" from dimension "area" and category "2014" from dimension "year". Because these ids do not contain whitespaces, double quotes are not strictly necessary.
+
+```
+area=DE,year=2014
+```

jsonstatslice

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+var
+	argv=require("yargs")
+		.version()
+		.usage("Usage:\n  $0 [input filename] [output filename] -f [filter]\n  $0 < [input] > [output] -f [filter] -t")
+		.example("$0 oecd.json oecd-subset.json -f \"area\"=\"DE\",\"year\"=\"2014\"", "converts JSON-stat file oecd.json into a new JSON-stat file (oecd-subset.json).")
+		.example("$0 < oecd.json > oecd-subset.json -f \"area\"=\"DE\",\"year\"=\"2014\" -t", "converts JSON-stat stream oecd.json into a new JSON-stat stream (oecd-subset.json).")
+		.alias("f", "filter")
+		.describe("f", "Filter string (for example: area=DE,year=2014)")
+		.boolean("t")
+		.alias("t", "stream")
+		.describe("t", "Enable the stream interface")
+		.help("h")
+		.alias("h", "help")
+		.argv
+	,
+	inout=require("./inout"),
+
+	callback=function(contents){
+		var
+			arrfil,
+			subset,
+			filter=argv.filter
+		;
+
+		//filter is not required: if not specified (no -f or -f without string) input=output
+		if(!filter || filter===true){
+			return contents;
+		}
+
+		if(filter.indexOf("=")===-1){
+			console.error("Error: The filter has not been specified correctly (missing =).");
+			process.exit(1);
+		}
+
+		arrfil=filter.split(",").map(function(e){
+			return e.split("=");
+		});
+
+		subset=inout.dataset(contents).Slice(arrfil);
+		if(subset===null){
+			console.error("Error: The input does not containt valid JSON-stat or the filters are not valid.");
+			process.exit(1);
+		}else{
+			return JSON.stringify(subset.__tree__);
+		}
+	}
+;
+
+inout.main(argv, callback, true);

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "jsonstat-conv",
-	"version": "0.8.3",
+	"version": "0.9.0",
 	"description": "JSON-stat Command Line Conversion Tools",
 	"homepage": "https://github.com/badosa/JSON-stat-conv",
 	"keywords": [
@@ -17,7 +17,8 @@
 		"jsonstat2arrobj": "jsonstat2arrobj",
 		"jsonstat2object": "jsonstat2object",
 		"jsonstat2csv": "jsonstat2csv",
-		"csv2jsonstat": "csv2jsonstat"
+		"csv2jsonstat": "csv2jsonstat",
+		"jsonstatslice": "jsonstatslice"
 	},
 	"scripts": {
 		"test": "echo \"Error: no test specified\" && exit 1"