Class CecalPacker

Discovers asset files under a project root and packs them into a single .cecal archive with a sidecar manifest for incremental rebuilds.

Inheritance

object

CecalPacker

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: PopcorningGuineaPig.Engine.Assets.Cecal

Assembly: PopcorningGuineaPig.Engine.dll

Syntax

public sealed class CecalPacker

Remarks

CecalPacker is a pure transformation: given a project root and an output path, it walks the tree, hashes each packable asset, and produces a deterministic archive. It has no dependency on build orchestration, so any downstream build step can invoke it as a one-liner.

Constructors

CecalPacker(ILogger<CecalPacker>?)

Declaration

public CecalPacker(ILogger<CecalPacker>? logger = null)

Parameters

Type	Name	Description
ILogger<CecalPacker>	logger

Methods

Pack(string, string)

Scans projectRoot for packable assets and produces outputCecalPath along with its sidecar manifest. If an existing manifest proves the archive is up-to-date, no write happens.

Declaration

public PackResult Pack(string projectRoot, string outputCecalPath)

Parameters

Type	Name	Description
string	projectRoot
string	outputCecalPath

Returns

Type	Description
PackResult

RemoveRawAssetsFromBuildOutput(string, IEnumerable<string>)

Deletes every file under buildOutputDir whose relative path matches one of packedLogicalPaths. Files outside the packed set are never touched. Empty asset directories left behind are removed bottom-up; non-empty parents are preserved.

Declaration

public void RemoveRawAssetsFromBuildOutput(string buildOutputDir, IEnumerable<string> packedLogicalPaths)

Parameters

Type	Name	Description
string	buildOutputDir
IEnumerable<string>	packedLogicalPaths