Shim legacy init macros whenever possible.

Author: chitoyuu

gdnative-core/src/init/macros.rs

@@ -21,3 +21,77 @@ macro_rules! godot_init {
         };
     };
 }
+
+/// Legacy macro that declares all the API endpoints necessary to initialize a NativeScript library.
+///
+/// This is a shim for the new [`#[gdnative::init::callbacks]`][crate::init::callbacks] attribute
+/// macro, which is now used to declare API callbacks along with the
+/// [`GDNativeCallbacks`][crate::init::GDNativeCallbacks] trait.
+#[macro_export]
+#[deprecated = "use the #[gdnative::init::callbacks] attribute macro instead"]
+macro_rules! godot_nativescript_init {
+    () => {
+        const _: () = {
+            struct GDNativeCallbacksImpl;
+
+            #[$crate::init::callbacks]
+            unsafe impl $crate::init::GDNativeCallbacks for GDNativeCallbacksImpl {}
+        };
+    };
+    ($callback:ident) => {
+        const _: () = {
+            struct GDNativeCallbacksImpl;
+
+            #[$crate::init::callbacks]
+            unsafe impl $crate::init::GDNativeCallbacks for GDNativeCallbacksImpl {
+                fn nativescript_init(handle: $crate::init::InitHandle) {
+                    $callback(handle);
+                }
+            }
+        };
+    };
+    (_ as $fn_name:ident) => {
+        ::std::compile_error!("this syntax is no longer supported. use the #[gdnative::init::callbacks] attribute macro with a prefix instead");
+    };
+    ($callback:ident as $fn_name:ident) => {
+        ::std::compile_error!("this syntax is no longer supported. use the #[gdnative::init::callbacks] attribute macro with a prefix instead");
+    };
+}
+
+/// This macro now does nothing. It is provided only for limited backwards compatibility.
+///
+/// Use the new [`#[gdnative::init::callbacks]`][crate::init::callbacks] attribute macro and,
+/// [`GDNativeCallbacks`][crate::init::GDNativeCallbacks] trait instead.
+#[macro_export]
+#[deprecated = "use the #[gdnative::init::callbacks] attribute macro instead"]
+macro_rules! godot_gdnative_init {
+    () => {};
+    ($callback:ident) => {
+        ::std::compile_error!("this syntax is no longer supported. use the #[gdnative::init::callbacks] attribute macro instead");
+    };
+    (_ as $fn_name:ident) => {
+        ::std::compile_error!("this syntax is no longer supported. use the #[gdnative::init::callbacks] attribute macro with a prefix instead");
+    };
+    ($callback:ident as $fn_name:ident) => {
+        ::std::compile_error!("this syntax is no longer supported. use the #[gdnative::init::callbacks] attribute macro with a prefix instead");
+    };
+}
+
+/// This macro now does nothing. It is provided only for limited backwards compatibility.
+///
+/// Use the new [`#[gdnative::init::callbacks]`][crate::init::callbacks] attribute macro and,
+/// [`GDNativeCallbacks`][crate::init::GDNativeCallbacks] trait instead.
+#[macro_export]
+#[deprecated = "use the #[gdnative::init::callbacks] attribute macro instead"]
+macro_rules! godot_gdnative_terminate {
+    () => {};
+    ($callback:ident) => {
+        ::std::compile_error!("this syntax is no longer supported. use the #[gdnative::init::callbacks] attribute macro instead");
+    };
+    (_ as $fn_name:ident) => {
+        ::std::compile_error!("this syntax is no longer supported. use the #[gdnative::init::callbacks] attribute macro with a prefix instead");
+    };
+    ($callback:ident as $fn_name:ident) => {
+        ::std::compile_error!("this syntax is no longer supported. use the #[gdnative::init::callbacks] attribute macro with a prefix instead");
+    };
+}

gdnative-core/src/init/mod.rs

@@ -204,7 +204,9 @@ pub fn auto_register(_init_handle: InitHandle) {
 }
 
 #[allow(deprecated)]
-pub use crate::godot_init;
+pub use crate::{
+    godot_gdnative_init, godot_gdnative_terminate, godot_init, godot_nativescript_init,
+};
 
 #[doc(inline)]
 pub use gdnative_derive::callbacks;

gdnative/src/prelude.rs

@@ -16,8 +16,6 @@ pub use gdnative_core::export::{
     ClassBuilder, ExportInfo, Method, MethodBuilder, NativeClass, NativeClassMethods, Property,
     PropertyUsage, SignalBuilder, SignalParam,
 };
-#[allow(deprecated)]
-pub use gdnative_core::godot_init;
 pub use gdnative_core::init::{GDNativeCallbacks, InitHandle};
 pub use gdnative_core::object::{
     memory::{ManuallyManaged, RefCounted},
@@ -26,6 +24,10 @@ pub use gdnative_core::object::{
     TRef,
 };
 pub use gdnative_core::{godot_dbg, godot_error, godot_print, godot_warn};
+#[allow(deprecated)]
+pub use gdnative_core::{
+    godot_gdnative_init, godot_gdnative_terminate, godot_init, godot_nativescript_init,
+};
 pub use gdnative_derive::*;
 
 /// User-data attributes from [`export::user_data`][crate::export::user_data] module.