Merge pull request #115 from madsmtm/foundation-deref

Use `Deref` in `objc2-foundation` and remove "`INS`" helper traits

Author: madsmtm

objc2-foundation/CHANGELOG.md

@@ -6,6 +6,33 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## Unreleased - YYYY-MM-DD
 
+### Added
+* Objects now `Deref` to their superclasses. E.g. `NSMutableArray` derefs to
+  `NSArray`, which derefs to `NSObject`, which derefs to `Object`.
+
+  This allows more ergonomic usage.
+
+### Changed
+* **BREAKING**: Removed the following helper traits in favor of inherent
+  methods on the objects themselves:
+  - `INSMutableArray`
+  - `INSArray`
+  - `INSMutableData`
+  - `INSData`
+  - `INSDictionary`
+  - `INSString`
+  - `INSValue`
+  - `INSObject`
+
+  This changed because objects now deref to their superclasses.
+* **BREAKING**: Relaxed a lot of bounds from `INSObject` to `Message`. At some
+  point in the future a new trait will be introduced which remedies this
+  change.
+* **BREAKING**: Removed the `I` prefix from:
+  - `INSCopying` (now `NSCopying`)
+  - `INSMutableCopying` (now `NSMutableCopying`)
+  - `INSFastEnumeration` (now `NSFastEnumeration`)
+
 
 ## 0.2.0-alpha.4 - 2022-01-03
 

objc2-foundation/examples/basic_usage.rs

@@ -1,7 +1,5 @@
 use objc2::rc::autoreleasepool;
-use objc2_foundation::{
-    INSArray, INSCopying, INSDictionary, INSString, NSArray, NSDictionary, NSObject, NSString,
-};
+use objc2_foundation::{NSArray, NSCopying, NSDictionary, NSObject, NSString};
 
 fn main() {
     // Create and compare NSObjects

objc2-foundation/examples/class_with_lifetime.rs

@@ -7,7 +7,7 @@ use objc2::rc::{Id, Owned, Shared};
 use objc2::runtime::{Class, Object, Sel};
 use objc2::{msg_send, sel};
 use objc2::{Encoding, Message, RefEncode};
-use objc2_foundation::{INSObject, NSObject};
+use objc2_foundation::NSObject;
 
 #[repr(C)]
 pub struct MyObject<'a> {
@@ -23,6 +23,8 @@ unsafe impl RefEncode for MyObject<'_> {
 
 unsafe impl Message for MyObject<'_> {}
 
+static MYOBJECT_REGISTER_CLASS: Once = Once::new();
+
 impl<'a> MyObject<'a> {
     fn new(number_ptr: &'a mut u8) -> Id<Self, Owned> {
         unsafe {
@@ -48,11 +50,7 @@ impl<'a> MyObject<'a> {
             **ptr = number;
         }
     }
-}
-
-static MYOBJECT_REGISTER_CLASS: Once = Once::new();
 
-unsafe impl INSObject for MyObject<'_> {
     fn class() -> &'static Class {
         MYOBJECT_REGISTER_CLASS.call_once(|| {
             let superclass = NSObject::class();

objc2-foundation/examples/custom_class.rs

@@ -6,7 +6,7 @@ use objc2::rc::{Id, Owned};
 use objc2::runtime::{Class, Object, Sel};
 use objc2::{msg_send, sel};
 use objc2::{Encoding, Message, RefEncode};
-use objc2_foundation::{INSObject, NSObject};
+use objc2_foundation::NSObject;
 
 /// In the future this should be an `extern type`, if that gets stabilized,
 /// see [RFC-1861](https://rust-lang.github.io/rfcs/1861-extern-types.html).
@@ -22,6 +22,10 @@ unsafe impl RefEncode for MYObject {
     const ENCODING_REF: Encoding<'static> = Encoding::Object;
 }
 
+unsafe impl Message for MYObject {}
+
+static MYOBJECT_REGISTER_CLASS: Once = Once::new();
+
 impl MYObject {
     fn new() -> Id<Self, Owned> {
         let cls = Self::class();
@@ -41,13 +45,7 @@ impl MYObject {
             obj.set_ivar("_number", number);
         }
     }
-}
-
-unsafe impl Message for MYObject {}
-
-static MYOBJECT_REGISTER_CLASS: Once = Once::new();
 
-unsafe impl INSObject for MYObject {
     fn class() -> &'static Class {
         MYOBJECT_REGISTER_CLASS.call_once(|| {
             let superclass = NSObject::class();