gjdwebserver-overlay/mail-client/geary/files/0069-Util.JS-Support-converting-between-JSC.Value-and-GLi.patch
Gerben Jan Dijkman 63f719a806 Added files
2021-03-01 15:30:25 +01:00

331 lines
13 KiB
Diff

From 1ba2bd0f5ba655b38aff63d6332b0bb52c704119 Mon Sep 17 00:00:00 2001
From: Michael Gratton <mike@vee.net>
Date: Wed, 26 Aug 2020 15:20:12 +1000
Subject: [PATCH 069/124] Util.JS: Support converting between JSC.Value and
GLib.Variant objects
Add `variant_to_value` and `value_to_variant` methods, document them
and add tests.
---
src/client/util/util-js.vala | 159 +++++++++++++++++++++++++++++
test/client/util/util-js-test.vala | 125 +++++++++++++++++++++++
2 files changed, 284 insertions(+)
diff --git a/src/client/util/util-js.vala b/src/client/util/util-js.vala
index 52c9428b..2f05a3e2 100644
--- a/src/client/util/util-js.vala
+++ b/src/client/util/util-js.vala
@@ -127,6 +127,165 @@ namespace Util.JS {
}
}
+ /**
+ * Converts a JS value to a GLib variant.
+ *
+ * Simple value objects (string, number, and Boolean values),
+ * arrays of these, and objects with these types as properties are
+ * supported. Arrays are converted to arrays of variants, and
+ * objects to dictionaries containing string keys and variant
+ * values. Null or undefined values are returned as an empty maybe
+ * variant type, since it is not possible to determine the actual
+ * type.
+ *
+ * Throws a type error if the given value's type is not supported.
+ */
+ public inline GLib.Variant value_to_variant(JSC.Value value)
+ throws Error {
+ if (value.is_null() || value.is_undefined()) {
+ return new GLib.Variant.maybe(GLib.VariantType.VARIANT, null);
+ }
+ if (value.is_boolean()) {
+ return new GLib.Variant.boolean(value.to_boolean());
+ }
+ if (value.is_number()) {
+ return new GLib.Variant.double(value.to_double());
+ }
+ if (value.is_string()) {
+ return new GLib.Variant.string(value.to_string());
+ }
+ if (value.is_array()) {
+ int len = to_int32(value.object_get_property("length"));
+ GLib.Variant[] values = new GLib.Variant[len];
+ for (int i = 0; i < len; i++) {
+ values[i] = new GLib.Variant.variant(
+ value_to_variant(value.object_get_property_at_index(i))
+ );
+ }
+ return new GLib.Variant.array(GLib.VariantType.VARIANT, values);
+ }
+ if (value.is_object()) {
+ GLib.VariantDict dict = new GLib.VariantDict();
+ string[] names = value.object_enumerate_properties();
+ if (names != null) {
+ foreach (var name in names) {
+ try {
+ dict.insert_value(
+ name,
+ new GLib.Variant.variant(
+ value_to_variant(
+ value.object_get_property(name)
+ )
+ )
+ );
+ } catch (Error.TYPE err) {
+ // ignored
+ }
+ }
+ }
+ return dict.end();
+ }
+ throw new Error.TYPE("Unsupported JS type: %s", value.to_string());
+ }
+
+ /**
+ * Converts a GLib variant to a JS value.
+ *
+ * Simple value objects (string, number, and Boolean values),
+ * arrays and tuples of these, and dictionaries with string keys
+ * are supported. Tuples and arrays are converted to JS arrays,
+ * and dictionaries or tuples containing dictionary entries are
+ * converted to JS objects.
+ *
+ * Throws a type error if the given variant's type is not supported.
+ */
+ public inline JSC.Value variant_to_value(JSC.Context context,
+ GLib.Variant variant)
+ throws Error.TYPE {
+ JSC.Value? value = null;
+ GLib.Variant.Class type = variant.classify();
+ if (type == MAYBE) {
+ GLib.Variant? maybe = variant.get_maybe();
+ if (maybe != null) {
+ value = variant_to_value(context, maybe);
+ } else {
+ value = new JSC.Value.null(context);
+ }
+ } else if (type == VARIANT) {
+ value = variant_to_value(context, variant.get_variant());
+ } else if (type == STRING) {
+ value = new JSC.Value.string(context, variant.get_string());
+ } else if (type == BOOLEAN) {
+ value = new JSC.Value.boolean(context, variant.get_boolean());
+ } else if (type == DOUBLE) {
+ value = new JSC.Value.number(context, variant.get_double());
+ } else if (type == INT64) {
+ value = new JSC.Value.number(context, (double) variant.get_int64());
+ } else if (type == INT32) {
+ value = new JSC.Value.number(context, (double) variant.get_int32());
+ } else if (type == INT16) {
+ value = new JSC.Value.number(context, (double) variant.get_int16());
+ } else if (type == UINT64) {
+ value = new JSC.Value.number(context, (double) variant.get_uint64());
+ } else if (type == UINT32) {
+ value = new JSC.Value.number(context, (double) variant.get_uint32());
+ } else if (type == UINT16) {
+ value = new JSC.Value.number(context, (double) variant.get_uint16());
+ } else if (type == BYTE) {
+ value = new JSC.Value.number(context, (double) variant.get_byte());
+ } else if (type == ARRAY ||
+ type == TUPLE) {
+ size_t len = variant.n_children();
+ if (len == 0) {
+ if (type == ARRAY ||
+ type == TUPLE) {
+ value = new JSC.Value.array_from_garray(context, null);
+ } else {
+ value = new JSC.Value.object(context, null, null);
+ }
+ } else {
+ var first = variant.get_child_value(0);
+ if (first.classify() == DICT_ENTRY) {
+ value = new JSC.Value.object(context, null, null);
+ for (size_t i = 0; i < len; i++) {
+ var entry = variant.get_child_value(i);
+ if (entry.classify() != DICT_ENTRY) {
+ throw new Error.TYPE(
+ "Variant mixes dict entries with others: %s",
+ variant.print(true)
+ );
+ }
+ var key = entry.get_child_value(0);
+ if (key.classify() != STRING) {
+ throw new Error.TYPE(
+ "Dict entry key is not a string: %s",
+ entry.print(true)
+ );
+ }
+ value.object_set_property(
+ key.get_string(),
+ variant_to_value(context, entry.get_child_value(1))
+ );
+ }
+ } else {
+ var values = new GLib.GenericArray<JSC.Value>((uint) len);
+ for (size_t i = 0; i < len; i++) {
+ values.add(
+ variant_to_value(context, variant.get_child_value(i))
+ );
+ }
+ value = new JSC.Value.array_from_garray(context, values);
+ }
+ }
+ }
+ if (value == null) {
+ throw new Error.TYPE(
+ "Unsupported variant type %s", variant.print(true)
+ );
+ }
+ return value;
+ }
+
/**
* Escapes a string so as to be safe to use as a JS string literal.
*
diff --git a/test/client/util/util-js-test.vala b/test/client/util/util-js-test.vala
index 1fbe5276..16a01d83 100644
--- a/test/client/util/util-js-test.vala
+++ b/test/client/util/util-js-test.vala
@@ -7,9 +7,23 @@
public class Util.JS.Test : TestCase {
+
+ private JSC.Context? context = null;
+
+
public Test() {
base("Util.JS.Test");
add_test("escape_string", escape_string);
+ add_test("to_variant", to_variant);
+ add_test("to_value", to_value);
+ }
+
+ public override void set_up() throws GLib.Error {
+ this.context = new JSC.Context();
+ }
+
+ public override void tear_down() throws GLib.Error {
+ this.context = null;
}
public void escape_string() throws GLib.Error {
@@ -21,4 +35,115 @@ public class Util.JS.Test : TestCase {
assert(Util.JS.escape_string("something…\n") == """something…\n""");
}
+
+ public void to_variant() throws GLib.Error {
+ assert_equal(
+ value_to_variant(new JSC.Value.null(this.context)).print(true),
+ "@mv nothing"
+ );
+ assert_equal(
+ value_to_variant(new JSC.Value.string(this.context, "test")).print(true),
+ "'test'"
+ );
+ assert_equal(
+ value_to_variant(new JSC.Value.number(this.context, 1.0)).print(true),
+ "1.0"
+ );
+ assert_equal(
+ value_to_variant(new JSC.Value.boolean(this.context, true)).print(true),
+ "true"
+ );
+ assert_equal(
+ value_to_variant(new JSC.Value.boolean(this.context, false)).print(true),
+ "false"
+ );
+
+ var value = new JSC.Value.array_from_garray(this.context, null);
+ assert_equal(
+ value_to_variant(value).print(true),
+ "@av []"
+ );
+ var array = new GLib.GenericArray<JSC.Value>();
+ array.add(new JSC.Value.string(this.context, "test"));
+ value = new JSC.Value.array_from_garray(this.context, array);
+ assert_equal(
+ value_to_variant(value).print(true),
+ "[<'test'>]"
+ );
+ value = new JSC.Value.object(this.context, null, null);
+ assert_equal(
+ value_to_variant(value).print(true),
+ "@a{sv} {}"
+ );
+ value.object_set_property(
+ "test", new JSC.Value.boolean(this.context, true)
+ );
+ assert_equal(
+ value_to_variant(value).print(true),
+ "{'test': <<true>>}"
+ );
+ }
+
+ public void to_value() throws GLib.Error {
+ var variant = new GLib.Variant.maybe(GLib.VariantType.STRING, null);
+ var value = variant_to_value(this.context, variant);
+ assert_true(value.is_null(), variant.print(true));
+
+ variant = new GLib.Variant.string("test");
+ value = variant_to_value(this.context, variant);
+ assert_true(value.is_string(), variant.print(true));
+ assert_equal(value.to_string(), "test", variant.print(true));
+
+ variant = new GLib.Variant.int32(42);
+ value = variant_to_value(this.context, variant);
+ assert_true(value.is_number(), variant.print(true));
+ assert_equal<int32?>(value.to_int32(), 42, variant.print(true));
+
+ variant = new GLib.Variant.double(42.0);
+ value = variant_to_value(this.context, variant);
+ assert_true(value.is_number(), variant.print(true));
+ assert_within(value.to_double(), 42.0, 0.0000001, variant.print(true));
+
+ variant = new GLib.Variant.boolean(true);
+ value = variant_to_value(this.context, variant);
+ assert_true(value.is_boolean(), variant.print(true));
+ assert_true(value.to_boolean(), variant.print(true));
+
+ variant = new GLib.Variant.boolean(false);
+ value = variant_to_value(this.context, variant);
+ assert_true(value.is_boolean(), variant.print(true));
+ assert_false(value.to_boolean(), variant.print(true));
+
+ variant = new GLib.Variant.strv({"test"});
+ value = variant_to_value(this.context, variant);
+ assert_true(value.is_array(), variant.print(true));
+ assert_true(
+ value.object_get_property_at_index(0).is_string(),
+ variant.print(true)
+ );
+ assert_equal(
+ value.object_get_property_at_index(0).to_string(),
+ "test",
+ variant.print(true)
+ );
+
+ var dict = new GLib.VariantDict();
+ variant = dict.end();
+ value = variant_to_value(this.context, variant);
+ assert_true(value.is_object(), variant.print(true));
+
+ dict = new GLib.VariantDict();
+ dict.insert_value("test", new GLib.Variant.boolean(true));
+ variant = dict.end();
+ value = variant_to_value(this.context, variant);
+ assert_true(value.is_object(), variant.print(true));
+ assert_true(
+ value.object_get_property("test").is_boolean(),
+ value.to_string()
+ );
+ assert_true(
+ value.object_get_property("test").to_boolean(),
+ value.to_string()
+ );
+ }
}
--
2.29.2