- Added GTMSignalHandler for simple signal handling (via kqueue/runloop).

- Fixed up GTMIPhoneUnitTestDelegate to be pickier about which tests it runs
- Added GTMNSString+URLArguments to GTMiPhone
- Added GTMHTTPFetcher and GTMHTTPServer to GTMiPhone
- Made sure that build would work with iPhone device attached, and that all 
  tests run directly on the phone.
- Added GTMValidatingContainers which are a set of mutable container classes 
  that allow you to have a selector on a target that is called to verify that 
  the objects being put into the container are valid. This can be controlled 
  at compile time so that you don't take the performance hit in a release build.
- Added GTMPath, which represents an existing absolute path on the file system.
  It also makes it very easy to contruct new paths in the file system as well
  as whole directory hierarchies.
- Added GTMNSString+Replace for a common replacement need.
- Added NSString+FindFolder for two commen helpers for building paths to common
  locations.
- Added GTMLargeTypeWindow for doing display windows similar to Address Book
  Large Type display for phone numbers.

1 files changed, 75 insertions, 0 deletions

diff --git a/Foundation/GTMSignalHandler.h b/Foundation/GTMSignalHandler.h
new file mode 100644
index 0000000..da3a3ea
--- /dev/null
+++ b/Foundation/GTMSignalHandler.h
@@ -0,0 +1,75 @@
+//
+//  GTMSignalHandler.h
+//
+//  Copyright 2008 Google Inc.
+//
+//  Licensed under the Apache License, Version 2.0 (the "License"); you may not
+//  use this file except in compliance with the License.  You may obtain a copy
+//  of the License at
+// 
+//  http://www.apache.org/licenses/LICENSE-2.0
+// 
+//  Unless required by applicable law or agreed to in writing, software
+//  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+//  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+//  License for the specific language governing permissions and limitations under
+//  the License.
+//
+
+#import <Foundation/Foundation.h>
+
+// GTMSignalHandler.
+//
+// This is a very simple, easy-to-use class for registering handlers that get
+// called when a specific signal is delivered.  Also handy for ignoring
+// inconvenient signals.  Ignoring SIGKILL is not support for what should be
+// obvious reasons.
+//
+// Example of how to catch SIGABRT and SIGTERM while ignring SIGWINCH:
+//   GTMSignalHandler *abrt, *term, *winch;
+//   abrt = [[GTMSignalHandler alloc]
+//               initWithSignal:SIGABRT
+//                       target:self
+//                      handler:@selector(handleAbort:)];
+//
+//   term = [[GTMSignalHandler alloc]
+//               initWithSignal:SIGTERM
+//                       target:self
+//                      handler:@selector(handleTerm:)];
+//
+//   winch = [[GTMSignalHandler alloc] initWithSignal:SIGWINCH
+//                initWithSignal:SIGWINCH
+//                        target:nil
+//                       handler:NULL
+//
+// And then the signal handler has the triggered signal number boxed in an
+// NSNumber:
+//  -(void)handleTerm:(NSNumber *)signo {
+//    .. do stuff ..
+//  }
+//
+// Release the handler when you're no longer interested in handling that signal.
+// Note that signal(SIG_IGN, signo) is performed on each signal handled by
+// objects of this class, and those do not get un-done.
+//
+// Multiple handlers for the same signal is NOT supported.
+//
+// kqueue() is used to handle the signals, and the default runloop for the first
+// signal handler is used for signal delivery, so keep that in mind when you're
+// using this class.  This class explicitly does not handle arbitrary runloops
+// and threading.
+//
+@interface GTMSignalHandler : NSObject {
+ @private
+  int signo_;
+  __weak id target_;
+  SEL handler_;
+}
+
+// Returns a retained signal handler object that will invoke |handler| on the
+// |target| whenever a signal of number |signo| is delivered to the process.
+-(id)initWithSignal:(int)signo
+             target:(id)target
+            handler:(SEL)handler;
+
+@end  // GTMSignalHandler