application, datastore, polystore imported from Capy

Author: vinniefalco

include/boost/http/application.hpp

@@ -0,0 +1,78 @@
+//
+// Copyright (c) 2022 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// 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)
+//
+// Official repository: https://github.com/cppalliance/http
+//
+
+#ifndef BOOST_HTTP_APPLICATION_HPP
+#define BOOST_HTTP_APPLICATION_HPP
+
+#include <boost/http/detail/config.hpp>
+#include <boost/http/core/polystore.hpp>
+#include <memory>
+#include <type_traits>
+
+namespace boost {
+namespace http {
+
+/** A collection of type-erased parts and process state
+
+    An object of this type holds a collection of type-erased parts,
+    where each part undergoes two-phase initialization. First the part is
+    constructed by calling @ref emplace. The @ref start function invokes
+    `start()` on each part. When @ref stop is called, each part has its
+    `stop()` member invoked. And when the application object is destroyed,
+    all the parts are destroyed in reverse order of construction.
+*/
+class BOOST_HTTP_SYMBOL_VISIBLE
+    application : public http::polystore
+{
+public:
+    application(application const&) = delete;
+    application& operator=(application const&) = delete;
+
+    /** Destructor
+
+        All stored objects will be destroyed in the reverse order of creation.
+    */
+    BOOST_HTTP_DECL
+    ~application();
+
+    /** Constructor
+    */
+    BOOST_HTTP_DECL
+    application();
+
+    /** Invoke `start` on each part in creation order
+        Each call is performed synchronously; this function blocks until each
+        part returns. Only one invocation of `start` is permitted.
+    */
+    BOOST_HTTP_DECL
+    void start();
+
+    /** Invoke `stop` on each part in reverse creation order
+        This function is idempotent and returns immediately.
+        @par Thread Safety
+        May be called concurrently.
+    */
+    BOOST_HTTP_DECL
+    void stop();
+
+    /** Wait until the application is stopped
+    */
+    BOOST_HTTP_DECL
+    void join();
+
+private:
+    enum state : char;
+    struct impl;
+    impl* impl_;
+};
+
+} // http
+} // boost
+
+#endif

include/boost/http/brotli.hpp

@@ -20,10 +20,10 @@
 
     @code
     #include <boost/http/brotli.hpp>
-    #include <boost/capy/datastore.hpp>
+    #include <boost/http/datastore.hpp>
 
     // Create a datastore for services
-    boost::capy::datastore ctx;
+    boost::http::datastore ctx;
 
     // Install compression and decompression services
     auto& encoder = boost::http::brotli::install_encode_service(ctx);

include/boost/http/brotli/decode.hpp

@@ -71,7 +71,7 @@ using metadata_chunk_func = void (*)(void* opaque, const std::uint8_t* data, std
 
     @code
     // Example: Simple one-shot decompression
-    boost::capy::datastore ctx;
+    boost::http::datastore ctx;
     auto& decoder = boost::http::brotli::install_decode_service(ctx);
 
     std::vector<std::uint8_t> compressed_data = get_compressed_data();
@@ -249,7 +249,7 @@ struct BOOST_SYMBOL_VISIBLE
 */
 BOOST_HTTP_DECL
 decode_service&
-install_decode_service(capy::polystore& ctx);
+install_decode_service(http::polystore& ctx);
 
 } // brotli
 } // http

include/boost/http/brotli/encode.hpp

@@ -153,7 +153,7 @@ enum constants
 
     @code
     // Example: Simple one-shot compression
-    boost::capy::datastore ctx;
+    boost::http::datastore ctx;
     auto& encoder = boost::http::brotli::install_encode_service(ctx);
 
     std::vector<std::uint8_t> input_data = get_input_data();
@@ -353,7 +353,7 @@ struct BOOST_SYMBOL_VISIBLE
 */
 BOOST_HTTP_DECL
 encode_service&
-install_encode_service(capy::polystore& ctx);
+install_encode_service(http::polystore& ctx);
 
 } // brotli
 } // http

include/boost/http/brotli/shared_dictionary.hpp

@@ -12,7 +12,7 @@
 
 #include <boost/http/detail/config.hpp>
 #include <boost/http/brotli/types.hpp>
-#include <boost/capy/core/polystore_fwd.hpp>
+#include <boost/http/core/polystore_fwd.hpp>
 
 namespace boost {
 namespace http {
@@ -69,7 +69,7 @@ struct BOOST_SYMBOL_VISIBLE
 */
 BOOST_HTTP_DECL
 shared_dictionary_service&
-install_shared_dictionary_service(capy::polystore& ctx);
+install_shared_dictionary_service(http::polystore& ctx);
 
 } // brotli
 } // http