- [+] add cmd esc, Escape json string, OK

Author: suntong

README.e.md

@@ -20,6 +20,8 @@ The `jsonfiddle` makes it easy to look at the JSON data from different aspects.
 
 ### $ {{exec "jsonfiddle" | color "sh"}}
 
+### $ {{shell "jsonfiddle esc" | color "sh"}}
+
 ### $ {{shell "jsonfiddle fmt" | color "sh"}}
 
 ### $ {{shell "jsonfiddle sort" | color "sh"}}
@@ -28,6 +30,26 @@ The `jsonfiddle` makes it easy to look at the JSON data from different aspects.
 
 # Examples
 
+## Escape with `jsonfiddle esc`
+
+### $ {{shell "jsonfiddle esc -i test/Customer.ref" | color "json"}}
+
+### Usage
+
+`jsonfiddle esc` will escape any arbitrary string so as to embed it as content of json string. This seems useless at first, but it actually allows you to embed any arbitrary file into [GitHub Gists JSON API](https://developer.github.com/v3/gists/), so as to post any arbitrary file onto GitHub Gist:
+
+
+   echo '{"description":"SmartyStreets API Demo","public":true,"files":{"SmartyStreets.json":{"content":'"`jsonfiddle fmt -i test/SmartyStreets.json | jsonfiddle esc -i`"'}}}' | curl --data @- https://api.github.com/gists
+
+This will give you
+https://gist.github.com/anonymous/1423d4768dd9b88262ca513626e68d8e
+
+
+By "_arbitrary file_" I do mean arbitrary file. Check this out:
+https://gist.github.com/anonymous/a51798ce99ff59d8d4ba536cbf4b6996
+
+This is why `jsonfiddle esc` is a command on its own, instead of being part of functionalities of `jsonfiddle fmt` or `jsonfiddle sort`.
+
 ## Format with `jsonfiddle fmt`
 
 ### Pretty print

README.md

@@ -10,10 +10,14 @@
 - [jsonfiddle - JSON Fiddling](#jsonfiddle---json-fiddling)
 - [Usage](#usage)
   - [$ jsonfiddle](#-jsonfiddle)
+  - [$ jsonfiddle esc](#-jsonfiddle-esc)
   - [$ jsonfiddle fmt](#-jsonfiddle-fmt)
   - [$ jsonfiddle sort](#-jsonfiddle-sort)
   - [$ jsonfiddle j2s](#-jsonfiddle-j2s)
 - [Examples](#examples)
+  - [Escape with `jsonfiddle esc`](#escape-with-`jsonfiddle-esc`)
+    - [$ jsonfiddle esc -i test/Customer.ref](#-jsonfiddle-esc--i-testcustomerref)
+    - [Usage](#usage-1)
   - [Format with `jsonfiddle fmt`](#format-with-`jsonfiddle-fmt`)
     - [Pretty print](#pretty-print)
       - [> test/CustomerSI.ref](#-testcustomersiref)
@@ -47,7 +51,7 @@ The `jsonfiddle` makes it easy to look at the JSON data from different aspects.
 ### $ jsonfiddle
 ```sh
 JSON Fiddling
-Version v0.2.0 built on 2017-08-12
+Version v0.3.0 built on 2017-08-14
 
 Tool to fiddle with json strings
 
@@ -61,11 +65,27 @@ Options:
 
 Commands:
 
+  esc    Escape json string so as to embed it as content of json string
   fmt    Format json string
   sort   Sort json fields recursively
   j2s    JSON to struct
 ```
 
+### $ jsonfiddle esc
+```sh
+Escape json string so as to embed it as content of json string
+
+Options:
+
+  -h, --help         display help information
+  -c, --compact      Compact JSON data, remove all whitespaces
+      --prefix       prefix for json string output
+  -d, --indent[= ]   indent for json string output
+  -v, --verbose      Verbose mode (Multiple -v options increase the verbosity.)
+  -i, --input       *the source to get json string from (mandatory)
+  -o, --output       the output (default: stdout)
+```
+
 ### $ jsonfiddle fmt
 ```sh
 Format json string
@@ -117,6 +137,29 @@ Options:
 
 # Examples
 
+## Escape with `jsonfiddle esc`
+
+### $ jsonfiddle esc -i test/Customer.ref
+```json
+"{\n \"firstName\": \"John\",\n \"lastName\": \"Smith\",\n \"age\": 25,\n \"address\": {\n  \"streetAddress\": \"21 2nd Street\",\n  \"city\": \"New York\",\n  \"state\": \"NY\",\n  \"postalCode\": \"10021\"\n },\n \"phoneNumber\": [\n  {\n   \"type\": \"home\",\n   \"number\": \"212 555-1234\"\n  },\n  {\n   \"type\": \"fax\",\n   \"number\": \"646 555-4567\"\n  }\n ]\n}\n\n"
+```
+
+### Usage
+
+`jsonfiddle esc` will escape any arbitrary string so as to embed it as content of json string. This seems useless at first, but it actually allows you to embed any arbitrary file into [GitHub Gists JSON API](https://developer.github.com/v3/gists/), so as to post any arbitrary file onto GitHub Gist:
+
+
+   echo '{"description":"SmartyStreets API Demo","public":true,"files":{"SmartyStreets.json":{"content":'"`jsonfiddle fmt -i test/SmartyStreets.json | jsonfiddle esc -i`"'}}}' | curl --data @- https://api.github.com/gists
+
+This will give you
+https://gist.github.com/anonymous/1423d4768dd9b88262ca513626e68d8e
+
+
+By "_arbitrary file_" I do mean arbitrary file. Check this out:
+https://gist.github.com/anonymous/a51798ce99ff59d8d4ba536cbf4b6996
+
+This is why `jsonfiddle esc` is a command on its own, instead of being part of functionalities of `jsonfiddle fmt` or `jsonfiddle sort`.
+
 ## Format with `jsonfiddle fmt`
 
 ### Pretty print

cmdEsc.go

@@ -7,14 +7,28 @@
 package main
 
 import (
+	"encoding/json"
 	"fmt"
+	"io/ioutil"
 
 	"github.com/mkideal/cli"
 )
 
 func escCLI(ctx *cli.Context) error {
 	rootArgv = ctx.RootArgv().(*rootT)
 	argv := ctx.Argv().(*escT)
-	fmt.Printf("[esc]:\n  %+v\n  %+v\n  %v\n", rootArgv, argv, ctx.Args())
+	// fmt.Printf("[esc]:\n  %+v\n  %+v\n  %v\n", rootArgv, argv, ctx.Args())
+	Opts.Prefix, Opts.Indent, Opts.Compact, Opts.Verbose =
+		rootArgv.Prefix, rootArgv.Indent, rootArgv.Compact, rootArgv.Verbose.Value()
+
+	data, err := ioutil.ReadAll(argv.Filei)
+	argv.Filei.Close()
+	abortOn("[::esc] Reading input", err)
+	// fmt.Printf("] %s", data)
+
+	out, err := json.Marshal(string(data))
+	abortOn("[::esc] Formatting input", err)
+	fmt.Fprintf(argv.Fileo, "%s", out)
+
 	return nil
 }