google-cloud-chronicle-v1 0.a → 0.1.0

data/proto_docs/google/protobuf/timestamp.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Protobuf
+    # A Timestamp represents a point in time independent of any time zone or local
+    # calendar, encoded as a count of seconds and fractions of seconds at
+    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+    # January 1, 1970, in the proleptic Gregorian calendar which extends the
+    # Gregorian calendar backwards to year one.
+    #
+    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+    # second table is needed for interpretation, using a [24-hour linear
+    # smear](https://developers.google.com/time/smear).
+    #
+    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+    # restricting to that range, we ensure that we can convert to and from [RFC
+    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
+    #
+    # # Examples
+    #
+    # Example 1: Compute Timestamp from POSIX `time()`.
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(time(NULL));
+    #     timestamp.set_nanos(0);
+    #
+    # Example 2: Compute Timestamp from POSIX `gettimeofday()`.
+    #
+    #     struct timeval tv;
+    #     gettimeofday(&tv, NULL);
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(tv.tv_sec);
+    #     timestamp.set_nanos(tv.tv_usec * 1000);
+    #
+    # Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
+    #
+    #     FILETIME ft;
+    #     GetSystemTimeAsFileTime(&ft);
+    #     UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
+    #
+    #     // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
+    #     // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
+    #     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
+    #
+    # Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
+    #
+    #     long millis = System.currentTimeMillis();
+    #
+    #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
+    #         .setNanos((int) ((millis % 1000) * 1000000)).build();
+    #
+    # Example 5: Compute Timestamp from Java `Instant.now()`.
+    #
+    #     Instant now = Instant.now();
+    #
+    #     Timestamp timestamp =
+    #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
+    #             .setNanos(now.getNano()).build();
+    #
+    # Example 6: Compute Timestamp from current time in Python.
+    #
+    #     timestamp = Timestamp()
+    #     timestamp.GetCurrentTime()
+    #
+    # # JSON Mapping
+    #
+    # In JSON format, the Timestamp type is encoded as a string in the
+    # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
+    # format is "\\{year}-\\{month}-\\{day}T\\{hour}:\\{min}:\\{sec}[.\\{frac_sec}]Z"
+    # where \\{year} is always expressed using four digits while \\{month}, \\{day},
+    # \\{hour}, \\{min}, and \\{sec} are zero-padded to two digits each. The fractional
+    # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
+    # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
+    # is required. A proto3 JSON serializer should always use UTC (as indicated by
+    # "Z") when printing the Timestamp type and a proto3 JSON parser should be
+    # able to accept both UTC and other timezones (as indicated by an offset).
+    #
+    # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
+    # 01:30 UTC on January 15, 2017.
+    #
+    # In JavaScript, one can convert a Date object to this format using the
+    # standard
+    # [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
+    # method. In Python, a standard `datetime.datetime` object can be converted
+    # to this format using
+    # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
+    # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
+    # the Joda Time's [`ISODateTimeFormat.dateTime()`](
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
+    # ) to obtain a formatter capable of generating timestamps in this format.
+    # @!attribute [rw] seconds
+    #   @return [::Integer]
+    #     Represents seconds of UTC time since Unix epoch
+    #     1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
+    #     9999-12-31T23:59:59Z inclusive.
+    # @!attribute [rw] nanos
+    #   @return [::Integer]
+    #     Non-negative fractions of a second at nanosecond resolution. Negative
+    #     second values with fractions must still have non-negative nanos values
+    #     that count forward in time. Must be from 0 to 999,999,999
+    #     inclusive.
+    class Timestamp
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/rpc/status.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Rpc
+    # The `Status` type defines a logical error model that is suitable for
+    # different programming environments, including REST APIs and RPC APIs. It is
+    # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+    # three pieces of data: error code, error message, and error details.
+    #
+    # You can find out more about this error model and how to work with it in the
+    # [API Design Guide](https://cloud.google.com/apis/design/errors).
+    # @!attribute [rw] code
+    #   @return [::Integer]
+    #     The status code, which should be an enum value of
+    #     [google.rpc.Code][google.rpc.Code].
+    # @!attribute [rw] message
+    #   @return [::String]
+    #     A developer-facing error message, which should be in English. Any
+    #     user-facing error message should be localized and sent in the
+    #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized
+    #     by the client.
+    # @!attribute [rw] details
+    #   @return [::Array<::Google::Protobuf::Any>]
+    #     A list of messages that carry the error details.  There is a common set of
+    #     message types for APIs to use.
+    class Status
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/type/interval.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Type
+    # Represents a time interval, encoded as a Timestamp start (inclusive) and a
+    # Timestamp end (exclusive).
+    #
+    # The start must be less than or equal to the end.
+    # When the start equals the end, the interval is empty (matches no time).
+    # When both start and end are unspecified, the interval matches any time.
+    # @!attribute [rw] start_time
+    #   @return [::Google::Protobuf::Timestamp]
+    #     Optional. Inclusive start of the interval.
+    #
+    #     If specified, a Timestamp matching this interval will have to be the same
+    #     or after the start.
+    # @!attribute [rw] end_time
+    #   @return [::Google::Protobuf::Timestamp]
+    #     Optional. Exclusive end of the interval.
+    #
+    #     If specified, a Timestamp matching this interval will have to be before the
+    #     end.
+    class Interval
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

metadata

@@ -1,27 +1,125 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-chronicle-v1
 version: !ruby/object:Gem::Version
-  version: 0.a
+  version: 0.1.0
 platform: ruby
 authors:
 - Google LLC
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
-description: Placeholder for the future Google-authored gem google-cloud-chronicle-v1.
-  This placeholder is being released on 2025-05-15 in order to reserve the name. The
-  final gem should be available shortly after that date. If it has not been released
-  in a timely manner, or if this placeholder interferes with your work, you can contact
-  the Google Ruby team by opening an issue in the GitHub repository https://github.com/googleapis/google-cloud-ruby.
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gapic-common
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: google-cloud-errors
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: The Google Cloud Security Operations API, popularly known as the Chronicle
+  API, serves endpoints that enable security analysts to analyze and mitigate a security
+  threat throughout its lifecycle. Note that google-cloud-chronicle-v1 is a version-specific
+  client library. For most uses, we recommend installing the main client library google-cloud-chronicle
+  instead. See the readme for more details.
 email: googleapis-packages@google.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".yardopts"
+- AUTHENTICATION.md
 - LICENSE.md
 - README.md
+- lib/google-cloud-chronicle-v1.rb
+- lib/google/cloud/chronicle/v1.rb
+- lib/google/cloud/chronicle/v1/data_access_control_pb.rb
+- lib/google/cloud/chronicle/v1/data_access_control_service.rb
+- lib/google/cloud/chronicle/v1/data_access_control_service/client.rb
+- lib/google/cloud/chronicle/v1/data_access_control_service/credentials.rb
+- lib/google/cloud/chronicle/v1/data_access_control_service/paths.rb
+- lib/google/cloud/chronicle/v1/data_access_control_service/rest.rb
+- lib/google/cloud/chronicle/v1/data_access_control_service/rest/client.rb
+- lib/google/cloud/chronicle/v1/data_access_control_service/rest/service_stub.rb
+- lib/google/cloud/chronicle/v1/data_access_control_services_pb.rb
+- lib/google/cloud/chronicle/v1/entity_pb.rb
+- lib/google/cloud/chronicle/v1/entity_service.rb
+- lib/google/cloud/chronicle/v1/entity_service/client.rb
+- lib/google/cloud/chronicle/v1/entity_service/credentials.rb
+- lib/google/cloud/chronicle/v1/entity_service/paths.rb
+- lib/google/cloud/chronicle/v1/entity_service/rest.rb
+- lib/google/cloud/chronicle/v1/entity_service/rest/client.rb
+- lib/google/cloud/chronicle/v1/entity_service/rest/service_stub.rb
+- lib/google/cloud/chronicle/v1/entity_services_pb.rb
+- lib/google/cloud/chronicle/v1/instance_pb.rb
+- lib/google/cloud/chronicle/v1/instance_service.rb
+- lib/google/cloud/chronicle/v1/instance_service/client.rb
+- lib/google/cloud/chronicle/v1/instance_service/credentials.rb
+- lib/google/cloud/chronicle/v1/instance_service/paths.rb
+- lib/google/cloud/chronicle/v1/instance_service/rest.rb
+- lib/google/cloud/chronicle/v1/instance_service/rest/client.rb
+- lib/google/cloud/chronicle/v1/instance_service/rest/service_stub.rb
+- lib/google/cloud/chronicle/v1/instance_services_pb.rb
+- lib/google/cloud/chronicle/v1/reference_list_pb.rb
+- lib/google/cloud/chronicle/v1/reference_list_service.rb
+- lib/google/cloud/chronicle/v1/reference_list_service/client.rb
+- lib/google/cloud/chronicle/v1/reference_list_service/credentials.rb
+- lib/google/cloud/chronicle/v1/reference_list_service/paths.rb
+- lib/google/cloud/chronicle/v1/reference_list_service/rest.rb
+- lib/google/cloud/chronicle/v1/reference_list_service/rest/client.rb
+- lib/google/cloud/chronicle/v1/reference_list_service/rest/service_stub.rb
+- lib/google/cloud/chronicle/v1/reference_list_services_pb.rb
+- lib/google/cloud/chronicle/v1/rest.rb
+- lib/google/cloud/chronicle/v1/rule_pb.rb
+- lib/google/cloud/chronicle/v1/rule_service.rb
+- lib/google/cloud/chronicle/v1/rule_service/client.rb
+- lib/google/cloud/chronicle/v1/rule_service/credentials.rb
+- lib/google/cloud/chronicle/v1/rule_service/operations.rb
+- lib/google/cloud/chronicle/v1/rule_service/paths.rb
+- lib/google/cloud/chronicle/v1/rule_service/rest.rb
+- lib/google/cloud/chronicle/v1/rule_service/rest/client.rb
+- lib/google/cloud/chronicle/v1/rule_service/rest/operations.rb
+- lib/google/cloud/chronicle/v1/rule_service/rest/service_stub.rb
+- lib/google/cloud/chronicle/v1/rule_services_pb.rb
 - lib/google/cloud/chronicle/v1/version.rb
+- proto_docs/README.md
+- proto_docs/google/api/client.rb
+- proto_docs/google/api/field_behavior.rb
+- proto_docs/google/api/launch_stage.rb
+- proto_docs/google/api/resource.rb
+- proto_docs/google/cloud/chronicle/v1/data_access_control.rb
+- proto_docs/google/cloud/chronicle/v1/entity.rb
+- proto_docs/google/cloud/chronicle/v1/instance.rb
+- proto_docs/google/cloud/chronicle/v1/reference_list.rb
+- proto_docs/google/cloud/chronicle/v1/rule.rb
+- proto_docs/google/longrunning/operations.rb
+- proto_docs/google/protobuf/any.rb
+- proto_docs/google/protobuf/duration.rb
+- proto_docs/google/protobuf/empty.rb
+- proto_docs/google/protobuf/field_mask.rb
+- proto_docs/google/protobuf/timestamp.rb
+- proto_docs/google/rpc/status.rb
+- proto_docs/google/type/interval.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
@@ -33,14 +131,16 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.9
 specification_version: 4
-summary: Placeholder for the future Google-authored gem google-cloud-chronicle-v1
+summary: The Google Cloud Security Operations API, popularly known as the Chronicle
+  API, serves endpoints that enable security analysts to analyze and mitigate a security
+  threat throughout its lifecycle.
 test_files: []