aws-crt 0.1.1.pre-x64-mingw32 → 0.1.6-x64-mingw32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf2b6d0d49226485190fa278952197681c03748305967d159ce159445554de51
-  data.tar.gz: dc9cc8aab116560f7492e889aed4c40269b4a7814efab34ee71339a92208350c
+  metadata.gz: 31132df91573dcd6e8bcbcc3b80ce3756ae1b49a74de0744fdb51715781d3d64
+  data.tar.gz: 54af56c674d3fc38e0c4a37701d08c0837ee4add13fe01d8ca67b4b7b3994d9c
 SHA512:
-  metadata.gz: 623d0bd571f31c092adb1bcc6769211e23efc1827e9e7c4acfa2b85c3bc6c5c42a8f0407a79ae085f3950bc88527cfc83d4f0aba66099c2bb1c72280bcccf23e
-  data.tar.gz: 6bd3886f2877998154909459279b5d09d86af4c618633cd085a7b0ed502b70a197f954933bb2894365e67ac0e6984c268dc3253fa55df2134db5d66ed09fd097
+  metadata.gz: bf4b64bdc3a8d338100e082527bf4733fea449c4976d9830c737ec27ea2eec8d263908b1ec7d662c99f532be980d0386cdef69de0957b8b410cf381202579b96
+  data.tar.gz: 482264bbd60922c3f3f233057a270a6c2c3acbcb4618a1f8f53f1b1594accf38b4bf59c4a87c362a3cb64ac9eb6907a696cf7ab63d246fd2a770e50022c377f3

data/CHANGELOG.md

@@ -0,0 +1,22 @@
+Unreleased Changes
+------------------
+
+0.1.6 (2022-08-12)
+------------------
+
+* Issue - Update to the latest aws-crt-ffi.
+
+0.1.5 (2022-04-05)
+------------------
+
+* Issue - Update to the latest aws-crt-ffi.
+
+0.1.4 (2022-03-15)
+------------------
+
+* Issue - Update the aws-lc submodule to a version that is not vulnerable to OpenSSL CVE-2022-0778 - Possible infinite loop in BN_mod_sqrt()
+
+0.1.0 (2021-08-04)
+------------------
+
+* Feature - Initial preview release of `aws-crt` gem.

data/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://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
+
+       http://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/VERSION

@@ -1 +1 @@
-0.1.1.pre
+0.1.6

data/lib/aws-crt/auth/credentials.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Aws
+  module Crt
+    module Auth
+      # CRT CredentialOptions
+      class CredentialsOptions
+        include Aws::Crt::ManagedNative
+        native_destroy Aws::Crt::Native.method(:credentials_options_release)
+
+        UINT64_MAX = 18_446_744_073_709_551_615
+
+        # @param [String] access_key_id
+        # @param [String] secret_access_key
+        # @param [String] session_token (nil)
+        # @param [Time|int] expiration (nil) - Either a Time or an int
+        #   seconds since unix epoch
+        def initialize(access_key_id, secret_access_key,
+                       session_token = nil, expiration = nil)
+          if !access_key_id || access_key_id.empty?
+            raise ArgumentError, 'access_key_id  must be set'
+          end
+
+          if !secret_access_key || secret_access_key.empty?
+            raise ArgumentError, 'secret_access_key  must be set'
+          end
+
+          manage_native do
+            Aws::Crt::Native.credentials_options_new
+          end
+
+          Aws::Crt::Native.credentials_options_set_access_key_id(
+            native, access_key_id, access_key_id.length
+          )
+
+          Aws::Crt::Native.credentials_options_set_secret_access_key(
+            native, secret_access_key, secret_access_key.length
+          )
+
+          if session_token && !session_token.empty?
+            Aws::Crt::Native.credentials_options_set_session_token(
+              native, session_token, session_token.length
+            )
+          end
+
+          Aws::Crt::Native.credentials_options_set_expiration_timepoint_seconds(
+            native, expiration&.to_i || UINT64_MAX
+          )
+        end
+      end
+
+      # Utility class for Credentials.
+      class Credentials
+        include Aws::Crt::ManagedNative
+        native_destroy Aws::Crt::Native.method(:credentials_release)
+
+        # @param [String] access_key_id
+        # @param [String] secret_access_key
+        # @param [String] session_token (nil)
+        # @param [Time|int] expiration (nil) - Either a Time or an int
+        #   seconds since unix epoch
+        def initialize(access_key_id, secret_access_key,
+                       session_token = nil, expiration = nil)
+
+          credential_options = CredentialsOptions.new(
+            access_key_id, secret_access_key,
+            session_token, expiration
+          )
+          manage_native do
+            Aws::Crt::Native.credentials_new(
+              credential_options.native
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/aws-crt/auth/signable.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Aws
+  module Crt
+    module Auth
+      # Signing Config
+      class Signable
+        include Aws::Crt::ManagedNative
+        native_destroy Aws::Crt::Native.method(:signable_release)
+
+        # @param [Http::Message] http_request
+        def initialize(http_request)
+          manage_native do
+            Aws::Crt::Native.signable_new_from_http_request(http_request.native)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/aws-crt/auth/signer.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Aws
+  module Crt
+    # High level Ruby abstractions for CRT Auth functionality
+    module Auth
+      # Ruby interface to CRT signing functions
+      module Signer
+        # Sign a request
+        # @param [SigningConfig] - SigningConfig to apply to this signature
+        # @param [Signable] - Signable object (request) to sign.
+        #
+        # @return [Hash] Return a hash with keys:
+        #   * signature[String] - the computed signature
+        #   * headers[Hash] - signed headers, including the `Authorization`
+        #      header.
+        def self.sign_request(
+          signing_config, signable, method = 'default', path = 'default'
+        )
+          out = {}
+          callback = proc do |result, status, _userdata|
+            Aws::Crt::Errors.raise_last_error unless status.zero?
+            http_request = Http::Message.new(method, path)
+            Aws::Crt::Native.signing_result_apply_to_http_request(
+              result,
+              http_request.native
+            )
+            out[:path] = http_request.path
+            out[:headers] = http_request.headers
+            if (auth = out[:headers]['Authorization']) &&
+               (match = /Signature=([a-f0-9]+)/.match(auth))
+              out[:signature] = match[1]
+            end
+            out[:http_request] = http_request
+
+            nil
+          end
+
+          # Currently this will always be synchronous
+          # (because we are resolving credentials) - so do not need to
+          # sync threads/callbacks
+          Aws::Crt::Native.sign_request_aws(
+            signable.native, signing_config.native, callback, nil
+          )
+          out
+        end
+      end
+    end
+  end
+end

data/lib/aws-crt/auth/signing_config.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require 'time'
+
+module Aws
+  module Crt
+    module Auth
+      # Signing Config
+      class SigningConfig
+        include Aws::Crt::ManagedNative
+        native_destroy Aws::Crt::Native.method(:signing_config_aws_release)
+
+        # @param [Hash] options
+        # @option options [required, Aws::Crt::Native::signing_algorithm]
+        #   :algorithm
+        # @option options [required, Aws::Crt::Native::signature_type]
+        #   :signature_type
+        # @option options [required, Credentials] :credentials
+        # @option options [required, String] :region
+        # @option options [required, String] :service
+        # @option options [Time] :date (Time.now)
+        # @option options [Array<String>]
+        #   :unsigned_headers ([])
+        # @option options [Boolean] :use_double_uri_encode (false)
+        # @option options [Boolean] :should_normalize_uri_path (false)
+        # @option options [Boolean] :omit_session_token (false)
+
+        # @option options [Boolean] :signed_body_header_type
+        #   (:sbht_content_sha256) -
+        #   Controls if signing adds a header containing the
+        #   canonical request's body value
+        # @option options [String] :signed_body_value - Optional string to use
+        #   as the canonical request's body value. If string is empty, a value
+        #   will be calculated from the payload during signing. Typically,
+        #   this is the SHA-256 of the (request/chunk/event) payload,
+        #   written as lowercase hex. If this has been precalculated, it can
+        #   be set here. Special values used by certain services can also
+        #   be set (e.g. "UNSIGNED-PAYLOAD"
+        #   "STREAMING-AWS4-HMAC-SHA256-PAYLOAD"
+        #   "STREAMING-AWS4-HMAC-SHA256-EVENTS").
+        # @option options[Integer] :expiration_in_seconds (0) -
+        #   If non-zero and the
+        #   signing transform is query param, then signing will add
+        #   X-Amz-Expires to the query string, equal to the value
+        #   specified here.  If this value is zero or if header signing
+        #   is being used then this parameter has no effect.
+        def initialize(options = {})
+          # validation of parameters is handled in signing_config_new
+
+          # create a callback function for aws_should_sign_header_fn
+          @sign_header_fn = extract_unsigned_header_fn(
+            options[:unsigned_headers]
+          )
+
+          signed_body_header_type = options.fetch(
+            :signed_body_header_type,
+            :sbht_content_sha256
+          )
+
+          # ensure we retain a reference to the credentials to avoid GC
+          @credentials = options[:credentials]
+          manage_native do
+            Aws::Crt::Native.signing_config_aws_new
+          end
+
+          Aws::Crt::Native.signing_config_aws_set_algorithm(native, options[:algorithm])
+          Aws::Crt::Native.signing_config_aws_set_signature_type(native, options[:signature_type])
+          Aws::Crt::Native.signing_config_aws_set_region(native, options[:region], options[:region].length)
+          Aws::Crt::Native.signing_config_aws_set_service(native, options[:service], options[:service].length)
+          Aws::Crt::Native.signing_config_aws_set_date(native, extract_date(options))
+          Aws::Crt::Native.signing_config_aws_set_credentials_provider(native, @credentials&.native)
+          Aws::Crt::Native.signing_config_aws_set_signed_body_header_type(native, signed_body_header_type)
+          if @sign_header_fn
+            Aws::Crt::Native.signing_config_aws_set_should_sign_header_fn(native, @sign_header_fn)
+          end
+
+          assign_body_value(options)
+          assign_flags(options)
+
+          validate_config!
+        end
+
+        private
+
+        def extract_date(options)
+          (options[:date] || Time.now).to_i
+        end
+
+        def extract_unsigned_header_fn(unsigned_headers)
+          return nil unless unsigned_headers&.size&.positive?
+
+          unsigned_headers = Set.new(unsigned_headers.map(&:downcase))
+          proc do |param_ptr, len, _p|
+            param = param_ptr.read_string(len)
+            !unsigned_headers.include? param.to_s.downcase
+          end
+        end
+
+        def assign_flags(options)
+          Aws::Crt::Native.signing_config_aws_set_use_double_uri_encode(native, options.fetch(:use_double_uri_encode, false))
+          Aws::Crt::Native.signing_config_aws_set_should_normalize_uri_path(native, options.fetch(:should_normalize_uri_path, false))
+          Aws::Crt::Native.signing_config_aws_set_omit_session_token(native, options.fetch(:omit_session_token, false))
+          Aws::Crt::Native.signing_config_aws_set_expiration_in_seconds(native, options.fetch(:expiration_in_seconds, 0))
+        end
+
+        def assign_body_value(options)
+          if options[:signed_body_value]
+            Aws::Crt::Native.signing_config_aws_set_signed_body_value(native, options[:signed_body_value], options[:signed_body_value].length)
+          end
+        end
+
+        def validate_config!
+          unless Aws::Crt::Native.signing_config_aws_validate(native)
+            # validate returns a boolean rather than int to indicate status
+            # but still sets the exception
+            Errors.raise_last_error
+          end
+        end
+      end
+    end
+  end
+end

data/lib/aws-crt/auth/static_credentials_provider.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Aws
+  module Crt
+    module Auth
+      # CRT CredentialOptions
+      class StaticCredentialsProviderOptions
+        include Aws::Crt::ManagedNative
+        native_destroy Aws::Crt::Native.method(:credentials_provider_static_options_release)
+
+        # @param [String] access_key_id
+        # @param [String] secret_access_key
+        # @param [String] session_token (nil)
+        def initialize(access_key_id, secret_access_key,
+                       session_token = nil)
+          if !access_key_id || access_key_id.empty?
+            raise ArgumentError, 'access_key_id  must be set'
+          end
+
+          if !secret_access_key || secret_access_key.empty?
+            raise ArgumentError, 'secret_access_key  must be set'
+          end
+
+          manage_native do
+            Aws::Crt::Native.credentials_provider_static_options_new
+          end
+
+          Aws::Crt::Native.credentials_provider_static_options_set_access_key_id(
+            native, access_key_id, access_key_id.length
+          )
+
+          Aws::Crt::Native.credentials_provider_static_options_set_secret_access_key(
+            native, secret_access_key, secret_access_key.length
+          )
+
+          if session_token && !session_token.empty?
+            Aws::Crt::Native.credentials_provider_static_options_set_session_token(
+              native, session_token, session_token.length
+            )
+          end
+        end
+      end
+
+      # Utility class for Credentials.
+      class StaticCredentialsProvider
+        include Aws::Crt::ManagedNative
+        native_destroy Aws::Crt::Native.method(:credentials_provider_release)
+
+        # @param [String] access_key_id
+        # @param [String] secret_access_key
+        # @param [String] session_token (nil)
+        def initialize(access_key_id, secret_access_key,
+                       session_token = nil)
+
+          credential_options = StaticCredentialsProviderOptions.new(
+            access_key_id, secret_access_key,
+            session_token
+          )
+          manage_native do
+            Aws::Crt::Native.credentials_provider_static_new(
+              credential_options.native
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/aws-crt/checksums/crc.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Aws
+  module Crt
+    # High level Ruby abstractions for CRT Checksums functionality
+    module Checksums
+      def self.crc32(str, previous = 0)
+        Aws::Crt::Native.crc32(
+          FFI::MemoryPointer.from_string(str),
+          str.size,
+          previous
+        )
+      end
+
+      def self.crc32c(str, previous = 0)
+        Aws::Crt::Native.crc32c(
+          FFI::MemoryPointer.from_string(str),
+          str.size,
+          previous
+        )
+      end
+    end
+  end
+end

data/lib/aws-crt/http/headers.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Aws
+  module Crt
+    # High level Ruby abstractions for CRT HTTP functionality
+    module Http
+      # HTTP Headers
+      class Headers
+        include Aws::Crt::ManagedNative
+        native_destroy Aws::Crt::Native.method(
+          :http_headers_release
+        )
+
+        def initialize(headers = {})
+          blob = StringBlob.encode(headers.flatten)
+          blob_ptr = FFI::MemoryPointer.new(:char, blob.length)
+          blob_ptr.write_array_of_char(blob)
+
+          manage_native do
+            Aws::Crt::Native.http_headers_new_from_blob(blob_ptr, blob.length)
+          end
+        end
+
+        def to_blob_strings
+          buf_out = Aws::Crt::Native::CrtBuf.new
+          Aws::Crt::Native.http_headers_to_blob(native, buf_out)
+          StringBlob.decode(buf_out.to_blob)
+        end
+      end
+    end
+  end
+end

data/lib/aws-crt/http/message.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Aws
+  module Crt
+    # High level Ruby abstractions for CRT HTTP functionality
+    module Http
+      # HTTP Message (request)
+      class Message
+        include Aws::Crt::ManagedNative
+        native_destroy Aws::Crt::Native.method(
+          :http_message_release
+        )
+
+        def initialize(method, path, headers = {})
+          strings = [method, path] +
+                    headers.flatten
+          blob = StringBlob.encode(strings)
+          blob_ptr = FFI::MemoryPointer.new(:char, blob.length)
+          blob_ptr.write_array_of_char(blob)
+
+          manage_native do
+            Aws::Crt::Native.http_message_new_from_blob(blob_ptr, blob.length)
+          end
+        end
+
+        def to_blob_strings
+          buf_out = Aws::Crt::Native::CrtBuf.new
+          Aws::Crt::Native.http_message_to_blob(native, buf_out)
+          StringBlob.decode(buf_out.to_blob)
+        end
+
+        def headers
+          blob_strings = to_blob_strings
+          # blob_strings must have at least 2 element and must have
+          # pairs of header/values
+          if blob_strings.length < 2 ||
+             blob_strings.length.odd?
+            raise Aws::Crt::Errors::Error,
+                  'Invalid blob_string for HTTP Message'
+          end
+          blob_strings[2..blob_strings.length].each_slice(2).to_h
+        end
+
+        def method
+          to_blob_strings[0]
+        end
+
+        def path
+          to_blob_strings[1]
+        end
+      end
+    end
+  end
+end

data/lib/aws-crt/{io.rb → io/event_loop_group.rb}

@@ -4,13 +4,12 @@ module Aws
   module Crt
     # High level Ruby abstractions for CRT IO functionality
     module IO
-      # A collection of event-loops.
-      # An event-loop is a thread for doing async work, such as I/O.
-      # Classes that need to do async work will ask the EventLoopGroup
-      # for an event-loop to use.
-      class EventLoopGroup
+      # Options for an EventLoopGroup
+      class EventLoopGroupOptions
         include Aws::Crt::ManagedNative
-        native_destroy Aws::Crt::Native.method(:event_loop_group_release)
+        native_destroy Aws::Crt::Native.method(
+          :event_loop_group_options_release
+        )
 
         def initialize(max_threads = nil)
           unless max_threads.nil? ||
@@ -22,8 +21,29 @@ module Aws
           max_threads = 0 if max_threads.nil?
 
           manage_native do
-            Aws::Crt::Native.event_loop_group_new(max_threads)
+            Aws::Crt::Native.event_loop_group_options_new
+          end
+
+          Aws::Crt::Native.event_loop_group_options_set_max_threads(@native,
+                                                                    max_threads)
+        end
+      end
+
+      # A collection of event-loops.
+      # An event-loop is a thread for doing async work, such as I/O.
+      # Classes that need to do async work will ask the EventLoopGroup
+      # for an event-loop to use.
+      class EventLoopGroup
+        include Aws::Crt::ManagedNative
+        native_destroy Aws::Crt::Native.method(:event_loop_group_release)
+
+        def initialize(max_threads = nil)
+          @options = EventLoopGroupOptions.new(max_threads)
+
+          manage_native do
+            Aws::Crt::Native.event_loop_group_new(@options.native)
           end
+          Aws::Crt::Native.event_loop_group_acquire(@native)
         end
       end
     end

data/lib/aws-crt/native.rb

@@ -7,17 +7,18 @@ module Aws
     module Native
       extend FFI::Library
 
-      ffi_lib [crt_bin_path(local_platform), 'libaws-crt']
+      ffi_lib [crt_bin_path(local_platform), 'libaws-crt-ffi']
 
-      # aws_byte_cursor binding
-      class ByteCursor < FFI::Struct
-        layout :len, :size_t,
-               :ptr, :pointer
+      # Warning, when used as an output structure
+      # the memory in ptr needs to be manually destructed!
+      class CrtBuf < FFI::Struct
+        layout :ptr, :pointer,
+               :len, :size_t
 
-        def to_s
+        def to_blob
           return unless (self[:len]).positive? && !(self[:ptr]).null?
 
-          self[:ptr].read_string(self[:len])
+          self[:ptr].read_array_of_char(self[:len])
         end
       end
 
@@ -107,53 +108,115 @@ module Aws
 
       # Core API
       attach_function :aws_crt_init, [], :void, raise: false
+      attach_function :aws_crt_clean_up, [], :void
       attach_function :aws_crt_last_error, [], :int, raise: false
       attach_function :aws_crt_error_str, [:int], :string, raise: false
       attach_function :aws_crt_error_name, [:int], :string, raise: false
       attach_function :aws_crt_error_debug_str, [:int], :string, raise: false
       attach_function :aws_crt_reset_error, [], :void, raise: false
+      attach_function :aws_crt_thread_join_all, [:uint64], :int
+
+      # Core Memory Management
+      attach_function :aws_crt_mem_release, [:pointer], :void, raise: false
+      attach_function :aws_crt_mem_bytes, [], :uint64, raise: false
+      attach_function :aws_crt_mem_count, [], :uint64, raise: false
+      attach_function :aws_crt_mem_dump, [], :void, raise: false
 
-      attach_function :aws_crt_thread_join_all_managed, [], :int
+      typedef :pointer, :blob
 
       # IO API
-      attach_function :aws_crt_event_loop_group_new, [:uint16], :pointer
-      attach_function :aws_crt_event_loop_group_release, [:pointer], :void
+      typedef :pointer, :event_loop_group_options_ptr
+      attach_function :aws_crt_event_loop_group_options_new, [], :event_loop_group_options_ptr
+      attach_function :aws_crt_event_loop_group_options_release, [:event_loop_group_options_ptr], :void
+      attach_function :aws_crt_event_loop_group_options_set_max_threads, %i[event_loop_group_options_ptr uint16], :void
+
+      typedef :pointer, :event_loop_group_ptr
+      attach_function :aws_crt_event_loop_group_new, [:event_loop_group_options_ptr], :pointer
+      attach_function :aws_crt_event_loop_group_acquire, [:event_loop_group_ptr], :event_loop_group_ptr
+      attach_function :aws_crt_event_loop_group_release, [:event_loop_group_ptr], :void
+
+      # HTTP API
+      typedef :pointer, :headers_ptr
+      attach_function :aws_crt_http_headers_new_from_blob, %i[blob size_t], :headers_ptr
+      attach_function :aws_crt_http_headers_to_blob, [:headers_ptr, CrtBuf], :void
+      attach_function :aws_crt_http_headers_release, [:headers_ptr], :void
+
+      typedef :pointer, :http_message_ptr
+      attach_function :aws_crt_http_message_new_from_blob, %i[blob size_t], :http_message_ptr
+      attach_function :aws_crt_http_message_to_blob, [:http_message_ptr, CrtBuf], :void
+      attach_function :aws_crt_http_message_release, [:http_message_ptr], :void
 
       # Auth API
-      attach_function :aws_crt_credentials_new, %i[string string string uint64], :pointer
-      attach_function :aws_crt_credentials_release, [:pointer], :void
-      attach_function :aws_crt_credentials_get_access_key_id, [:pointer], ByteCursor.by_value
-      attach_function :aws_crt_credentials_get_secret_access_key, [:pointer], ByteCursor.by_value
-      attach_function :aws_crt_credentials_get_session_token, [:pointer], ByteCursor.by_value
-      attach_function :aws_crt_credentials_get_expiration_timepoint_seconds, [:pointer], :uint64
+      typedef :pointer, :credentials_options_ptr
+      attach_function :aws_crt_credentials_options_new, [], :credentials_options_ptr
+      attach_function :aws_crt_credentials_options_release, [:credentials_options_ptr], :void
+      attach_function :aws_crt_credentials_options_set_access_key_id, %i[credentials_options_ptr string size_t], :void
+      attach_function :aws_crt_credentials_options_set_secret_access_key, %i[credentials_options_ptr string size_t], :void
+      attach_function :aws_crt_credentials_options_set_session_token, %i[credentials_options_ptr string size_t], :void
+      attach_function :aws_crt_credentials_options_set_expiration_timepoint_seconds, %i[credentials_options_ptr uint64], :void
+
+      typedef :pointer, :credentials_ptr
+      attach_function :aws_crt_credentials_new, [:credentials_options_ptr], :credentials_ptr
+      attach_function :aws_crt_credentials_acquire, [:credentials_ptr], :credentials_ptr
+      attach_function :aws_crt_credentials_release, [:credentials_ptr], :void
+
+      typedef :pointer, :credentials_provider_ptr
+      attach_function :aws_crt_credentials_provider_acquire, [:credentials_provider_ptr], :credentials_provider_ptr
+      attach_function :aws_crt_credentials_provider_release, [:credentials_provider_ptr], :void
+
+      typedef :pointer, :static_cred_provider_options_ptr
+      attach_function :aws_crt_credentials_provider_static_options_new, [], :static_cred_provider_options_ptr
+      attach_function :aws_crt_credentials_provider_static_options_release, [:static_cred_provider_options_ptr], :void
+      attach_function :aws_crt_credentials_provider_static_options_set_access_key_id, %i[static_cred_provider_options_ptr string size_t], :void
+      attach_function :aws_crt_credentials_provider_static_options_set_secret_access_key, %i[static_cred_provider_options_ptr string size_t], :void
+      attach_function :aws_crt_credentials_provider_static_options_set_session_token, %i[static_cred_provider_options_ptr string size_t], :void
+
+      attach_function :aws_crt_credentials_provider_static_new, [:static_cred_provider_options_ptr], :credentials_provider_ptr
 
       enum :signing_algorithm, %i[sigv4 sigv4a]
-      enum :signature_type, %i[http_request_headers http_request_query_params
-                               http_request_chunk http_request_event]
+      enum :signature_type, %i[
+        http_request_headers http_request_query_params
+        http_request_chunk http_request_event
+        canonical_request_headers canonical_request_query_params
+      ]
       enum :signed_body_header_type, %i[sbht_none sbht_content_sha256]
-      callback :should_sign_header_fn, [ByteCursor.by_ref, :pointer], :bool
-      attach_function :aws_crt_signing_config_new, %i[signing_algorithm signature_type string string string uint64 pointer signed_body_header_type should_sign_header_fn bool bool bool uint64], :pointer
-      attach_function :aws_crt_signing_config_release, [:pointer], :void
-      attach_function :aws_crt_signing_config_is_signing_synchronous, [:pointer], :bool, raise: false
-
-      attach_function :aws_crt_signable_new, [], :pointer
-      attach_function :aws_crt_signable_release, [:pointer], :void
-      attach_function :aws_crt_signable_set_property, %i[pointer string string], :int
-      attach_function :aws_crt_signable_get_property, %i[pointer string], :string, raise: false
-      attach_function :aws_crt_signable_append_property_list, %i[pointer string string string], :int
-      attach_function :aws_crt_signable_set_property_list, %i[pointer string size_t pointer pointer], :int
-
-      callback :signing_complete_fn, %i[pointer int pointer], :void
-      attach_function :aws_crt_sign_request_synchronous, %i[pointer pointer signing_complete_fn], :int
-      attach_function :aws_crt_verify_sigv4a_signing, %i[pointer pointer string string string string], :int
-
-      attach_function :aws_crt_signing_result_get_property, %i[pointer string], :string, raise: false
-      attach_function :aws_crt_signing_result_get_property_list, %i[pointer string], PropertyList.by_ref, raise: false
-      attach_function :aws_crt_property_list_release, %i[pointer], :void
+
+      typedef :pointer, :signing_config_ptr
+      callback :should_sign_header_fn, %i[pointer size_t pointer], :bool
+      attach_function :aws_crt_signing_config_aws_new, [], :signing_config_ptr
+      attach_function :aws_crt_signing_config_aws_release, [:signing_config_ptr], :void
+      attach_function :aws_crt_signing_config_aws_validate, [:signing_config_ptr], :bool
+      attach_function :aws_crt_signing_config_aws_set_algorithm, %i[signing_config_ptr signing_algorithm], :void
+      attach_function :aws_crt_signing_config_aws_set_signature_type, %i[signing_config_ptr signature_type], :void
+      attach_function :aws_crt_signing_config_aws_set_credentials_provider, %i[signing_config_ptr credentials_provider_ptr], :void
+      attach_function :aws_crt_signing_config_aws_set_region, %i[signing_config_ptr string size_t], :void
+      attach_function :aws_crt_signing_config_aws_set_service, %i[signing_config_ptr string size_t], :void
+      attach_function :aws_crt_signing_config_aws_set_use_double_uri_encode, %i[signing_config_ptr bool], :void
+      attach_function :aws_crt_signing_config_aws_set_should_normalize_uri_path, %i[signing_config_ptr bool], :void
+      attach_function :aws_crt_signing_config_aws_set_omit_session_token, %i[signing_config_ptr bool], :void
+      attach_function :aws_crt_signing_config_aws_set_signed_body_value, %i[signing_config_ptr string size_t], :void
+      attach_function :aws_crt_signing_config_aws_set_signed_body_header_type, %i[signing_config_ptr signed_body_header_type], :void
+      attach_function :aws_crt_signing_config_aws_set_expiration_in_seconds, %i[signing_config_ptr uint64], :void
+      attach_function :aws_crt_signing_config_aws_set_date, %i[signing_config_ptr uint64], :void
+      attach_function :aws_crt_signing_config_aws_set_should_sign_header_fn, %i[signing_config_ptr should_sign_header_fn], :void
+
+      typedef :pointer, :signable_ptr
+      attach_function :aws_crt_signable_new_from_http_request, [:http_message_ptr], :signable_ptr
+      attach_function :aws_crt_signable_release, [:signable_ptr], :void
+
+      typedef :pointer, :user_data_ptr
+      typedef :pointer, :signing_result_ptr
+
+      callback :signing_complete_fn, %i[signing_result_ptr int user_data_ptr], :void
+      attach_function :aws_crt_sign_request_aws, %i[signable_ptr signing_config_ptr signing_complete_fn user_data_ptr], :int
+      attach_function :aws_crt_signing_result_apply_to_http_request, %i[signing_result_ptr http_message_ptr], :int
+
+      # Checksums
+      attach_function :aws_crt_crc32, %i[pointer size_t uint32], :uint32, raise: false
+      attach_function :aws_crt_crc32c, %i[pointer size_t uint32], :uint32, raise: false
 
       # Internal testing API
       attach_function :aws_crt_test_error, [:int], :int
-      attach_function :aws_crt_test_pointer_error, [], :pointer
     end
   end
 end

data/lib/aws-crt/platforms.rb

@@ -2,20 +2,24 @@
 
 # Maps OS name to crt binary name.
 OS_BINARIES = {
-  'darwin' => 'libaws-crt.dylib',
-  'linux' => 'libaws-crt.so',
-  'mingw32' => 'aws-crt.dll'
+  'darwin' => 'libaws-crt-ffi.dylib',
+  'linux' => 'libaws-crt-ffi.so',
+  'mingw32' => 'aws-crt-ffi.dll'
 }.freeze
 
-DEFAULT_BINARY = 'libaws-crt.so'
+DEFAULT_BINARY = 'libaws-crt-ffi.so'
 
-# @return [String] returns Gem::Platform style name for the current system
-# similar to Gem::Platform.local but will return systems host os/cpu
-# for Jruby
+# @return [Gem::Platform] similar to Gem::Platform.local but will return
+# host os/cpu for Jruby
 def local_platform
   Gem::Platform.new(host_string)
 end
 
+# @return [Gem::Platform] return Gem::Platform for host os with target cpu
+def target_platform(cpu)
+  Gem::Platform.new(target_string(cpu))
+end
+
 # @return [String] return the file name for the CRT library for the platform
 def crt_bin_name(platform)
   OS_BINARIES[platform.os] || DEFAULT_BINARY
@@ -31,9 +35,14 @@ def crt_bin_path(platform)
   File.expand_path(crt_bin_name(platform), crt_bin_dir(platform))
 end
 
-# @return [String] generate a string that be used with Gem::Platform
+# @return [String] generate a string that can be used with Gem::Platform
 def host_string
-  "#{host_cpu}-#{host_os}"
+  target_string(host_cpu)
+end
+
+# @return [String] generate a string that can be used with Gem::Platform
+def target_string(cpu)
+  "#{cpu}-#{host_os}"
 end
 
 # @return [String] host cpu, even on jruby

data/lib/aws-crt/string_blob.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'stringio'
+
+module Aws
+  module Crt
+    # module for CRT Blob utility methods
+    # CRT encodes lists of strings as [length, str*]
+    # using null padded, unsigned long
+    module StringBlob
+      # Encode an array of strings into
+      # a buffer (blob)
+      # @param strings [Array<String>]
+      # @return buffer (Array<char>)
+      def self.encode(strings)
+        buffer = StringIO.new
+        strings.each do |s|
+          e = s.to_s.unpack('c*')
+          buffer << [e.length].pack('N')
+          buffer << e.pack('c*')
+        end
+        buffer.string.unpack('c*')
+      end
+
+      # Decode a blob (StringBlob)/Buffer into
+      # an array of strings
+      # @param buffer - array of chars (buffer)
+      # @return strings
+      def self.decode(buffer)
+        strings = []
+        i = 0
+        while i < buffer.size
+          len = buffer[i, 4].pack('c*').unpack1('N')
+          strings << buffer[i + 4, len].pack('c*')
+                                       .force_encoding(Encoding::UTF_8)
+          i += len + 4
+        end
+        strings
+      end
+    end
+  end
+end

data/lib/aws-crt.rb

@@ -4,12 +4,25 @@ require_relative 'aws-crt/platforms'
 require_relative 'aws-crt/native'
 require_relative 'aws-crt/errors'
 require_relative 'aws-crt/managed_native'
-require_relative 'aws-crt/io'
+require_relative 'aws-crt/string_blob'
+
+require_relative 'aws-crt/io/event_loop_group'
+require_relative 'aws-crt/http/headers'
+require_relative 'aws-crt/http/message'
+
+require_relative 'aws-crt/auth/credentials'
+require_relative 'aws-crt/auth/static_credentials_provider'
+require_relative 'aws-crt/auth/signing_config'
+require_relative 'aws-crt/auth/signable'
+require_relative 'aws-crt/auth/signer'
+require_relative 'aws-crt/checksums/crc'
 
 # Top level Amazon Web Services (AWS) namespace
 module Aws
-  # Top level namespace for all common runtime (CRT) functionality
+  # Common runtime bindings
   module Crt
+    GEM_VERSION = File.read(File.expand_path('../VERSION', __dir__)).strip
+
     # Ensure native init() is called when gem loads
     Aws::Crt::Native.init
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-crt
 version: !ruby/object:Gem::Version
-  version: 0.1.1.pre
+  version: 0.1.6
 platform: x64-mingw32
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-08 00:00:00.000000000 Z
+date: 2022-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -44,18 +44,31 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- LICENSE.txt
 - VERSION
-- bin/x64/aws-crt.dll
+- bin/x64/aws-crt-ffi.dll
 - lib/aws-crt.rb
+- lib/aws-crt/auth/credentials.rb
+- lib/aws-crt/auth/signable.rb
+- lib/aws-crt/auth/signer.rb
+- lib/aws-crt/auth/signing_config.rb
+- lib/aws-crt/auth/static_credentials_provider.rb
+- lib/aws-crt/checksums/crc.rb
 - lib/aws-crt/errors.rb
-- lib/aws-crt/io.rb
+- lib/aws-crt/http/headers.rb
+- lib/aws-crt/http/message.rb
+- lib/aws-crt/io/event_loop_group.rb
 - lib/aws-crt/managed_native.rb
 - lib/aws-crt/native.rb
 - lib/aws-crt/platforms.rb
+- lib/aws-crt/string_blob.rb
 homepage: https://github.com/awslabs/aws-crt-ruby
 licenses:
 - Apache-2.0
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/awslabs/aws-crt-ruby/tree/main/gems/aws-crt
+  changelog_uri: https://github.com/awslabs/aws-crt-ruby/tree/main/gems/aws-crt/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -67,9 +80,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.1.6
 signing_key: