HackClassScanner

, _(*1)

A class that recursively scans a directory for hack classes., _(*2)

Installation

Add the following line to your composer.json file in the require section., _(*3)

“kilahm/hack-class-scanner”: “dev-master”

Then run composer update., _(*4)

Use

To use the class, simply instantiate it with a set of base directories to scan and a set of directories to ignore., _(*5)

use kilahm\Scanner\ClassScanner;

$scanner = new ClassScanner(
  Set{‘directory/to/scan’, ‘other/directory’},
  Set{‘other/directory/to/ignore’}
);
$classMap = $scanner->mapClassToFile();
$classAndInterfaceMap = $scanner->mapClassOrInterfaceToFile();

The $classMap variable will then hold a Map<string,string> object that maps class names (with full namespace) to the files in which the class is defined. The $classAndInterfaceMap will be the same as $classMap except it will include interfaces as well as classes., _(*6)

Filters

You can filter the result files based on the name of the class or the name of the file. A filter must be a closure with a signature of function(string) : bool. The input for a class filter is the name of the class including the namespace. The input for a file filter is the name of the file including the full path (via realpath). If all registered filter functions return true for a particular file or class name, the file will be scanned for a class and the class name will appear in the output, respectively., _(*7)

$includes = Set{...};
$excludes = Set{...};
$scanner = new ClassScanner($includes, $excludes);
$classFilter = $className ==> preg_match(‘/pattern/’, $className);
$fileFilter = $fileName ==> preg_match(‘/pattern/’, $fileName);
$scanner->addClassNameFilter($classFilter);
$scanner->addFileNameFilter($fileFilter);
$classMap = $scanner->mapClassToFile();

Assumptions

This class assumes you are following the practice of one class per file. The scanner will stop searching once it has found the first class name in a file., _(*8)