Class Finder

Extension/src/Utility/Filesystem/find.ts:162–223

 *
 */
export class Finder implements AsyncIterable<string> {
    #excludedFolders = new Set<string | RegExp>(['winsxs', 'syswow64', 'system32']);
    #files = accumulator<string>().autoComplete(false);
    files = this.#files.reiterable();

    private match: (file: File) => Promise<boolean> | boolean;
    private promises = new Array<Promise<void>>();

    constructor(executableName: string);
    constructor(executableRegEx: RegExp);
    constructor(fileMatcher: (file: File) => Promise<boolean> | boolean);
    constructor(binary: string | RegExp | ((file: File) => Promise<boolean> | boolean)) {
        switch (typeof binary) {
            case 'string':
                this.match = (file: File) => file.isExecutable && file.basename === binary;
                break;
            case 'function':
                this.match = binary;
                break;
            case 'object':
                this.match = (file: File) => file.isExecutable && !!file.basename.match(binary);
                break;
        }
    }

    static resetCache() {
        cache.clear();
    }

    exclude(folder: string) {
        this.#excludedFolders.add(folder);
    }

    /**
     * Add one or more locations to scan, with an optionally specified depth.
     *
     * The scanning of those locations begins immediately and is done asynchronously.
     *
     */
    scan(...location: (Promise<string> | string)[]): Finder;
    scan(depth: number, ...location: (Promise<string> | string)[]): Finder;
    scan(...location: (Promise<string> | string | number)[]): Finder {
        const depth = typeof location[0] === 'number' ? location.shift() as number : 0;
        this.promises.push(...location.map(each => scanFolder(each.toString(), depth, this.match, (f) => !this.#excludedFolders.has(f.name), this.#files)));
        return this;
    }

    [Symbol.asyncIterator](): AsyncIterator<string> {
        this.#files.complete();
        return this.#files[Symbol.asyncIterator]();
    }

    get results(): Promise<Set<string>> {
        return Promise.all(this.promises).then(async () => {
            const result = new Set<string>();
            for await (const file of this) {
                result.add(file);
            }