#include <OOAIStateMachineVerifierStage.h>

Inheritance diagram for OOAIStateMachineVerifierStage:

Collaboration diagram for OOAIStateMachineVerifierStage:

Instance Methods
(void)	- stateMachineNamed:usedByShip:

(void)	- dealloc `[implementation]`

(NSString *)	- name `[implementation]`

(BOOL)	- shouldRun `[implementation]`

(void)	- run `[implementation]`

(void)	- validateAI: `[implementation]`

Instance Methods inherited from OOFileHandlingVerifierStage
(NSSet *)	- dependencies `[implementation]`

(NSSet *)	- dependents `[implementation]`

Instance Methods inherited from OOOXPVerifierStage
(OOOXPVerifier *)	- verifier

(BOOL)	- completed

(id)	- init `[implementation]`

(id)	- description `[implementation]`

(void)	- setVerifier: `[implementation]`

(BOOL)	- isDependentOf: `[implementation]`

(void)	- registerDependency: `[implementation]`

(void)	- dependencyRegistrationComplete `[implementation]`

(BOOL)	- canRun `[implementation]`

(void)	- performRun `[implementation]`

(void)	- noteSkipped `[implementation]`

(NSSet *)	- resolvedDependencies `[implementation]`

(NSSet *)	- resolvedDependents `[implementation]`

(void)	- registerDepedent: `[implementation]`

(void)	- dependencyCompleted: `[implementation]`

Class Methods
(NSString *)	+ nameForReverseDependencyForVerifier:

Private Attributes
NSSet *	_whitelist

NSMutableSet *	_usedAIs

Detailed Description

Definition at line 32 of file OOAIStateMachineVerifierStage.h.

Method Documentation

◆ dealloc

- (void) dealloc

implementation

Reimplemented from OOOXPVerifierStage.

Definition at line 46 of file OOAIStateMachineVerifierStage.m.

{
    [_whitelist release];
    [_usedAIs release];
    
    [super dealloc];
}

References dealloc, and OOOXPVerifierStage::dealloc.

Referenced by dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ name

- (NSString *) name

implementation

Reimplemented from OOOXPVerifierStage.

Definition at line 55 of file OOAIStateMachineVerifierStage.m.

56{

57 return kStageName;

58}

kStageName

static NSString *const kStageName

Definition OOAIStateMachineVerifierStage.m:34

References kStageName, and name.

Referenced by name, and stateMachineNamed:usedByShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ nameForReverseDependencyForVerifier:

+ (NSString *) nameForReverseDependencyForVerifier: (OOOXPVerifier *) verifier

Definition at line 93 of file OOAIStateMachineVerifierStage.m.

93 :(OOOXPVerifier *)verifier

94{

95 return kStageName;

96}

-[OOOXPVerifierStage verifier]

OOOXPVerifier * verifier()

Definition OOOXPVerifierStage.m:76

References kStageName.

Referenced by OOCheckShipDataPListVerifierStage::dependents, and OOCheckShipDataPListVerifierStage::run.

Here is the caller graph for this function:

◆ run

- (void) run

implementation

Reimplemented from OOOXPVerifierStage.

Definition at line 67 of file OOAIStateMachineVerifierStage.m.

{
    NSArray                     *aiNames = nil;
    NSEnumerator                *aiEnum = nil;
    NSString                    *aiName = nil;
    NSMutableSet                *whitelist = nil;
    
    // Build whitelist. Note that we merge in aliases since the distinction doesn't matter when just validating.
    whitelist = [[NSMutableSet alloc] init];
    [whitelist addObjectsFromArray:[[ResourceManager whitelistDictionary] oo_arrayForKey:@"ai_methods"]];
    [whitelist addObjectsFromArray:[[ResourceManager whitelistDictionary] oo_arrayForKey:@"ai_and_action_methods"]];
    [whitelist addObjectsFromArray:[[[ResourceManager whitelistDictionary] oo_dictionaryForKey:@"ai_method_aliases"] allKeys]];
    _whitelist = [whitelist copy];
    [whitelist release];
    
    aiNames = [[_usedAIs allObjects] sortedArrayUsingSelector:@selector(caseInsensitiveCompare:)];
    for (aiEnum = [aiNames objectEnumerator]; (aiName = [aiEnum nextObject]); )
    {
        [self validateAI:aiName];
    }
    
    [_whitelist release];
    _whitelist = nil;
}

References _whitelist, nil, run, validateAI:, and ResourceManager::whitelistDictionary.

Referenced by run.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ shouldRun

- (BOOL) shouldRun

implementation

Reimplemented from OOOXPVerifierStage.

Definition at line 61 of file OOAIStateMachineVerifierStage.m.

62{

63 return [_usedAIs count] != 0;

64}

References shouldRun.

Referenced by shouldRun.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ stateMachineNamed:usedByShip:

- (void) stateMachineNamed:		(NSString *)	name
usedByShip:		(NSString *)	shipName

Definition at line 99 of file OOAIStateMachineVerifierStage.m.

                          :(NSString *)name usedByShip:(NSString *)shipName
{
    OOFileScannerVerifierStage  *fileScanner = nil;
    
    if (name == nil)  return;
    if ([_usedAIs containsObject:name])  return;
    if (_usedAIs == nil)  _usedAIs = [[NSMutableSet alloc] init];
    [_usedAIs addObject:name];
    
    fileScanner = [[self verifier] fileScannerStage];
    if (![fileScanner fileExists:name
                        inFolder:@"AIs"
                  referencedFrom:[NSString stringWithFormat:@"shipdata.plist entry \"%@\"", shipName]
                    checkBuiltIn:YES])
    {
        OOLog(@"verifyOXP.validateAI.notFound", @"----- WARNING: AI state machine \"%@\" referenced in shipdata.plist entry \"%@\" could not be found in %@ or in Oolite.", name, shipName, [[self verifier] oxpDisplayName]);
    }
}

References _usedAIs, OOOXPVerifier::fileScannerStage, name, nil, OOLog, and OOOXPVerifierStage::verifier.

Here is the call graph for this function:

◆ validateAI:

- (void) validateAI: (NSString *) aiName

implementation

Provided by category OOAIStateMachineVerifierStage(Private).

Definition at line 123 of file OOAIStateMachineVerifierStage.m.

                   :(NSString *)aiName
{
    NSString                *path = nil;
    NSDictionary            *aiStateMachine = nil;
    NSEnumerator            *stateEnum = nil;
    NSString                *stateKey = nil;
    NSDictionary            *stateHandlers = nil;
    NSEnumerator            *handlerEnum = nil;
    NSString                *handlerKey = nil;
    NSArray                 *handlerActions = nil;
    NSEnumerator            *actionEnum = nil;
    NSString                *action = nil;
    NSRange                 spaceRange;
    NSString                *selector = nil;
    NSMutableSet            *badSelectors = nil;
    NSString                *badSelectorDesc = nil;
    NSUInteger              index = 0;
    
    OOLog(@"verifyOXP.verbose.validateAI", @"- Validating AI \"%@\".", aiName);
    OOLogIndentIf(@"verifyOXP.verbose.validateAI");
    
    // Attempt to load AI.
    path = [[[self verifier] fileScannerStage] pathForFile:aiName inFolder:@"AIs" referencedFrom:@"AI list" checkBuiltIn:NO];
    if (path == nil)  return;
    
    badSelectors = [NSMutableSet set];
    
    aiStateMachine = OODictionaryFromFile(path);
    if (aiStateMachine == nil)
    {
        OOLog(@"verifyOXP.validateAI.failed.notDictPlist", @"***** ERROR: could not interpret \"%@\" as a dictionary.", path);
        return;
    }
    
    // Validate each state.
    for (stateEnum = [aiStateMachine keyEnumerator]; (stateKey = [stateEnum nextObject]); )
    {
        stateHandlers = [aiStateMachine objectForKey:stateKey];
        if (![stateHandlers isKindOfClass:[NSDictionary class]])
        {
            OOLog(@"verifyOXP.validateAI.failed.invalidFormat.state", @"***** ERROR: state \"%@\" in AI \"%@\" is not a dictionary.", stateKey, aiName);
            continue;
        }
        
        // Verify handlers for this state.
        for (handlerEnum = [stateHandlers keyEnumerator]; (handlerKey = [handlerEnum nextObject]); )
        {
            handlerActions = [stateHandlers objectForKey:handlerKey];
            if (![handlerActions isKindOfClass:[NSArray class]])
            {
                OOLog(@"verifyOXP.validateAI.failed.invalidFormat.handler", @"***** ERROR: handler \"%@\" for state \"%@\" in AI \"%@\" is not an array, ignoring.", handlerKey, stateKey, aiName);
                continue;
            }
            
            // Verify commands for this handler.
            index = 0;
            for (actionEnum = [handlerActions objectEnumerator]; (action = [actionEnum nextObject]); )
            {
                index++;
                if (![action isKindOfClass:[NSString class]])
                {
                    OOLog(@"verifyOXP.validateAI.failed.invalidFormat.action", @"***** ERROR: action %lu in handler \"%@\" for state \"%@\" in AI \"%@\" is not a string, ignoring.", index - 1, handlerKey, stateKey, aiName);
                    continue;
                }
                
                // Trim spaces from beginning and end.
                action = [action stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceCharacterSet]];
                
                // Cut off parameters.
                spaceRange = [action rangeOfString:@" "];
                if (spaceRange.location == NSNotFound)  selector = action;
                else  selector = [action substringToIndex:spaceRange.location];
                
                // Check against whitelist.
                if (![_whitelist containsObject:selector])
                {
                    [badSelectors addObject:selector];
                }
            }
        }
    }
    
    if ([badSelectors count] != 0)
    {
        badSelectorDesc = [[[badSelectors allObjects] sortedArrayUsingSelector:@selector(caseInsensitiveCompare:)] componentsJoinedByString:@", "];
        OOLog(@"verifyOXP.validateAI.failed.badSelector", @"***** ERROR: the AI \"%@\" uses %lu unpermitted method%s: %@", aiName, [badSelectors count], ([badSelectors count] == 1) ? "" : "s", badSelectorDesc);
    }
    
    OOLogOutdentIf(@"verifyOXP.verbose.validateAI");
}

Referenced by run.

Here is the caller graph for this function:

Member Data Documentation

◆ _usedAIs

- (NSMutableSet*) _usedAIs

private

Definition at line 36 of file OOAIStateMachineVerifierStage.h.

Referenced by stateMachineNamed:usedByShip:.

◆ _whitelist

- (NSSet*) _whitelist

private

Definition at line 35 of file OOAIStateMachineVerifierStage.h.

Referenced by run.

The documentation for this class was generated from the following files:

src/Core/OXPVerifier/OOAIStateMachineVerifierStage.h
src/Core/OXPVerifier/OOAIStateMachineVerifierStage.m

Instance Methods

Class Methods

Private Attributes

Detailed Description

Method Documentation

◆ dealloc

◆ name

◆ nameForReverseDependencyForVerifier:

◆ run

◆ shouldRun

◆ stateMachineNamed:usedByShip:

◆ validateAI:

Member Data Documentation

◆ _usedAIs

◆ _whitelist