1.5.0

New jsonstat2csv options: --by and --drop

Author: badosa

docs/API.md

@@ -359,11 +359,25 @@ String. Decimal separator. Default is ".", unless column separator is ";" (then
 jsonstat2csv oecd.json oecd.tsv --column "\t" --decimal ","
 ```
 
+#### --by (-y)
+
+String. Dimension ID. When a valid dimension ID is provided, the resulting CSV is transposed by that dimension and the value column is replaced by as many columns as categories in the specified dimension.
+
+When this option is set with a valid ID, **--status**, **--vlabel** and **--slabel** are ignored. When **--rich** is set or an invalid ID is specified, **--by** is ignored.
+
+#### --drop (-o)
+
+String. Comma-separated list of dimension IDs. When a valid dimension ID is provided in **--by** parameter, ***drop*** can provide a list of constant dimension IDs to remove from the resulting CSV.
+
+```
+jsonstat2csv eurostat.json eurostat.csv --by unit --drop freq,age
+```
+
 #### --rich (-r)
 
 Boolean. Output is a rich CSV in the [JSON-stat Comma-Separated Values format](https://github.com/jsonstat/csv) (CSV-stat, or JSV for short). CSV-stat is CSV plus a metadata header. CSV-stat supports all the JSON-stat dataset core semantics. This means that CSV-stat can be converted back to JSON-stat (using [csv2jsonstat](#csv2jsonstat)) without loss of information (only the *note*, *link*, *child*, *coordinates* and *extension* properties are not currently supported).
 
-When this option is set, **--status**, **--vlabel** and **--slabel** are ignored.
+When this option is set, **--status**, **--vlabel**, **--slabel**, **--by** and **--drop** are ignored.
 
 ```
 jsonstat2csv oecd.json oecd.jsv --rich

jsonstat2csv

@@ -25,6 +25,10 @@ var
 		.describe("v", "Label of the value field (default is 'Value')")
 		.alias("l", "slabel")
 		.describe("l", "Label of the status field (default is 'Status')")
+		.alias("y", "by")
+		.describe("y", "Dimension to transposed by")
+		.alias("o", "drop")
+		.describe("o", "Comma-separated list of constant dimensions to remove when a valid 'by' is specified.")
 		.boolean("b")
 		.alias("b", "big")
 		.describe("b", "This is an emergency option only to be used when the stream interface is not enabled and the dataset is very big.")
@@ -50,7 +54,9 @@ var
 					na: argv.na,
 					delimiter: (argv.column==="\\t") ? "\t" : argv.column,
 					separator: (argv.unit==="\\t") ? "\t" : argv.unit,
-					decimal: argv.decimal
+					decimal: argv.decimal,
+					by: argv.by,
+					drop: argv.drop ?  argv.drop.split(",") : []
 				}
 			)
 		;

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "jsonstat-conv",
-	"version": "1.4.2",
+	"version": "1.5.0",
 	"description": "JSON-stat Command Line Conversion Tools",
 	"homepage": "https://github.com/jsonstat/conv",
 	"keywords": [
@@ -42,7 +42,7 @@
 	},
 	"license": "Apache-2.0",
 	"dependencies": {
-		"jsonstat-suite": "^3.2.5",
+		"jsonstat-suite": "^3.5.0",
 		"jsonstat-toolkit": "^1.4.2",
 		"rw": "^1.3.3",
 		"yargs": "^15.1.0",