- [+] add final tested version

Author: suntong

README.md

@@ -0,0 +1,8 @@
+# Go JSON File Handling
+
+This package provides simple wrapping around saving and reading JSON files (streams) in GO. It exists because way too many sample/demo code are doing it the wrong way. Wrong in the sense of efficiency -- when reading JSON from file for example, the right is to read from stream, instead of reading the whole file via `ioutil.ReadAll` into a big buffer first then decode the buffer next.
+
+Every single hit I searched, for "JSON files reading writing", is doing reading like this. They are actually not wrong, but just not ideal, especially when it comes to big JSON files.
+
+Hence, this simple JSON files reading writing wrapping package. Here is a [simple demo code](https://github.com/suntong/lang/blob/master/lang/Go/src/ds/jsonfile.go).
+

jsonfile.go

@@ -0,0 +1,44 @@
+////////////////////////////////////////////////////////////////////////////
+// Porgram: jsonfile.go
+// Purpose: GO JSON File Handling
+// Authors: Tong Sun (c) 2016, All rights reserved
+// Credits: Mkideal Wang https://github.com/mkideal/cli/issues/22
+////////////////////////////////////////////////////////////////////////////
+
+package jsonfile
+
+import (
+	"encoding/json"
+	"io"
+	"os"
+)
+
+// ReadJSON reads JSON from stream.
+func ReadJSON(r io.Reader, js interface{}) error {
+	return json.NewDecoder(r).Decode(js)
+}
+
+// ReadJSONFromFile reads JSON from the file with given name.
+func ReadJSONFromFile(filename string, js interface{}) error {
+	file, err := os.Open(filename)
+	defer file.Close()
+	if err != nil {
+		return err
+	}
+	return ReadJSON(file, js)
+}
+
+// WriteJSON writes JSON to the stream.
+func WriteJSON(w io.Writer, js interface{}) error {
+	return json.NewEncoder(w).Encode(js)
+}
+
+// WriteJSONFromFile writes JSON to the file with given name.
+func WriteJSONToFile(filename string, js interface{}) error {
+	file, err := os.Create(filename)
+	defer file.Close()
+	if err != nil {
+		return err
+	}
+	return WriteJSON(file, js)
+}