1// [The "BSD licence"] 2// Copyright (c) 2006-2007 Kay Roepke 3// All rights reserved. 4// 5// Redistribution and use in source and binary forms, with or without 6// modification, are permitted provided that the following conditions 7// are met: 8// 1. Redistributions of source code must retain the above copyright 9// notice, this list of conditions and the following disclaimer. 10// 2. Redistributions in binary form must reproduce the above copyright 11// notice, this list of conditions and the following disclaimer in the 12// documentation and/or other materials provided with the distribution. 13// 3. The name of the author may not be used to endorse or promote products 14// derived from this software without specific prior written permission. 15// 16// THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17// IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18// OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19// IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21// NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25// THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 27#import <Cocoa/Cocoa.h> 28#import "ANTLRParser.h" 29#import "ANTLRDebugEventListener.h" 30#import <sys/socket.h> 31#import <netinet/in.h> 32#import <netinet/tcp.h> 33#include <arpa/inet.h> 34 35// default port for ANTLRWorks 36#define DEFAULT_DEBUGGER_PORT 0xC001 37 38@interface ANTLRDebugEventProxy : NSObject <ANTLRDebugEventListener> { 39 int serverSocket; 40 41 struct sockaddr debugger_sockaddr; 42 socklen_t debugger_socklen; 43 int debuggerSocket; 44 NSFileHandle *debuggerFH; 45 46 NSString *grammarName; 47 int debuggerPort; 48} 49 50- (id) init; 51- (id) initWithGrammarName:(NSString *)aGrammarName debuggerPort:(NSInteger)aPort; 52- (void) waitForDebuggerConnection; 53- (void) waitForAck; 54- (void) sendToDebugger:(NSString *)message; 55- (void) sendToDebugger:(NSString *)message waitForResponse:(BOOL)wait; 56 57- (NSInteger) serverSocket; 58- (void) setServerSocket: (NSInteger) aServerSocket; 59 60- (NSInteger) debuggerSocket; 61- (void) setDebuggerSocket: (NSInteger) aDebuggerSocket; 62 63- (NSString *) grammarName; 64- (void) setGrammarName: (NSString *) aGrammarName; 65 66- (NSInteger) debuggerPort; 67- (void) setDebuggerPort: (NSInteger) aDebuggerPort; 68 69- (NSString *) escapeNewlines:(NSString *)aString; 70 71#pragma mark - 72 73#pragma mark DebugEventListener Protocol 74- (void) enterRule:(NSString *)ruleName; 75- (void) enterAlt:(NSInteger)alt; 76- (void) exitRule:(NSString *)ruleName; 77- (void) enterSubRule:(NSInteger)decisionNumber; 78- (void) exitSubRule:(NSInteger)decisionNumber; 79- (void) enterDecision:(NSInteger)decisionNumber; 80- (void) exitDecision:(NSInteger)decisionNumber; 81- (void) consumeToken:(id<ANTLRToken>)t; 82- (void) consumeHiddenToken:(id<ANTLRToken>)t; 83- (void) LT:(NSInteger)i foundToken:(id<ANTLRToken>)t; 84- (void) mark:(NSInteger)marker; 85- (void) rewind:(NSInteger)marker; 86- (void) rewind; 87- (void) beginBacktrack:(NSInteger)level; 88- (void) endBacktrack:(NSInteger)level wasSuccessful:(BOOL)successful; 89- (void) locationLine:(NSInteger)line column:(NSInteger)pos; 90- (void) recognitionException:(ANTLRRecognitionException *)e; 91- (void) beginResync; 92- (void) endResync; 93- (void) semanticPredicate:(NSString *)predicate matched:(BOOL)result; 94- (void) commence; 95- (void) terminate; 96 97 98#pragma mark Tree Parsing 99- (void) consumeNode:(unsigned)nodeHash ofType:(NSInteger)type text:(NSString *)text; 100- (void) LT:(NSInteger)i foundNode:(unsigned)nodeHash ofType:(NSInteger)type text:(NSString *)text; 101 102 103#pragma mark AST Events 104 105- (void) createNilNode:(unsigned)hash; 106- (void) createNode:(unsigned)hash text:(NSString *)text type:(NSInteger)type; 107- (void) createNode:(unsigned)hash fromTokenAtIndex:(NSInteger)tokenIndex; 108- (void) makeNode:(unsigned)newRootHash parentOf:(unsigned)oldRootHash; 109- (void) addChild:(unsigned)childHash toTree:(unsigned)treeHash; 110- (void) setTokenBoundariesForTree:(unsigned)nodeHash From:(NSInteger)tokenStartIndex To:(NSInteger)tokenStopIndex; 111 112@end 113