google-cloud-language 0.36.0 → 1.0.0

data/LICENSE

@@ -1,201 +0,0 @@
-                            Apache License
-                           Version 2.0, January 2004
-                        https://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   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.

data/lib/google/cloud/language/v1.rb

@@ -1,148 +0,0 @@
-# Copyright 2020 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.
-
-
-require "google/cloud/language/v1/language_service_client"
-
-module Google
-  module Cloud
-    module Language
-      # rubocop:disable LineLength
-
-      ##
-      # # Ruby Client for Cloud Natural Language API
-      #
-      # [Cloud Natural Language API][Product Documentation]:
-      # Provides natural language understanding technologies, such as sentiment
-      # analysis, entity recognition, entity sentiment analysis, and other text
-      # annotations, to developers.
-      # - [Product Documentation][]
-      #
-      # ## Quick Start
-      # In order to use this library, you first need to go through the following
-      # steps:
-      #
-      # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-      # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-      # 3. [Enable the Cloud Natural Language API.](https://console.cloud.google.com/apis/library/language.googleapis.com)
-      # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-language/latest/file.AUTHENTICATION.html)
-      #
-      # ### Installation
-      # ```
-      # $ gem install google-cloud-language
-      # ```
-      #
-      # ### Next Steps
-      # - Read the [Cloud Natural Language API Product documentation][Product Documentation]
-      #   to learn more about the product and see How-to Guides.
-      # - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
-      #   to see the full list of Cloud APIs that we cover.
-      #
-      # [Product Documentation]: https://cloud.google.com/natural-language
-      #
-      # ## Enabling Logging
-      #
-      # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-      # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
-      # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
-      # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
-      #
-      # Configuring a Ruby stdlib logger:
-      #
-      # ```ruby
-      # require "logger"
-      #
-      # module MyLogger
-      #   LOGGER = Logger.new $stderr, level: Logger::WARN
-      #   def logger
-      #     LOGGER
-      #   end
-      # end
-      #
-      # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
-      # module GRPC
-      #   extend MyLogger
-      # end
-      # ```
-      #
-      module V1
-        # rubocop:enable LineLength
-
-        ##
-        # Provides text analysis operations such as sentiment analysis and entity
-        # recognition.
-        #
-        # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
-        #   Provides the means for authenticating requests made by the client. This parameter can
-        #   be many types.
-        #   A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
-        #   authenticating requests made by this client.
-        #   A `String` will be treated as the path to the keyfile to be used for the construction of
-        #   credentials for this client.
-        #   A `Hash` will be treated as the contents of a keyfile to be used for the construction of
-        #   credentials for this client.
-        #   A `GRPC::Core::Channel` will be used to make calls through.
-        #   A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
-        #   should already be composed with a `GRPC::Core::CallCredentials` object.
-        #   A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
-        #   metadata for requests, generally, to give OAuth credentials.
-        # @param scopes [Array<String>]
-        #   The OAuth scopes for this service. This parameter is ignored if
-        #   an updater_proc is supplied.
-        # @param client_config [Hash]
-        #   A Hash for call options for each method. See
-        #   Google::Gax#construct_settings for the structure of
-        #   this data. Falls back to the default config if not specified
-        #   or the specified config is missing data points.
-        # @param timeout [Numeric]
-        #   The default timeout, in seconds, for calls made through this client.
-        # @param metadata [Hash]
-        #   Default metadata to be sent with each request. This can be overridden on a per call basis.
-        # @param service_address [String]
-        #   Override for the service hostname, or `nil` to leave as the default.
-        # @param service_port [Integer]
-        #   Override for the service port, or `nil` to leave as the default.
-        # @param exception_transformer [Proc]
-        #   An optional proc that intercepts any exceptions raised during an API call to inject
-        #   custom error handling.
-        def self.new \
-            credentials: nil,
-            scopes: nil,
-            client_config: nil,
-            timeout: nil,
-            metadata: nil,
-            service_address: nil,
-            service_port: nil,
-            exception_transformer: nil,
-            lib_name: nil,
-            lib_version: nil
-          kwargs = {
-            credentials: credentials,
-            scopes: scopes,
-            client_config: client_config,
-            timeout: timeout,
-            metadata: metadata,
-            exception_transformer: exception_transformer,
-            lib_name: lib_name,
-            service_address: service_address,
-            service_port: service_port,
-            lib_version: lib_version
-          }.select { |_, v| v != nil }
-          Google::Cloud::Language::V1::LanguageServiceClient.new(**kwargs)
-        end
-      end
-    end
-  end
-end

data/lib/google/cloud/language/v1/credentials.rb

@@ -1,41 +0,0 @@
-# Copyright 2020 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.
-
-
-require "googleauth"
-
-module Google
-  module Cloud
-    module Language
-      module V1
-        class Credentials < Google::Auth::Credentials
-          SCOPE = [
-            "https://www.googleapis.com/auth/cloud-platform"
-          ].freeze
-          PATH_ENV_VARS = %w(LANGUAGE_CREDENTIALS
-                             LANGUAGE_KEYFILE
-                             GOOGLE_CLOUD_CREDENTIALS
-                             GOOGLE_CLOUD_KEYFILE
-                             GCLOUD_KEYFILE)
-          JSON_ENV_VARS = %w(LANGUAGE_CREDENTIALS_JSON
-                             LANGUAGE_KEYFILE_JSON
-                             GOOGLE_CLOUD_CREDENTIALS_JSON
-                             GOOGLE_CLOUD_KEYFILE_JSON
-                             GCLOUD_KEYFILE_JSON)
-          DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
-        end
-      end
-    end
-  end
-end

data/lib/google/cloud/language/v1/doc/google/cloud/language/v1/language_service.rb

@@ -1,1039 +0,0 @@
-# Copyright 2020 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.
-
-
-module Google
-  module Cloud
-    module Language
-      module V1
-        # ================================================================ #
-        #
-        # Represents the input to API methods.
-        # @!attribute [rw] type
-        #   @return [Google::Cloud::Language::V1::Document::Type]
-        #     Required. If the type is not set or is `TYPE_UNSPECIFIED`,
-        #     returns an `INVALID_ARGUMENT` error.
-        # @!attribute [rw] content
-        #   @return [String]
-        #     The content of the input in string format.
-        #     Cloud audit logging exempt since it is based on user data.
-        # @!attribute [rw] gcs_content_uri
-        #   @return [String]
-        #     The Google Cloud Storage URI where the file content is located.
-        #     This URI must be of the form: gs://bucket_name/object_name. For more
-        #     details, see https://cloud.google.com/storage/docs/reference-uris.
-        #     NOTE: Cloud Storage object versioning is not supported.
-        # @!attribute [rw] language
-        #   @return [String]
-        #     The language of the document (if not specified, the language is
-        #     automatically detected). Both ISO and BCP-47 language codes are
-        #     accepted.<br>
-        #     [Language Support](https://cloud.google.com/natural-language/docs/languages)
-        #     lists currently supported languages for each API method.
-        #     If the language (either specified by the caller or automatically detected)
-        #     is not supported by the called API method, an `INVALID_ARGUMENT` error
-        #     is returned.
-        class Document
-          # The document types enum.
-          module Type
-            # The content type is not specified.
-            TYPE_UNSPECIFIED = 0
-
-            # Plain text
-            PLAIN_TEXT = 1
-
-            # HTML
-            HTML = 2
-          end
-        end
-
-        # Represents a sentence in the input document.
-        # @!attribute [rw] text
-        #   @return [Google::Cloud::Language::V1::TextSpan]
-        #     The sentence text.
-        # @!attribute [rw] sentiment
-        #   @return [Google::Cloud::Language::V1::Sentiment]
-        #     For calls to {AnalyzeSentiment} or if
-        #     {Google::Cloud::Language::V1::AnnotateTextRequest::Features#extract_document_sentiment AnnotateTextRequest::Features#extract_document_sentiment} is set to
-        #     true, this field will contain the sentiment for the sentence.
-        class Sentence; end
-
-        # Represents a phrase in the text that is a known entity, such as
-        # a person, an organization, or location. The API associates information, such
-        # as salience and mentions, with entities.
-        # @!attribute [rw] name
-        #   @return [String]
-        #     The representative name for the entity.
-        # @!attribute [rw] type
-        #   @return [Google::Cloud::Language::V1::Entity::Type]
-        #     The entity type.
-        # @!attribute [rw] metadata
-        #   @return [Hash{String => String}]
-        #     Metadata associated with the entity.
-        #
-        #     For most entity types, the metadata is a Wikipedia URL (`wikipedia_url`)
-        #     and Knowledge Graph MID (`mid`), if they are available. For the metadata
-        #     associated with other entity types, see the Type table below.
-        # @!attribute [rw] salience
-        #   @return [Float]
-        #     The salience score associated with the entity in the [0, 1.0] range.
-        #
-        #     The salience score for an entity provides information about the
-        #     importance or centrality of that entity to the entire document text.
-        #     Scores closer to 0 are less salient, while scores closer to 1.0 are highly
-        #     salient.
-        # @!attribute [rw] mentions
-        #   @return [Array<Google::Cloud::Language::V1::EntityMention>]
-        #     The mentions of this entity in the input document. The API currently
-        #     supports proper noun mentions.
-        # @!attribute [rw] sentiment
-        #   @return [Google::Cloud::Language::V1::Sentiment]
-        #     For calls to {AnalyzeEntitySentiment} or if
-        #     {Google::Cloud::Language::V1::AnnotateTextRequest::Features#extract_entity_sentiment AnnotateTextRequest::Features#extract_entity_sentiment} is set to
-        #     true, this field will contain the aggregate sentiment expressed for this
-        #     entity in the provided document.
-        class Entity
-          # The type of the entity. For most entity types, the associated metadata is a
-          # Wikipedia URL (`wikipedia_url`) and Knowledge Graph MID (`mid`). The table
-          # below lists the associated fields for entities that have different
-          # metadata.
-          module Type
-            # Unknown
-            UNKNOWN = 0
-
-            # Person
-            PERSON = 1
-
-            # Location
-            LOCATION = 2
-
-            # Organization
-            ORGANIZATION = 3
-
-            # Event
-            EVENT = 4
-
-            # Artwork
-            WORK_OF_ART = 5
-
-            # Consumer product
-            CONSUMER_GOOD = 6
-
-            # Other types of entities
-            OTHER = 7
-
-            # Phone number<br><br>
-            # The metadata lists the phone number, formatted according to local
-            # convention, plus whichever additional elements appear in the text:<ul>
-            # <li><code>number</code> &ndash; the actual number, broken down into
-            # sections as per local convention</li> <li><code>national_prefix</code>
-            # &ndash; country code, if detected</li> <li><code>area_code</code> &ndash;
-            # region or area code, if detected</li> <li><code>extension</code> &ndash;
-            # phone extension (to be dialed after connection), if detected</li></ul>
-            PHONE_NUMBER = 9
-
-            # Address<br><br>
-            # The metadata identifies the street number and locality plus whichever
-            # additional elements appear in the text:<ul>
-            # <li><code>street_number</code> &ndash; street number</li>
-            # <li><code>locality</code> &ndash; city or town</li>
-            # <li><code>street_name</code> &ndash; street/route name, if detected</li>
-            # <li><code>postal_code</code> &ndash; postal code, if detected</li>
-            # <li><code>country</code> &ndash; country, if detected</li>
-            # <li><code>broad_region</code> &ndash; administrative area, such as the
-            # state, if detected</li> <li><code>narrow_region</code> &ndash; smaller
-            # administrative area, such as county, if detected</li>
-            # <li><code>sublocality</code> &ndash; used in Asian addresses to demark a
-            # district within a city, if detected</li></ul>
-            ADDRESS = 10
-
-            # Date<br><br>
-            # The metadata identifies the components of the date:<ul>
-            # <li><code>year</code> &ndash; four digit year, if detected</li>
-            # <li><code>month</code> &ndash; two digit month number, if detected</li>
-            # <li><code>day</code> &ndash; two digit day number, if detected</li></ul>
-            DATE = 11
-
-            # Number<br><br>
-            # The metadata is the number itself.
-            NUMBER = 12
-
-            # Price<br><br>
-            # The metadata identifies the <code>value</code> and <code>currency</code>.
-            PRICE = 13
-          end
-        end
-
-        # Represents the smallest syntactic building block of the text.
-        # @!attribute [rw] text
-        #   @return [Google::Cloud::Language::V1::TextSpan]
-        #     The token text.
-        # @!attribute [rw] part_of_speech
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech]
-        #     Parts of speech tag for this token.
-        # @!attribute [rw] dependency_edge
-        #   @return [Google::Cloud::Language::V1::DependencyEdge]
-        #     Dependency tree parse for this token.
-        # @!attribute [rw] lemma
-        #   @return [String]
-        #     [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
-        class Token; end
-
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
-        # @!attribute [rw] magnitude
-        #   @return [Float]
-        #     A non-negative number in the [0, +inf) range, which represents
-        #     the absolute magnitude of sentiment regardless of score (positive or
-        #     negative).
-        # @!attribute [rw] score
-        #   @return [Float]
-        #     Sentiment score between -1.0 (negative sentiment) and 1.0
-        #     (positive sentiment).
-        class Sentiment; end
-
-        # Represents part of speech information for a token. Parts of speech
-        # are as defined in
-        # http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
-        # @!attribute [rw] tag
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Tag]
-        #     The part of speech tag.
-        # @!attribute [rw] aspect
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Aspect]
-        #     The grammatical aspect.
-        # @!attribute [rw] case
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Case]
-        #     The grammatical case.
-        # @!attribute [rw] form
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Form]
-        #     The grammatical form.
-        # @!attribute [rw] gender
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Gender]
-        #     The grammatical gender.
-        # @!attribute [rw] mood
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Mood]
-        #     The grammatical mood.
-        # @!attribute [rw] number
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Number]
-        #     The grammatical number.
-        # @!attribute [rw] person
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Person]
-        #     The grammatical person.
-        # @!attribute [rw] proper
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Proper]
-        #     The grammatical properness.
-        # @!attribute [rw] reciprocity
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Reciprocity]
-        #     The grammatical reciprocity.
-        # @!attribute [rw] tense
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Tense]
-        #     The grammatical tense.
-        # @!attribute [rw] voice
-        #   @return [Google::Cloud::Language::V1::PartOfSpeech::Voice]
-        #     The grammatical voice.
-        class PartOfSpeech
-          # The characteristic of a verb that expresses time flow during an event.
-          module Aspect
-            # Aspect is not applicable in the analyzed language or is not predicted.
-            ASPECT_UNKNOWN = 0
-
-            # Perfective
-            PERFECTIVE = 1
-
-            # Imperfective
-            IMPERFECTIVE = 2
-
-            # Progressive
-            PROGRESSIVE = 3
-          end
-
-          # The grammatical function performed by a noun or pronoun in a phrase,
-          # clause, or sentence. In some languages, other parts of speech, such as
-          # adjective and determiner, take case inflection in agreement with the noun.
-          module Case
-            # Case is not applicable in the analyzed language or is not predicted.
-            CASE_UNKNOWN = 0
-
-            # Accusative
-            ACCUSATIVE = 1
-
-            # Adverbial
-            ADVERBIAL = 2
-
-            # Complementive
-            COMPLEMENTIVE = 3
-
-            # Dative
-            DATIVE = 4
-
-            # Genitive
-            GENITIVE = 5
-
-            # Instrumental
-            INSTRUMENTAL = 6
-
-            # Locative
-            LOCATIVE = 7
-
-            # Nominative
-            NOMINATIVE = 8
-
-            # Oblique
-            OBLIQUE = 9
-
-            # Partitive
-            PARTITIVE = 10
-
-            # Prepositional
-            PREPOSITIONAL = 11
-
-            # Reflexive
-            REFLEXIVE_CASE = 12
-
-            # Relative
-            RELATIVE_CASE = 13
-
-            # Vocative
-            VOCATIVE = 14
-          end
-
-          # Depending on the language, Form can be categorizing different forms of
-          # verbs, adjectives, adverbs, etc. For example, categorizing inflected
-          # endings of verbs and adjectives or distinguishing between short and long
-          # forms of adjectives and participles
-          module Form
-            # Form is not applicable in the analyzed language or is not predicted.
-            FORM_UNKNOWN = 0
-
-            # Adnomial
-            ADNOMIAL = 1
-
-            # Auxiliary
-            AUXILIARY = 2
-
-            # Complementizer
-            COMPLEMENTIZER = 3
-
-            # Final ending
-            FINAL_ENDING = 4
-
-            # Gerund
-            GERUND = 5
-
-            # Realis
-            REALIS = 6
-
-            # Irrealis
-            IRREALIS = 7
-
-            # Short form
-            SHORT = 8
-
-            # Long form
-            LONG = 9
-
-            # Order form
-            ORDER = 10
-
-            # Specific form
-            SPECIFIC = 11
-          end
-
-          # Gender classes of nouns reflected in the behaviour of associated words.
-          module Gender
-            # Gender is not applicable in the analyzed language or is not predicted.
-            GENDER_UNKNOWN = 0
-
-            # Feminine
-            FEMININE = 1
-
-            # Masculine
-            MASCULINE = 2
-
-            # Neuter
-            NEUTER = 3
-          end
-
-          # The grammatical feature of verbs, used for showing modality and attitude.
-          module Mood
-            # Mood is not applicable in the analyzed language or is not predicted.
-            MOOD_UNKNOWN = 0
-
-            # Conditional
-            CONDITIONAL_MOOD = 1
-
-            # Imperative
-            IMPERATIVE = 2
-
-            # Indicative
-            INDICATIVE = 3
-
-            # Interrogative
-            INTERROGATIVE = 4
-
-            # Jussive
-            JUSSIVE = 5
-
-            # Subjunctive
-            SUBJUNCTIVE = 6
-          end
-
-          # Count distinctions.
-          module Number
-            # Number is not applicable in the analyzed language or is not predicted.
-            NUMBER_UNKNOWN = 0
-
-            # Singular
-            SINGULAR = 1
-
-            # Plural
-            PLURAL = 2
-
-            # Dual
-            DUAL = 3
-          end
-
-          # The distinction between the speaker, second person, third person, etc.
-          module Person
-            # Person is not applicable in the analyzed language or is not predicted.
-            PERSON_UNKNOWN = 0
-
-            # First
-            FIRST = 1
-
-            # Second
-            SECOND = 2
-
-            # Third
-            THIRD = 3
-
-            # Reflexive
-            REFLEXIVE_PERSON = 4
-          end
-
-          # This category shows if the token is part of a proper name.
-          module Proper
-            # Proper is not applicable in the analyzed language or is not predicted.
-            PROPER_UNKNOWN = 0
-
-            # Proper
-            PROPER = 1
-
-            # Not proper
-            NOT_PROPER = 2
-          end
-
-          # Reciprocal features of a pronoun.
-          module Reciprocity
-            # Reciprocity is not applicable in the analyzed language or is not
-            # predicted.
-            RECIPROCITY_UNKNOWN = 0
-
-            # Reciprocal
-            RECIPROCAL = 1
-
-            # Non-reciprocal
-            NON_RECIPROCAL = 2
-          end
-
-          # The part of speech tags enum.
-          module Tag
-            # Unknown
-            UNKNOWN = 0
-
-            # Adjective
-            ADJ = 1
-
-            # Adposition (preposition and postposition)
-            ADP = 2
-
-            # Adverb
-            ADV = 3
-
-            # Conjunction
-            CONJ = 4
-
-            # Determiner
-            DET = 5
-
-            # Noun (common and proper)
-            NOUN = 6
-
-            # Cardinal number
-            NUM = 7
-
-            # Pronoun
-            PRON = 8
-
-            # Particle or other function word
-            PRT = 9
-
-            # Punctuation
-            PUNCT = 10
-
-            # Verb (all tenses and modes)
-            VERB = 11
-
-            # Other: foreign words, typos, abbreviations
-            X = 12
-
-            # Affix
-            AFFIX = 13
-          end
-
-          # Time reference.
-          module Tense
-            # Tense is not applicable in the analyzed language or is not predicted.
-            TENSE_UNKNOWN = 0
-
-            # Conditional
-            CONDITIONAL_TENSE = 1
-
-            # Future
-            FUTURE = 2
-
-            # Past
-            PAST = 3
-
-            # Present
-            PRESENT = 4
-
-            # Imperfect
-            IMPERFECT = 5
-
-            # Pluperfect
-            PLUPERFECT = 6
-          end
-
-          # The relationship between the action that a verb expresses and the
-          # participants identified by its arguments.
-          module Voice
-            # Voice is not applicable in the analyzed language or is not predicted.
-            VOICE_UNKNOWN = 0
-
-            # Active
-            ACTIVE = 1
-
-            # Causative
-            CAUSATIVE = 2
-
-            # Passive
-            PASSIVE = 3
-          end
-        end
-
-        # Represents dependency parse tree information for a token. (For more
-        # information on dependency labels, see
-        # http://www.aclweb.org/anthology/P13-2017
-        # @!attribute [rw] head_token_index
-        #   @return [Integer]
-        #     Represents the head of this token in the dependency tree.
-        #     This is the index of the token which has an arc going to this token.
-        #     The index is the position of the token in the array of tokens returned
-        #     by the API method. If this token is a root token, then the
-        #     `head_token_index` is its own index.
-        # @!attribute [rw] label
-        #   @return [Google::Cloud::Language::V1::DependencyEdge::Label]
-        #     The parse label for the token.
-        class DependencyEdge
-          # The parse label enum for the token.
-          module Label
-            # Unknown
-            UNKNOWN = 0
-
-            # Abbreviation modifier
-            ABBREV = 1
-
-            # Adjectival complement
-            ACOMP = 2
-
-            # Adverbial clause modifier
-            ADVCL = 3
-
-            # Adverbial modifier
-            ADVMOD = 4
-
-            # Adjectival modifier of an NP
-            AMOD = 5
-
-            # Appositional modifier of an NP
-            APPOS = 6
-
-            # Attribute dependent of a copular verb
-            ATTR = 7
-
-            # Auxiliary (non-main) verb
-            AUX = 8
-
-            # Passive auxiliary
-            AUXPASS = 9
-
-            # Coordinating conjunction
-            CC = 10
-
-            # Clausal complement of a verb or adjective
-            CCOMP = 11
-
-            # Conjunct
-            CONJ = 12
-
-            # Clausal subject
-            CSUBJ = 13
-
-            # Clausal passive subject
-            CSUBJPASS = 14
-
-            # Dependency (unable to determine)
-            DEP = 15
-
-            # Determiner
-            DET = 16
-
-            # Discourse
-            DISCOURSE = 17
-
-            # Direct object
-            DOBJ = 18
-
-            # Expletive
-            EXPL = 19
-
-            # Goes with (part of a word in a text not well edited)
-            GOESWITH = 20
-
-            # Indirect object
-            IOBJ = 21
-
-            # Marker (word introducing a subordinate clause)
-            MARK = 22
-
-            # Multi-word expression
-            MWE = 23
-
-            # Multi-word verbal expression
-            MWV = 24
-
-            # Negation modifier
-            NEG = 25
-
-            # Noun compound modifier
-            NN = 26
-
-            # Noun phrase used as an adverbial modifier
-            NPADVMOD = 27
-
-            # Nominal subject
-            NSUBJ = 28
-
-            # Passive nominal subject
-            NSUBJPASS = 29
-
-            # Numeric modifier of a noun
-            NUM = 30
-
-            # Element of compound number
-            NUMBER = 31
-
-            # Punctuation mark
-            P = 32
-
-            # Parataxis relation
-            PARATAXIS = 33
-
-            # Participial modifier
-            PARTMOD = 34
-
-            # The complement of a preposition is a clause
-            PCOMP = 35
-
-            # Object of a preposition
-            POBJ = 36
-
-            # Possession modifier
-            POSS = 37
-
-            # Postverbal negative particle
-            POSTNEG = 38
-
-            # Predicate complement
-            PRECOMP = 39
-
-            # Preconjunt
-            PRECONJ = 40
-
-            # Predeterminer
-            PREDET = 41
-
-            # Prefix
-            PREF = 42
-
-            # Prepositional modifier
-            PREP = 43
-
-            # The relationship between a verb and verbal morpheme
-            PRONL = 44
-
-            # Particle
-            PRT = 45
-
-            # Associative or possessive marker
-            PS = 46
-
-            # Quantifier phrase modifier
-            QUANTMOD = 47
-
-            # Relative clause modifier
-            RCMOD = 48
-
-            # Complementizer in relative clause
-            RCMODREL = 49
-
-            # Ellipsis without a preceding predicate
-            RDROP = 50
-
-            # Referent
-            REF = 51
-
-            # Remnant
-            REMNANT = 52
-
-            # Reparandum
-            REPARANDUM = 53
-
-            # Root
-            ROOT = 54
-
-            # Suffix specifying a unit of number
-            SNUM = 55
-
-            # Suffix
-            SUFF = 56
-
-            # Temporal modifier
-            TMOD = 57
-
-            # Topic marker
-            TOPIC = 58
-
-            # Clause headed by an infinite form of the verb that modifies a noun
-            VMOD = 59
-
-            # Vocative
-            VOCATIVE = 60
-
-            # Open clausal complement
-            XCOMP = 61
-
-            # Name suffix
-            SUFFIX = 62
-
-            # Name title
-            TITLE = 63
-
-            # Adverbial phrase modifier
-            ADVPHMOD = 64
-
-            # Causative auxiliary
-            AUXCAUS = 65
-
-            # Helper auxiliary
-            AUXVV = 66
-
-            # Rentaishi (Prenominal modifier)
-            DTMOD = 67
-
-            # Foreign words
-            FOREIGN = 68
-
-            # Keyword
-            KW = 69
-
-            # List for chains of comparable items
-            LIST = 70
-
-            # Nominalized clause
-            NOMC = 71
-
-            # Nominalized clausal subject
-            NOMCSUBJ = 72
-
-            # Nominalized clausal passive
-            NOMCSUBJPASS = 73
-
-            # Compound of numeric modifier
-            NUMC = 74
-
-            # Copula
-            COP = 75
-
-            # Dislocated relation (for fronted/topicalized elements)
-            DISLOCATED = 76
-
-            # Aspect marker
-            ASP = 77
-
-            # Genitive modifier
-            GMOD = 78
-
-            # Genitive object
-            GOBJ = 79
-
-            # Infinitival modifier
-            INFMOD = 80
-
-            # Measure
-            MES = 81
-
-            # Nominal complement of a noun
-            NCOMP = 82
-          end
-        end
-
-        # Represents a mention for an entity in the text. Currently, proper noun
-        # mentions are supported.
-        # @!attribute [rw] text
-        #   @return [Google::Cloud::Language::V1::TextSpan]
-        #     The mention text.
-        # @!attribute [rw] type
-        #   @return [Google::Cloud::Language::V1::EntityMention::Type]
-        #     The type of the entity mention.
-        # @!attribute [rw] sentiment
-        #   @return [Google::Cloud::Language::V1::Sentiment]
-        #     For calls to {AnalyzeEntitySentiment} or if
-        #     {Google::Cloud::Language::V1::AnnotateTextRequest::Features#extract_entity_sentiment AnnotateTextRequest::Features#extract_entity_sentiment} is set to
-        #     true, this field will contain the sentiment expressed for this mention of
-        #     the entity in the provided document.
-        class EntityMention
-          # The supported types of mentions.
-          module Type
-            # Unknown
-            TYPE_UNKNOWN = 0
-
-            # Proper name
-            PROPER = 1
-
-            # Common noun (or noun compound)
-            COMMON = 2
-          end
-        end
-
-        # Represents an output piece of text.
-        # @!attribute [rw] content
-        #   @return [String]
-        #     The content of the output text.
-        # @!attribute [rw] begin_offset
-        #   @return [Integer]
-        #     The API calculates the beginning offset of the content in the original
-        #     document according to the {Google::Cloud::Language::V1::EncodingType EncodingType} specified in the API request.
-        class TextSpan; end
-
-        # Represents a category returned from the text classifier.
-        # @!attribute [rw] name
-        #   @return [String]
-        #     The name of the category representing the document, from the [predefined
-        #     taxonomy](/natural-language/docs/categories).
-        # @!attribute [rw] confidence
-        #   @return [Float]
-        #     The classifier's confidence of the category. Number represents how certain
-        #     the classifier is that this category represents the given text.
-        class ClassificationCategory; end
-
-        # The sentiment analysis request message.
-        # @!attribute [rw] document
-        #   @return [Google::Cloud::Language::V1::Document]
-        #     Input document.
-        # @!attribute [rw] encoding_type
-        #   @return [Google::Cloud::Language::V1::EncodingType]
-        #     The encoding type used by the API to calculate sentence offsets.
-        class AnalyzeSentimentRequest; end
-
-        # The sentiment analysis response message.
-        # @!attribute [rw] document_sentiment
-        #   @return [Google::Cloud::Language::V1::Sentiment]
-        #     The overall sentiment of the input document.
-        # @!attribute [rw] language
-        #   @return [String]
-        #     The language of the text, which will be the same as the language specified
-        #     in the request or, if not specified, the automatically-detected language.
-        #     See {Google::Cloud::Language::V1::Document#language Document#language} field for more details.
-        # @!attribute [rw] sentences
-        #   @return [Array<Google::Cloud::Language::V1::Sentence>]
-        #     The sentiment for all the sentences in the document.
-        class AnalyzeSentimentResponse; end
-
-        # The entity-level sentiment analysis request message.
-        # @!attribute [rw] document
-        #   @return [Google::Cloud::Language::V1::Document]
-        #     Input document.
-        # @!attribute [rw] encoding_type
-        #   @return [Google::Cloud::Language::V1::EncodingType]
-        #     The encoding type used by the API to calculate offsets.
-        class AnalyzeEntitySentimentRequest; end
-
-        # The entity-level sentiment analysis response message.
-        # @!attribute [rw] entities
-        #   @return [Array<Google::Cloud::Language::V1::Entity>]
-        #     The recognized entities in the input document with associated sentiments.
-        # @!attribute [rw] language
-        #   @return [String]
-        #     The language of the text, which will be the same as the language specified
-        #     in the request or, if not specified, the automatically-detected language.
-        #     See {Google::Cloud::Language::V1::Document#language Document#language} field for more details.
-        class AnalyzeEntitySentimentResponse; end
-
-        # The entity analysis request message.
-        # @!attribute [rw] document
-        #   @return [Google::Cloud::Language::V1::Document]
-        #     Input document.
-        # @!attribute [rw] encoding_type
-        #   @return [Google::Cloud::Language::V1::EncodingType]
-        #     The encoding type used by the API to calculate offsets.
-        class AnalyzeEntitiesRequest; end
-
-        # The entity analysis response message.
-        # @!attribute [rw] entities
-        #   @return [Array<Google::Cloud::Language::V1::Entity>]
-        #     The recognized entities in the input document.
-        # @!attribute [rw] language
-        #   @return [String]
-        #     The language of the text, which will be the same as the language specified
-        #     in the request or, if not specified, the automatically-detected language.
-        #     See {Google::Cloud::Language::V1::Document#language Document#language} field for more details.
-        class AnalyzeEntitiesResponse; end
-
-        # The syntax analysis request message.
-        # @!attribute [rw] document
-        #   @return [Google::Cloud::Language::V1::Document]
-        #     Input document.
-        # @!attribute [rw] encoding_type
-        #   @return [Google::Cloud::Language::V1::EncodingType]
-        #     The encoding type used by the API to calculate offsets.
-        class AnalyzeSyntaxRequest; end
-
-        # The syntax analysis response message.
-        # @!attribute [rw] sentences
-        #   @return [Array<Google::Cloud::Language::V1::Sentence>]
-        #     Sentences in the input document.
-        # @!attribute [rw] tokens
-        #   @return [Array<Google::Cloud::Language::V1::Token>]
-        #     Tokens, along with their syntactic information, in the input document.
-        # @!attribute [rw] language
-        #   @return [String]
-        #     The language of the text, which will be the same as the language specified
-        #     in the request or, if not specified, the automatically-detected language.
-        #     See {Google::Cloud::Language::V1::Document#language Document#language} field for more details.
-        class AnalyzeSyntaxResponse; end
-
-        # The document classification request message.
-        # @!attribute [rw] document
-        #   @return [Google::Cloud::Language::V1::Document]
-        #     Input document.
-        class ClassifyTextRequest; end
-
-        # The document classification response message.
-        # @!attribute [rw] categories
-        #   @return [Array<Google::Cloud::Language::V1::ClassificationCategory>]
-        #     Categories representing the input document.
-        class ClassifyTextResponse; end
-
-        # The request message for the text annotation API, which can perform multiple
-        # analysis types (sentiment, entities, and syntax) in one call.
-        # @!attribute [rw] document
-        #   @return [Google::Cloud::Language::V1::Document]
-        #     Input document.
-        # @!attribute [rw] features
-        #   @return [Google::Cloud::Language::V1::AnnotateTextRequest::Features]
-        #     The enabled features.
-        # @!attribute [rw] encoding_type
-        #   @return [Google::Cloud::Language::V1::EncodingType]
-        #     The encoding type used by the API to calculate offsets.
-        class AnnotateTextRequest
-          # All available features for sentiment, syntax, and semantic analysis.
-          # Setting each one to true will enable that specific analysis for the input.
-          # @!attribute [rw] extract_syntax
-          #   @return [true, false]
-          #     Extract syntax information.
-          # @!attribute [rw] extract_entities
-          #   @return [true, false]
-          #     Extract entities.
-          # @!attribute [rw] extract_document_sentiment
-          #   @return [true, false]
-          #     Extract document-level sentiment.
-          # @!attribute [rw] extract_entity_sentiment
-          #   @return [true, false]
-          #     Extract entities and their associated sentiment.
-          # @!attribute [rw] classify_text
-          #   @return [true, false]
-          #     Classify the full document into categories.
-          class Features; end
-        end
-
-        # The text annotations response message.
-        # @!attribute [rw] sentences
-        #   @return [Array<Google::Cloud::Language::V1::Sentence>]
-        #     Sentences in the input document. Populated if the user enables
-        #     {Google::Cloud::Language::V1::AnnotateTextRequest::Features#extract_syntax AnnotateTextRequest::Features#extract_syntax}.
-        # @!attribute [rw] tokens
-        #   @return [Array<Google::Cloud::Language::V1::Token>]
-        #     Tokens, along with their syntactic information, in the input document.
-        #     Populated if the user enables
-        #     {Google::Cloud::Language::V1::AnnotateTextRequest::Features#extract_syntax AnnotateTextRequest::Features#extract_syntax}.
-        # @!attribute [rw] entities
-        #   @return [Array<Google::Cloud::Language::V1::Entity>]
-        #     Entities, along with their semantic information, in the input document.
-        #     Populated if the user enables
-        #     {Google::Cloud::Language::V1::AnnotateTextRequest::Features#extract_entities AnnotateTextRequest::Features#extract_entities}.
-        # @!attribute [rw] document_sentiment
-        #   @return [Google::Cloud::Language::V1::Sentiment]
-        #     The overall sentiment for the document. Populated if the user enables
-        #     {Google::Cloud::Language::V1::AnnotateTextRequest::Features#extract_document_sentiment AnnotateTextRequest::Features#extract_document_sentiment}.
-        # @!attribute [rw] language
-        #   @return [String]
-        #     The language of the text, which will be the same as the language specified
-        #     in the request or, if not specified, the automatically-detected language.
-        #     See {Google::Cloud::Language::V1::Document#language Document#language} field for more details.
-        # @!attribute [rw] categories
-        #   @return [Array<Google::Cloud::Language::V1::ClassificationCategory>]
-        #     Categories identified in the input document.
-        class AnnotateTextResponse; end
-
-        # Represents the text encoding that the caller uses to process the output.
-        # Providing an `EncodingType` is recommended because the API provides the
-        # beginning offsets for various outputs, such as tokens and mentions, and
-        # languages that natively use different text encodings may access offsets
-        # differently.
-        module EncodingType
-          # If `EncodingType` is not specified, encoding-dependent information (such as
-          # `begin_offset`) will be set at `-1`.
-          NONE = 0
-
-          # Encoding-dependent information (such as `begin_offset`) is calculated based
-          # on the UTF-8 encoding of the input. C++ and Go are examples of languages
-          # that use this encoding natively.
-          UTF8 = 1
-
-          # Encoding-dependent information (such as `begin_offset`) is calculated based
-          # on the UTF-16 encoding of the input. Java and JavaScript are examples of
-          # languages that use this encoding natively.
-          UTF16 = 2
-
-          # Encoding-dependent information (such as `begin_offset`) is calculated based
-          # on the UTF-32 encoding of the input. Python is an example of a language
-          # that uses this encoding natively.
-          UTF32 = 3
-        end
-      end
-    end
-  end
-end