class Backblaze::B2::File

Public Class Methods

create(data:, bucket:, name: nil, base_name: '', content_type: 'b2/x-auto', info: {}) click to toggle source
# File lib/backblaze/b2/file.rb, line 16
def create(data:, bucket:, name: nil, base_name: '', content_type: 'b2/x-auto', info: {})
  raise ArgumentError.new('data must not be nil') if data.nil?

  case bucket
  when String
    upload_url = Bucket.upload_url(bucket_id: bucket)
  when Bucket
    upload_url = bucket.upload_url
  else
    raise ArgumentError.new('You must pass a bucket')
  end

  close_file = false
  case data
  when String
    data.force_encoding('ASCII-8BIT')
    raise ArgumentError.new('Must provide a file name for data') if name.nil?
  when ::File, Tempfile
    data.binmode
    data.rewind
    if name.nil?
      raise ArgumentError.new('Must provide a file name with Tempfiles') if data.is_a? Tempfile
      name = ::File.basename(data)
    end
  else
    raise ArgumentError.new('Must provide a file name with streams') if name.nil?
    if data.respond_to?(:read)
      close_file = true
      temp = Tempfile.new(name)
      temp.binmode
      IO.copy_stream(data, temp)
      data = temp
      data.rewind
    else
      raise ArgumentError.new('Unsuitable data type. Please read the docs.')
    end
  end

  uri = URI(upload_url[:url])
  req = Net::HTTP::Post.new(uri)

  req.add_field("Authorization", upload_url[:token])
  req.add_field("X-Bz-File-Name", "#{base_name}/#{name}".tr_s('/', '/').sub(/\A\//, ''))
  req.add_field("Content-Type", content_type)
  req.add_field("Content-Length", data.size)

  digest = Digest::SHA1.new
  if data.is_a? String
    digest.update(data)
    req.body = data
  else
    digest.file(data)
    data.rewind
    req.body_stream = data
  end

  req.add_field("X-Bz-Content-Sha1", digest)

  info.first(10).map do |key, value|
    req.add_field("X-Bz-Info-#{URI.encode(key)}", value)
  end

  http = Net::HTTP.new(req.uri.host, req.uri.port)
  http.use_ssl = (req.uri.scheme == 'https')
  res = http.start {|make| make.request(req)}

  response = JSON.parse(res.body)

  raise Backblaze::FileError.new(response) unless res.code.to_i == 200

  params = {
    file_name: response['fileName'],
    bucket_id: response['bucketId'],
    size: response['contentLength'],
    file_id: response['fileId'],
    upload_timestamp: Time.now.to_i * 1000,
    action: 'upload'
  }

  File.new(params)
end
new(file_name:, bucket_id:, versions: nil, **file_version_args) click to toggle source
# File lib/backblaze/b2/file.rb, line 3
def initialize(file_name:, bucket_id:, versions: nil, **file_version_args)
  @file_name = file_name
  @bucket_id = bucket_id
  if versions
    @fetched_all = true
    @versions = versions
  else
    @fetched_all = false
    @versions = [FileVersion.new(file_version_args.merge(file_name: file_name))]
  end
end

Public Instance Methods

destroy!(thread_count: 4) click to toggle source
# File lib/backblaze/b2/file.rb, line 124
def destroy!(thread_count: 4)
  versions
  thread_count = @versions.length if thread_count > @versions.length || thread_count < 1
  lock = Mutex.new
  errors = []
  threads = []
  thread_count.times do
    threads << Thread.new do
      version = nil
      loop do
        lock.synchronize { version = @versions.pop }
        break if version.nil?
        begin
          version.destroy!
        rescue Backblaze::FileError => e
          lock.synchronize { errors << e }
        end
      end
    end
  end
  threads.map(&:join)
  @destroyed = true
  if errors.any?
    raise Backblaze::DestroyErrors.new(errors)
  end
end
download_url(bucket:) click to toggle source
# File lib/backblaze/b2/file.rb, line 112
def download_url(bucket:)
  "#{Backblaze::B2.download_url}/file/#{bucket.is_a?(Bucket) ? bucket.name : bucket}/#{file_name}"
end
exists?() click to toggle source
# File lib/backblaze/b2/file.rb, line 151
def exists?
  !@destroyed
end
file_id_download_url() click to toggle source
# File lib/backblaze/b2/file.rb, line 116
def file_id_download_url
  latest.download_url
end
file_name() click to toggle source
# File lib/backblaze/b2/file.rb, line 99
def file_name
  @file_name
end
Also aliased as: name
latest() click to toggle source
# File lib/backblaze/b2/file.rb, line 120
def latest
  @versions.first
end
method_missing(m, *args, &block) click to toggle source
Calls superclass method
# File lib/backblaze/b2/file.rb, line 155
def method_missing(m, *args, &block)
  if latest.respond_to?(m)
    latest.send(m, *args, &block)
  else
    super
  end
end
name()
Alias for: file_name
respond_to?(m) click to toggle source
Calls superclass method
# File lib/backblaze/b2/file.rb, line 163
def respond_to?(m)
  if latest.respond_to?(m)
    true
  else
    super
  end
end
versions() click to toggle source
# File lib/backblaze/b2/file.rb, line 104
def versions
  unless @fetched_all
    @versions = file_versions(bucket_id: @bucket_id, convert: true, limit: -1, double_check_server: false, file_name: file_name)
    @fetched_all = true
  end
  @versions
end