chore: Use Meson to generate the header file (#55)

Author: DataTriny

.github/workflows/ci.yml

@@ -110,14 +110,19 @@ jobs:
     steps:
     - uses: actions/checkout@v5
 
-    - name: install nightly toolchain
+    - uses: actions/setup-python@v6
+    - run: pip install meson ninja
+
+    - name: install nightly Rust toolchain
       uses: dtolnay/rust-toolchain@master
       with:
         toolchain: nightly-2025-03-27
 
-    - uses: dtolnay/install@master
+    - name: install cbindgen
+      uses: dtolnay/install@master
       with:
         crate: cbindgen
-    - run: cmake -S . -B build -DACCESSKIT_BUILD_HEADERS=ON -DACCESSKIT_BUILD_LIBRARIES=OFF
-    - run: cmake --build build
+
+    - run: meson setup build
+    - run: meson compile -C build accesskit.h
     - run: cmp build/accesskit.h include/accesskit.h

README.md

@@ -69,6 +69,14 @@ cmake --build build
 cmake --install build
 ```
 
+Alternatively, you can use Meson like so:
+
+```console
+meson setup build
+meson compile -C build accesskit.h
+meson install -C build --tags generated-headers --no-rebuild
+```
+
 ## License
 
 AccessKit is licensed under the [Apache License, Version 2.0](LICENSE-APACHE) or the [MIT license](LICENSE-MIT), at your option.

meson.build

@@ -260,15 +260,6 @@ if toolchain_arg != []
   cargo_wrapper_args += toolchain_arg
 endif
 
-includes = files(
-    'include/accesskit.h'
-)
-
-install_headers(
-    includes,
-    subdir: '@0@'.format(accesskit_c_lib_name),
-)
-
 library_sources = files(
   'Cargo.lock',
   'Cargo.toml',
@@ -280,6 +271,48 @@ library_sources = files(
   'src/windows.rs',
 )
 
+# Header generation with cbindgen
+generated_headers_directory = meson.project_source_root() / 'include'
+rustup = find_program('rustup', required: false)
+cbindgen = find_program('cbindgen', required: false)
+clang_format = find_program('clang-format', required: false)
+
+if rustup.found() and cbindgen.found() and clang_format.found()
+  # Generate header with cbindgen, then format
+  generated_header = custom_target(
+    'accesskit_unformatted.h',
+    output: 'accesskit_unformatted.h',
+    depend_files: [library_sources, '.clang-format', 'cbindgen.toml'],
+    command: [
+      rustup, 'run', 'nightly-2025-03-27',
+      cbindgen, '--crate', 'accesskit-c', '--output', '@OUTPUT@',
+      meson.project_source_root()
+    ],
+    build_by_default: false,
+  )
+
+  formatted_header = custom_target(
+    'accesskit.h',
+    input: generated_header,
+    output: 'accesskit.h',
+    command: [clang_format, '@INPUT@'],
+    capture: true,
+    build_by_default: false,
+    install: true,
+    install_dir: generated_headers_directory,
+    install_tag: ['generated-headers'],
+  )
+endif
+
+includes = files(
+    generated_headers_directory / 'accesskit.h'
+)
+
+install_headers(
+    includes,
+    subdir: '@0@'.format(accesskit_c_lib_name),
+)
+
 rust_artifacts = custom_target(
   'accesskit-c',
   build_by_default: true,
@@ -440,6 +473,7 @@ if get_option('default_library') in ['static', 'both']
     ],
     install: true,
     install_dir: get_option('libdir'),
+    install_tag: ['devel'],
   )
 endif