Catch up with Gearman's libtest
[m6w6/libmemcached] / libtest / framework.h
index 7a58cbeeb94cef276c424af3f94a304772ee651c..da1d5b9878ed2b28a4ac5451a10050778fe8b440 100644 (file)
-/* uTest Copyright (C) 2011 Data Differential, http://datadifferential.com/
+/*  vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
+ *
+ *  Data Differential YATL (i.e. libtest)  library
+ *
+ *  Copyright (C) 2012 Data Differential, http://datadifferential.com/
+ *
+ *  Redistribution and use in source and binary forms, with or without
+ *  modification, are permitted provided that the following conditions are
+ *  met:
+ *
+ *      * Redistributions of source code must retain the above copyright
+ *  notice, this list of conditions and the following disclaimer.
+ *
+ *      * Redistributions in binary form must reproduce the above
+ *  copyright notice, this list of conditions and the following disclaimer
+ *  in the documentation and/or other materials provided with the
+ *  distribution.
+ *
+ *      * The names of its contributors may not be used to endorse or
+ *  promote products derived from this software without specific prior
+ *  written permission.
+ *
+ *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ *  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ *  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ *  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ *  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ *  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ *  THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ *  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ *  OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *
- * Use and distribution licensed under the BSD license.  See
- * the COPYING file in the parent directory for full text.
  */
 
 #pragma once
 
+#include <libtest/signal.h>
+
 /**
   Framework is the structure which is passed to the test implementation to be filled.
   This must be implemented in order for the test framework to load the tests. We call
   get_world() in order to fill this structure.
 */
 
-struct Framework {
-  collection_st *collections;
+#include <vector>
 
-  /* These methods are called outside of any collection call. */
-  test_callback_create_fn *_create;
-  test_callback_fn *_destroy;
+class Framework {
+public:
+
+public:
+  test_return_t create();
 
-  void* create(test_return_t* arg)
+  void create(test_callback_create_fn* arg)
   {
-    if (_create)
-    {
-      return _create(arg);
-    }
+    _create= arg;
+  }
 
-    return NULL;
+  void destroy(test_callback_destroy_fn* arg)
+  {
+    _destroy= arg;
   }
 
-  test_return_t destroy(void*);
+  void collections(collection_st* arg)
+  {
+    _collections= arg;
+  }
 
-  /* This is called a the beginning of any collection run. */
-  test_callback_fn *collection_startup;
+  void set_on_error(test_callback_error_fn *arg)
+  {
+    _on_error= arg;
+  }
 
-  test_return_t startup(void*);
+  test_return_t on_error(const enum test_return_t, void *);
 
-  /* This is called a the end of any collection run. */
-  test_callback_fn *collection_shutdown;
+  void set_socket()
+  {
+    _servers.set_socket();
+  }
 
-  test_return_t shutdown(void* arg)
+  void set_sasl(const std::string& username_arg, const std::string& password_arg)
   {
-    if (collection_shutdown)
-    {
-      return collection_shutdown(arg);
-    }
+    _servers.set_sasl(username_arg, password_arg);
+  }
 
-    return TEST_SUCCESS;
+  libtest::server_startup_st& servers()
+  {
+    return _servers;
   }
 
-  /**
-    These are run before/after the test. If implemented. Their execution is not controlled
-    by the test.
-  */
-  struct Item {
-    /* This is called a the beginning of any run. */
-    test_callback_fn *_startup;
-
-    test_return_t startup(void*);
-
-    /* 
-      This called on a test if the test requires a flush call (the bool is
-      from test_st) 
-    */
-    test_callback_fn *_flush;
-
-    /*
-       Run before and after the runnner is executed.
-    */
-    test_callback_fn *pre_run;
-    test_callback_fn *post_run;
-
-    Item() :
-      _startup(NULL),
-      _flush(NULL),
-      pre_run(NULL),
-      post_run(NULL)
-    { }
-
-    test_return_t flush(void* arg, test_st* run);
-
-    void set_pre(test_callback_fn *arg)
-    {
-      pre_run= arg;
-    }
-
-    void set_post(test_callback_fn *arg)
-    {
-      pre_run= arg;
-    }
-
-    test_return_t pre(void *arg)
-    {
-      if (pre_run)
-      {
-        return pre_run(arg);
-      }
-
-      return TEST_SUCCESS;
-    }
-
-    test_return_t post(void *arg)
-    {
-      if (post_run)
-      {
-        return post_run(arg);
-      }
-
-      return TEST_SUCCESS;
-    }
-
-  } item;
+  void set_runner(libtest::Runner *arg)
+  {
+    _runner= arg;
+  }
+
+  libtest::Runner *runner();
+
+  void exec();
+
+  libtest::Collection& collection();
+
+  Framework(libtest::SignalThread&, const std::string&);
+
+  virtual ~Framework();
+
+  Framework(libtest::SignalThread&,
+            const std::string&,
+            const std::string&);
+
+  bool match(const char* arg);
+
+  void *creators_ptr()
+  {
+    return _creators_ptr;
+  }
+
+  libtest::SignalThread& signal()
+  {
+    return _signal;
+  }
+
+  uint32_t sum_total();
+  uint32_t sum_success();
+  uint32_t sum_skipped();
+  uint32_t sum_failed();
+
+  size_t size() 
+  {
+    return _collection.size();
+  }
+
+  uint32_t total() const
+  {
+    return _total;
+  }
+
+  uint32_t success() const
+  {
+    return _success;
+  }
+
+  uint32_t skipped() const
+  {
+    return _skipped;
+  }
+
+  uint32_t failed() const
+  {
+    return _failed;
+  }
+
+private:
+  Framework& operator=(const Framework&);
+
+  collection_st *_collections;
+
+  uint32_t _total;
+  uint32_t _success;
+  uint32_t _skipped;
+  uint32_t _failed;
+  
+  /* These methods are called outside of any collection call. */
+  test_callback_create_fn *_create;
+  test_callback_destroy_fn *_destroy;
 
   /**
     If an error occurs during the test, this is called.
   */
   test_callback_error_fn *_on_error;
 
-  test_return_t on_error(const enum test_return_t, void *);
-
   /**
     Runner represents the callers for the tests. If not implemented we will use
     a set of default implementations.
   */
-  Runner *runner;
-
-  Framework();
-
-  virtual ~Framework()
-  { }
-
-  Framework(const Framework&);
-
-private:
-  Framework& operator=(const Framework&);
+  libtest::Runner *_runner;
+
+  libtest::server_startup_st _servers;
+  bool _socket;
+  void *_creators_ptr;
+  unsigned long int _servers_to_run;
+  std::vector<libtest::Collection*> _collection;
+  libtest::SignalThread& _signal;
+  std::string _only_run;
+  std::string _wildcard;
 };