3 * Copyright (c) 2007 - 2011, Blue Static <http://www.bluestatic.org>
5 * This program is free software; you can redistribute it and/or modify it under the terms of the GNU
6 * General Public License as published by the Free Software Foundation; either version 2 of the
7 * License, or (at your option) any later version.
9 * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
10 * even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * General Public License for more details.
13 * You should have received a copy of the GNU General Public License along with this program; if not,
14 * write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
17 #import <Cocoa/Cocoa.h>
19 extern NSString
* const kBreakpointTypeFile
;
20 extern NSString
* const kBreakpointTypeFunctionEntry
;
22 // This represents a breakpoint at a certain file and line number. It also
23 // maintains the identifier that the backend assigns to the breakpoint.
24 @interface Breakpoint
: NSObject
26 // The type of breakpoint, one of the kBreakpointType constants above.
27 @
property (weak
, readonly
) NSString
* type
;
29 // The unique identifier assigned by the debugger engine, only valid while
31 @
property (readwrite
, assign
) unsigned long debuggerId
;
33 @
property(weak
, nonatomic
, readonly
) NSString
* displayValue
;
35 // kBreakpointTypeFile:
36 @
property (readonly
) NSString
* file
;
37 @
property (readonly
) unsigned long line
;
38 @
property (copy
) NSData
* secureBookmark
;
40 // kBreakpointTypeFunctionEntry:
41 @
property (readonly
) NSString
* functionName
;
43 + (instancetype
)breakpointAtLine
:(unsigned long)line inFile
:(NSString
*)file
;
44 + (instancetype
)breakpointOnFunctionNamed
:(NSString
*)name
;
46 // Initializer from NSUserDefaults.
47 - (instancetype
)initWithDictionary
:(NSDictionary
*)dict
;
49 - (NSString
*)transformedPath
;
51 // Creates a dictionary representation for use in NSUserDefaults.
52 - (NSDictionary
*)dictionary
;
54 // For kBreakpointTypeFile: ////////////////////////////////////////////////////
56 // Creates a new secure bookmark for maintaining access to the file in the App
57 // Sandbox across relaunches.
58 - (BOOL
)createSecureBookmark
;
60 // Call to enable read-only access to the file.
61 - (BOOL
)startSecureFileAccess
;
63 // Call when done accessing the file.
64 - (BOOL
)stopSecureFileAccess
;