Add wrapper around qmlRegisterModule function (#220)

This is a rarely used feature, but is still needed in some corner-cases.

Closes #219

Author: ratijas

qmetaobject/src/lib.rs

@@ -216,6 +216,8 @@ pub mod webengine;
 pub mod prelude {
     #[cfg(qt_5_8)]
     pub use crate::qtdeclarative::qml_register_enum;
+    #[cfg(qt_5_9)]
+    pub use crate::qtdeclarative::qml_register_module;
     pub use crate::{
         qml_register_type, qrc, qt_base_class, qt_method, qt_plugin, qt_property, qt_signal,
         QAbstractListModel, QByteArray, QColor, QDate, QDateTime, QEnum, QModelIndex, QObject,

qmetaobject/src/qtdeclarative.rs

@@ -502,6 +502,32 @@ pub fn qml_register_type<T: QObject + Default + Sized>(
     })
 }
 
+/// Wrapper around [`void qmlRegisterModule(const char *uri, int versionMajor, int versionMinor)`][qt] function.
+///
+/// [qt]: https://doc.qt.io/qt-5/qqmlengine.html#qmlRegisterModule
+#[cfg(qt_5_9)]
+pub fn qml_register_module(
+    uri: &CStr,
+    version_major: u32,
+    version_minor: u32,
+) {
+    let uri_ptr = uri.as_ptr();
+
+    cpp!(unsafe [
+        uri_ptr as "const char *",
+        version_major as "int",
+        version_minor as "int"
+    ] {
+    #if QT_VERSION >= QT_VERSION_CHECK(5,9,0)
+        qmlRegisterModule(
+            uri_ptr,
+            version_major,
+            version_minor
+        );
+    #endif
+    });
+}
+
 /// Alias for type of `QQmlPrivate::RegisterSingletonType::qobjectApi` callback
 /// and its C++ counterpart.
 type QmlRegisterSingletonTypeCallback =

qmetaobject/tests/tests.rs

@@ -200,6 +200,26 @@ fn register_type() {
     ));
 }
 
+#[test]
+#[cfg(qt_5_9)]
+fn register_module() {
+    qml_register_module(CStr::from_bytes_with_nul(b"TestEmptyModule\0").unwrap(), 1, 2);
+
+    let obj = MyObject::default(); // not used but needed for do_test
+    assert!(do_test(
+        obj,
+        r"
+        import TestEmptyModule 1.2 as TM
+
+        QtObject {
+            function doTest() {
+                return typeof TM === 'object';
+            }
+        }
+        "
+    ));
+}
+
 #[derive(Default, QObject)]
 struct RegisterSingletonInstanceObj {
     base: qt_base_class!(trait QObject),