Added a simple example that uses the Twitter Search API.

glynos · glynos · commit 59791153658b · 2011-12-11T14:15:33.000+01:00
diff --git a/boost/network/uri/decode.hpp b/boost/network/uri/decode.hpp
@@ -93,6 +93,13 @@ OutputIterator decode(const SinglePassRange &range,
                       const OutputIterator &out) {
     return decode(boost::begin(range), boost::end(range), out);
 }
+
+inline
+std::string decoded(const std::string &input) {
+    std::string decoded;
+    decode(input, std::back_inserter(decoded));
+    return decoded;
+}
 } // namespace uri
 } // namespace network
 } // namespace boost
diff --git a/boost/network/uri/encode.hpp b/boost/network/uri/encode.hpp
@@ -161,6 +161,13 @@ OutputIterator encode(const SinglePassRange &range,
                       const OutputIterator &out) {
     return encode(boost::begin(range), boost::end(range), out);
 }
+
+inline
+std::string encoded(const std::string &input) {
+    std::string encoded;
+    encode(input, std::back_inserter(encoded));
+    return encoded;
+}
 } // namespace uri
 } // namespace network
 } // namespace boost
diff --git a/libs/network/doc/uri.rst b/libs/network/doc/uri.rst
@@ -1,9 +1,9 @@
-The URI template
-================
+The URI class
+=============
 
 In addition to protocol implementations, the :mod:`cpp-netlib`
-provides a powerful URI template.  The URI template implements a
-parser based on `RFC 3986`_.
+provides a powerful URI class.  The class implements a parser based
+on `RFC 3986`_ and `RFC 2732`_.
 
 Generic URI Syntax Overview
 ```````````````````````````
@@ -60,31 +60,24 @@ elements.  Another example, using HTTP is given below:
 The difference here between the path in a hierarchical URI and that in
 the example above for the non-hierarchical URI.
 
-``basic_uri``
-`````````````
+The ``uri`` class
+`````````````````
 
-The ``basic_uri`` definition is consistent with that of
-``basic_message``::
-
-   template <class Tag>
-   class basic_uri;
-
-As it stands, the template only supplies a URI parser and no builder.
+As of version 0.9.3, ``uri`` supplies a URI parser and builder.
 To use the parser, it's as simple as supplying a string to the
 constructor::
 
-   boost::network::uri::uri instance("http://cpp-netlib.github.com/");
+   using namespace boost::network;
+   uri::uri instance("http://cpp-netlib.github.com/");
    assert(boost::is_valid(instance));
-   std::cout << "scheme: " << boost::network::uri::scheme(instance) << std::endl
-             << "host: " << boost::network::uri::host(instance) << std::endl;
+   std::cout << "scheme: " << uri::scheme(instance) << std::endl
+             << "host: " << uri::host(instance) << std::endl;
 
 The command-line output of this program will be::
 
    scheme: http
    host: cpp-netlib.github.com
 
-A future version of ``basic_uri`` will provide a full builder API.
-
 ``URI Concept``
 ```````````````
 
@@ -127,3 +120,4 @@ A future version of ``basic_uri`` will provide a full builder API.
 .. _`RFC 3986`: http://tools.ietf.org/html/rfc3986
 .. _`RFC 2368`: http://tools.ietf.org/html/rfc2368
 .. _`RFC 3513`: http://tools.ietf.org/html/rfc3513
+.. _`RFC 2732`: http://tools.ietf.org/html/rfc2732
diff --git a/libs/network/example/CMakeLists.txt b/libs/network/example/CMakeLists.txt
@@ -12,6 +12,7 @@ add_executable(http_client http_client.cpp)
 add_executable(simple_wget simple_wget.cpp)
 add_executable(atom_reader atom/atom.cpp atom/main.cpp)
 add_executable(rss_reader rss/rss.cpp rss/main.cpp)
+add_executable(twitter_search twitter/search.cpp)
 add_executable(hello_world_server http/hello_world_server.cpp)
 if (UNIX)
   add_executable(fileserver http/fileserver.cpp)
@@ -21,6 +22,7 @@ add_dependencies(http_client cppnetlib-uri cppnetlib-client-connections)
 add_dependencies(simple_wget cppnetlib-uri cppnetlib-client-connections)
 add_dependencies(atom_reader cppnetlib-uri cppnetlib-client-connections)
 add_dependencies(rss_reader cppnetlib-uri cppnetlib-client-connections)
+add_dependencies(twitter_search cppnetlib-uri cppnetlib-client-connections)
 add_dependencies(uri cppnetlib-uri)
 set(BOOST_CLIENT_LIBS
     ${Boost_PROGRAM_OPTIONS_LIBRARY}
@@ -59,6 +61,12 @@ target_link_libraries(rss_reader
     cppnetlib-uri
     cppnetlib-client-connections)
 
+target_link_libraries(twitter_search
+    ${BOOST_CLIENT_LIBS}
+    ${CMAKE_THREAD_LIBS_INIT}
+    cppnetlib-uri
+    cppnetlib-client-connections)
+
 target_link_libraries(hello_world_server
     ${BOOST_SERVER_LIBS}
     ${CMAKE_THREAD_LIBS_INIT})
@@ -68,6 +76,7 @@ if (OPENSSL_FOUND)
   target_link_libraries(simple_wget ${OPENSSL_LIBRARIES})
   target_link_libraries(atom_reader ${OPENSSL_LIBRARIES})
   target_link_libraries(rss_reader ${OPENSSL_LIBRARIES})
+  target_link_libraries(twitter_search ${OPENSSL_LIBRARIES})
   target_link_libraries(hello_world_server ${OPENSSL_LIBRARIES})
 endif (OPENSSL_FOUND)
 
@@ -84,6 +93,7 @@ set_target_properties(http_client PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CPP-NETL
 set_target_properties(simple_wget PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CPP-NETLIB_BINARY_DIR}/example)
 set_target_properties(atom_reader PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CPP-NETLIB_BINARY_DIR}/example)
 set_target_properties(rss_reader PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CPP-NETLIB_BINARY_DIR}/example)
+set_target_properties(twitter_search PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CPP-NETLIB_BINARY_DIR}/example)
 set_target_properties(hello_world_server PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CPP-NETLIB_BINARY_DIR}/example)
 if (UNIX)
   set_target_properties(fileserver PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CPP-NETLIB_BINARY_DIR}/example)
diff --git a/libs/network/example/atom/main.cpp b/libs/network/example/atom/main.cpp
@@ -6,6 +6,7 @@
 
 #include "atom.hpp"
 #include <boost/network/protocol/http/client.hpp>
+#include <boost/foreach.hpp>
 #include <iostream>
 
 int main(int argc, char * argv[]) {
diff --git a/libs/network/example/rss/main.cpp b/libs/network/example/rss/main.cpp
@@ -6,6 +6,7 @@
 
 #include "rss.hpp"
 #include <boost/network/protocol/http/client.hpp>
+#include <boost/foreach.hpp>
 #include <iostream>
 
 int main(int argc, char * argv[]) {
diff --git a/libs/network/example/twitter/search.cpp b/libs/network/example/twitter/search.cpp
@@ -0,0 +1,45 @@
+//            Copyright (c) Glyn Matthews 2011.
+// Distributed under the Boost Software License, Version 1.0.
+//    (See accompanying file LICENSE_1_0.txt or copy at
+//          http://www.boost.org/LICENSE_1_0.txt)
+
+
+#include <boost/network/protocol/http/client.hpp>
+#include <boost/fusion/include/adapt_struct.hpp>
+#include <boost/variant/recursive_variant.hpp>
+#include <boost/spirit/home/qi.hpp>
+#include <boost/foreach.hpp>
+#include <iostream>
+
+// This example uses the Twitter Search API.
+//
+// https://dev.twitter.com/docs/using-search
+
+int main(int argc, char * argv[]) {
+    using namespace boost::network;
+
+    if (argc != 2) {
+        std::cout << "Usage: " << argv[0] << " <query>" << std::endl;
+        return 1;
+    }
+
+    try {
+        http::client client;
+
+        uri::uri search_uri("http://search.twitter.com/search.json");
+
+		std::cout << "Searching Twitter for query: " << argv[1] << std::endl;
+        uri::uri search_1;
+        search_1 << search_uri << uri::query("q", uri::encoded(argv[1]));
+        http::client::request request(search_1.string());
+        http::client::response response = client.get(request);
+
+        std::cout << body(response) << std::endl;
+    }
+    catch (std::exception &e) {
+        std::cerr << e.what() << std::endl;
+    }
+
+    return 0;
+}
+
