Added example on how to link with the library from the command-line.

Author: jgaa

examples/cmdline/build.sh

@@ -0,0 +1,8 @@
+g++ -DBOOST_COROUTINE_NO_DEPRECATION_WARNING main.cpp \
+	-lrestc-cpp -lz -lssl -lcrypto -lpthread \
+	-lboost_system -lboost_program_options \
+	-lboost_filesystem -lboost_date_time \
+	-lboost_context -lboost_coroutine \
+	-lboost_chrono -lboost_log -lboost_thread \
+	-lboost_log_setup -lboost_regex \
+	-lboost_atomic -lpthread

examples/cmdline/main.cpp

@@ -0,0 +1,85 @@
+// We use the example from the main readme file
+
+#include <iostream>
+
+#include <boost/lexical_cast.hpp>
+#include <boost/fusion/adapted.hpp>
+
+#define BOOST_LOG_DYN_LINK 1
+#include <boost/log/trivial.hpp>
+#include <boost/log/utility/setup.hpp>
+
+#include <restc-cpp/restc-cpp.h>
+#include <restc-cpp/RequestBuilder.h>
+
+using namespace std;
+using namespace restc_cpp;
+namespace logging = boost::log;
+
+// C++ structure that match the JSON entries received
+// from http://jsonplaceholder.typicode.com/posts/{id}
+struct Post {
+    int userId = 0;
+    int id = 0;
+    string title;
+    string body;
+};
+
+// Since C++ does not (yet) offer reflection, we need to tell the library how
+// to map json members to a type. We are doing this by declaring the
+// structs/classes with BOOST_FUSION_ADAPT_STRUCT from the boost libraries.
+// This allows us to convert the C++ classes to and from JSON.
+
+BOOST_FUSION_ADAPT_STRUCT(
+    Post,
+    (int, userId)
+    (int, id)
+    (string, title)
+    (string, body)
+)
+
+// The C++ main function - the place where any adventure starts
+int main() {
+    // Set the log-level to a reasonable value
+    logging::core::get()->set_filter
+    (
+        logging::trivial::severity >= logging::trivial::info
+    );
+
+    // Create an instance of the rest client
+    auto rest_client = RestClient::Create();
+
+    // Create and instantiate a Post from data received from the server.
+    Post my_post = rest_client->ProcessWithPromiseT<Post>([&](Context& ctx) {
+        // This is a co-routine, running in a worker-thread
+
+        // Instantiate a Post structure.
+        Post post;
+
+        // Serialize it asynchronously. The asynchronously part does not really matter
+        // here, but it may if you receive huge data structures.
+        SerializeFromJson(post,
+
+            // Construct a request to the server
+            RequestBuilder(ctx)
+                .Get("http://jsonplaceholder.typicode.com/posts/1")
+
+                // Add some headers for good taste
+                .Header("X-Client", "RESTC_CPP")
+                .Header("X-Client-Purpose", "Testing")
+
+                // Send the request
+                .Execute());
+
+        // Return the post instance trough a C++ future<>
+        return post;
+    })
+
+    // Get the Post instance from the future<>, or any C++ exception thrown
+    // within the lambda.
+    .get();
+
+    // Print the result for everyone to see.
+    cout << "Received post# " << my_post.id << ", title: " << my_post.title
+        << endl;
+}

examples/cmdline/readme.md

@@ -0,0 +1,17 @@
+# example cmdline
+
+This example shows how to compile a program using restc-cpp from the command-line.
+
+We assume that the library has been built and installed.
+
+Currently this example is only tested under Linux.
+
+```sh
+~/src/restc-cpp/examples/cmdline$ ./build.sh
+~/src/restc-cpp/examples/cmdline$ ./a.out
+Received post# 1, title: sunt aut facere repellat provident occaecati excepturi optio reprehenderit
+~/src/restc-cpp/examples/cmdline$
+```
+
+Please examine [build.sh](build.sh) to see the full list of libraries to link with.
+