Add clang-format configuration

5 files changed, 57 insertions, 46 deletions

diff --git a/.clang-format b/.clang-format
new file mode 100644
index 0000000..8f8c61c
--- /dev/null
+++ b/.clang-format
@@ -0,0 +1,33 @@
+# Copyright 2020-2024 David Robillard <d@drobilla.net>
+# SPDX-License-Identifier: 0BSD OR ISC
+
+---
+AlignConsecutiveAssignments: true
+AlignConsecutiveDeclarations: true
+AlignEscapedNewlines: Left
+AttributeMacros:
+  - SUIL_API
+BasedOnStyle: Mozilla
+BraceWrapping:
+  AfterClass: true
+  AfterEnum: false
+  AfterExternBlock: false
+  AfterFunction: true
+  AfterNamespace: false
+  AfterStruct: false
+  SplitEmptyFunction: false
+  SplitEmptyRecord: false
+BreakBeforeBraces: Custom
+Cpp11BracedListStyle: true
+FixNamespaceComments: true
+IndentCaseLabels: false
+IndentPPDirectives: AfterHash
+KeepEmptyLinesAtTheStartOfBlocks: false
+SpacesInContainerLiterals: false
+StatementMacros:
+  - SUIL_DISABLE_GTK_WARNINGS
+  - SUIL_DISABLE_QT_WARNINGS
+  - SUIL_ERRORF
+  - SUIL_RESTORE_WARNINGS
+  - _Pragma
+...
diff --git a/include/suil/suil.h b/include/suil/suil.h
index ba55a91..b9983ea 100644
--- a/include/suil/suil.h
+++ b/include/suil/suil.h
@@ -105,8 +105,7 @@ typedef enum { SUIL_ARG_NONE } SuilArg;
    and corresponding value pairs for passing any necessary platform-specific
    information.  It must be terminated with SUIL_ARG_NONE.
 */
-SUIL_API
-void
+SUIL_API void
 suil_init(int* argc, char*** argv, SuilArg key, ...);
 
 /**
@@ -121,8 +120,7 @@ suil_init(int* argc, char*** argv, SuilArg key, ...);
    where 1 is the highest quality (direct native embedding with no wrapping)
    and increasing values are of a progressively lower quality and/or stability.
 */
-SUIL_API
-unsigned
+SUIL_API unsigned
 suil_ui_supported(const char* host_type_uri, const char* ui_type_uri);
 
 /**
@@ -148,8 +146,7 @@ typedef struct SuilHostImpl SuilHost;
    @param subscribe_func Function to subscribe to port updates.
    @param unsubscribe_func Function to unsubscribe from port updates.
 */
-SUIL_API
-SuilHost*
+SUIL_API SuilHost*
 suil_host_new(SuilPortWriteFunc       write_func,
               SuilPortIndexFunc       index_func,
               SuilPortSubscribeFunc   subscribe_func,
@@ -160,15 +157,13 @@ suil_host_new(SuilPortWriteFunc       write_func,
 
    Note this function will only be called if the UI supports it.
 */
-SUIL_API
-void
+SUIL_API void
 suil_host_set_touch_func(SuilHost* host, SuilTouchFunc touch_func);
 
 /**
    Free `host`.
 */
-SUIL_API
-void
+SUIL_API void
 suil_host_free(SuilHost* host);
 
 /**
@@ -213,8 +208,7 @@ typedef void* SuilWidget;
    @param features NULL-terminated array of supported features, or NULL.
    @return A new UI instance, or NULL if instantiation failed.
 */
-SUIL_API
-SuilInstance*
+SUIL_API SuilInstance*
 suil_instance_new(SuilHost*                 host,
                   SuilController            controller,
                   const char*               container_type_uri,
@@ -231,8 +225,7 @@ suil_instance_new(SuilHost*                 host,
    The caller must ensure all references to the UI have been dropped before
    calling this function (e.g. it has been removed from its parent).
 */
-SUIL_API
-void
+SUIL_API void
 suil_instance_free(SuilInstance* instance);
 
 /**
@@ -244,8 +237,7 @@ suil_instance_free(SuilInstance* instance);
 
    The returned handle is shared and must not be deleted.
 */
-SUIL_API
-SuilHandle
+SUIL_API SuilHandle
 suil_instance_get_handle(SuilInstance* instance);
 
 /**
@@ -256,8 +248,7 @@ suil_instance_get_handle(SuilInstance* instance);
    wrapper widget created by Suil, and not necessarily the widget directly
    implemented by the UI.
 */
-SUIL_API
-SuilWidget
+SUIL_API SuilWidget
 suil_instance_get_widget(SuilInstance* instance);
 
 /**
@@ -277,8 +268,7 @@ suil_instance_get_widget(SuilInstance* instance);
    @param format Format of `buffer` (mapped URI, or 0 for float).
    @param buffer Change data, e.g. the new port value.
 */
-SUIL_API
-void
+SUIL_API void
 suil_instance_port_event(SuilInstance* instance,
                          uint32_t      port_index,
                          uint32_t      buffer_size,
@@ -286,8 +276,7 @@ suil_instance_port_event(SuilInstance* instance,
                          const void*   buffer);
 
 /// Return a data structure defined by some LV2 extension URI
-SUIL_API
-const void*
+SUIL_API const void*
 suil_instance_extension_data(SuilInstance* instance, const char* uri);
 
 /**
diff --git a/src/dylib.h b/src/dylib.h
index ac8bfbc..845a795 100644
--- a/src/dylib.h
+++ b/src/dylib.h
@@ -11,7 +11,7 @@
 enum DylibFlags {
   DYLIB_GLOBAL = 0,
   DYLIB_LAZY   = 1,
-  DYLIB_NOW    = 2
+  DYLIB_NOW    = 2,
 };
 
 static inline void*
@@ -40,7 +40,7 @@ dylib_error(void)
 enum DylibFlags {
   DYLIB_GLOBAL = RTLD_GLOBAL,
   DYLIB_LAZY   = RTLD_LAZY,
-  DYLIB_NOW    = RTLD_NOW
+  DYLIB_NOW    = RTLD_NOW,
 };
 
 static inline void*
diff --git a/src/host.c b/src/host.c
index d53b8c3..3bdc418 100644
--- a/src/host.c
+++ b/src/host.c
@@ -13,8 +13,7 @@
 int    suil_argc = 0;
 char** suil_argv = NULL;
 
-SUIL_API
-SuilHost*
+SUIL_API SuilHost*
 suil_host_new(SuilPortWriteFunc       write_func,
               SuilPortIndexFunc       index_func,
               SuilPortSubscribeFunc   subscribe_func,
@@ -32,15 +31,13 @@ suil_host_new(SuilPortWriteFunc       write_func,
   return host;
 }
 
-SUIL_API
-void
+SUIL_API void
 suil_host_set_touch_func(SuilHost* host, SuilTouchFunc touch_func)
 {
   host->touch_func = touch_func;
 }
 
-SUIL_API
-void
+SUIL_API void
 suil_host_free(SuilHost* host)
 {
   if (host) {
@@ -72,8 +69,7 @@ suil_load_init_module(const char* module_name)
 }
 #endif
 
-SUIL_API
-void
+SUIL_API void
 suil_init(int* argc, char*** argv, SuilArg key, ...)
 {
   (void)key;
diff --git a/src/instance.c b/src/instance.c
index 496155c..d039226 100644
--- a/src/instance.c
+++ b/src/instance.c
@@ -22,8 +22,7 @@
 #define WIN_UI_URI LV2_UI_PREFIX "WindowsUI"
 #define COCOA_UI_URI LV2_UI__CocoaUI
 
-SUIL_API
-unsigned
+SUIL_API unsigned
 suil_ui_supported(const char* host_type_uri, const char* ui_type_uri)
 {
   enum {
@@ -127,8 +126,7 @@ open_wrapper(SuilHost*      host,
   return wrapper;
 }
 
-SUIL_API
-SuilInstance*
+SUIL_API SuilInstance*
 suil_instance_new(SuilHost*                 host,
                   SuilController            controller,
                   const char*               container_type_uri,
@@ -269,8 +267,7 @@ suil_instance_new(SuilHost*                 host,
   return instance;
 }
 
-SUIL_API
-void
+SUIL_API void
 suil_instance_free(SuilInstance* instance)
 {
   if (instance) {
@@ -304,22 +301,19 @@ suil_instance_free(SuilInstance* instance)
   }
 }
 
-SUIL_API
-SuilHandle
+SUIL_API SuilHandle
 suil_instance_get_handle(SuilInstance* instance)
 {
   return instance->handle;
 }
 
-SUIL_API
-LV2UI_Widget
+SUIL_API LV2UI_Widget
 suil_instance_get_widget(SuilInstance* instance)
 {
   return instance->host_widget;
 }
 
-SUIL_API
-void
+SUIL_API void
 suil_instance_port_event(SuilInstance* instance,
                          uint32_t      port_index,
                          uint32_t      buffer_size,
@@ -332,8 +326,7 @@ suil_instance_port_event(SuilInstance* instance,
   }
 }
 
-SUIL_API
-const void*
+SUIL_API const void*
 suil_instance_extension_data(SuilInstance* instance, const char* uri)
 {
   if (instance->descriptor->extension_data) {