Class: DropboxApi::Metadata::WriteMode

Inherits:
Base
  • Object
show all
Defined in:
lib/dropbox_api/metadata/write_mode.rb

Overview

Your intent when writing a file to some path. This is used to determine what constitutes a conflict and what the autorename strategy is.

In some situations, the conflict behavior is identical:

- If the target path doesn't contain anything, the file is always
  written; no conflict.
- If the target path contains a folder, it's always a conflict.
- If the target path contains a file with identical contents, nothing
  gets written; no conflict.

The conflict checking differs in the case where there’s a file at the target path with contents different from the contents you’re trying to write. The value will be one of the following datatypes:

  • :add: Do not overwrite an existing file if there is a conflict. The autorename strategy is to append a number to the file name. For example, “document.txt” might become “document (2).txt”.

  • :overwrite: Always overwrite the existing file. The autorename strategy is the same as it is for add.

  • :update: Overwrite if the given “rev” matches the existing file’s “rev”. The autorename strategy is to append the string “conflicted copy” to the file name. For example, “document.txt” might become “document (conflicted copy).txt” or “document (Panda’s conflicted copy).txt”.

Constant Summary collapse

VALID_WRITE_MODES = 
[
  :add,
  :overwrite,
  :update
]

Instance Method Summary collapse

Methods inherited from Base

field, #serialized_field

Constructor Details

#initialize(write_mode, rev = nil) ⇒ WriteMode

Returns a new instance of WriteMode.

Examples:

DropboxApi::Metadata::WriteMode.new :add
DropboxApi::Metadata::WriteMode.new :overwrite
DropboxApi::Metadata::WriteMode.new :update, "a1c10ce0dd78"


42
43
44
45
46
47
 
# File 'lib/dropbox_api/metadata/write_mode.rb', line 42

def initialize(write_mode, rev = nil)
  @write_mode = write_mode.to_sym
  @rev = rev

  check_validity
end

Instance Method Details

#check_validity ⇒ Object 



49
50
51
52
53
54
55
56
57
 
# File 'lib/dropbox_api/metadata/write_mode.rb', line 49

def check_validity
  unless valid_mode? @write_mode
    raise ArgumentError, "Invalid write mode: #{value}"
  end

  if @write_mode == :update && @rev.nil?
    raise ArgumentError, "Mode `:update` expects a `rev` number"
  end
end

#to_hash ⇒ Object 



59
60
61
62
63
64
65
66
 
# File 'lib/dropbox_api/metadata/write_mode.rb', line 59

def to_hash
  hash = {
    ".tag" => @write_mode
  }
  hash["update"] = @rev if @write_mode == :update

  hash
end