uplink-ruby 1.0.0

data/lib/uplink/uplink_util.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module Uplink
+  class UplinkUtil
+    class << self
+      def get_system_values(object)
+        return if object.null? || object[:system].null?
+
+        [object[:system][:created], object[:system][:expires], object[:system][:content_length]]
+      end
+
+      def get_custom_metadata(object)
+        custom = {}
+
+        return custom if object.null? || object[:custom].null?
+
+        count = object[:custom][:count]
+        mem_entries = object[:custom][:entries]
+
+        return custom if mem_entries.null?
+
+        count.times do |i|
+          entry = UplinkLib::UplinkCustomMetadataEntry.new(mem_entries + (i * UplinkLib::UplinkCustomMetadataEntry.size))
+          next if entry.null?
+
+          key = entry[:key].read_string
+          value = entry[:value].read_string
+          custom[key] = value
+        end
+
+        custom
+      end
+
+      def build_uplink_config(config)
+        raise ArgumentError, 'config argument is nil' if config.nil?
+
+        config_options = UplinkLib::UplinkConfig.new
+        user_agent = FFI::MemoryPointer.from_string(config[:user_agent]) if config[:user_agent]
+        temp_directory = FFI::MemoryPointer.from_string(config[:temp_directory]) if config[:temp_directory]
+        config_options[:user_agent] = user_agent
+        config_options[:dial_timeout_milliseconds] = config[:dial_timeout_milliseconds]&.to_i || 0
+        config_options[:temp_directory] = temp_directory
+
+        config_options
+      end
+
+      def build_upload_options(options)
+        upload_options = nil
+        if options && !options.empty?
+          upload_options = UplinkLib::UplinkUploadOptions.new
+          upload_options[:expires] = options[:expires].to_i if options[:expires]
+        end
+
+        upload_options
+      end
+
+      def build_custom_metadata(custom)
+        count = custom.size
+        mem_entries = FFI::MemoryPointer.new(UplinkLib::UplinkCustomMetadataEntry, count)
+
+        custom.to_a.each_with_index do |(key, value), i|
+          mem_key = FFI::MemoryPointer.from_string(key.to_s) if key
+          mem_value = FFI::MemoryPointer.from_string(value.to_s) if value
+
+          entry = UplinkLib::UplinkCustomMetadataEntry.new(mem_entries + (i * UplinkLib::UplinkCustomMetadataEntry.size))
+          entry[:key] = mem_key
+          entry[:key_length] = key ? key.length : 0
+          entry[:value] = mem_value
+          entry[:value_length] = value ? value.to_s.length : 0
+        end
+
+        custom_metadata = UplinkLib::UplinkCustomMetadata.new
+        custom_metadata[:count] = count
+        custom_metadata[:entries] = mem_entries
+
+        custom_metadata
+      end
+    end
+  end
+end

data/lib/uplink/upload.rb

@@ -0,0 +1,208 @@
+# frozen_string_literal: true
+
+module Uplink
+  class Upload
+    def initialize(upload_result)
+      @upload = upload_result[:upload]
+    end
+
+    def write(bytes, length)
+      raise ArgumentError, 'bytes argument is nil' if bytes.nil?
+
+      if bytes.is_a?(Array) && bytes.first.is_a?(Integer)
+        mem_bytes = FFI::MemoryPointer.new(:uint8, length)
+        mem_bytes.write_array_of_uint8(bytes)
+      else
+        mem_bytes = bytes
+      end
+
+      result = UplinkLib.uplink_upload_write(@upload, mem_bytes, length)
+      abort unless result[:error].null?
+      ErrorUtil.handle_result_error(result)
+
+      result[:bytes_written]
+    ensure
+      UplinkLib.uplink_free_write_result(result) if result
+    end
+
+    def set_custom_metadata(custom)
+      custom_metadata = UplinkUtil.build_custom_metadata(custom)
+
+      error = UplinkLib.uplink_upload_set_custom_metadata(@upload, custom_metadata)
+      ErrorUtil.handle_error(error)
+    ensure
+      UplinkLib.uplink_free_error(error) if error
+    end
+
+    def commit
+      error = UplinkLib.uplink_upload_commit(@upload)
+      ErrorUtil.handle_error(error)
+    ensure
+      UplinkLib.uplink_free_error(error) if error
+    end
+
+    def abort
+      error = UplinkLib.uplink_upload_abort(@upload)
+      ErrorUtil.handle_error(error)
+    ensure
+      UplinkLib.uplink_free_error(error) if error
+    end
+
+    def info
+      result = UplinkLib.uplink_upload_info(@upload)
+      ErrorUtil.handle_result_error(result)
+
+      Object.new(result)
+    ensure
+      UplinkLib.uplink_free_object_result(result) if result
+    end
+  end
+
+  class UploadInfo
+    attr_reader :upload_id, :key, :is_prefix, :created, :expires, :content_length, :custom
+
+    def initialize(upload_info_result, upload_info = nil)
+      init_attributes(upload_info_result.nil? || upload_info_result.null? ? upload_info : upload_info_result[:info])
+    end
+
+    private
+
+    def init_attributes(upload_info)
+      return if upload_info.nil? || upload_info.null?
+
+      @upload_id = upload_info[:upload_id]
+      @key = upload_info[:key]
+      @is_prefix = upload_info[:is_prefix]
+      @created, @expires, @content_length = UplinkUtil.get_system_values(upload_info)
+      @custom = UplinkUtil.get_custom_metadata(upload_info)
+    end
+  end
+
+  class PartUpload
+    def initialize(part_upload_result)
+      @part_upload = part_upload_result[:part_upload]
+    end
+
+    def write(bytes, length)
+      raise ArgumentError, 'bytes argument is nil' if bytes.nil?
+
+      if bytes.is_a?(Array) && bytes.first.is_a?(Integer)
+        mem_bytes = FFI::MemoryPointer.new(:uint8, length)
+        mem_bytes.write_array_of_uint8(bytes)
+      else
+        mem_bytes = bytes
+      end
+
+      result = UplinkLib.uplink_part_upload_write(@part_upload, mem_bytes, length)
+      abort unless result[:error].null?
+      ErrorUtil.handle_result_error(result)
+
+      result[:bytes_written]
+    ensure
+      UplinkLib.uplink_free_write_result(result) if result
+    end
+
+    def set_etag(etag)
+      error = UplinkLib.uplink_part_upload_set_etag(@part_upload, etag)
+      ErrorUtil.handle_error(error)
+    ensure
+      UplinkLib.uplink_free_error(error) if error
+    end
+
+    def commit
+      error = UplinkLib.uplink_part_upload_commit(@part_upload)
+      ErrorUtil.handle_error(error)
+    ensure
+      UplinkLib.uplink_free_error(error) if error
+    end
+
+    def abort
+      error = UplinkLib.uplink_part_upload_abort(@part_upload)
+      ErrorUtil.handle_error(error)
+    ensure
+      UplinkLib.uplink_free_error(error) if error
+    end
+
+    def info
+      result = UplinkLib.uplink_part_upload_info(@part_upload)
+      ErrorUtil.handle_result_error(result)
+
+      UploadPart.new(result)
+    ensure
+      UplinkLib.uplink_free_part_result(result) if result
+    end
+  end
+
+  class UploadPart
+    attr_reader :part_number, :size, :modified, :etag
+
+    def initialize(upload_part_result, upload_part = nil)
+      init_attributes(upload_part_result.nil? || upload_part_result.null? ? upload_part : upload_part_result[:part])
+    end
+
+    private
+
+    def init_attributes(part)
+      return if part.nil? || part.null?
+
+      @part_number = part[:part_number]
+      @size = part[:size]
+      @modified = part[:modified]
+      @etag = part[:etag]
+    end
+  end
+
+  class UploadIterator
+    def initialize(upload_iterator)
+      @upload_iterator = upload_iterator
+    end
+
+    def next?
+      has_next = UplinkLib.uplink_upload_iterator_next(@upload_iterator)
+      unless has_next
+        begin
+          error = UplinkLib.uplink_upload_iterator_err(@upload_iterator)
+          ErrorUtil.handle_error(error)
+        ensure
+          UplinkLib.uplink_free_error(error) if error
+        end
+      end
+
+      has_next
+    end
+
+    def item
+      upload_info = UplinkLib.uplink_upload_iterator_item(@upload_iterator)
+      UploadInfo.new(nil, upload_info)
+    ensure
+      UplinkLib.uplink_free_upload_info(upload_info) if upload_info
+    end
+  end
+
+  class UploadPartIterator
+    def initialize(upload_part_iterator)
+      @upload_part_iterator = upload_part_iterator
+    end
+
+    def next?
+      has_next = UplinkLib.uplink_part_iterator_next(@upload_part_iterator)
+      unless has_next
+        begin
+          error = UplinkLib.uplink_part_iterator_err(@upload_part_iterator)
+          ErrorUtil.handle_error(error)
+        ensure
+          UplinkLib.uplink_free_error(error) if error
+        end
+      end
+
+      has_next
+    end
+
+    def item
+      upload_part = UplinkLib.uplink_part_iterator_item(@upload_part_iterator)
+      UploadPart.new(nil, upload_part)
+    ensure
+      UplinkLib.uplink_free_part(upload_part) if upload_part
+    end
+  end
+end

data/lib/uplink.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'uplink_lib'
+require 'uplink/access'
+require 'uplink/bucket'
+require 'uplink/download'
+require 'uplink/edge_credential'
+require 'uplink/error_util'
+require 'uplink/object'
+require 'uplink/project'
+require 'uplink/storj_error'
+require 'uplink/uplink_util'
+require 'uplink/upload'
+
+module Uplink
+  class << self
+    def parse_access(access_string)
+      result = UplinkLib.uplink_parse_access(access_string)
+      ErrorUtil.handle_result_error(result)
+
+      yield Access.new(result)
+    ensure
+      UplinkLib.uplink_free_access_result(result) if result
+    end
+
+    def request_access_with_passphrase(satellite_address, api_key, passphrase)
+      result = UplinkLib.uplink_request_access_with_passphrase(satellite_address, api_key, passphrase)
+      ErrorUtil.handle_result_error(result)
+
+      yield Access.new(result)
+    ensure
+      UplinkLib.uplink_free_access_result(result) if result
+    end
+
+    def request_access_with_passphrase_and_config(config, satellite_address, api_key, passphrase)
+      config_options = UplinkUtil.build_uplink_config(config)
+
+      result = UplinkLib.uplink_config_request_access_with_passphrase(config_options, satellite_address, api_key, passphrase)
+      ErrorUtil.handle_result_error(result)
+
+      yield Access.new(result)
+    ensure
+      UplinkLib.uplink_free_access_result(result) if result
+    end
+
+    def derive_encryption_key(passphrase, salt, length)
+      raise ArgumentError, 'salt argument is not a string' unless salt.is_a?(String)
+
+      result = UplinkLib.uplink_derive_encryption_key(passphrase, salt, length)
+      ErrorUtil.handle_result_error(result)
+
+      yield result[:encryption_key]
+    ensure
+      UplinkLib.uplink_free_encryption_key_result(result) if result
+    end
+
+    def internal_universe_is_empty?
+      UplinkLib.uplink_internal_UniverseIsEmpty != 0
+    end
+  end
+end

data/lib/uplink_lib.rb

@@ -0,0 +1,345 @@
+# frozen_string_literal: true
+
+require 'ffi'
+
+module UplinkLib
+  extend FFI::Library
+
+  ffi_lib 'libuplink.so'
+
+  class UplinkHandle < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkAccess < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkProject < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkDownload < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkUpload < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkEncryptionKey < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkPartUpload < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkConfig < FFI::Struct
+    layout :user_agent, :pointer,    # string
+           :dial_timeout_milliseconds, :int32_t,
+           :temp_directory, :pointer # string
+  end
+
+  class UplinkBucket < FFI::Struct
+    layout :name, :string,
+           :created, :int64_t
+  end
+
+  class UplinkSystemMetadata < FFI::Struct
+    layout :created, :int64_t,
+           :expires, :int64_t,
+           :content_length, :int64_t
+  end
+
+  class UplinkCustomMetadataEntry < FFI::Struct
+    layout :key, :pointer,   # string
+           :key_length, :size_t,
+           :value, :pointer, # string
+           :value_length, :size_t
+  end
+
+  class UplinkCustomMetadata < FFI::Struct
+    layout :entries, :pointer, # array of UplinkCustomMetadataEntry
+           :count, :size_t
+  end
+
+  class UplinkObject < FFI::Struct
+    layout :key, :string,
+           :is_prefix, :bool,
+           :system, UplinkSystemMetadata.val,
+           :custom, UplinkCustomMetadata.val
+  end
+
+  class UplinkUploadOptions < FFI::Struct
+    layout :expires, :int64_t
+  end
+
+  class UplinkDownloadOptions < FFI::Struct
+    layout :offset, :int64_t,
+           :length, :int64_t
+  end
+
+  class UplinkListObjectsOptions < FFI::Struct
+    layout :prefix, :pointer, # string
+           :cursor, :pointer, # string
+           :recursive, :bool,
+           :system, :bool,
+           :custom, :bool
+  end
+
+  class UplinkListUploadsOptions < FFI::Struct
+    layout :prefix, :pointer, # string
+           :cursor, :pointer, # string
+           :recursive, :bool,
+           :system, :bool,
+           :custom, :bool
+  end
+
+  class UplinkListBucketsOptions < FFI::Struct
+    layout :cursor, :pointer # string
+  end
+
+  class UplinkObjectIterator < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkBucketIterator < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkUploadIterator < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkPartIterator < FFI::Struct
+    layout :_handle, :size_t
+  end
+
+  class UplinkPermission < FFI::Struct
+    layout :allow_download, :bool,
+           :allow_upload, :bool,
+           :allow_list, :bool,
+           :allow_delete, :bool,
+           :not_before, :int64_t,
+           :not_after, :int64_t
+  end
+
+  class UplinkPart < FFI::Struct
+    layout :part_number, :uint32_t,
+           :size, :size_t,
+           :modified, :int64_t,
+           :etag, :string,
+           :etag_length, :size_t
+  end
+
+  class UplinkSharePrefix < FFI::Struct
+    layout :bucket, :pointer, # string
+           :prefix, :pointer  # string
+  end
+
+  class UplinkError < FFI::Struct
+    layout :code, :int32_t,
+           :message, :string
+  end
+
+  class UplinkAccessResult < FFI::Struct
+    layout :access, UplinkAccess.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkProjectResult < FFI::Struct
+    layout :project, UplinkProject.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkBucketResult < FFI::Struct
+    layout :bucket, UplinkBucket.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkObjectResult < FFI::Struct
+    layout :object, UplinkObject.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkUploadResult < FFI::Struct
+    layout :upload, UplinkUpload.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkPartUploadResult < FFI::Struct
+    layout :part_upload, UplinkPartUpload.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkDownloadResult < FFI::Struct
+    layout :download, UplinkDownload.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkWriteResult < FFI::Struct
+    layout :bytes_written, :size_t,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkReadResult < FFI::Struct
+    layout :bytes_read, :size_t,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkStringResult < FFI::Struct
+    layout :string, :string,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkEncryptionKeyResult < FFI::Struct
+    layout :encryption_key, UplinkEncryptionKey.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkUploadInfo < FFI::Struct
+    layout :upload_id, :string,
+           :key, :string,
+           :is_prefix, :bool,
+           :system, UplinkSystemMetadata.val,
+           :custom, UplinkCustomMetadata.val
+  end
+
+  class UplinkUploadInfoResult < FFI::Struct
+    layout :info, UplinkUploadInfo.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkCommitUploadOptions < FFI::Struct
+    layout :custom_metadata, UplinkCustomMetadata.val
+  end
+
+  class UplinkCommitUploadResult < FFI::Struct
+    layout :object, UplinkObject.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkPartResult < FFI::Struct
+    layout :part, UplinkPart.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class UplinkListUploadPartsOptions < FFI::Struct
+    layout :cursor, :uint32_t
+  end
+
+  class EdgeConfig < FFI::Struct
+    layout :auth_service_address, :pointer, # string
+           :certificate_pem, :pointer       # string
+  end
+
+  class EdgeRegisterAccessOptions < FFI::Struct
+    layout :is_public, :bool
+  end
+
+  class EdgeCredentials < FFI::Struct
+    layout :access_key_id, :string,
+           :secret_key, :string,
+           :endpoint, :string
+  end
+
+  class EdgeCredentialsResult < FFI::Struct
+    layout :credentials, EdgeCredentials.ptr,
+           :error, UplinkError.ptr
+  end
+
+  class EdgeShareURLOptions < FFI::Struct
+    layout :raw, :bool
+  end
+
+  class UplinkMoveObjectOptions < FFI::Struct; end
+  class UplinkUploadObjectMetadataOptions < FFI::Struct; end
+  class UplinkCopyObjectOptions < FFI::Struct; end
+
+  attach_function :uplink_parse_access, [:string], UplinkAccessResult.val
+  attach_function :uplink_request_access_with_passphrase, [:string, :string, :string], UplinkAccessResult.val
+  attach_function :uplink_access_satellite_address, [UplinkAccess.ptr], UplinkStringResult.val
+  attach_function :uplink_access_serialize, [UplinkAccess.ptr], UplinkStringResult.val
+  attach_function :uplink_access_share, [UplinkAccess.ptr, UplinkPermission.val, :pointer, :long_long], UplinkAccessResult.val
+  attach_function :uplink_access_override_encryption_key, [UplinkAccess.ptr, :string, :string, UplinkEncryptionKey.ptr], UplinkError.ptr
+  attach_function :uplink_free_string_result, [UplinkStringResult.val], :void
+  attach_function :uplink_free_access_result, [UplinkAccessResult.val], :void
+  attach_function :uplink_stat_bucket, [UplinkProject.ptr, :string], UplinkBucketResult.val
+  attach_function :uplink_create_bucket, [UplinkProject.ptr, :string], UplinkBucketResult.val
+  attach_function :uplink_ensure_bucket, [UplinkProject.ptr, :string], UplinkBucketResult.val
+  attach_function :uplink_delete_bucket, [UplinkProject.ptr, :string], UplinkBucketResult.val
+  attach_function :uplink_delete_bucket_with_objects, [UplinkProject.ptr, :string], UplinkBucketResult.val
+  attach_function :uplink_free_bucket_result, [UplinkBucketResult.val], :void
+  attach_function :uplink_free_bucket, [UplinkBucket.ptr], :void
+  attach_function :uplink_list_buckets, [UplinkProject.ptr, UplinkListBucketsOptions.ptr], UplinkBucketIterator.ptr
+  attach_function :uplink_bucket_iterator_next, [UplinkBucketIterator.ptr], :bool
+  attach_function :uplink_bucket_iterator_err, [UplinkBucketIterator.ptr], UplinkError.ptr
+  attach_function :uplink_bucket_iterator_item, [UplinkBucketIterator.ptr], UplinkBucket.ptr
+  attach_function :uplink_free_bucket_iterator, [UplinkBucketIterator.ptr], :void
+  attach_function :uplink_config_request_access_with_passphrase, [UplinkConfig.val, :string, :string, :string], UplinkAccessResult.val
+  attach_function :uplink_config_open_project, [UplinkConfig.val, UplinkAccess.ptr], UplinkProjectResult.val
+  attach_function :uplink_copy_object, [UplinkProject.ptr, :string, :string, :string, :string, UplinkCopyObjectOptions.ptr], UplinkObjectResult.val
+  attach_function :uplink_download_object, [UplinkProject.ptr, :string, :string, UplinkDownloadOptions.ptr], UplinkDownloadResult.val
+  attach_function :uplink_download_read, [UplinkDownload.ptr, :pointer, :size_t], UplinkReadResult.val
+  attach_function :uplink_download_info, [UplinkDownload.ptr], UplinkObjectResult.val
+  attach_function :uplink_free_read_result, [UplinkReadResult.val], :void
+  attach_function :uplink_close_download, [UplinkDownload.ptr], UplinkError.ptr
+  attach_function :uplink_free_download_result, [UplinkDownloadResult.val], :void
+  attach_function :edge_register_access, [EdgeConfig.val, UplinkAccess.ptr, EdgeRegisterAccessOptions.ptr], EdgeCredentialsResult.val
+  attach_function :edge_free_credentials_result, [EdgeCredentialsResult.val], :void
+  attach_function :edge_free_credentials, [EdgeCredentials.ptr], :void
+  attach_function :edge_join_share_url, [:string, :string, :string, :string, EdgeShareURLOptions.ptr], UplinkStringResult.val
+  attach_function :uplink_derive_encryption_key, [:string, :pointer, :size_t], UplinkEncryptionKeyResult.val
+  attach_function :uplink_free_encryption_key_result, [UplinkEncryptionKeyResult.val], :void
+  attach_function :uplink_free_error, [UplinkError.ptr], :void
+  attach_function :uplink_internal_UniverseIsEmpty, [], :uchar
+  attach_function :uplink_move_object, [UplinkProject.ptr, :string, :string, :string, :string, UplinkMoveObjectOptions.ptr], UplinkError.ptr
+  attach_function :uplink_begin_upload, [UplinkProject.ptr, :string, :string, UplinkUploadOptions.ptr], UplinkUploadInfoResult.val
+  attach_function :uplink_free_upload_info_result, [UplinkUploadInfoResult.val], :void
+  attach_function :uplink_free_upload_info, [UplinkUploadInfo.ptr], :void
+  attach_function :uplink_commit_upload, [UplinkProject.ptr, :string, :string, :string, UplinkCommitUploadOptions.ptr], UplinkCommitUploadResult.val
+  attach_function :uplink_free_commit_upload_result, [UplinkCommitUploadResult.val], :void
+  attach_function :uplink_abort_upload, [UplinkProject.ptr, :string, :string, :string], UplinkError.ptr
+  attach_function :uplink_upload_part, [UplinkProject.ptr, :string, :string, :string, :uint32_t], UplinkPartUploadResult.val
+  attach_function :uplink_part_upload_write, [UplinkPartUpload.ptr, :pointer, :size_t], UplinkWriteResult.val
+  attach_function :uplink_part_upload_commit, [UplinkPartUpload.ptr], UplinkError.ptr
+  attach_function :uplink_part_upload_abort, [UplinkPartUpload.ptr], UplinkError.ptr
+  attach_function :uplink_part_upload_set_etag, [UplinkPartUpload.ptr, :string], UplinkError.ptr
+  attach_function :uplink_part_upload_info, [UplinkPartUpload.ptr], UplinkPartResult.val
+  attach_function :uplink_free_part_result, [UplinkPartResult.val], :void
+  attach_function :uplink_free_part_upload_result, [UplinkPartUploadResult.val], :void
+  attach_function :uplink_free_part, [UplinkPart.ptr], :void
+  attach_function :uplink_list_uploads, [UplinkProject.ptr, :string, UplinkListUploadsOptions.ptr], UplinkUploadIterator.ptr
+  attach_function :uplink_upload_iterator_next, [UplinkUploadIterator.ptr], :bool
+  attach_function :uplink_upload_iterator_err, [UplinkUploadIterator.ptr], UplinkError.ptr
+  attach_function :uplink_upload_iterator_item, [UplinkUploadIterator.ptr], UplinkUploadInfo.ptr
+  attach_function :uplink_free_upload_iterator, [UplinkUploadIterator.ptr], :void
+  attach_function :uplink_list_upload_parts, [UplinkProject.ptr, :string, :string, :string, UplinkListUploadPartsOptions.ptr], UplinkPartIterator.ptr
+  attach_function :uplink_part_iterator_next, [UplinkPartIterator.ptr], :bool
+  attach_function :uplink_part_iterator_err, [UplinkPartIterator.ptr], UplinkError.ptr
+  attach_function :uplink_part_iterator_item, [UplinkPartIterator.ptr], UplinkPart.ptr
+  attach_function :uplink_free_part_iterator, [UplinkPartIterator.ptr], :void
+  attach_function :uplink_stat_object, [UplinkProject.ptr, :string, :string], UplinkObjectResult.val
+  attach_function :uplink_delete_object, [UplinkProject.ptr, :string, :string], UplinkObjectResult.val
+  attach_function :uplink_free_object_result, [UplinkObjectResult.val], :void
+  attach_function :uplink_free_object, [UplinkObject.ptr], :void
+  attach_function :uplink_update_object_metadata, [UplinkProject.ptr, :string, :string, UplinkCustomMetadata.val, UplinkUploadObjectMetadataOptions.ptr], UplinkError.ptr
+  attach_function :uplink_list_objects, [UplinkProject.ptr, :string, UplinkListObjectsOptions.ptr], UplinkObjectIterator.ptr
+  attach_function :uplink_object_iterator_next, [UplinkObjectIterator.ptr], :bool
+  attach_function :uplink_object_iterator_err, [UplinkObjectIterator.ptr], UplinkError.ptr
+  attach_function :uplink_object_iterator_item, [UplinkObjectIterator.ptr], UplinkObject.ptr
+  attach_function :uplink_free_object_iterator, [UplinkObjectIterator.ptr], :void
+  attach_function :uplink_open_project, [UplinkAccess.ptr], UplinkProjectResult.val
+  attach_function :uplink_close_project, [UplinkProject.ptr], UplinkError.ptr
+  attach_function :uplink_free_project_result, [UplinkProjectResult.val], :void
+  attach_function :uplink_revoke_access, [UplinkProject.ptr, UplinkAccess.ptr], UplinkError.ptr
+  attach_function :uplink_upload_object, [UplinkProject.ptr, :string, :string, UplinkUploadOptions.ptr], UplinkUploadResult.val
+  attach_function :uplink_upload_write, [UplinkUpload.ptr, :pointer, :size_t], UplinkWriteResult.val
+  attach_function :uplink_upload_commit, [UplinkUpload.ptr], UplinkError.ptr
+  attach_function :uplink_upload_abort, [UplinkUpload.ptr], UplinkError.ptr
+  attach_function :uplink_upload_info, [UplinkUpload.ptr], UplinkObjectResult.val
+  attach_function :uplink_upload_set_custom_metadata, [UplinkUpload.ptr, UplinkCustomMetadata.val], UplinkError.ptr
+  attach_function :uplink_free_write_result, [UplinkWriteResult.val], :void
+  attach_function :uplink_free_upload_result, [UplinkUploadResult.val], :void
+end