Ferreteria/v0.6/clade/Sys/FileSys/Aspect/Ident/stringer/Chain/@removed

Removed Code

Additional Clades

The following have also been removed:

• Nested never had any content (just iface/class), but apparently I did a page for it anyway.
• Nested/Named
• Nested/Named/Blank
• Nested/Named/Cap
• Nested/Named/FileList
• Root

2025-12-15

Entire previous version, replaced 2025-11-06 (though apparently I did some tidying after that, not noticing that it was retired):

/* BaseClass */ use Woozalia\Ferret\Data\Mem\QVar\cStr as BaseClass;
/* BaseIface */ use Woozalia\Ferret\Data\Mem\QVar\iStr as BaseIface;
/* CapClass */ use Woozalia\Ferret\Sys\FileSys\Aspect\Ident\stringer\Chain\Nested\Named\cCap as CapClass;
/* CapIface */ use Woozalia\Ferret\Sys\FileSys\Aspect\Ident\stringer\Chain\Nested\Named\iCap as CapIface;
/* FileClass */ use Woozalia\Ferret\Sys\FileSys\Node\cFi as FileClass;
/* FileIface */ use Woozalia\Ferret\Sys\FileSys\Node\iFi as FileIface;
/* FldrClass */ use Woozalia\Ferret\Sys\FileSys\Node\cFo as FldrClass;
/* FldrIface */ use Woozalia\Ferret\Sys\FileSys\Node\iFo as FldrIface;
/* NodeClass */ use Woozalia\Ferret\Sys\FileSys\cNode as NodeClass;
/* NodeIface */ use Woozalia\Ferret\Sys\FileSys\iNode as NodeIface;
/* QObjClass */ use Woozalia\Ferret\Data\Mem\QVar\cObj as QObjClass;
/* QObjIface */ use Woozalia\Ferret\Data\Mem\QVar\iObj as QObjIface;
/* SelfIface */ use Woozalia\Ferret\Sys\FileSys\Aspect\Ident\stringer\iChain as SelfIface;

interface iChain extends BaseIface {
    function AddSegment(string $fn) : CapIface;
    function ParsePath(string $fpr) : CapIface;
    function QOBase() : QObjIface;
}
abstract class caChain extends BaseClass implements SelfIface {

    // ++ ACTION ++ //

    public function AddSegment(string $fn) : CapIface { return new CapClass($fn,$this); }
    // ACTION: Parse the given relative path and return a new PathPiece for the last segment
    public function ParsePath(string $fpr) : CapIface {
        $fpClean = trim($fpr,'/');  // make sure there are no extra slashes
        $arPath = explode('/',$fpClean);
        $oSeg = $this;
        foreach ($arPath as $fnSeg) {
            $oSeg = $oSeg->AddSegment($fnSeg);
        }
        return $oSeg;
    }

    // -- ACTION -- //
    // ++ FIGURING ++ //

    /* 2025-11-04 Removing these (for now) because of ambiguity with QSPath().
    // RETURNS entire filespec, including base
    public function GetSpec() : string { return $this->PathStatus()->GetAbsPath(); }
    /*----
      RETURNS relative filespec from base
      PUBLIC because sometimes we need that information
    * /
    public function GetPath() : string { return $this->PathStatus()->GetRelPath(); }
    */
    /**
      * INPUT:
      *  $fsa = absolute filespec within this repository's folder
      * NOTE: This functionality is basically tFolder::WhatRemains().
      *  Possibly that should be used instead of re-implementing here.
      * HISTORY:
      *   2023-12-05 moved from .\Kiosk\cRepository to .\Data\Stored\File\Path\caPiece
      */
    public function FigureRelative(string $fsFull) : string {
        // might as well do a sanity-check, even though it should already have been done
        $fpThis = $this->PathStatus()->GetAbsPath();
        // if $fsFull starts with the repo's base path...
        if (str_starts_with($fsFull,$fpThis)) {
            // get the part of $fsFull *after* that base path
            $nlThis = strlen($fpThis);
            $fpRemain = substr($fsFull,$nlThis);
        } else {
            // I think this still shouldn't happen...
            echo "NO MATCH: FULL=[$fsFull], THIS=[$fpThis]<br>";
            throw new \exception('Internal error: bad value in constructor');
        }
        return $fpRemain;
    }

    // -- FIGURING -- //
    // ++ OBJECTS ++ //

    private $qoBase = NULL;
    public function QOBase() : QObjIface { return $this->qoBase ?? ($this->qoBase = QObjClass::AsNew()); }

    // ++ OBJECTS: FILESYS ++ //

    /**
     * NOTE:
     *  2023-10-03 These used to return different classes (cFile and cFolder),
     *    but apparently the functionality we need is now in a class which
     *    doesn't differentiate like that. (Maybe that's work to be done yet?)
     */
    public function GetFileNode() : FileIface {
        $fs = $this->GetSpec();
        return new FileClass($fs);
    }
    public function GetFolderNode() : FolderIface {
        $fs = $this->GetSpec();
        return new FolderClass($fs);
    }

    public function Info() : NodeIface { return new SelfNodeClass($this->GetSpec()); }

    // -- OBJECTS -- //

}