aboutsummaryrefslogtreecommitdiff
path: root/src/include
diff options
context:
space:
mode:
Diffstat (limited to 'src/include')
-rw-r--r--src/include/taler_testing_auditor_lib.h98
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