Parent

Class/Module Index [+]

Quicksearch

Fog::Storage::InternetArchive::File

Attributes

body[W]
multipart_chunk_size[RW]

@note Chunk size to use for multipart uploads.

Use small chunk sizes to minimize memory. E.g. 5242880 = 5mb

Public Instance Methods

acl() click to toggle source

acl for internet archive is always public-read

# File lib/fog/internet_archive/models/storage/file.rb, line 49
def acl
  'public-read'
end
acl=(new_acl) click to toggle source
# File lib/fog/internet_archive/models/storage/file.rb, line 53
def acl=(new_acl)
  'public-read'
end
body() click to toggle source

Get file's body if exists, else ' '.

@return [File]

# File lib/fog/internet_archive/models/storage/file.rb, line 61
def body
  attributes[:body] ||= if last_modified && (file = collection.get(identity))
    file.body
  else
    ''
  end
end
copy(target_directory_key, target_file_key, options = {}) click to toggle source

Copy object from one bucket to other bucket.

required attributes: directory, key

@param target_directory_key [String] @param target_file_key [String] @param options [Hash] options for copy_object method @return [String] Fog::InternetArchive::Files#head status of directory contents

# File lib/fog/internet_archive/models/storage/file.rb, line 98
def copy(target_directory_key, target_file_key, options = {})
  requires :directory, :key
  service.copy_object(directory.key, key, target_directory_key, target_file_key, options)
  target_directory = service.directories.new(:key => target_directory_key)
  target_directory.files.head(target_file_key)
end
destroy(options = {}) click to toggle source

Destroy file via http DELETE.

required attributes: directory, key

@param options [Hash] @return [Boolean] true if successful

# File lib/fog/internet_archive/models/storage/file.rb, line 113
def destroy(options = {})
  requires :directory, :key
  options['x-archive-cascade-delete'] = cascade_delete if cascade_delete
  service.delete_object(directory.key, key, options)
  true
end
directory() click to toggle source

Get the file instance's directory.

@return [Fog::InternetArchive::Storage::Directory]

# File lib/fog/internet_archive/models/storage/file.rb, line 84
def directory
  @directory
end
metadata() click to toggle source
# File lib/fog/internet_archive/models/storage/file.rb, line 121
def metadata
  attributes.reject {|key, value| !(key.to_s =~ /^x-(amz||archive)-meta/)}
end
metadata=(new_metadata) click to toggle source
# File lib/fog/internet_archive/models/storage/file.rb, line 126
def metadata=(new_metadata)
  merge_attributes(new_metadata)
end
owner=(new_owner) click to toggle source
# File lib/fog/internet_archive/models/storage/file.rb, line 132
def owner=(new_owner)
  if new_owner
    attributes[:owner] = {
      :display_name => new_owner['DisplayName'],
      :id           => new_owner['ID']
    }
  end
end
public=(new_public) click to toggle source

Set Access-Control-List permissions.

valid new_publics: public_read, private

@param [String] new_public @return [String] new_puplic

# File lib/fog/internet_archive/models/storage/file.rb, line 149
def public=(new_public)
  'public-read'
end
public_url() click to toggle source

Get publicly acessible url via http GET.

required attributes: directory, key

@return [String] public url

# File lib/fog/internet_archive/models/storage/file.rb, line 160
def public_url
  requires :directory, :key
  "http://#{Fog::InternetArchive::DOMAIN_NAME}/download/#{directory.key}/#{Fog::InternetArchive.escape(key)}".gsub('%2F','/')
end
save(options = {}) click to toggle source

Save file with body as contents to directory.key with name key via http PUT

required attributes: body, directory, key

@param [Hash] options @option options [String] cache_controle sets Cache-Control header. For example, 'No-cache' @option options [String] content_disposition sets Content-Disposition HTTP header. For exampple, 'attachment; filename=testing.txt' @option options [String] content_encoding sets Content-Encoding HTTP header. For example, 'x-gzip' @option options [String] content_md5 sets Content-MD5. For example, '79054025255fb1a26e4bc422aef54eb4' @option options [String] content_type Content-Type. For example, 'text/plain' @option options [String] expires sets number of seconds before AWS Object expires. @option options [String] storage_class sets x-amz-storage-class HTTP header. Defaults to 'STANDARD'. Or, 'REDUCED_REDUNDANCY' @option options [String] encryption sets HTTP encryption header. Set to 'AES256' to encrypt files at rest on S3 @return [Boolean] true if no errors

# File lib/fog/internet_archive/models/storage/file.rb, line 180
def save(options = {})
  requires :body, :directory, :key
  if options != {}
    Fog::Logger.deprecation("options param is deprecated [light_black](#{caller.first})[/]")
  end
  options['Cache-Control'] = cache_control if cache_control
  options['Content-Disposition'] = content_disposition if content_disposition
  options['Content-Encoding'] = content_encoding if content_encoding
  options['Content-MD5'] = content_md5 if content_md5
  options['Content-Type'] = content_type if content_type
  options['Expires'] = expires if expires
  options.merge!(metadata)

  options['x-archive-auto-make-bucket'] = auto_make_bucket if auto_make_bucket
  options['x-archive-interactive-priority'] = interactive_priority if interactive_priority
  options['x-archive-keep-old-version'] = keep_old_version if keep_old_version
  options['x-archive-queue-derive'] = queue_derive if queue_derive
  options['x-archive-size-hint'] = size_hint.to_i.to_s if size_hint

  set_metadata_array_headers(:collections, options)
  set_metadata_array_headers(:subjects, options)

  if multipart_chunk_size && body.respond_to?(:read)
    data = multipart_save(options)
    merge_attributes(data.body)
  else
    data = service.put_object(directory.key, key, body, options)
    merge_attributes(data.headers.reject {|key, value| ['Content-Length', 'Content-Type'].include?(key)})
  end
  self.etag.gsub!('"','') if self.etag
  self.content_length = Fog::Storage.get_body_size(body)
  self.content_type ||= Fog::Storage.get_content_type(body)
  true
end
url(expires, options = {}) click to toggle source

Get a url for file.

required attributes: key

@param expires [String] number of seconds before url expires @param options [Hash] @return [String] url

# File lib/fog/internet_archive/models/storage/file.rb, line 224
def url(expires, options = {})
  requires :key
  collection.get_url(key, expires, options)
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.