Exporting Natspec documentation to a JSON interface

- Adding a getDocumentation() function to solidity compiler stack
  so that we can obtain the natspec interface for a contract

- Adding libjsoncpp as a dependency of libsolidity. This is done
  in a dirty way, using libjsonrpc-cpp s an intermediate dependency
  for the moment. Will fix soon.

- Start of a test file for Natspec exporting to JSON

1 files changed, 26 insertions, 0 deletions

diff --git a/CompilerStack.cpp b/CompilerStack.cpp
index 6535e00d..45d3e0b8 100644
--- a/CompilerStack.cpp
+++ b/CompilerStack.cpp
@@ -28,6 +28,8 @@
 #include <libsolidity/Compiler.h>
 #include <libsolidity/CompilerStack.h>
 
+#include <jsonrpc/json/json.h>
+
 using namespace std;
 
 namespace dev
@@ -125,6 +127,30 @@ string const& CompilerStack::getInterface()
 	return m_interface;
 }
 
+string const& CompilerStack::getDocumentation()
+{
+
+	Json::StyledWriter writer;
+	if (!m_parseSuccessful)
+		BOOST_THROW_EXCEPTION(CompilerError() << errinfo_comment("Parsing was not successful."));
+	if (m_documentation.empty())
+	{
+		Json::Value doc;
+		Json::Value methods;
+
+		vector<FunctionDefinition const*> exportedFunctions = m_contractASTNode->getInterfaceFunctions();
+		for (FunctionDefinition const* f: exportedFunctions)
+		{
+			Json::Value user;
+			user["user"] = Json::Value(*f->getDocumentation());
+			methods[f->getName()] = user;
+		}
+		doc["methods"] = methods;
+		m_documentation = writer.write(doc);
+	}
+	return m_documentation;
+}
+
 bytes CompilerStack::staticCompile(std::string const& _sourceCode, bool _optimize)
 {
 	CompilerStack stack;