Add the matrix_http_api_gen_parameters() convenience method

docs/reference/matrix-glib/matrix-glib-sections.txt

@@ -57,6 +57,7 @@ matrix_http_api_new
 matrix_http_api_get_validate_certificate
 matrix_http_api_set_validate_certificate
 matrix_http_api_get_base_url
+matrix_http_api_gen_parameters
 <SUBSECTION Standard>
 MatrixHTTPAPI
 MatrixHTTPAPIClass

src/matrix-http-api.c

@@ -306,6 +306,46 @@ matrix_http_api_get_validate_certificate(MatrixHTTPAPI *api)
     return priv->validate_certificate;
 }
 
+/**
+ * matrix_http_api_gen_parameters:
+ * @param1_name: name of the first parameter
+ * @...: value of the first parameter, followed by name/value pairs,
+ *       terminated by a NULL value as a parameter name
+ *
+ * Generate a GHashTable suitable as the parameters argument for
+ * different API calls.
+ *
+ * Returns: (transfer full): a #GHashTable with the specified
+ *          parameter table
+ */
+GHashTable *
+matrix_http_api_gen_parameters(const gchar *param1_name, ...)
+{
+    GHashTable *table;
+    va_list var_args;
+    gchar *name;
+
+    g_return_val_if_fail(param1_name != NULL, NULL);
+
+    table = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, g_free);
+
+    va_start(var_args, param1_name);
+
+    name = (gchar *)param1_name;
+
+    while (name) {
+        gchar *value = va_arg(var_args, gchar *);
+
+        g_hash_table_insert(table, name, value);
+
+        name = va_arg(var_args, gchar *);
+    }
+
+    va_end(var_args);
+
+    return table;
+}
+
 /**
  * matrix_http_api_get_base_url:
  * @api: a #MatrixHTTPAPI implementation

src/matrix-http-api.h

@@ -50,6 +50,7 @@ void matrix_http_api_set_validate_certificate(MatrixHTTPAPI *api,
 gboolean matrix_http_api_get_validate_certificate(MatrixHTTPAPI *api);
 const gchar *matrix_http_api_get_base_url(MatrixHTTPAPI *api);
 
+GHashTable *matrix_http_api_gen_parameters(const gchar *param1_name, ...);
 MatrixHTTPAPI *matrix_http_api_new(const gchar *base_url, const gchar *token);
 G_END_DECLS