User-defined type support.

- Users may now register custom types that can be converted to/from Variant. These registered custom types may be passed directly to RPC and pub/sub operations and handlers (closes #69).
- timeservice and timeclient examples have been provided which showcase the use of conversion facilities. These examples use the CppWAMP library in a header-only fashion (closes #67).
- Converters have been provided for std::unordered_map and boost::optional (closes #68).
- Payload::withArgs now takes variadic arguments, instead of a std::initializer_list<Variant>. This change makes it possible for registered user-defined types to be automatically converted to Variant.
- std::tuple support is now provided via the new conversion facilities, in <cppwamp/types/tuple.hpp>.
- Fixed compile errors that occur only when the library is used in a header-only fashion.

Author: ecorm

CHANGELOG.md

@@ -1,3 +1,19 @@
+v0.5.0
+======
+User-defined type support.
+
+### New Features
+- Users may now register custom types that can be converted to/from `Variant`. These registered custom types may be passed directly to RPC and pub/sub operations and handlers. See *Custom Variant Conversions* in the tutorial for usage examples (closes #69).
+- `timeservice` and `timeclient` examples have been provided which showcase the use of conversion facilities. These examples use the CppWAMP library in a header-only fashion (closes #67).
+- Converters have been provided for `std::unordered_map` and `boost::optional` (closes #68).
+
+### Breaking Changes
+- `Payload::withArgs` now takes variadic arguments, instead of a `std::initializer_list<Variant>`. This change makes it possible for registered user-defined types to be automatically converted to `Variant`. Wherever you do `Rpc("foo").withArgs({"hello", 42})` should be changed to `Rpc("foo").withArgs("hello", 42)` (notice the removed curly braces).
+- `std::tuple` support is now provided via the new conversion facilities, in `<cppwamp/types/tuple.hpp>`.
+
+### Other Changes
+- Fixed compile errors that occur only when the library is used in a header-only fashion.
+
 v0.4.0
 ======
 Connection API improvements.

Doxyfile.in

@@ -766,6 +766,7 @@ WARN_LOGFILE           =
 
 INPUT                  = cppwamp/include/cppwamp \
                          cppwamp/include/cppwamp/internal \
+                         cppwamp/include/cppwamp/types \
                          doc
 
 # This tag can be used to specify the character encoding of the source files

README.md

@@ -13,6 +13,7 @@ C++11 client library for the [WAMP][wamp] protocol.
 - Provides both callback and co-routine based asynchronous APIs
 - Easy conversion between static and dynamic types
 - RPC and pub/sub event handlers can have static argument types
+- User-defined types can be registered and exchanged via RPC and pub-sub
 - Header-only, but may also be optionally compiled
 - Unit tested
 - Permissive license (Boost)
@@ -64,6 +65,7 @@ Tested Platforms
 This library has been tested with:
 
 - GCC 4.8.2, x86_64-linux-gnu, on Linux Mint 17 (based on Ubuntu 14.04)
+- Clang 3.6.0, x86_64-pc-linux-gnu, on Linux Mint 17
 - GCC 4.9.2 on Debian 8.0 "jessie"
 - Xcode 6.3.1 (Clang 602.0.49) on OS X 10.10.3
 
@@ -78,15 +80,12 @@ wamp::AsioService iosvc;
 boost::asio::spawn(iosvc, [&](boost::asio::yield_context yield)
 {
     // Specify a TCP transport and JSON serialization
-    auto tcp = wamp::legacy::TcpConnector::create(iosvc, "localhost",
-                                                  8001, wamp::Json::id());
-
+    auto tcp = connector<Json>(iosvc, TcpHost("localhost", 8001));
     auto session = wamp::CoroSession<>::create(tcp);
     session->connect(yield);
     auto sessionInfo = session->join(Realm("myrealm"), yield);
     std::cout << "Client joined. Session ID = "
               << sessionInfo.id() << "\n";
-
     // etc.
 });
 iosvc.run();
@@ -106,7 +105,7 @@ boost::asio::spawn(iosvc, [&](boost::asio::yield_context yield)
 
 ### Calling a remote procedure
 ```c++
-auto result = session->call(Rpc("add").withArgs({2, 2}), yield);
+auto result = session->call(Rpc("add").withArgs(2, 2), yield);
 std::cout << "2 + 2 is " << result[0].to<int>() << "\n";
 ```
 
@@ -131,7 +130,7 @@ boost::asio::spawn(iosvc, [&](boost::asio::yield_context yield)
 ### Publishing an event
 ```c++
 float value = std::rand() % 10;
-session->publish(Pub("sensorSampled").withArgs({value}));
+session->publish(Pub("sensorSampled").withArgs(value));
 ```
 
 <a name="advanced"></a>Supported Advanced Profile Features

cppwamp.pro

@@ -10,12 +10,22 @@ TEMPLATE = subdirs
 chatexample.subdir = examples/chat
 chatexample.target = chat
 
+timeservice.subdir = examples/timeservice
+timeservice.target = timeservice
+
+timeclient.subdir = examples/timeclient
+timeclient.target = timeclient
+
 SUBDIRS = cppwamp \
           test \
-          chatexample
+          chatexample \
+          timeservice \
+          timeclient
 
 test.depends = cppwamp
 chatexample.depends = cppwamp
+timeservice.depends = cppwamp
+timeclient.depends = cppwamp
 
 OTHER_FILES += \
     CMakeLists.txt \

cppwamp/CMakeLists.txt

@@ -12,6 +12,7 @@ set(HEADERS
     include/cppwamp/asyncresult.hpp
     include/cppwamp/codec.hpp
     include/cppwamp/connector.hpp
+    include/cppwamp/conversion.hpp
     include/cppwamp/corosession.hpp
     include/cppwamp/dialoguedata.hpp
     include/cppwamp/error.hpp
@@ -27,11 +28,11 @@ set(HEADERS
     include/cppwamp/subscription.hpp
     include/cppwamp/tcp.hpp
     include/cppwamp/tcphost.hpp
+    include/cppwamp/traits.hpp
     include/cppwamp/uds.hpp
     include/cppwamp/udspath.hpp
     include/cppwamp/unpacker.hpp
     include/cppwamp/variant.hpp
-    include/cppwamp/varianttuple.hpp
     include/cppwamp/version.hpp
     include/cppwamp/visitor.hpp
     include/cppwamp/wampdefs.hpp
@@ -45,6 +46,7 @@ set(HEADERS
     include/cppwamp/internal/config.hpp
     include/cppwamp/internal/dialogue.hpp
     include/cppwamp/internal/endian.hpp
+    include/cppwamp/internal/integersequence.hpp
     include/cppwamp/internal/legacyasioendpoint.hpp
     include/cppwamp/internal/legacyasiotransport.hpp
     include/cppwamp/internal/messagetraits.hpp
@@ -62,10 +64,14 @@ set(HEADERS
     include/cppwamp/internal/varianttraitsfwd.hpp
     include/cppwamp/internal/variantvisitors.hpp
     include/cppwamp/internal/wampmessage.hpp
+    include/cppwamp/types/tuple.hpp
+    include/cppwamp/types/boostoptional.hpp
+    include/cppwamp/types/unorderedmap.hpp
 )
 
 set(INLINES
     include/cppwamp/internal/asyncresult.ipp
+    include/cppwamp/internal/conversion.ipp
     include/cppwamp/internal/corosession.ipp
     include/cppwamp/internal/dialoguedata.ipp
     include/cppwamp/internal/endian.ipp
@@ -88,9 +94,9 @@ set(INLINES
     include/cppwamp/internal/udspath.ipp
     include/cppwamp/internal/unpacker.ipp
     include/cppwamp/internal/variant.ipp
-    include/cppwamp/internal/varianttuple.ipp
     include/cppwamp/internal/version.ipp
     include/cppwamp/internal/visitor.ipp
+    include/cppwamp/types/internal/tuple.ipp
 )
 
 set(DOCUMENTS

cppwamp/cppwamp.pro

@@ -17,6 +17,7 @@ HEADERS += \
     include/cppwamp/asyncresult.hpp \
     include/cppwamp/codec.hpp \
     include/cppwamp/connector.hpp \
+    include/cppwamp/conversion.hpp \
     include/cppwamp/corosession.hpp \
     include/cppwamp/dialoguedata.hpp \
     include/cppwamp/error.hpp \
@@ -32,11 +33,11 @@ HEADERS += \
     include/cppwamp/subscription.hpp \
     include/cppwamp/tcp.hpp \
     include/cppwamp/tcphost.hpp \
+    include/cppwamp/traits.hpp \
     include/cppwamp/uds.hpp \
     include/cppwamp/udspath.hpp \
     include/cppwamp/unpacker.hpp \
     include/cppwamp/variant.hpp \
-    include/cppwamp/varianttuple.hpp \
     include/cppwamp/version.hpp \
     include/cppwamp/visitor.hpp \
     include/cppwamp/wampdefs.hpp \
@@ -50,6 +51,7 @@ HEADERS += \
     include/cppwamp/internal/config.hpp \
     include/cppwamp/internal/dialogue.hpp \
     include/cppwamp/internal/endian.hpp \
+    include/cppwamp/internal/integersequence.hpp \
     include/cppwamp/internal/legacyasioendpoint.hpp \
     include/cppwamp/internal/legacyasiotransport.hpp \
     include/cppwamp/internal/messagetraits.hpp \
@@ -67,8 +69,12 @@ HEADERS += \
     include/cppwamp/internal/varianttraitsfwd.hpp \
     include/cppwamp/internal/variantvisitors.hpp \
     include/cppwamp/internal/wampmessage.hpp \
+    include/cppwamp/types/tuple.hpp \
+    include/cppwamp/types/boostoptional.hpp \
+    include/cppwamp/types/unorderedmap.hpp \
     \
     include/cppwamp/internal/asyncresult.ipp \
+    include/cppwamp/internal/conversion.ipp \
     include/cppwamp/internal/corosession.ipp \
     include/cppwamp/internal/dialoguedata.ipp \
     include/cppwamp/internal/endian.ipp \
@@ -91,9 +97,9 @@ HEADERS += \
     include/cppwamp/internal/udspath.ipp \
     include/cppwamp/internal/unpacker.ipp \
     include/cppwamp/internal/variant.ipp \
-    include/cppwamp/internal/varianttuple.ipp \
     include/cppwamp/internal/version.ipp \
-    include/cppwamp/internal/visitor.ipp
+    include/cppwamp/internal/visitor.ipp \
+    include/cppwamp/types/internal/tuple.ipp
 
 OTHER_FILES += \
     CMakeLists.txt
@@ -132,4 +138,8 @@ QMAKE_CXXFLAGS += \
 
 LIBS += -pthread
 
-DEPENDPATH += ./include ./include/internal
+DEPENDPATH += \
+    ./include \
+    ./include/internal \
+    ./include/types \
+    ./include/types/internal