Class: Cocoa::NSObject

Inherits:

Object

Object
Cocoa::NSObject

show all

Includes:: Cocoa

Defined in:: lib/cocoa/helpers.rb,
lib/cocoa/extensions.rb,
lib/cocoa/bindings/NSObject.rb

Direct Known Subclasses

CAAnimation, CAConstraint, CAConstraintLayoutManager, CAEmitterCell, CALayer, CAMediaTimingFunction, CARemoteLayerClient, CARemoteLayerServer, CARenderer, CATransaction, CAValueFunction, CIColor, CIFilter, CIImage, NSAffineTransform, NSAlert, NSAnimation, NSAnimationContext, NSAppleEventDescriptor, NSAppleEventManager, NSAppleScript, NSArray, NSAssertionHandler, NSAttributedString, NSAutoreleasePool, NSBezierPath, NSBundle, NSCache, NSCachedURLResponse, NSCalendar, NSCell, NSCharacterSet, NSClassDescription, NSCoder, NSColor, NSColorList, NSColorPicker, NSColorSpace, NSCondition, NSConditionLock, NSConnection, NSController, NSCursor, NSData, NSDate, NSDateComponents, NSDecimalNumberHandler, NSDictionary, NSDistantObjectRequest, NSDistributedLock, NSDockTile, NSDocument, NSDocumentController, NSDraggingImageComponent, NSDraggingItem, NSDraggingSession, NSEnumerator, NSError, NSEvent, NSException, NSExpression, NSFileCoordinator, NSFileHandle, NSFileManager, NSFileVersion, NSFileWrapper, NSFont, NSFontCollection, NSFontDescriptor, NSFontManager, NSFormatter, NSGarbageCollector, NSGlyphGenerator, NSGlyphInfo, NSGradient, NSGraphicsContext, NSHTTPCookie, NSHTTPCookieStorage, NSHashTable, NSHelpManager, NSHost, NSImage, NSImageRep, NSIndexPath, NSIndexSet, NSInputManager, NSInputServer, NSInvocation, NSJSONSerialization, NSLayoutConstraint, NSLayoutManager, NSLinguisticTagger, NSLocale, NSLock, NSMapTable, NSMenu, NSMenuItem, NSMetadataItem, NSMetadataQuery, NSMetadataQueryAttributeValueTuple, NSMetadataQueryResultGroup, NSMethodSignature, NSMovie, NSNetService, NSNetServiceBrowser, NSNib, NSNibConnector, NSNotification, NSNotificationCenter, NSNotificationQueue, NSNull, NSOpenGLContext, NSOpenGLPixelBuffer, NSOpenGLPixelFormat, NSOperation, NSOperationQueue, NSOrderedSet, NSOrthography, NSPageLayout, NSParagraphStyle, NSPasteboard, NSPasteboardItem, NSPipe, NSPointerArray, NSPointerFunctions, NSPort, NSPortMessage, NSPortNameServer, NSPositionalSpecifier, NSPredicate, NSPredicateEditorRowTemplate, NSPrintInfo, NSPrintOperation, NSPrintPanel, NSPrinter, NSProcessInfo, NSPropertyListSerialization, NSProxy, NSRecursiveLock, NSRegularExpression, NSResponder, NSRulerMarker, NSRunLoop, NSRunningApplication, NSScanner, NSScreen, NSScriptCoercionHandler, NSScriptCommand, NSScriptCommandDescription, NSScriptExecutionContext, NSScriptObjectSpecifier, NSScriptSuiteRegistry, NSScriptWhoseTest, NSSet, NSShadow, NSSharingService, NSSharingServicePicker, NSSortDescriptor, NSSound, NSSpeechRecognizer, NSSpeechSynthesizer, NSSpellChecker, NSSpellServer, NSStatusBar, NSStatusItem, NSStream, NSString, NSTabViewItem, NSTableColumn, NSTask, NSTextAlternatives, NSTextAttachment, NSTextBlock, NSTextCheckingResult, NSTextContainer, NSTextFinder, NSTextInputContext, NSTextList, NSTextTab, NSThread, NSTimeZone, NSTimer, NSToolbar, NSToolbarItem, NSTouch, NSTrackingArea, NSTreeNode, NSTypesetter, NSURL, NSURLAuthenticationChallenge, NSURLCache, NSURLConnection, NSURLCredential, NSURLCredentialStorage, NSURLDownload, NSURLHandle, NSURLProtectionSpace, NSURLProtocol, NSURLRequest, NSURLResponse, NSUUID, NSUbiquitousKeyValueStore, NSUndoManager, NSUserDefaults, NSUserNotification, NSUserNotificationCenter, NSUserScriptTask, NSValue, NSValueTransformer, NSWorkspace, NSXMLNode, NSXMLParser, NSXPCConnection, NSXPCInterface, NSXPCListener

Constant Summary

Constants included from Cocoa

Instance Attribute Summary collapse

#klass ⇒ Object

Returns the value of attribute klass.
#object ⇒ Object

Returns the value of attribute object.

Class Method Summary collapse

Instance Method Summary collapse

#autorelease ⇒ Object
#init ⇒ Object
#initialize(allocated = false) ⇒ NSObject constructor

A new instance of NSObject.
#new ⇒ Object

Methods included from Cocoa

#CFRangeMake, #CGRectMake, #NSMakePoint, #NSMakeRange, #NSMakeRect, #NSMakeSize, attach_nsstring_getter, #const_missing, #instance_for, #instances

Constructor Details

#initialize(allocated = false) ⇒ `NSObject`

Returns a new instance of NSObject.

# File 'lib/cocoa/extensions.rb', line 62

def initialize allocated=false
  @klass = ObjC.objc_getClass(self.class.native_name)
  unless allocated
    self.object = @klass
    new
  end
end

Instance Attribute Details

#klass ⇒ `Object`

Returns the value of attribute klass.



82
83
84

# File 'lib/cocoa/helpers.rb', line 82

def klass
  @klass
end

#object ⇒ `Object`

Returns the value of attribute object.



83
84
85

# File 'lib/cocoa/helpers.rb', line 83

def object
  @object
end

Class Method Details

.alloc ⇒ `Object`

# File 'lib/cocoa/extensions.rb', line 38

def self.alloc
  instance = new(true)
  instance.object = ObjC.msgSend_pointer(get_class,"alloc")
  instance
end

.attach_method(method, *_params) ⇒ `Object`

# File 'lib/cocoa/helpers.rb', line 124

def self.attach_method method,*_params
  return if method==:class
  @method_specs ||= {}
  @method_specs[method] = []
  [_params].flatten.each do |spec|
    @method_specs[method] << ObjC::MethodDef.new(method,spec)
  end
  define_method method do |*args|
    klass = self.class; klass = klass.superclass while !klass.instance_methods(false).include?(method)
    spec = klass.instance_variable_get(:@method_specs)[method]

    matching = if args.size <= 1
      matching = spec.select do |m|
        m.types.size == args.size
      end
    else
      matching = if args.last.is_a? Hash
        spec.select do |m|
          args.last.keys == m.names
        end
      else
        raise "hell" unless args.size == 1
        spec.select do |m|
          m.types.size == 1
        end
      end
    end
    raise "hell" unless matching.size == 1
    m = matching.first
    m.call(self,@object,*args)
  end
end

.attach_singular_method(method, *__params) ⇒ `Object`

# File 'lib/cocoa/helpers.rb', line 85

def self.attach_singular_method method,*__params
  return if method == :superclass
  return if method == :class
  return if method == :new

  @@singular_specs ||= {}
  @@singular_specs[method] = []
  [__params].flatten.each do |spec|
    @@singular_specs[method] << ObjC::MethodDef.new(method,spec)
  end

  define_singleton_method method do |*args|
    matching = if args.size <= 1
      matching = @@singular_specs[method].select do |m|
        m.types.size == args.size
      end
    else
      matching = if args.last.is_a? Hash
        @@singular_specs[method].select do |m|
          args.last.keys == m.names
        end
      else
        if args.size == 1
          @@singular_specs[method].select do |m|
            m.types.size == 1
          end
        else
          @@singular_specs[method].select do |m|
            m.variadic? && m.types.size == 1
          end
        end
      end
    end
    raise "hell" unless matching.size == 1
    m = matching.first
    m.call(self,ObjC.objc_getClass(name.split('::').last),*args)
  end
end

.const_missing(name) ⇒ `Object`



24
25
26

# File 'lib/cocoa/extensions.rb', line 24

def self.const_missing name
  Cocoa.const_get name
end

.get_class ⇒ `Object`



58
59
60

# File 'lib/cocoa/extensions.rb', line 58

def self.get_class
  ObjC.objc_getClass(native_name)
end

.inherited(parent) ⇒ `Object`

# File 'lib/cocoa/extensions.rb', line 44

def self.inherited(parent)
  if parent.name
    klass = begin
      Cocoa::const_get(parent.native_name)
      ObjC.objc_getClass(parent.native_name)
    rescue
    end
    unless klass && klass.address != 0
      klass = ObjC.objc_allocateClassPair(ObjC.objc_getClass(native_name),parent.native_name,0)
      ObjC.objc_registerClassPair(klass)
    end
  end
end

.method_added(name) ⇒ `Object`

# File 'lib/cocoa/helpers.rb', line 192

def self.method_added(name)
  return if name == :== # TODO: define as equals or something?
  return if name.to_s[-1] == '='
  return if caller[1].split('`').last[0..-2] == 'method_added'      # self
  return if caller.first.split('`').last[0..-2] == 'define_method'  # MRI
  return if caller.first.split('`').last[0..-2] == 'attach_method'  # Rubinius

  # define an alias for keyword argument methods such that:
  # class Foo
  #   def bar whatever, alpha: nil
  #     puts "alpha is: #{alpha}"
  #   end
  #   def bar whatever, omega: nil
  #     puts "omega is: #{omega}"
  #   end
  # end
  # Foo.new.bar "hello", omega: "is omega"
  # Foo.new.bar "hello", alpha: "is alpha"
  #=>
  # omega is: is omega
  # alpha is: is alpha
  keys = instance_method(name).parameters.select{ |param| param.first == :key }.map{ |param| param.last }
  ruby_name = name
  if keys.size > 0
    ruby_name = "_#{name}_with_#{keys.join('_and_')}".to_sym
    alias_method ruby_name, name
  end


  defs = method_defs name
  defs ||= ObjC::MethodDef.new(name, :names => [], :types => ['@'], :retval => 'v')  # TODO: generate from method arguments!

  [defs].flatten.each do |m|
    @callbacks ||= []
    @callbacks << Proc.new do |this,cmd,*args|
      m.ruby_name = ruby_name
      begin
        instance = Cocoa.instances[this.address]
        params = instance_method(ruby_name).parameters
        m.callback(instance,params,args)
      rescue => e
        puts e.message
        puts e.backtrace
      end
    end

    callback_name = "#{self.name.gsub('::','__')}_#{m.selector.gsub(/:/,'_')}".to_sym
    add_method = "add_#{callback_name}".to_sym

    native_name = begin
      arr = self.name.split('::')
      native = if arr.first == 'Cocoa'
        arr.last
      else
        self.name.gsub(/::/,'__')
      end
      native
    end

    ObjC.callback callback_name, [:pointer, :pointer]+m.ffi_types, m.ffi_return_type
    ObjC.attach_function add_method, :class_addMethod, [:pointer,:pointer,callback_name,:string], :void

    ObjC.send(add_method,ObjC.objc_getClass(native_name),ObjC.sel_registerName(m.selector),@callbacks.last,m.objc_types)
  end
end

.method_defs(method) ⇒ `Object`

# File 'lib/cocoa/helpers.rb', line 162

def self.method_defs method
  klass = self
  method_specs = klass.instance_variable_get(:@method_specs)
  while klass && (!method_specs || !method_specs[method])
    klass = klass.superclass
    method_specs = klass.instance_variable_get(:@method_specs)
  end
  return nil unless method_specs

  spec = method_specs[method]
  params = instance_method(method).parameters
  keys = params.select{ |param| param.first == :key }.map{ |param| param.last }
  if params.size > 0 && params.last.first == :rest
    filtered = spec.select do |m|
      ((m.types.size == 0 && keys.size == 0) || (m.types.size > keys.size)) &&
      (m.names[0,keys.size-1] || []) == keys
    end
    return nil if filtered.size == 0
    filtered
  else
    filtered = spec.select do |m|
      ((m.types.size == 0 && keys.size == 0) || (m.types.size == keys.size+1)) &&
      m.names == keys
    end
    return nil if filtered.size == 0
    raise filtered.inspect unless filtered.size == 1
    filtered.first
  end
end

.native_name ⇒ `Object`

# File 'lib/cocoa/extensions.rb', line 28

def self.native_name
  arr = name.split('::')
  native = if arr.first == 'Cocoa'
    arr.last
  else
    name.gsub(/::/,'__')
  end
  native
end

Instance Method Details

#autorelease ⇒ `Object`

# File 'lib/cocoa/extensions.rb', line 80

def autorelease
  self.object = ObjC.msgSend_pointer(@object,"autorelease")
  self
end

#init ⇒ `Object`

# File 'lib/cocoa/extensions.rb', line 70

def init
  self.object = ObjC.msgSend_pointer(@object,"init")
  self
end

#new ⇒ `Object`

# File 'lib/cocoa/extensions.rb', line 75

def new
  self.object = ObjC.msgSend_pointer(@object,"new")
  self
end

Class: Cocoa::NSObject

Direct Known Subclasses

Constant Summary

Constants included from Cocoa

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Cocoa

Constructor Details

#initialize(allocated = false) ⇒ NSObject

Instance Attribute Details

#klass ⇒ Object

#object ⇒ Object

Class Method Details

.alloc ⇒ Object

.attach_method(method, *_params) ⇒ Object

.attach_singular_method(method, *__params) ⇒ Object

.const_missing(name) ⇒ Object

.get_class ⇒ Object

.inherited(parent) ⇒ Object

.method_added(name) ⇒ Object

.method_defs(method) ⇒ Object

.native_name ⇒ Object

Instance Method Details

#autorelease ⇒ Object

#init ⇒ Object

#new ⇒ Object

#initialize(allocated = false) ⇒ `NSObject`

#klass ⇒ `Object`

#object ⇒ `Object`

.alloc ⇒ `Object`

.attach_method(method, *_params) ⇒ `Object`

.attach_singular_method(method, *__params) ⇒ `Object`

.const_missing(name) ⇒ `Object`

.get_class ⇒ `Object`

.inherited(parent) ⇒ `Object`

.method_added(name) ⇒ `Object`

.method_defs(method) ⇒ `Object`

.native_name ⇒ `Object`

#autorelease ⇒ `Object`

#init ⇒ `Object`

#new ⇒ `Object`