Latest 0.2.0
Homepage https://github.com/yext/YXTUnsatisfiableConstraintsDetector
License MIT
Platforms ios 7.0, requires ARC
Authors

CI Status

A debugging tool that catches unsatisfiable constraint errors as they appear at the console and provides call backs either directly to blocks or via NSNotificationCenter. This allows such errors to be handled at runtime.

This tool is intended for debugging only, and has not been designed for production-level performance.

Use cases

  • Highlighting constraint issues during development visually
  • Catching constraint problems during unit testing
  • Failing UI tests by killing the application on receipt of a constraint error.

Example Project

To run the example project, clone the repo, and run pod install from the Example directory first.

The example project shows a use of the detector to highlight UIViews with unsatisfiable constraints, displaying a red border on problem views.

Requirements

YXTUnsatisfiableConstraintsDetector supports projects for iOS 7 and above.

Installation

Manual Install

To install manually, copy the files under Pod/Classes into your project.

CocoaPods

YXTUnsatisfiableConstraintsDetector is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod "YXTUnsatisfiableConstraintsDetector"

Usage

To import the detector into a given source file:

#import "YXTUnsatisfiableConstraintsDetector.h"

You can then instantiate an instance of YXTUnsatisfiableConstraintsDetector and add callback blocks using the registerBlock: method. When all your blocks are configured, call beginMonitoring to start listening for errors.

It is recommended to create a single instance of YXTUnsatisfiableConstraintsDetector in your AppDelegate’s launch method, and to enclose this in a DEBUG check to ensure it is not called in release builds. For example, to register a callback that marks views with errors in red:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
#ifdef DEBUG
    YXTUnsatisfiableConstraintsDetector *detector = [[YXTUnsatisfiableConstraintsDetector alloc] init];
    [detector registerBlock:^(UIView *view){
        if(view != nil){
            dispatch_async(dispatch_get_main_queue(), ^(void){
                view.layer.borderColor = [UIColor redColor].CGColor;
                view.layer.borderWidth = 3.0;
            });
        }
    }];
    [detector beginMonitoring];
#endif
    return YES;
}

Note that view may be null if the problem UIView is not currently in the view hierarchy.

Author

Tom Elliott, [email protected]

License

YXTUnsatisfiableConstraintsDetector is available under the MIT license. See the LICENSE file for more info.

Latest podspec

{
    "name": "YXTUnsatisfiableConstraintsDetector",
    "version": "0.2.0",
    "summary": "A utility for detecting unsatisfiable constraint errors and calling back to allow automated runtime handling.",
    "description": "YXTUnsatisfiableConstraintsDetector is a debugging tool that catches unsatisfiable constraint errors as they appear at the console and provides call backs either directly to blocks or via NSNotificationCenter. This allows such errors to be handled at runtime.nnThis tool is intended for debugging only, and has not been designed for production-level performance.",
    "homepage": "https://github.com/yext/YXTUnsatisfiableConstraintsDetector",
    "license": "MIT",
    "authors": {
        "Tom Elliott": "[email protected]"
    },
    "source": {
        "git": "https://github.com/yext/YXTUnsatisfiableConstraintsDetector.git",
        "tag": "0.2.0"
    },
    "platforms": {
        "ios": "7.0"
    },
    "requires_arc": true,
    "source_files": "Pod/Classes/**/*",
    "resource_bundles": {
        "YXTUnsatisfiableConstraintsDetector": [
            "Pod/Assets/*.png"
        ]
    }
}

Pin It on Pinterest

Share This