add skeleton for auditor httpd tests

1 files changed, 98 insertions, 0 deletions

diff --git a/src/include/taler_testing_auditor_lib.h b/src/include/taler_testing_auditor_lib.h
new file mode 100644
index 000000000..49b55581d
--- /dev/null
+++ b/src/include/taler_testing_auditor_lib.h
@@ -0,0 +1,98 @@
+/*
+  This file is part of TALER
+  (C) 2018 Taler Systems SA
+
+  TALER is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 3, or
+  (at your option) any later version.
+
+  TALER is distributed in the hope that it will be useful, but
+  WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public
+  License along with TALER; see the file COPYING.  If not, see
+  <http://www.gnu.org/licenses/>
+*/
+
+/**
+ * @file include/taler_testing_auditor_lib.h
+ * @brief API for writing an interpreter to test Taler components
+ * @author Christian Grothoff <christian@grothoff.org>
+ * @author Marcello Stanisci
+ */
+#ifndef TALER_TESTING_AUDITOR_LIB_H
+#define TALER_TESTING_AUDITOR_LIB_H
+
+#include "taler_util.h"
+#include "taler_exchange_service.h"
+#include <gnunet/gnunet_json_lib.h>
+#include "taler_json_lib.h"
+#include <microhttpd.h>
+
+
+/* ********************* Helper functions ********************* */
+
+/**
+ * Prepare launching an auditor and exchange.  Checks that the configured
+ * port is available, runs taler-exchange-keyup, taler-auditor-exchange,
+ * taler-auditor-sign and taler-exchange-dbinit.  Does not
+ * launch the exchange process itself.
+ *
+ * @param config_filename configuration file to use
+ * @param auditor_base_url[out] will be set to the auditor base url,
+ *        if the config has any; otherwise it will be set to
+ *        NULL.
+ * @param exchange_base_url[out] will be set to the exchange base url,
+ *        if the config has any; otherwise it will be set to
+ *        NULL.
+ * @return #GNUNET_OK on success, #GNUNET_NO if test should be
+ *         skipped, #GNUNET_SYSERR on test failure
+ */
+int
+TALER_TESTING_AUDITOR_prepare_auditor (const char *config_filename,
+				       char **auditor_base_url,
+				       char **exchange_base_url);
+
+
+/**
+ * Wait for the auditor to have started. Waits for at
+ * most 10s, after that returns 77 to indicate an error.
+ *
+ * @param base_url what URL should we expect the exchange
+ *        to be running at
+ * @return 0 on success
+ */
+int
+TALER_TESTING_AUDITOR_wait_auditor_ready (const char *base_url);
+
+
+/**
+ * Remove files from previous runs
+ */
+void
+TALER_TESTING_AUDITOR_cleanup_files (const char *config_name);
+
+
+/**
+ * Initialize scheduler loop and curl context for the testcase
+ * including starting and stopping the auditor and exchange using the
+ * given configuration file.
+ *
+ * @param main_cb routine containing all the commands to run.
+ * @param main_cb_cls closure for @a main_cb, typically NULL.
+ * @param config_file configuration file for the test-suite.
+ *
+ * @return #GNUNET_OK if all is okay, != #GNUNET_OK otherwise.
+ *         non-#GNUNET_OK codes are #GNUNET_SYSERR most of the
+ *         time.
+ */
+int
+TALER_TESTING_AUDITOR_setup_with_auditor (TALER_TESTING_Main main_cb,
+					  void *main_cb_cls,
+					  const char *config_filename);
+
+
+#endif