Sourcecode
extends WriterAbstract
in package
uses
IoTrait
Sourcecode transformation writer; generates syntax highlighted source files in a destination's subfolder.
Table of Contents
Properties
Methods
- __construct() : mixed
- __toString() : string
- checkRequirements() : void
- This method verifies whether PHP has all requirements needed to run this writer.
- getName() : string
- Name of this writer, used to identify this writer.
- transform() : void
- This method writes every source code entry in the structure file to a highlighted file.
- copy() : void
- persistTo() : void
- readSourceFile() : string
- copyDirectory() : void
- isGlobalTemplateReference() : bool
- normalizeDestination() : string
- normalizeSourcePath() : string
- stripFirstPartOfPath() : string
Properties
$pathGenerator read-only
private
PathGenerator
$pathGenerator
Methods
__construct()
public
__construct(PathGenerator $pathGenerator) : mixed
Parameters
- $pathGenerator : PathGenerator
__toString()
public
__toString() : string
Return values
stringcheckRequirements()
This method verifies whether PHP has all requirements needed to run this writer.
public
checkRequirements() : void
If one of the requirements is missing for this Writer then an exception of type RequirementMissing should be thrown; this indicates to the calling process that this writer will not function.
Tags
getName()
Name of this writer, used to identify this writer.
public
getName() : string
This name is also used in Collection as key and should match the name provided in the template definitions' transformations.
Return values
stringtransform()
This method writes every source code entry in the structure file to a highlighted file.
public
transform(Transformation $transformation, ProjectDescriptor $project, DocumentationSetDescriptor $documentationSet) : void
Parameters
- $transformation : Transformation
-
Transformation to execute.
- $project : ProjectDescriptor
-
Document containing the structure.
- $documentationSet : DocumentationSetDescriptor
copy()
protected
copy(Transformation $transformation, string $path, string $destination) : void
Parameters
- $transformation : Transformation
- $path : string
- $destination : string
persistTo()
protected
persistTo(Transformation $transformation, string $path, string $contents) : void
Parameters
- $transformation : Transformation
- $path : string
- $contents : string
readSourceFile()
protected
readSourceFile(Transformation $transformation, string $path) : string
Parameters
- $transformation : Transformation
- $path : string
Return values
stringcopyDirectory()
private
copyDirectory(Transformation $transformation, string $path, string $destination) : void
Parameters
- $transformation : Transformation
- $path : string
- $destination : string
isGlobalTemplateReference()
private
isGlobalTemplateReference(string $path) : bool
Parameters
- $path : string
Return values
boolnormalizeDestination()
private
normalizeDestination(string $destination) : string
Parameters
- $destination : string
Return values
stringnormalizeSourcePath()
private
normalizeSourcePath(string $path) : string
Parameters
- $path : string
Return values
stringstripFirstPartOfPath()
private
stripFirstPartOfPath(string $path) : string
Parameters
- $path : string