Rename #[class(hide)] -> #[class(hidden)]; add utility to require minimum API version

Author: Bromeon

godot-macros/src/class/derive_godot_class.rs

@@ -13,7 +13,7 @@ use crate::class::{
     make_property_impl, make_virtual_callback, BeforeKind, Field, FieldExport, FieldVar, Fields,
     SignatureInfo,
 };
-use crate::util::{bail, ident, path_ends_with_complex, KvParser};
+use crate::util::{bail, ident, path_ends_with_complex, require_api_version, KvParser};
 use crate::{util, ParseResult};
 
 pub fn derive_godot_class(decl: Declaration) -> ParseResult<TokenStream> {
@@ -307,12 +307,7 @@ fn parse_struct_attributes(class: &Struct) -> ParseResult<ClassAttributes> {
 
         // #[class(editor_plugin)]
         if let Some(attr_key) = parser.handle_alone_with_span("editor_plugin")? {
-            if cfg!(before_api = "4.1") {
-                return bail!(
-                    attr_key,
-                    "#[class(editor_plugin)] is not supported in Godot 4.0"
-                );
-            }
+            require_api_version!("4.1", &attr_key, "#[class(editor_plugin)]")?;
 
             is_editor_plugin = true;
 
@@ -331,8 +326,9 @@ fn parse_struct_attributes(class: &Struct) -> ParseResult<ClassAttributes> {
             }
         }
 
-        // #[class(hide)]
-        if parser.handle_alone("hide")? {
+        // #[class(hidden)]
+        if let Some(span) = parser.handle_alone_with_span("hidden")? {
+            require_api_version!("4.2", span, "#[class(hidden)]")?;
             is_hidden = true;
         }
 

godot-macros/src/class/godot_api.rs

@@ -13,7 +13,7 @@ use crate::class::{
     into_signature_info, make_method_registration, make_virtual_callback, BeforeKind,
     FuncDefinition, SignatureInfo,
 };
-use crate::util::{bail, KvParser};
+use crate::util::{bail, require_api_version, KvParser};
 use crate::{util, ParseResult};
 
 pub fn attribute_godot_api(input_decl: venial::Declaration) -> ParseResult<TokenStream> {
@@ -513,7 +513,12 @@ where
                 let rename = parser.handle_expr("rename")?.map(|ts| ts.to_string());
 
                 // #[func(virtual)]
-                let is_virtual = parser.handle_alone("virtual")?;
+                let is_virtual = if let Some(span) = parser.handle_alone_with_span("virtual")? {
+                    require_api_version!("4.3", span, "#[func(virtual)]")?;
+                    true
+                } else {
+                    false
+                };
 
                 // #[func(gd_self)]
                 let has_gd_self = parser.handle_alone("gd_self")?;

godot-macros/src/lib.rs

@@ -391,12 +391,12 @@ use crate::util::ident;
 ///
 /// ## Class hiding
 ///
-/// If you want to register a class with Godot, but not have it show up in the editor then you can use `#[class(hide)]`.
+/// If you want to register a class with Godot, but not have it show up in the editor then you can use `#[class(hidden)]`.
 ///
 /// ```
 /// # use godot::prelude::*;
 /// #[derive(GodotClass)]
-/// #[class(base=Node, init, hide)]
+/// #[class(base=Node, init, hidden)]
 /// pub struct Foo {}
 /// ```
 ///

godot-macros/src/util/mod.rs

@@ -58,7 +58,20 @@ macro_rules! bail {
     }
 }
 
-pub(crate) use bail;
+macro_rules! require_api_version {
+    ($min_version:literal, $span:expr, $attribute:literal) => {
+        if !cfg!(since_api = $min_version) {
+            bail!(
+                $span,
+                "{} requires at least Godot API version {}",
+                $attribute,
+                $min_version
+            )
+        } else {
+            Ok(())
+        }
+    };
+}
 
 pub fn error_fn<T>(msg: impl AsRef<str>, tokens: T) -> Error
 where
@@ -73,7 +86,9 @@ macro_rules! error {
     }
 }
 
+pub(crate) use bail;
 pub(crate) use error;
+pub(crate) use require_api_version;
 
 pub fn reduce_to_signature(function: &Function) -> Function {
     let mut reduced = function.clone();