Class: Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2OutputDirectory
- Inherits:
-
Object
- Object
- Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2OutputDirectory
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- lib/google/apis/remotebuildexecution_v2/classes.rb,
lib/google/apis/remotebuildexecution_v2/representations.rb,
lib/google/apis/remotebuildexecution_v2/representations.rb
Overview
An OutputDirectory
is the output in an ActionResult
corresponding to a
directory's full contents rather than a single file.
Instance Attribute Summary collapse
-
#path ⇒ String
The full path of the directory relative to the working directory.
-
#tree_digest ⇒ Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2Digest
A content digest.
Instance Method Summary collapse
-
#initialize(**args) ⇒ BuildBazelRemoteExecutionV2OutputDirectory
constructor
A new instance of BuildBazelRemoteExecutionV2OutputDirectory.
-
#update!(**args) ⇒ Object
Update properties of this object.
Constructor Details
#initialize(**args) ⇒ BuildBazelRemoteExecutionV2OutputDirectory
Returns a new instance of BuildBazelRemoteExecutionV2OutputDirectory.
1607 1608 1609 |
# File 'lib/google/apis/remotebuildexecution_v2/classes.rb', line 1607 def initialize(**args) update!(**args) end |
Instance Attribute Details
#path ⇒ String
The full path of the directory relative to the working directory. The path
separator is a forward slash /
. Since this is a relative path, it MUST NOT
begin with a leading forward slash. The empty string value is allowed, and it
denotes the entire working directory.
Corresponds to the JSON property path
1577 1578 1579 |
# File 'lib/google/apis/remotebuildexecution_v2/classes.rb', line 1577 def path @path end |
#tree_digest ⇒ Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2Digest
A content digest. A digest for a given blob consists of the size of the blob
and its hash. The hash algorithm to use is defined by the server. The size is
considered to be an integral part of the digest and cannot be separated. That
is, even if the hash
field is correctly specified but size_bytes
is not,
the server MUST reject the request. The reason for including the size in the
digest is as follows: in a great many cases, the server needs to know the size
of the blob it is about to work with prior to starting an operation with it,
such as flattening Merkle tree structures or streaming it to a worker.
Technically, the server could implement a separate metadata store, but this
results in a significantly more complicated implementation as opposed to
having the client specify the size up-front (or storing the size along with
the digest in every message where digests are embedded). This does mean that
the API leaks some implementation details of (what we consider to be) a
reasonable server implementation, but we consider this to be a worthwhile
tradeoff. When a Digest
is used to refer to a proto message, it always
refers to the message in binary encoded form. To ensure consistent hashing,
clients and servers MUST ensure that they serialize messages according to the
following rules, even if there are alternate valid encodings for the same
message: * Fields are serialized in tag order. * There are no unknown fields. *
There are no duplicate fields. * Fields are serialized according to the
default semantics for their type. Most protocol buffer implementations will
always follow these rules when serializing, but care should be taken to avoid
shortcuts. For instance, concatenating two messages to merge them may produce
duplicate fields.
Corresponds to the JSON property treeDigest
1605 1606 1607 |
# File 'lib/google/apis/remotebuildexecution_v2/classes.rb', line 1605 def tree_digest @tree_digest end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
1612 1613 1614 1615 |
# File 'lib/google/apis/remotebuildexecution_v2/classes.rb', line 1612 def update!(**args) @path = args[:path] if args.key?(:path) @tree_digest = args[:tree_digest] if args.key?(:tree_digest) end |