Added example project.

Made escape and escapeKey functions public.
Modified escape function to create " around strings to get the same look like json.

Author: terbshaeusser

Example/CMakeLists.txt

@@ -0,0 +1,17 @@
+cmake_minimum_required(VERSION 3.10)
+project(example)
+
+set(CMAKE_CXX_STANDARD 11)
+
+# Disable building cppcson tests
+set(CPPCSON_BUILD_TESTS OFF)
+
+# Add cppcson as sub directory
+add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/.. ${CMAKE_CURRENT_BINARY_DIR}/cppcson)
+
+# Define our executable and link to cppcson
+add_executable(example
+        main.cpp
+        )
+
+target_link_libraries(example cppcson)

Example/Data/1.cson

@@ -0,0 +1,12 @@
+{
+	# an array
+	abc: [
+		'a'
+		'b'
+		'c'
+	]
+
+	# an object
+	a:
+		b: 'c'
+}

Example/Data/2.cson

@@ -0,0 +1,40 @@
+# Look Ma! Comments!!!
+
+# Look Ma! An Array with no commas!
+greatDocumentaries: [
+	'earthlings.com'
+	'forksoverknives.com'
+	'cowspiracy.com'
+]
+
+# Look Ma! An Object without braces!
+importantFacts:
+	# Look Ma! Multi-Line Strings! Without Quote Escaping!
+	emissions: '''
+		Livestock and their byproducts account for at least 32,000 million tons of carbon dioxide (CO2) per year, or 51% of all worldwide greenhouse gas emissions.
+		Goodland, R Anhang, J. “Livestock and Climate Change: What if the key actors in climate change were pigs, chickens and cows?”
+		WorldWatch, November/December 2009. Worldwatch Institute, Washington, DC, USA. Pp. 10–19.
+		http://www.worldwatch.org/node/6294
+		'''
+
+	landuse: '''
+		Livestock covers 45% of the earth’s total land.
+		Thornton, Phillip, Mario Herrero, and Polly Ericksen. “Livestock and Climate Change.” Livestock Exchange, no. 3 (2011).
+		https://cgspace.cgiar.org/bitstream/handle/10568/10601/IssueBrief3.pdf
+		'''
+
+	burger: '''
+		One hamburger requires 660 gallons of water to produce – the equivalent of 2 months’ worth of showers.
+		Catanese, Christina. “Virtual Water, Real Impacts.” Greenversations: Official Blog of the U.S. EPA. 2012.
+		http://blog.epa.gov/healthywaters/2012/03/virtual-water-real-impacts-world-water-day-2012/
+		“50 Ways to Save Your River.” Friends of the River.
+		http://www.friendsoftheriver.org/site/PageServer?pagename=50ways
+		'''
+
+	milk: '''
+		1,000 gallons of water are required to produce 1 gallon of milk.
+		“Water trivia facts.” United States Environmental Protection Agency.
+		http://water.epa.gov/learn/kids/drinkingwater/water_trivia_facts.cfm#_edn11
+		'''
+
+	more: 'http://cowspiracy.com/facts'

Example/Data/3.cson

@@ -0,0 +1,3 @@
+# comment
+[1,2,3]
+# comment

Example/Data/4.json

@@ -0,0 +1 @@
+{"abc":["a","b","c"],"a":{"b":"c"}}

Example/Data/8.cson

@@ -0,0 +1 @@
+{}

Example/Data/README.md

@@ -0,0 +1,4 @@
+# Example Files
+
+These files were taken from
+[here](https://github.com/bevry/cson/tree/master/test-fixtures/src).

Example/README.md

@@ -0,0 +1,33 @@
+# cppcson Example
+
+This folder contains an example application illustrating how the cppcson
+library can be used.
+
+The application reads in a passed \*.cson/\*.json file and prints the content in
+formatted cson to the console.
+
+Input files for testing can be found in the *Data* folder.
+
+## How to build?
+
+On Unix systems:
+
+```
+mkdir build
+cd build
+
+cmake ..
+make
+```
+
+On Windows:
+
+In the Visual Studio command line:
+
+```
+mkdir build
+cd build
+
+cmake -G "NMake Makefiles" ..
+nmake
+```

Example/main.cpp

@@ -0,0 +1,79 @@
+#include <cppcson.hpp>
+#include <fstream>
+#include <iostream>
+
+static void print(const cppcson::Value &value, bool isRoot, int32_t indent) {
+  if (value.isNull()) {
+    std::cout << "null";
+  } else if (value.isBool()) {
+    std::cout << value.asBool();
+  } else if (value.isInt()) {
+    std::cout << value.asInt();
+  } else if (value.isFloat()) {
+    std::cout << value.asFloat();
+  } else if (value.isString()) {
+    std::cout << cppcson::escape(value.asString());
+  } else if (value.isArray()) {
+    std::cout << "[";
+
+    indent += 2;
+    for (auto &item : value) {
+      std::cout << std::endl << std::string(indent, ' ');
+      print(item, false, indent);
+    }
+    indent -= 2;
+
+    std::cout << std::endl << std::string(indent, ' ') << "]";
+  } else if (value.isObject()) {
+    if (!isRoot) {
+      indent += 2;
+    }
+
+    auto skipNewline = isRoot;
+
+    for (auto &key : value.keys()) {
+      if (skipNewline) {
+        skipNewline = false;
+      } else {
+        std::cout << std::endl;
+      }
+
+      std::cout << std::string(indent, ' ') << cppcson::escapeKey(key) << ": ";
+      print(value.item(key), false, indent);
+    }
+  }
+}
+
+static void print(const cppcson::Value &value) {
+  print(value, true, 0);
+  std::cout << std::endl;
+}
+
+int main(int argc, char const *const *argv) {
+  if (argc != 2) {
+    std::cout << "Error: Please pass a path to a cson file" << std::endl;
+    return 1;
+  }
+
+  std::string path(argv[1]);
+  std::ifstream stream(path);
+
+  if (stream.fail()) {
+    std::cout << "Error: File " << path << " could not be read" << std::endl;
+    return 2;
+  }
+
+  try {
+    auto root = cppcson::parse(stream);
+
+    print(root);
+    return 0;
+  } catch (const cppcson::Error &e) {
+    std::cout << "Error: The file " << path << " could not be parsed as cson"
+              << std::endl
+              << "Details:" << std::endl
+              << e.getLocation() << std::endl
+              << e.what() << std::endl;
+    return 3;
+  }
+}

Include/cppcson.hpp

@@ -234,4 +234,8 @@ extern const Options DEFAULT_OPTIONS;
 
 Value parse(std::istream &stream, const Options &options = DEFAULT_OPTIONS);
 
+std::string escapeKey(const std::string &str);
+
+std::string escape(const std::string &str);
+
 } // namespace cppcson