The base name of the file, that is, the name of the file without any
leading directory path. The base name must not contain a slash /.
If not provided, the implementation must set this field based on the
location field by taking the final path component after parsing
location as an IRI. If basename is provided, it is not required to
match the value from location.
When this file is made available to a CommandLineTool, it must be named
with basename, i.e. the final component of the path field must match
basename.
Optional hash code for validating file integrity. Currently must be in the form "sha1$ + hexadecimal string" using the SHA-1 algorithm.
Must be File to indicate this object describes a file.
File contents literal.
If neither location nor path is provided, contents must be
non-null. The implementation must assign a unique identifier for the
location field. When the file is staged as input to CommandLineTool,
the value of contents must be written to a file.
If contents is set as a result of an Javascript expression,
an entry in InitialWorkDirRequirement, or read in from
cwl.output.json, there is no specified upper limit on the
size of contents. Implementations may have practical limits
on the size of contents based on memory and storage
available to the workflow runner or other factors.
If the loadContents field of an InputParameter or
OutputParameter is true, and the input or output File object
location is valid, the file must be a UTF-8 text file 64 KiB
or smaller, and the implementation must read the entire
contents of the file and place it in the contents field. If
the size of the file is greater than 64 KiB, the
implementation must raise a fatal error.
The name of the directory containing file, that is, the path leading up
to the final slash in the path such that dirname + '/' + basename == path.
The implementation must set this field based on the value of path
prior to evaluating parameter references or expressions in a
CommandLineTool document. This field must not be used in any other
context.
The format of the file: this must be an IRI of a concept node that represents the file format, preferrably defined within an ontology. If no ontology is available, file formats may be tested by exact match.
Reasoning about format compatability must be done by checking that an
input file format is the same, owl:equivalentClass or
rdfs:subClassOf the format required by the input parameter.
owl:equivalentClass is transitive with rdfs:subClassOf, e.g. if
<B> owl:equivalentClass <C> and <B> owl:subclassOf <A> then infer
<C> owl:subclassOf <A>.
File format ontologies may be provided in the "$schemas" metadata at the
root of the document. If no ontologies are specified in $schemas, the
runtime may perform exact file format matches.
An IRI that identifies the file resource. This may be a relative reference, in which case it must be resolved using the base IRI of the document. The location may refer to a local or remote resource; the implementation must use the IRI to retrieve file content. If an implementation is unable to retrieve the file content stored at a remote resource (due to unsupported protocol, access denied, or other issue) it must signal an error.
If the location field is not provided, the contents field must be
provided. The implementation must assign a unique identifier for
the location field.
If the path field is provided but the location field is not, an
implementation may assign the value of the path field to location,
then follow the rules above.
The basename extension such that nameroot + nameext == basename, and
nameext is empty or begins with a period and contains at most one
period. Leading periods on the basename are ignored; a basename of
.cshrc will have an empty nameext.
The implementation must set this field automatically based on the value
of basename prior to evaluating parameter references or expressions.
The basename root such that nameroot + nameext == basename, and
nameext is empty or begins with a period and contains at most one
period. For the purposess of path splitting leading periods on the
basename are ignored; a basename of .cshrc will have a nameroot of
.cshrc.
The implementation must set this field automatically based on the value
of basename prior to evaluating parameter references or expressions.
The local host path where the File is available when a CommandLineTool is
executed. This field must be set by the implementation. The final
path component must match the value of basename. This field
must not be used in any other context. The command line tool being
executed must be able to to access the file at path using the POSIX
open(2) syscall.
As a special case, if the path field is provided but the location
field is not, an implementation may assign the value of the path
field to location, and remove the path field.
If the path contains POSIX shell metacharacters
(|,&, ;, <, >, (,), $,`, \, ", ',
<space>, <tab>, and <newline>) or characters
not allowed
for Internationalized Domain Names for Applications
then implementations may terminate the process with a
permanentFailure.
A list of additional files or directories that are associated with the
primary file and must be transferred alongside the primary file.
Examples include indexes of the primary file, or external references
which must be included when loading primary document. A file object
listed in secondaryFiles may itself include secondaryFiles for
which the same rules apply.
Optional file size (in bytes)
Generated using TypeDoc
Auto-generated interface for https://w3id.org/cwl/cwl#File
Represents a file (or group of files when
secondaryFilesis provided) that will be accessible by tools using standard POSIX file system call API such as open(2) and read(2).Files are represented as objects with
classofFile. File objects have a number of properties that provide metadata about the file.The
locationproperty of a File is a URI that uniquely identifies the file. Implementations must support the file:// URI scheme and may support other schemes such as http://. The value oflocationmay also be a relative reference, in which case it must be resolved relative to the URI of the document it appears in. Alternately tolocation, implementations must also accept thepathproperty on File, which must be a filesystem path available on the same host as the CWL runner (for inputs) or the runtime environment of a command line tool execution (for command line tool outputs).If no
locationorpathis specified, a file object must specifycontentswith the UTF-8 text content of the file. This is a "file literal". File literals do not correspond to external resources, but are created on disk withcontentswith when needed for a executing a tool. Where appropriate, expressions can return file literals to define new files on a runtime. The maximum size ofcontentsis 64 kilobytes.The
basenameproperty defines the filename on disk where the file is staged. This may differ from the resource name. If not provided,basenamemust be computed from the last path part oflocationand made available to expressions.The
secondaryFilesproperty is a list of File or Directory objects that must be staged in the same directory as the primary file. It is an error for file names to be duplicated insecondaryFiles.The
sizeproperty is the size in bytes of the File. It must be computed from the resource and made available to expressions. Thechecksumfield contains a cryptographic hash of the file content for use it verifying file contents. Implementations may, at user option, enable or disable computation of thechecksumfield for performance or other reasons. However, the ability to compute output checksums is required to pass the CWL conformance test suite.When executing a CommandLineTool, the files and secondary files may be staged to an arbitrary directory, but must use the value of
basenamefor the filename. Thepathproperty must be file path in the context of the tool execution runtime (local to the compute node, or within the executing container). All computed properties should be available to expressions. File literals also must be staged andpathmust be set.When collecting CommandLineTool outputs,
globmatching returns file paths (with thepathproperty) and the derived properties. This can all be modified byoutputEval. Alternately, if the filecwl.output.jsonis present in the output,outputBindingis ignored.File objects in the output must provide either a
locationURI or apathproperty in the context of the tool execution runtime (local to the compute node, or within the executing container).When evaluating an ExpressionTool, file objects must be referenced via
location(the expression tool does not have access to files on disk sopathis meaningless) or as file literals. It is legal to return a file object with an existinglocationbut a differentbasename. TheloadContentsfield of ExpressionTool inputs behaves the same as on CommandLineTool inputs, however it is not meaningful on the outputs.An ExpressionTool may forward file references from input to output by using the same value for
location.