Futilities/human/lib/cFolderator

Human Futilities: cFolderator class

Flow

The flow typically starts with StartSpider(), which retrieves the source-path from Options (GetSourcePath()) and then passes control to OnWantedFolder. (We assume that the folder in the source-path is wanted, even if it fails inclusion criteria that are applied to its sub-folders.)

At its core, OnWantedFolder(caPathPiece $op) gets a directory listing for $op$, puts that list in an array, and then for each entry in the array sets that entry as the last entry in $opCurr and passes it to OnPath($opCurr).

OnPath(caPathPiece $op) checks the filespec in $op to see whether it's a file or a folder (it is assumed to exist). In simplified form:

if ($op->IsFolder()) { $this->OnFolder($op); }
} else { $this->OnFile($op); }

Functions

actions

• StartSpider(caMatch $om)
  • formerly DoSearch() (kept for now as an alias)

events

• OnPath(caPathPiece $op)
• OnFolder(caPathNamed $op)
• OnWantedFolder(caPathPiece $op)
• OnFile(caPathNamed $op)

state

• protected function ResetCount() { $this->nFi = 0; $this->nFo = 0; }
• protected function IncFiles() { $this->nFi++; }
• protected function IncFolders() { $this->nFo++; }
• protected function SummarizeCount() : string { ... }: returns a string summarizing file & folder counts
• protected function ShortCount() : string { ... }: like SummarizeCount(), but shorter string ("fo:#/fi:#")

object

This pair sets and returns a Matcher object:

• protected function SetMatcher(caMatch $om) { $this->om = $om; }
  • This is only called from DoSearch().
• protected function GetMatcher() : caMatch { return $this->om; }