feat: Add interface builders

Author: Norbytus

src/builders/class.rs

@@ -381,6 +381,79 @@ impl ClassBuilder {
     }
 }
 
+pub struct InterfaceBuilder {
+    class_builder: ClassBuilder,
+}
+
+impl InterfaceBuilder {
+    pub fn new<T: Into<String>>(name: T) -> Self {
+        Self {
+            class_builder: ClassBuilder::new(name),
+        }
+    }
+
+    pub fn implements(mut self, interface: ClassEntryInfo) -> Self {
+        self.class_builder = self.class_builder.implements(interface);
+
+        self
+    }
+
+    pub fn method(mut self, func: FunctionBuilder<'static>, flags: MethodFlags) -> Self {
+        self.class_builder = self.class_builder.method(func, flags);
+
+        self
+    }
+
+    pub fn constant<T: Into<String>>(
+        mut self,
+        name: T,
+        value: impl IntoZval + 'static,
+        docs: DocComments,
+    ) -> Result<Self> {
+        self.class_builder = self.class_builder.constant(name, value, docs)?;
+
+        Ok(self)
+    }
+
+    pub fn dyn_constant<T: Into<String>>(
+        mut self,
+        name: T,
+        value: &'static dyn IntoZvalDyn,
+        docs: DocComments,
+    ) -> Result<Self> {
+        self.class_builder = self.class_builder.dyn_constant(name, value, docs)?;
+
+        Ok(self)
+    }
+
+    pub fn flags(mut self, flags: ClassFlags) -> Self {
+        self.class_builder = self.class_builder.flags(flags);
+        self
+    }
+
+    pub fn object_override<T: RegisteredClass>(mut self) -> Self {
+        self.class_builder = self.class_builder.object_override::<T>();
+
+        self
+    }
+
+    pub fn registration(mut self, register: fn(&'static mut ClassEntry)) -> Self {
+        self.class_builder = self.class_builder.registration(register);
+
+        self
+    }
+
+    pub fn docs(mut self, docs: DocComments) -> Self {
+        self.class_builder = self.class_builder.docs(docs);
+        self
+    }
+
+    pub fn builder(mut self) -> ClassBuilder {
+        self.class_builder = self.class_builder.flags(ClassFlags::Interface);
+        self.class_builder
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use crate::test::test_function;

src/builders/module.rs

@@ -2,6 +2,7 @@ use std::{convert::TryFrom, ffi::CString, mem, ptr};
 
 use super::{ClassBuilder, FunctionBuilder};
 use crate::{
+    builders::class::InterfaceBuilder,
     class::RegisteredClass,
     constant::IntoConst,
     describe::DocComments,
@@ -168,6 +169,34 @@ impl ModuleBuilder<'_> {
         self
     }
 
+    pub fn interface<T: RegisteredClass>(mut self) -> Self {
+        self.classes.push(|| {
+            let mut builder = InterfaceBuilder::new(T::CLASS_NAME);
+            for (method, flags) in T::method_builders() {
+                builder = builder.method(method, flags);
+            }
+            for (name, value, docs) in T::constants() {
+                builder = builder
+                    .dyn_constant(*name, *value, docs)
+                    .expect("Failed to register constant");
+            }
+
+            let mut class_builder = builder.builder();
+
+            if let Some(modifier) = T::BUILDER_MODIFIER {
+                class_builder = modifier(class_builder);
+            }
+
+            class_builder
+                .object_override::<T>()
+                .registration(|ce| {
+                    T::get_metadata().set_ce(ce);
+                })
+                .docs(T::DOC_COMMENTS)
+        });
+        self
+    }
+
     /// Adds a class to the extension.
     ///
     /// # Panics

src/lib.rs

@@ -51,8 +51,8 @@ pub mod prelude {
     pub use crate::php_println;
     pub use crate::types::ZendCallable;
     pub use crate::{
-        php_class, php_const, php_extern, php_function, php_impl, php_module, wrap_constant,
-        wrap_function, zend_fastcall, ZvalConvert,
+        php_class, php_const, php_extern, php_function, php_impl, php_interface, php_module,
+        wrap_constant, wrap_function, zend_fastcall, ZvalConvert,
     };
 }
 
@@ -66,6 +66,6 @@ pub const PHP_DEBUG: bool = cfg!(php_debug);
 pub const PHP_ZTS: bool = cfg!(php_zts);
 
 pub use ext_php_rs_derive::{
-    php_class, php_const, php_extern, php_function, php_impl, php_module, wrap_constant,
-    wrap_function, zend_fastcall, ZvalConvert,
+    php_class, php_const, php_extern, php_function, php_impl, php_interface, php_module,
+    wrap_constant, wrap_function, zend_fastcall, ZvalConvert,
 };