Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A Cocoa library to extend the Objective-C programming language.
Objective-C C Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
Configuration @ a4b09a9
Tests
extobjc.xcodeproj
extobjc
libffi @ 8ed37a4
.gitignore
.gitmodules
README.md

README.md

The Extended Objective-C library extends the dynamism of the Objective-C programming language to support additional patterns present in other dynamic programming languages (including those that are not necessarily object-oriented).

libextobjc is meant to be very modular – most of its classes and modules can be used with no more than one or two dependencies.

Please feel free to open issues for feature requests or ideas for language extensions (even if you have no idea how they'd work)!

Features

libextobjc currently includes the following features:

  • Safe categories, using EXTSafeCategory, for adding methods to a class without overwriting anything already there (identifying conflicts for you).
  • Concrete protocols, using EXTConcreteProtocol, for providing default implementations of the methods in a protocol.
  • Simpler and safer key paths, using EXTKeyPathCoding, which automatically checks key paths at compile-time.
  • Compile-time checking of selectors to ensure that an object declares a given selector, using EXTSelectorChecking.
  • Easier use of weak variables in blocks, using @weakify and @strongify in the EXTScope module.
  • Safer private methods, using EXTPrivateMethod, for declaring methods on a class, and getting notified if they conflict with other existing methods.
  • Scope-based resource cleanup, using @onExit in the EXTScope module, for automatically cleaning up manually-allocated memory, file handles, locks, etc., at the end of a scope.
  • EXTNil, which is like NSNull, but behaves much more closely to actual nil (i.e., doesn't crash when sent unrecognized messages).
  • Algebraic data types generated completely at compile-time, defined using EXTADT.
  • EXTBlockTarget, which extends the target-action mechanism with support for blocks.
  • EXTTuple, for multiple return values and assignment.
  • EXTPassthrough, to automatically implement methods that simply invoke the same method on another object.
  • Better variadic arguments, with support for packaging the arguments up as an array, using EXTVarargs.
  • Aspect-oriented programming, using EXTAspect.
  • Block-based coroutines, using EXTCoroutine.
  • Multimethods – methods which overload based on argument type – using EXTMultimethod.
  • Key-value annotations on properties, using EXTAnnotation.
  • Final methods – methods which cannot be overridden – using EXTFinalMethod.
  • EXTDispatchObject, which forwards messages to all objects in a given array.
  • EXTMaybe, which behaves like NSError and nil, making it safe for use as an erroneous return value.
  • EXTMultiObject, which behaves like all of the objects in a given array (forwarding to the first one that responds to each message).
  • Primitive mixins, using EXTMixin.
  • Protocol categories, using EXTProtocolCategory, for adding methods to every class that implements a given protocol.
  • Convenience functions to install blocks as methods, using EXTBlockMethod.
  • Lots of extensions and additional functionality built on top of <objc/runtime.h>, including extremely customizable method injection, reflection upon object properties, and various functions to extend class hierarchy checks and method lookups.

Some of these are just proofs of concept, and not necessarily recommended for production code. Others (mainly those bolded in the list above) are quite valuable, and make Objective-C safer and/or more flexible. Check out the headers for more information.

License

This library is public domain, and can be incorporated for free and without attribution for any use. Submodules and dependencies may have different licenses.

Requirements

libffi is used for EXTAspect, but is not required for the other modules of the project. In order for the unit tests to build and pass, libffi must be retrieved using git submodule update --init after cloning the repository.

The latest features in libextobjc must be compiled with Xcode 4.5. If you do not have the beta, there is an Xcode 4.3 tag instead; however, it is missing some of the newer features in the library.

Something went wrong with that request. Please try again.