alex/cacao
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
cacao/src/foundation/mod.rs

68 lines
2.1 KiB
Rust
Raw Normal View History

Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
//! This module contains some lightweight wrappers over Foundation data types.
//!
//! Some of it is pulled/inspired from Servo's cocoa-rs (e.g, the "id" type). While
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
//! this isn't a clone of their module (we don't need everything from there, but remaining
//! compatible in case an end-user wants to drop that low is deal), it's worth linking their
//! license and repository - they've done really incredible work and it's 100% worth acknowledging.
//!
//! - [core-foundation-rs Repository](https://github.com/servo/core-foundation-rs)
//! - [core-foundation-rs MIT License](https://github.com/servo/core-foundation-rs/blob/master/LICENSE-MIT)
//! - [core-foundation-rs Apache License](https://github.com/servo/core-foundation-rs/blob/master/LICENSE-APACHE)
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
//!
//! ## Why?
//! A good question. The existing wrappers tend to use traits over `id`, which works well for some
//! cases, but I found it frustrating and messy trying to work with them. These provide the API I
//! was looking for, and help provide all the proper `retain`/`release` logic needed for the
//! Objective-C side.
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
#![allow(non_camel_case_types)]
#![allow(non_upper_case_globals)]
use objc::runtime;
pub use objc::runtime::{BOOL, NO, YES};
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
mod autoreleasepool;
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
pub use autoreleasepool::AutoReleasePool;
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
mod array;
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
pub use array::NSArray;
More features and cleanup. - Reconfigured subclass creation, as there was a subtle-but-big-when-it-hit bug in the prior method where bridge callbacks would lose context of the appropriate delegate when calling the trait method. The new approach found in `src/foundation/class.rs` maps and caches subclass creation, and subclasses are now more apparent when debugging from the Objective-C side as we can carry their intended name/usage through. Not applied to all yet, but eventually. - Cleaned up a number of linter warnings that had grown over time. - Delegate traits now require an associated const `NAME`, which is used for subclass creation. - (macOS) Toolbars now supported setting selected items, which is typically used in preferences screens. - (macOS) Windows now support setting the toolbar display style. On Big Sur, this works as intended - it's a noop on older OS's that don't support it. - Support for system icons for macOS preferences windows. Still a bit to go to flesh this all out, but it's getting there - at which point then iOS supoort can be folded in easier.
2021-02-07 20:25:56 -08:00
mod class;
pub use class::load_or_register_class;
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
mod data;
pub use data::NSData;
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
mod dictionary;
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
pub use dictionary::NSDictionary;
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
mod number;
pub use number::NSNumber;
mod string;
pub use string::NSString;
/// More or less maps over to Objective-C's `id` type, which... can really be anything.
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
#[allow(non_camel_case_types)]
pub type id = *mut runtime::Object;
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
/// Exactly what it sounds like.
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
#[allow(non_upper_case_globals)]
pub const nil: id = 0 as id;
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
/// Platform-specific.
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
#[cfg(target_pointer_width = "32")]
pub type NSInteger = libc::c_int;
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
/// Platform-specific.
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
#[cfg(target_pointer_width = "32")]
pub type NSUInteger = libc::c_uint;
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
/// Platform-specific.
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
#[cfg(target_pointer_width = "64")]
pub type NSInteger = libc::c_long;
Fix NSData wrapper so storing and retrieving bytes in UserDefaults works as expected, with hopefully little to no cloning issues. Wrap the NSNumber logic into a proper type. More documentation/cleanup, still ongoing.
2020-03-31 15:22:00 -07:00
/// Platform-specific.
Wrap Foundation ourselves, because there's some considerations down the road and it's easier to do this now.
2020-03-17 16:55:09 -07:00
#[cfg(target_pointer_width = "64")]
pub type NSUInteger = libc::c_ulong;
Reference in a new issue Copy permalink