Add more variants for etcd::Watcher's constructor.

Resolves #143.

Signed-off-by: Tao He <sighingnow@gmail.com>

.github/workflows/centos-latest.yml

@@ -80,9 +80,11 @@ jobs:
 
       - name: Install cpprestsdk
         run: |
+          export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib:/usr/local/lib64
+
           mkdir -p build
           cd build
-          git clone https://github.com/microsoft/cpprestsdk.git
+          git clone https://github.com/microsoft/cpprestsdk.git --depth=1
           mkdir -p cpprestsdk/build
           cd cpprestsdk/build
           cmake .. -DCMAKE_BUILD_TYPE=Debug \

README.md

@@ -240,8 +240,8 @@ printf 'root\nroot\n' | /usr/local/bin/etcdctl user add root
 
 Etcd [transport security](https://etcd.io/docs/v3.4.0/op-guide/security/) and certificate based
 authentication have been supported as well. The `Client::Client` could accept arguments `ca` ,
-`cert` and `key` for CA cert, cert and private key files for the SSL/TLS transport and authentication.
+`cert` and `privkey` for CA cert, cert and private key files for the SSL/TLS transport and authentication.
-Note that the later arguments `cert` and `key` could be empty strings or omitted if you just need
+Note that the later arguments `cert` and `privkey` could be empty strings or omitted if you just need
 secure transport and don't enable certificate-based client authentication (using the `--client-cert-auth`
 arguments when launching etcd server).
 

etcd/Client.hpp

@@ -169,32 +169,32 @@ namespace etcd
      *
      * @param etcd_url is the url of the etcd server to connect to, like "http://127.0.0.1:2379",
      *                 or multiple url, seperated by ',' or ';'.
-     * @param ca   root CA file for SSL/TLS connection.
+     * @param ca      root CA file for SSL/TLS connection.
-     * @param cert cert chain file for SSL/TLS authentication, could be empty string.
+     * @param cert    cert chain file for SSL/TLS authentication, could be empty string.
-     * @param key  private key file for SSL/TLS authentication, could be empty string.
+     * @param privkey private key file for SSL/TLS authentication, could be empty string.
      * @param load_balancer is the load balance strategy, can be one of round_robin/pick_first/grpclb/xds.
      */
     Client(std::string const & etcd_url,
            std::string const & ca,
            std::string const & cert,
-           std::string const & key,
+           std::string const & privkey,
            std::string const & target_name_override,
-           std::string const & load_balancer);
+           std::string const & load_balancer = "round_robin");
 
     /**
      * Constructs an etcd client object.
      *
      * @param etcd_url is the url of the etcd server to connect to, like "http://127.0.0.1:2379",
      *                 or multiple url, seperated by ',' or ';'.
-     * @param ca   root CA file for SSL/TLS connection.
+     * @param ca      root CA file for SSL/TLS connection.
-     * @param cert cert chain file for SSL/TLS authentication, could be empty string.
+     * @param cert    cert chain file for SSL/TLS authentication, could be empty string.
-     * @param key  private key file for SSL/TLS authentication, could be empty string.
+     * @param privkey private key file for SSL/TLS authentication, could be empty string.
      * @param arguments user provided grpc channel arguments.
      */
     Client(std::string const & etcd_url,
            std::string const & ca,
            std::string const & cert,
-           std::string const & key,
+           std::string const & privkey,
            std::string const & target_name_override,
 #if defined(WITH_GRPC_CHANNEL_CLASS)
            grpc::ChannelArguments const & arguments
@@ -208,9 +208,9 @@ namespace etcd
      *
      * @param etcd_url is the url of the etcd server to connect to, like "http://127.0.0.1:2379",
      *                 or multiple url, seperated by ',' or ';'.
-     * @param ca   root CA file for SSL/TLS connection.
+     * @param ca      root CA file for SSL/TLS connection.
-     * @param cert cert chain file for SSL/TLS authentication, could be empty string.
+     * @param cert    cert chain file for SSL/TLS authentication, could be empty string.
-     * @param key  private key file for SSL/TLS authentication, could be empty string.
+     * @param privkey private key file for SSL/TLS authentication, could be empty string.
      * @param target_name_override Override the target host name if you want to pass multiple address
      * for load balancing with SSL, and there's no DNS. The @target_name_override@ must exist in the
      * SANS of your SSL certificate.
@@ -219,7 +219,7 @@ namespace etcd
     static Client *WithSSL(std::string const & etcd_url,
                                  std::string const & ca,
                                  std::string const & cert = "",
-                                 std::string const & key = "",
+                                 std::string const & privkey = "",
                                  std::string const & target_name_override = "",
                                  std::string const & load_balancer = "round_robin");
 
@@ -228,9 +228,9 @@ namespace etcd
      *
      * @param etcd_url is the url of the etcd server to connect to, like "http://127.0.0.1:2379",
      *                 or multiple url, seperated by ',' or ';'.
-     * @param ca   root CA file for SSL/TLS connection.
+     * @param ca      root CA file for SSL/TLS connection.
-     * @param cert cert chain file for SSL/TLS authentication, could be empty string.
+     * @param cert    cert chain file for SSL/TLS authentication, could be empty string.
-     * @param key  private key file for SSL/TLS authentication, could be empty string.
+     * @param privkey private key file for SSL/TLS authentication, could be empty string.
      * @param target_name_override Override the target host name if you want to pass multiple address
      * for load balancing with SSL, and there's no DNS. The @target_name_override@ must exist in the
      * SANS of your SSL certificate.
@@ -244,7 +244,7 @@ namespace etcd
 #endif
                                  std::string const & ca,
                                  std::string const & cert = "",
-                                 std::string const & key = "",
+                                 std::string const & privkey = "",
                                  std::string const & target_name_override = "");
 
     ~Client();

etcd/KeepAlive.hpp

@@ -55,6 +55,13 @@ namespace etcd
               std::function<void (std::exception_ptr)> const &handler,
               int ttl, int64_t lease_id = 0,
               int const auth_token_ttl = 300);
+    KeepAlive(std::string const & address,
+              std::string const & ca,
+              std::string const & cert,
+              std::string const & privkey,
+              std::function<void (std::exception_ptr)> const &handler,
+              int ttl, int64_t lease_id = 0,
+              std::string const & target_name_override = "");
 
     KeepAlive(KeepAlive const &) = delete;
     KeepAlive(KeepAlive &&) = delete;

etcd/SyncClient.hpp

@@ -224,32 +224,32 @@ namespace etcd
      *
      * @param etcd_url is the url of the etcd server to connect to, like "http://127.0.0.1:2379",
      *                 or multiple url, seperated by ',' or ';'.
-     * @param ca   root CA file for SSL/TLS connection.
+     * @param ca      root CA file for SSL/TLS connection.
-     * @param cert cert chain file for SSL/TLS authentication, could be empty string.
+     * @param cert    cert chain file for SSL/TLS authentication, could be empty string.
-     * @param key  private key file for SSL/TLS authentication, could be empty string.
+     * @param privkey private key file for SSL/TLS authentication, could be empty string.
      * @param load_balancer is the load balance strategy, can be one of round_robin/pick_first/grpclb/xds.
      */
     SyncClient(std::string const & etcd_url,
            std::string const & ca,
            std::string const & cert,
-           std::string const & key,
+           std::string const & privkey,
            std::string const & target_name_override,
-           std::string const & load_balancer);
+           std::string const & load_balancer = "round_robin");
 
     /**
      * Constructs an etcd client object.
      *
      * @param etcd_url is the url of the etcd server to connect to, like "http://127.0.0.1:2379",
      *                 or multiple url, seperated by ',' or ';'.
-     * @param ca   root CA file for SSL/TLS connection.
+     * @param ca      root CA file for SSL/TLS connection.
-     * @param cert cert chain file for SSL/TLS authentication, could be empty string.
+     * @param cert    cert chain file for SSL/TLS authentication, could be empty string.
-     * @param key  private key file for SSL/TLS authentication, could be empty string.
+     * @param privkey private key file for SSL/TLS authentication, could be empty string.
      * @param arguments user provided grpc channel arguments.
      */
     SyncClient(std::string const & etcd_url,
            std::string const & ca,
            std::string const & cert,
-           std::string const & key,
+           std::string const & privkey,
            std::string const & target_name_override,
 #if defined(WITH_GRPC_CHANNEL_CLASS)
            grpc::ChannelArguments const & arguments
@@ -264,9 +264,9 @@ namespace etcd
      *
      * @param etcd_url is the url of the etcd server to connect to, like "http://127.0.0.1:2379",
      *                 or multiple url, seperated by ',' or ';'.
-     * @param ca   root CA file for SSL/TLS connection.
+     * @param ca      root CA file for SSL/TLS connection.
-     * @param cert cert chain file for SSL/TLS authentication, could be empty string.
+     * @param cert    cert chain file for SSL/TLS authentication, could be empty string.
-     * @param key  private key file for SSL/TLS authentication, could be empty string.
+     * @param privkey private key file for SSL/TLS authentication, could be empty string.
      * @param target_name_override Override the target host name if you want to pass multiple address
      * for load balancing with SSL, and there's no DNS. The @target_name_override@ must exist in the
      * SANS of your SSL certificate.
@@ -275,7 +275,7 @@ namespace etcd
     static SyncClient *WithSSL(std::string const & etcd_url,
                                  std::string const & ca,
                                  std::string const & cert = "",
-                                 std::string const & key = "",
+                                 std::string const & privkey = "",
                                  std::string const & target_name_override = "",
                                  std::string const & load_balancer = "round_robin");
 
@@ -284,9 +284,9 @@ namespace etcd
      *
      * @param etcd_url is the url of the etcd server to connect to, like "http://127.0.0.1:2379",
      *                 or multiple url, seperated by ',' or ';'.
-     * @param ca   root CA file for SSL/TLS connection.
+     * @param ca      root CA file for SSL/TLS connection.
-     * @param cert cert chain file for SSL/TLS authentication, could be empty string.
+     * @param cert    cert chain file for SSL/TLS authentication, could be empty string.
-     * @param key  private key file for SSL/TLS authentication, could be empty string.
+     * @param privkey private key file for SSL/TLS authentication, could be empty string.
      * @param target_name_override Override the target host name if you want to pass multiple address
      * for load balancing with SSL, and there's no DNS. The @target_name_override@ must exist in the
      * SANS of your SSL certificate.
@@ -300,7 +300,7 @@ namespace etcd
 #endif
                                  std::string const & ca,
                                  std::string const & cert = "",
-                                 std::string const & key = "",
+                                 std::string const & privkey = "",
                                  std::string const & target_name_override = "");
 
     ~SyncClient();

etcd/Watcher.hpp

@@ -67,6 +67,20 @@ namespace etcd
             std::string const & key, std::string const &range_end, int64_t fromIndex,
             std::function<void(Response)> callback,
             int const auth_token_ttl = 300);
+    Watcher(std::string const & address,
+            std::string const & ca,
+            std::string const & cert,
+            std::string const & privkey,
+            std::string const & key, int64_t fromIndex,
+            std::function<void(Response)> callback, bool recursive=false,
+            std::string const & target_name_override = "");
+    Watcher(std::string const & address,
+            std::string const & ca,
+            std::string const & cert,
+            std::string const & privkey,
+            std::string const & key, std::string const &range_end, int64_t fromIndex,
+            std::function<void(Response)> callback,
+            std::string const & target_name_override = "");
 
     Watcher(Watcher const &) = delete;
     Watcher(Watcher &&) = delete;

src/Client.cpp

@@ -157,18 +157,18 @@ etcd::Client *etcd::Client::WithUser(std::string const & etcd_url,
 etcd::Client::Client(std::string const & address,
                      std::string const & ca,
                      std::string const & cert,
-                     std::string const & key,
+                     std::string const & privkey,
                      std::string const & target_name_override,
                      std::string const & load_balancer)
 {
   this->own_client = true;
-  this->client = new SyncClient(address, ca, cert, key, target_name_override, load_balancer);
+  this->client = new SyncClient(address, ca, cert, privkey, target_name_override, load_balancer);
 }
 
 etcd::Client::Client(std::string const & address,
                      std::string const & ca,
                      std::string const & cert,
-                     std::string const & key,
+                     std::string const & privkey,
                      std::string const & target_name_override,
 #if defined(WITH_GRPC_CHANNEL_CLASS)
            grpc::ChannelArguments const & arguments
@@ -179,16 +179,16 @@ etcd::Client::Client(std::string const & address,
                      )
 {
   this->own_client = true;
-  this->client = new SyncClient(address, ca, cert, key, target_name_override, arguments);
+  this->client = new SyncClient(address, ca, cert, privkey, target_name_override, arguments);
 }
 
 etcd::Client *etcd::Client::WithSSL(std::string const & etcd_url,
                                     std::string const & ca,
                                     std::string const & cert,
-                                    std::string const & key,
+                                    std::string const & privkey,
                                     std::string const & target_name_override,
                                     std::string const & load_balancer) {
-  return new etcd::Client(etcd_url, ca, cert, key, target_name_override, load_balancer);
+  return new etcd::Client(etcd_url, ca, cert, privkey, target_name_override, load_balancer);
 }
 
 etcd::Client *etcd::Client::WithSSL(std::string const & etcd_url,
@@ -199,9 +199,9 @@ etcd::Client *etcd::Client::WithSSL(std::string const & etcd_url,
 #endif
                                     std::string const & ca,
                                     std::string const & cert,
-                                    std::string const & key,
+                                    std::string const & privkey,
                                     std::string const & target_name_override) {
-  return new etcd::Client(etcd_url, ca, cert, key, target_name_override, arguments);
+  return new etcd::Client(etcd_url, ca, cert, privkey, target_name_override, arguments);
 }
 
 etcd::Client::~Client() {

src/KeepAlive.cpp

@@ -59,6 +59,16 @@ etcd::KeepAlive::KeepAlive(std::string const & address,
     KeepAlive(SyncClient(address, username, password, auth_token_ttl), ttl, lease_id) {
 }
 
+etcd::KeepAlive::KeepAlive(std::string const & address,
+              std::string const & ca,
+              std::string const & cert,
+              std::string const & privkey,
+              std::function<void (std::exception_ptr)> const &handler,
+              int ttl, int64_t lease_id,
+              std::string const & target_name_override):
+    KeepAlive(SyncClient(address, ca, cert, privkey, target_name_override), ttl, lease_id) {
+}
+
 etcd::KeepAlive::KeepAlive(SyncClient const &client,
                            std::function<void (std::exception_ptr)> const &handler,
                            int ttl, int64_t lease_id):

src/SyncClient.cpp

@@ -383,7 +383,7 @@ etcd::SyncClient *etcd::SyncClient::WithUser(std::string const & etcd_url,
 etcd::SyncClient::SyncClient(std::string const & address,
                      std::string const & ca,
                      std::string const & cert,
-                     std::string const & key,
+                     std::string const & privkey,
                      std::string const & target_name_override,
                      std::string const & load_balancer)
 {
@@ -393,7 +393,7 @@ etcd::SyncClient::SyncClient(std::string const & address,
   grpc_args.SetMaxSendMessageSize(std::numeric_limits<int>::max());
   grpc_args.SetMaxReceiveMessageSize(std::numeric_limits<int>::max());
   std::shared_ptr<grpc::ChannelCredentials> creds = grpc::SslCredentials(
-      etcd::detail::make_ssl_credentials(ca, cert, key));
+      etcd::detail::make_ssl_credentials(ca, cert, privkey));
   grpc_args.SetLoadBalancingPolicyName(load_balancer);
   if (!target_name_override.empty()) {
     grpc_args.SetString(GRPC_SSL_TARGET_NAME_OVERRIDE_ARG, target_name_override);
@@ -413,7 +413,7 @@ etcd::SyncClient::SyncClient(std::string const & address,
 etcd::SyncClient::SyncClient(std::string const & address,
                      std::string const & ca,
                      std::string const & cert,
-                     std::string const & key,
+                     std::string const & privkey,
                      std::string const & target_name_override,
                      #if defined(WITH_GRPC_CHANNEL_CLASS)
            grpc::ChannelArguments const & arguments
@@ -429,7 +429,7 @@ etcd::SyncClient::SyncClient(std::string const & address,
   grpc_args.SetMaxSendMessageSize(std::numeric_limits<int>::max());
   grpc_args.SetMaxReceiveMessageSize(std::numeric_limits<int>::max());
   std::shared_ptr<grpc::ChannelCredentials> creds = grpc::SslCredentials(
-      etcd::detail::make_ssl_credentials(ca, cert, key));
+      etcd::detail::make_ssl_credentials(ca, cert, privkey));
   if (!target_name_override.empty()) {
     grpc_args.SetString(GRPC_SSL_TARGET_NAME_OVERRIDE_ARG, target_name_override);
   }
@@ -448,10 +448,10 @@ etcd::SyncClient::SyncClient(std::string const & address,
 etcd::SyncClient *etcd::SyncClient::WithSSL(std::string const & etcd_url,
                                     std::string const & ca,
                                     std::string const & cert,
-                                    std::string const & key,
+                                    std::string const & privkey,
                                     std::string const & target_name_override,
                                     std::string const & load_balancer) {
-  return new etcd::SyncClient(etcd_url, ca, cert, key, target_name_override, load_balancer);
+  return new etcd::SyncClient(etcd_url, ca, cert, privkey, target_name_override, load_balancer);
 }
 
 etcd::SyncClient *etcd::SyncClient::WithSSL(std::string const & etcd_url,
@@ -462,9 +462,9 @@ etcd::SyncClient *etcd::SyncClient::WithSSL(std::string const & etcd_url,
 #endif
                                     std::string const & ca,
                                     std::string const & cert,
-                                    std::string const & key,
+                                    std::string const & privkey,
                                     std::string const & target_name_override) {
-  return new etcd::SyncClient(etcd_url, ca, cert, key, target_name_override, arguments);
+  return new etcd::SyncClient(etcd_url, ca, cert, privkey, target_name_override, arguments);
 }
 
 etcd::SyncClient::~SyncClient() {

src/Watcher.cpp

@@ -94,6 +94,26 @@ etcd::Watcher::Watcher(std::string const & address,
     Watcher(SyncClient(address, username, password, auth_token_ttl), key, range_end, fromIndex, callback) {
 }
 
+etcd::Watcher::Watcher(std::string const & address,
+            std::string const & ca,
+            std::string const & cert,
+            std::string const & privkey,
+            std::string const & key, int64_t fromIndex,
+            std::function<void(Response)> callback, bool recursive,
+            std::string const & target_name_override):
+    Watcher(SyncClient(address, ca, cert, privkey, target_name_override), key, fromIndex, callback, recursive) {
+}
+
+etcd::Watcher::Watcher(std::string const & address,
+            std::string const & ca,
+            std::string const & cert,
+            std::string const & privkey,
+            std::string const & key, std::string const & range_end, int64_t fromIndex,
+            std::function<void(Response)> callback,
+            std::string const & target_name_override):
+    Watcher(SyncClient(address, ca, cert, privkey, target_name_override), key, range_end, fromIndex, callback) {
+}
+
 etcd::Watcher::~Watcher()
 {
   this->Cancel();