rm-extensions 0.0.4 → 0.0.5

data/.gitignore

@@ -15,3 +15,6 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+build
+build*
+*.bridgesupport

data/README.md

@@ -8,7 +8,9 @@ Extensions and helpers for dealing with various areas of rubymotion:
 - retaining objects through async procedures
 - weak attr_accessors
 
-Currently depends on bubblewrap and BlocksKit.
+Currently depends on bubblewrap.
+
+AssociatedObject objc runtime taken from BlocksKit, modified to work with rubymotion.
 
 ## Installation
 

data/ext/NSObject+RMExtensions.h

@@ -0,0 +1,161 @@
+//  This is a pull from BlocksKit, with modifications to accept an NSString,
+//  Since we can't send true unique pointers for objects from rubymotion, and
+//  we'll rely on sending Symbols from rubymotion which turn into unique strings
+//  in objective-c.
+// 
+//
+//  NSObject+AssociatedObjects.h
+//  BlocksKit
+//
+
+/** Objective-C wrapper for 10.6+ associated object API.
+
+ In Mac OS X Snow Leopard and iOS 3.0, Apple introduced an addition to the
+ Objective-C Runtime called associated objects. Associated objects allow for the
+ pairing of a random key and object pair to be saved on an instance.
+
+ In BlocksKit, associated objects allow us to emulate instance variables in the 
+ ategories we use.
+ 
+ Class methods also exist for each association. These associations are unique to
+ each class, and exist for the lifetime of the application unless set to `nil`.
+ Each class is a unique meta-object; the ultimate singleton.
+
+ Created by [Andy Matuschak](https://github.com/andymatuschak) as
+ `AMAssociatedObjects`.
+ */
+@interface NSObject (RMEXTAssociatedObjects)
+
+/** Strongly associates an object with the reciever.
+ 
+ The associated value is retained as if it were a property
+ synthesized with `nonatomic` and `retain`.
+ 
+ Using retained association is strongly recommended for most
+ Objective-C object derivative of NSObject, particularly
+ when it is subject to being externally released or is in an
+ `NSAutoreleasePool`.
+ 
+ @param value Any object.
+ @param key A unique key pointer.
+ */
+- (void)rmext_associateValue:(id)value withKey:(NSString *)key;
+
+/** Strongly associates an object with the receiving class.
+ 
+ @see associateValue:withKey:
+ @param value Any object.
+ @param key A unique key pointer.
+ */
++ (void)rmext_associateValue:(id)value withKey:(NSString *)key;
+
+/** Strongly, thread-safely associates an object with the reciever.
+ 
+ The associated value is retained as if it were a property
+ synthesized with `atomic` and `retain`.
+ 
+ Using retained association is strongly recommended for most
+ Objective-C object derivative of NSObject, particularly
+ when it is subject to being externally released or is in an
+ `NSAutoreleasePool`.
+ 
+ @see associateValue:withKey:
+ @param value Any object.
+ @param key A unique key pointer.
+ */
+- (void)rmext_atomicallyAssociateValue:(id)value withKey:(NSString *)key;
+
+/** Strongly, thread-safely associates an object with the receiving class.
+ 
+ @see associateValue:withKey:
+ @param value Any object.
+ @param key A unique key pointer.
+ */
++ (void)rmext_atomicallyAssociateValue:(id)value withKey:(NSString *)key;
+
+/** Associates a copy of an object with the reciever.
+ 
+ The associated value is copied as if it were a property
+ synthesized with `nonatomic` and `copy`.
+ 
+ Using copied association is recommended for a block or
+ otherwise `NSCopying`-compliant instances like NSString.
+ 
+ @param value Any object, pointer, or value.
+ @param key A unique key pointer.
+ */
+- (void)rmext_associateCopyOfValue:(id)value withKey:(NSString *)key;
+
+/** Associates a copy of an object with the receiving class.
+ 
+ @see associateCopyOfValue:withKey:
+ @param value Any object, pointer, or value.
+ @param key A unique key pointer.
+ */
++ (void)rmext_associateCopyOfValue:(id)value withKey:(NSString *)key;
+
+/** Thread-safely associates a copy of an object with the reciever.
+ 
+ The associated value is copied as if it were a property
+ synthesized with `atomic` and `copy`.
+ 
+ Using copied association is recommended for a block or
+ otherwise `NSCopying`-compliant instances like NSString.
+ 
+ @see associateCopyOfValue:withKey:
+ @param value Any object, pointer, or value.
+ @param key A unique key pointer.
+ */
+- (void)rmext_atomicallyAssociateCopyOfValue:(id)value withKey:(NSString *)key;
+
+/** Thread-safely associates a copy of an object with the receiving class.
+ 
+ @see associateCopyOfValue:withKey:
+ @param value Any object, pointer, or value.
+ @param key A unique key pointer.
+ */
++ (void)rmext_atomicallyAssociateCopyOfValue:(id)value withKey:(NSString *)key;
+
+/** Weakly associates an object with the reciever.
+ 
+ A weak association will cause the pointer to be set to zero
+ or nil upon the disappearance of what it references;
+ in other words, the associated object is not kept alive.
+ 
+ @param value Any object.
+ @param key A unique key pointer.
+ */
+- (void)rmext_weaklyAssociateValue:(id)value withKey:(NSString *)key;
+
+/** Weakly associates an object with the receiving class.
+ 
+ @see weaklyAssociateValue:withKey:
+ @param value Any object.
+ @param key A unique key pointer.
+ */
++ (void)rmext_weaklyAssociateValue:(id)value withKey:(NSString *)key;
+
+/** Returns the associated value for a key on the reciever.
+
+ @param key A unique key pointer.
+ @return The object associated with the key, or `nil` if not found.
+ */
+- (id)rmext_associatedValueForKey:(NSString *)key;
+
+/** Returns the associated value for a key on the receiving class.
+ 
+ @see associatedValueForKey:
+ @param key A unique key pointer.
+ @return The object associated with the key, or `nil` if not found.
+ */
++ (id)rmext_associatedValueForKey:(NSString *)key;
+
+/** Returns the reciever to a clean state by removing all
+ associated objects, releasing them if necessary. */
+- (void)rmext_removeAllAssociatedObjects;
+
+/** Returns the recieving class to a clean state by removing
+ all associated objects, releasing them if necessary. */
++ (void)rmext_removeAllAssociatedObjects;
+
+@end

data/ext/NSObject+RMExtensions.m

@@ -0,0 +1,76 @@
+//  This is a pull from BlocksKit, with modifications to accept an NSString,
+//  Since we can't send true unique pointers for objects from rubymotion, and
+//  we'll rely on sending Symbols from rubymotion which turn into unique strings
+//  in objective-c.
+// 
+//
+//  NSObject+AssociatedObjects.m
+//  BlocksKit
+//
+
+#import "NSObject+RMExtensions.h"
+#import <objc/runtime.h>
+
+@implementation NSObject (RMEXTAssociatedObjects)
+
+#pragma mark - Instance Methods
+
+- (void)rmext_associateValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
+}
+
+- (void)rmext_atomicallyAssociateValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_RETAIN);
+}
+
+- (void)rmext_associateCopyOfValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_COPY_NONATOMIC);
+}
+
+- (void)rmext_atomicallyAssociateCopyOfValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_COPY);
+}
+
+- (void)rmext_weaklyAssociateValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_ASSIGN);
+}
+
+- (id)rmext_associatedValueForKey:(NSString *)key {
+  return objc_getAssociatedObject(self, key);
+}
+
+- (void)rmext_removeAllAssociatedObjects {
+  objc_removeAssociatedObjects(self);
+}
+
+#pragma mark - Class Methods
+
++ (void)rmext_associateValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
+}
+
++ (void)rmext_atomicallyAssociateValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_RETAIN);
+}
+
++ (void)rmext_associateCopyOfValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_COPY_NONATOMIC);
+}
+
++ (void)rmext_atomicallyAssociateCopyOfValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_COPY);
+}
+
++ (void)rmext_weaklyAssociateValue:(id)value withKey:(NSString *)key {
+  objc_setAssociatedObject(self, key, value, OBJC_ASSOCIATION_ASSIGN);
+}
+
++ (id)rmext_associatedValueForKey:(NSString *)key {
+  return objc_getAssociatedObject(self, key);
+}
+
++ (void)rmext_removeAllAssociatedObjects {
+  objc_removeAssociatedObjects(self);
+}
+
+@end

data/lib/motion/rm-extensions.rb

@@ -3,30 +3,13 @@ module RMExtensions
   # this module is included on Object, so these methods are available from anywhere in your code.
   module ObjectExtensions
 
-    # get a pointer for a symbol, which can be used as a key.
-    # the hash lookup table is kept per instance and not global so as objects dealloc,
-    # these mappings get freed.
-    def rmext_pointer_for_symbol(sym)
-      @rmext_pointers_for_symbols ||= {}
-      @rmext_pointers_for_symbols[sym] ||= begin
-        ptr = Pointer.new(:object)
-        ptr.assign(sym)
-        ptr
-      end
-      @rmext_pointers_for_symbols[sym]
-    end
-
     def rmext_weak_attr_accessor(*attrs)
       attrs.each do |attr|
         define_method(attr) do
-          ptr = rmext_pointer_for_symbol(attr.to_sym)
-          # p "weak_getter", attr, ptr
-          associatedValueForKey(ptr)
+          rmext_associatedValueForKey(attr.to_sym)
         end
         define_method("#{attr}=") do |val|
-          ptr = rmext_pointer_for_symbol(attr.to_sym)
-          # p "weak_setter", attr, ptr
-          weaklyAssociateValue(val, withKey:ptr)
+          rmext_weaklyAssociateValue(val, withKey: attr.to_sym)
           val
         end
       end
@@ -35,14 +18,10 @@ module RMExtensions
     def rmext_copy_attr_accessor(*attrs)
       attrs.each do |attr|
         define_method(attr) do
-          ptr = rmext_pointer_for_symbol(attr.to_sym)
-          # p "copy_getter", attr, ptr
-          associatedValueForKey(ptr)
+          rmext_associatedValueForKey(attr.to_sym)
         end
         define_method("#{attr}=") do |val|
-          ptr = rmext_pointer_for_symbol(attr.to_sym)
-          # p "copy_setter", attr, ptr
-          associateCopyOfValue(val, withKey:ptr)
+          rmext_associateCopyOfValue(val, withKey: attr.to_sym)
           val
         end
       end

data/lib/rm-extensions/version.rb

@@ -1,3 +1,3 @@
 module RMExtensions
-  VERSION = "0.0.4"
+  VERSION = "0.0.5"
 end

data/lib/rm-extensions.rb

@@ -8,4 +8,5 @@ Motion::Project::App.setup do |app|
   Dir.glob(File.join(File.dirname(__FILE__), 'motion/**/*.rb')).each do |file|
     app.files.unshift(file)
   end
+  app.vendor_project(File.join(File.dirname(__FILE__), '../ext'), :static)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rm-extensions
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-01 00:00:00.000000000 Z
+date: 2013-05-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bubble-wrap
@@ -39,6 +39,8 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- ext/NSObject+RMExtensions.h
+- ext/NSObject+RMExtensions.m
 - lib/motion/rm-extensions.rb
 - lib/rm-extensions.rb
 - lib/rm-extensions/version.rb