feat(capi): Add API to get runtime library version

capi/src/lib.rs

@@ -33,6 +33,8 @@ mod io;
 mod logger;
 mod public;
 
+pub mod version;
+
 /// Initializes chewing context and environment settings.
 ///
 /// Most of the Chewing IM APIs require a

capi/src/symbols-elf.map

@@ -128,4 +128,9 @@ CHEWING_0.9 {
         chewing_config_get_int;
         chewing_config_set_str;
         chewing_config_get_str;
+        chewing_version;
+        chewing_version_major;
+        chewing_version_minor;
+        chewing_version_patch;
+        chewing_version_extra;
 } CHEWING_0.5;

capi/src/symbols-mach_o.map

@@ -120,4 +120,9 @@ _chewing_config_has_option
 _chewing_config_set_int
 _chewing_config_get_int
 _chewing_config_set_str
-_chewing_config_get_str
+_chewing_config_get_str
+_chewing_version
+_chewing_version_major
+_chewing_version_minor
+_chewing_version_patch
+_chewing_version_extra

capi/src/symbols-msvc.def

@@ -121,4 +121,9 @@ EXPORTS
     chewing_config_set_int;
     chewing_config_get_int;
     chewing_config_set_str;
-    chewing_config_get_str;
+    chewing_config_get_str;
+    chewing_version;
+    chewing_version_major;
+    chewing_version_minor;
+    chewing_version_patch;
+    chewing_version_extra;

capi/src/version.rs

@@ -0,0 +1,26 @@
+use std::ffi::{c_char, c_int};
+
+#[no_mangle]
+pub extern "C" fn chewing_version() -> *const c_char {
+    c"0.9.0-alpha.1".as_ptr()
+}
+
+#[no_mangle]
+pub extern "C" fn chewing_version_major() -> c_int {
+    0
+}
+
+#[no_mangle]
+pub extern "C" fn chewing_version_minor() -> c_int {
+    9
+}
+
+#[no_mangle]
+pub extern "C" fn chewing_version_patch() -> c_int {
+    0
+}
+
+#[no_mangle]
+pub extern "C" fn chewing_version_extra() -> *const c_char {
+    c"-alpha.1".as_ptr()
+}

include/chewing.h

@@ -1080,6 +1080,16 @@ void chewing_set_hsuSelKeyType(struct ChewingContext *_ctx, int mode);
  */
 int chewing_get_hsuSelKeyType(struct ChewingContext *_ctx);
 
+const char *chewing_version(void);
+
+int chewing_version_major(void);
+
+int chewing_version_minor(void);
+
+int chewing_version_patch(void);
+
+const char *chewing_version_extra(void);
+
 #ifdef __cplusplus
 }  // extern "C"
 #endif  // __cplusplus

tests/test-config.c

@@ -8,6 +8,7 @@
  * of this file.
  */
 
+#include <stdio.h>
 #ifdef HAVE_CONFIG_H
 #    include <config.h>
 #endif
@@ -726,6 +727,21 @@ void test_new2()
     test_new2_userpath();
 }
 
+void test_runtime_version()
+{
+    char buf[256];
+    int major = chewing_version_major();
+    int minor = chewing_version_minor();
+    int patch = chewing_version_patch();
+    const char *extra = chewing_version_extra();
+    const char *version = chewing_version();
+
+    ok(version != NULL, "chewing_version returns a version string");
+
+    sprintf(buf, "%d.%d.%d%s", major, minor, patch, extra);
+    ok(strcmp(buf, version) == 0, "chewing_version can be created from components");
+}
+
 int main(int argc, char *argv[])
 {
     char *logname;
@@ -764,6 +780,8 @@ int main(int argc, char *argv[])
 
     test_new2();
 
+    test_runtime_version();
+
     fclose(fd);
 
     return exit_status();