Class: Files::File

Inherits:
Object
  • Object
show all
Defined in:
lib/files.com/models/file.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(*args) ⇒ File

Returns a new instance of File.



188
189
190
191
192
193
194
195
196
# File 'lib/files.com/models/file.rb', line 188

def initialize(*args)
  @attributes = (args[0].is_a?(Hash) && args[0]) || {}
  @options = (args[1].is_a?(Hash) && args[1])
  @options ||= (args[2].is_a?(Hash) && args[2]) || {}
  @attributes[:path] = args[0] if args[0].is_a?(String)
  @mode = args[1] || 'r' if args[1].is_a?(String)
  @write_io = StringIO.new
  @bytes_written = 0
end

Instance Attribute Details

#attributesObject (readonly)

Returns the value of attribute attributes.



5
6
7
# File 'lib/files.com/models/file.rb', line 5

def attributes
  @attributes
end

#lineno(*_args) ⇒ Object



410
411
412
# File 'lib/files.com/models/file.rb', line 410

def lineno(*_args)
  @lineno ||= 0
end

#modeObject (readonly)

Returns the value of attribute mode.



6
7
8
# File 'lib/files.com/models/file.rb', line 6

def mode
  @mode
end

#optionsObject (readonly)

Returns the value of attribute options.



5
6
7
# File 'lib/files.com/models/file.rb', line 5

def options
  @options
end

#posObject



436
437
438
# File 'lib/files.com/models/file.rb', line 436

def pos
  @pos ||= 0
end

#syncObject



518
519
520
# File 'lib/files.com/models/file.rb', line 518

def sync
  @sync ||= false
end

Class Method Details

.binread(name, *args) ⇒ Object



8
9
10
# File 'lib/files.com/models/file.rb', line 8

def self.binread(name, *args)
  new(name).read(*args)
end

.binwrite(name, *args) ⇒ Object



12
13
14
# File 'lib/files.com/models/file.rb', line 12

def self.binwrite(name, *args)
  new(name).write(*args)
end

.chmod(*_args) ⇒ Object



16
17
18
# File 'lib/files.com/models/file.rb', line 16

def self.chmod(*_args)
  raise NotImplementedError
end

.chown(*_args) ⇒ Object



20
21
22
# File 'lib/files.com/models/file.rb', line 20

def self.chown(*_args)
  raise NotImplementedError
end

.client(options = {}) ⇒ Object



24
25
26
# File 'lib/files.com/models/file.rb', line 24

def self.client(options = {})
  options[:client] || ApiClient.active_client
end

.copy(old_path, new_path) ⇒ Object



28
29
30
# File 'lib/files.com/models/file.rb', line 28

def self.copy(old_path, new_path)
  FileAction.copy(old_path, destination: new_path)
end

.copy_stream(*_args) ⇒ Object



32
33
34
# File 'lib/files.com/models/file.rb', line 32

def self.copy_stream(*_args)
  raise NotImplementedError
end

.create(path, params = {}, options = {}) ⇒ Object

Upload file

Parameters:

action - string - The action to perform.  Can be `append`, `attachment`, `end`, `upload`, `put`, or may not exist
etags[etag] (required) - array - etag identifier.
etags[part] (required) - array - Part number.
length - integer - Length of file.
mkdir_parents - boolean - Create parent directories if they do not exist?
part - integer - Part if uploading a part.
parts - integer - How many parts to fetch?
provided_mtime - string - User provided modification time.
ref - string -
restart - integer - File byte offset to restart from.
size - integer - Size of file.
structure - string - If copying folder, copy just the structure?
with_rename - boolean - Allow file rename instead of overwrite?


949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
# File 'lib/files.com/models/file.rb', line 949

def self.create(path, params = {}, options = {})
  params ||= {}
  params[:path] = path
  raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: action must be an String") if params.dig(:action) and !params.dig(:action).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: length must be an Integer") if params.dig(:length) and !params.dig(:length).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: part must be an Integer") if params.dig(:part) and !params.dig(:part).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: parts must be an Integer") if params.dig(:parts) and !params.dig(:parts).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: provided_mtime must be an String") if params.dig(:provided_mtime) and !params.dig(:provided_mtime).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: ref must be an String") if params.dig(:ref) and !params.dig(:ref).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: restart must be an Integer") if params.dig(:restart) and !params.dig(:restart).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: size must be an Integer") if params.dig(:size) and !params.dig(:size).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: structure must be an String") if params.dig(:structure) and !params.dig(:structure).is_a?(String)
  raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)

  response, options = Api.send_request("/files/#{URI.encode_www_form_component(params[:path])}", :post, params, options)
  File.new(response.data, options)
end

.delete(path, params = {}, options = {}) ⇒ Object

Parameters:

recursive - boolean - If true, will recursively delete folers.  Otherwise, will error on non-empty folders.  For legacy reasons, this parameter may also be provided as the HTTP header `Depth: Infinity`


985
986
987
988
989
990
991
992
993
# File 'lib/files.com/models/file.rb', line 985

def self.delete(path, params = {}, options = {})
  params ||= {}
  params[:path] = path
  raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
  raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)

  response, _options = Api.send_request("/files/#{URI.encode_www_form_component(params[:path])}", :delete, params, options)
  response.data
end

.destroy(path, params = {}, options = {}) ⇒ Object



995
996
997
# File 'lib/files.com/models/file.rb', line 995

def self.destroy(path, params = {}, options = {})
  delete(path, params, options)
end

.directory?(path, options = {}) ⇒ Boolean

Returns:

  • (Boolean)


36
37
38
# File 'lib/files.com/models/file.rb', line 36

def self.directory?(path, options = {})
  find(path, {}, options).type == "directory"
end

.download(path, params = {}, options = {}) ⇒ Object

Download file

Parameters:

action - string - Can be blank, `redirect` or `stat`.  If set to `stat`, we will return file information but without a download URL, and without logging a download.  If set to `redirect` we will serve a 302 redirect directly to the file.  This is used for integrations with Zapier, and is not recommended for most integrations.
id - integer - If provided, lookup the file by id instead of path.
with_previews - boolean - Include file preview information?
with_priority_color - boolean - Include file priority color information?


921
922
923
924
925
926
927
928
929
930
931
# File 'lib/files.com/models/file.rb', line 921

def self.download(path, params = {}, options = {})
  params ||= {}
  params[:path] = path
  raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: action must be an String") if params.dig(:action) and !params.dig(:action).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params.dig(:id) and !params.dig(:id).is_a?(Integer)
  raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)

  response, options = Api.send_request("/files/#{URI.encode_www_form_component(params[:path])}", :get, params, options)
  File.new(response.data, options)
end

.download_file(path, local_path = nil) ⇒ Object



40
41
42
43
# File 'lib/files.com/models/file.rb', line 40

def self.download_file(path, local_path = nil)
  local_path ||= File.basename(path)
  new(path).download_file(local_path)
end

.exist?(path, options = {}) ⇒ Boolean

Returns:

  • (Boolean)


45
46
47
48
49
50
51
52
53
54
# File 'lib/files.com/models/file.rb', line 45

def self.exist?(path, options = {})
  find(path, {}, options)
  true
rescue Error => e
  if e.code == 404
    false
  else
    raise e
  end
end

.exists?(path, options = {}) ⇒ Boolean

Returns:

  • (Boolean)


56
57
58
# File 'lib/files.com/models/file.rb', line 56

def self.exists?(path, options = {})
  exist?(path, options)
end

.find(path, params = {}, options = {}) ⇒ Object



60
61
62
63
# File 'lib/files.com/models/file.rb', line 60

def self.find(path, params = {}, options = {})
  params[:action] = "stat"
  download(path, params, options)
end

.for_fd(*_args) ⇒ Object



65
66
67
# File 'lib/files.com/models/file.rb', line 65

def self.for_fd(*_args)
  raise NotImplementedError
end

.foreach(name, *args, &block) ⇒ Object



69
70
71
# File 'lib/files.com/models/file.rb', line 69

def self.foreach(name, *args, &block)
  new(name).each(*args, &block)
end

.get(path, params = {}, options = {}) ⇒ Object



73
74
75
# File 'lib/files.com/models/file.rb', line 73

def self.get(path, params = {}, options = {})
  find(path, params, options)
end

.identical?(path1, path2) ⇒ Boolean

Returns:

  • (Boolean)


77
78
79
# File 'lib/files.com/models/file.rb', line 77

def self.identical?(path1, path2)
  new(path1).crc32 == new(path2).crc32
end

.lstat(path) ⇒ Object



81
82
83
# File 'lib/files.com/models/file.rb', line 81

def self.lstat(path)
  new(path).stat
end

.move(old_path, new_path) ⇒ Object



85
86
87
# File 'lib/files.com/models/file.rb', line 85

def self.move(old_path, new_path)
  FileAction.move(old_path, destination: new_path)
end

.mtime(path) ⇒ Object



89
90
91
# File 'lib/files.com/models/file.rb', line 89

def self.mtime(path)
  new(path).mtime
end

.open(path, mode = "r", options = {}, &block) ⇒ Object



93
94
95
96
97
98
99
100
# File 'lib/files.com/models/file.rb', line 93

def self.open(path, mode = "r", options={}, &block)
  file = new(path, mode, options)
  if block
    yield file
    file.close
  end
  file
end

.owned?(_path) ⇒ Boolean

Returns:

  • (Boolean)

Raises:



102
103
104
# File 'lib/files.com/models/file.rb', line 102

def self.owned?(_path)
  raise NotImplementedError
end

.pipe(*_args) ⇒ Object



106
107
108
# File 'lib/files.com/models/file.rb', line 106

def self.pipe(*_args)
  raise NotImplementedError
end

.popen(*_args) ⇒ Object



110
111
112
# File 'lib/files.com/models/file.rb', line 110

def self.popen(*_args)
  raise NotImplementedError
end

.read(name, *args) ⇒ Object



114
115
116
# File 'lib/files.com/models/file.rb', line 114

def self.read(name, *args)
  new(name).read(*args)
end

.readable?(path) ⇒ Boolean

Returns:

  • (Boolean)


118
119
120
# File 'lib/files.com/models/file.rb', line 118

def self.readable?(path)
  new(path).stat.permissions.include?("read")
end

.readlines(name, *args) ⇒ Object



122
123
124
# File 'lib/files.com/models/file.rb', line 122

def self.readlines(name, *args)
  new(name).readlines(*args)
end

.rename(old_path, new_path) ⇒ Object



126
127
128
# File 'lib/files.com/models/file.rb', line 126

def self.rename(old_path, new_path)
  FileAction.move(old_path, destination: new_path)
end

.select(*_args) ⇒ Object



130
131
132
# File 'lib/files.com/models/file.rb', line 130

def self.select(*_args)
  raise NotImplementedError
end

.stat(path) ⇒ Object



134
135
136
# File 'lib/files.com/models/file.rb', line 134

def self.stat(path)
  new(path).stat
end

.sysopen(*_args) ⇒ Object



138
139
140
# File 'lib/files.com/models/file.rb', line 138

def self.sysopen(*_args)
  raise NotImplementedError
end

.try_convert(*_args) ⇒ Object



142
143
144
# File 'lib/files.com/models/file.rb', line 142

def self.try_convert(*_args)
  raise NotImplementedError
end


146
147
148
# File 'lib/files.com/models/file.rb', line 146

def self.unlink(*paths)
  paths.map { |p| delete(p) }
end

.update(path, params = {}, options = {}) ⇒ Object

Parameters:

provided_mtime - string - Modified time of file.
priority_color - string - Priority/Bookmark color of file.


971
972
973
974
975
976
977
978
979
980
981
# File 'lib/files.com/models/file.rb', line 971

def self.update(path, params = {}, options = {})
  params ||= {}
  params[:path] = path
  raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: provided_mtime must be an String") if params.dig(:provided_mtime) and !params.dig(:provided_mtime).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: priority_color must be an String") if params.dig(:priority_color) and !params.dig(:priority_color).is_a?(String)
  raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)

  response, options = Api.send_request("/files/#{URI.encode_www_form_component(params[:path])}", :patch, params, options)
  File.new(response.data, options)
end

.upload_chunks(io, path, options, upload = nil, etags = []) ⇒ Object



150
151
152
153
154
155
156
157
158
159
160
# File 'lib/files.com/models/file.rb', line 150

def self.upload_chunks(io, path, options, upload = nil, etags = [])
  etags ||= []
  loop do
    upload = FileAction.begin_upload(path, { ref: upload&.ref, part: (upload&.part_number || 0) + 1 }, options)
    buf = io.read(upload.partsize) || ""
    method = upload.http_method.downcase.to_sym
    response = client(options).remote_request(method, upload.upload_uri, { "Content-Length": buf.length.to_s }, buf)
    etags << { etag: response.headers["ETag"], part: upload.part_number }
    return upload, etags if io.eof?
  end
end

.upload_file(path, destination = nil, options = {}) ⇒ Object



162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
# File 'lib/files.com/models/file.rb', line 162

def self.upload_file(path, destination = nil, options = {})
  local_file = ::File.open(path, 'r')
  destination ||= File.basename(path)
  upload, etags = upload_chunks(local_file, destination, options)

  params = {
    action: "end",
    etags: etags,
    provided_mtime: local_file.mtime.to_s,
    ref: upload.ref,
    size: local_file.size
  }

  create(destination, params, options)
ensure
  local_file.close
end

.write(*_args) ⇒ Object



180
181
182
# File 'lib/files.com/models/file.rb', line 180

def self.write(*_args)
  raise NotImplementedError
end

.zero?(path) ⇒ Boolean

Returns:

  • (Boolean)


184
185
186
# File 'lib/files.com/models/file.rb', line 184

def self.zero?(path)
  new(path).empty?
end

Instance Method Details

#actionObject

string - The action to perform. Can be ‘append`, `attachment`, `end`, `upload`, `put`, or may not exist



740
741
742
# File 'lib/files.com/models/file.rb', line 740

def action
  @attributes[:action]
end

#action=(value) ⇒ Object



744
745
746
# File 'lib/files.com/models/file.rb', line 744

def action=(value)
  @attributes[:action] = value
end

#advise(*_args) ⇒ Object



198
# File 'lib/files.com/models/file.rb', line 198

def advise(*_args); end

#atimeObject



200
201
202
# File 'lib/files.com/models/file.rb', line 200

def atime
  mtime
end

#autoclose=(*_args) ⇒ Object



204
# File 'lib/files.com/models/file.rb', line 204

def autoclose=(*_args); end

#autoclose?(*_args) ⇒ Boolean

Returns:

  • (Boolean)


206
# File 'lib/files.com/models/file.rb', line 206

def autoclose?(*_args); end

#binmodeObject



208
209
210
# File 'lib/files.com/models/file.rb', line 208

def binmode
  binmode?
end

#binmode?Boolean

Returns:

  • (Boolean)


212
213
214
# File 'lib/files.com/models/file.rb', line 212

def binmode?
  true
end

#birthtimeObject



216
217
218
# File 'lib/files.com/models/file.rb', line 216

def birthtime
  raise NotImplementedError
end

#bytesObject



220
221
222
# File 'lib/files.com/models/file.rb', line 220

def bytes
  read_io.bytes
end

#charsObject



224
225
226
# File 'lib/files.com/models/file.rb', line 224

def chars
  read_io.chars
end

#chmod(*_args) ⇒ Object



228
229
230
# File 'lib/files.com/models/file.rb', line 228

def chmod(*_args)
  raise NotImplementedError
end

#chown(*_args) ⇒ Object



232
233
234
# File 'lib/files.com/models/file.rb', line 232

def chown(*_args)
  raise NotImplementedError
end

#clientObject



236
237
238
# File 'lib/files.com/models/file.rb', line 236

def client
  options[:client] || ApiClient.active_client
end

#closeObject



240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
# File 'lib/files.com/models/file.rb', line 240

def close
  flush

  if @upload
    end_options = {
      "action": "end",
      "etags": @etags,
      "provided_mtime": Time.now.to_s,
      "ref": @upload.ref,
      "size": @bytes_written
    }

    file = File.create(path, end_options, @options)
    @attributes = file.attributes
    @upload = nil
  end
  @write_io.close
end

#close_on_exec=(*args) ⇒ Object



263
264
265
# File 'lib/files.com/models/file.rb', line 263

def close_on_exec=(*args)
  @write_io.close_on_exec = *args
end

#close_on_exec?(*args) ⇒ Boolean

Returns:

  • (Boolean)


259
260
261
# File 'lib/files.com/models/file.rb', line 259

def close_on_exec?(*args)
  @write_io.close_on_exec? *args
end

#close_read(*args) ⇒ Object



267
268
269
# File 'lib/files.com/models/file.rb', line 267

def close_read(*args)
  @write_io.close_read *args
end

#close_write(*args) ⇒ Object



271
272
273
# File 'lib/files.com/models/file.rb', line 271

def close_write(*args)
  @write_io.close_write *args
end

#closed?(*args) ⇒ Boolean

Returns:

  • (Boolean)


275
276
277
# File 'lib/files.com/models/file.rb', line 275

def closed?(*args)
  @write_io.closed? *args
end

#codepoints(*args, &block) ⇒ Object



279
280
281
# File 'lib/files.com/models/file.rb', line 279

def codepoints(*args, &block)
  @write_io.codepoints *args, &block
end

#copy(destination) ⇒ Object



283
284
285
# File 'lib/files.com/models/file.rb', line 283

def copy(destination)
  File.copy(path, destination)
end

#crc32Object

string - File CRC32 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.



650
651
652
# File 'lib/files.com/models/file.rb', line 650

def crc32
  @attributes[:crc32]
end

#crc32=(value) ⇒ Object



654
655
656
# File 'lib/files.com/models/file.rb', line 654

def crc32=(value)
  @attributes[:crc32] = value
end

#create(params = {}) ⇒ Object

Upload file

Parameters:

action - string - The action to perform.  Can be `append`, `attachment`, `end`, `upload`, `put`, or may not exist
etags[etag] (required) - array - etag identifier.
etags[part] (required) - array - Part number.
length - integer - Length of file.
mkdir_parents - boolean - Create parent directories if they do not exist?
part - integer - Part if uploading a part.
parts - integer - How many parts to fetch?
provided_mtime - string - User provided modification time.
ref - string -
restart - integer - File byte offset to restart from.
size - integer - Size of file.
structure - string - If copying folder, copy just the structure?
with_rename - boolean - Allow file rename instead of overwrite?


855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
# File 'lib/files.com/models/file.rb', line 855

def create(params = {})
  params ||= {}
  params[:path] = @attributes[:path]
  raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
  raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: action must be an String") if params.dig(:action) and !params.dig(:action).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: length must be an Integer") if params.dig(:length) and !params.dig(:length).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: part must be an Integer") if params.dig(:part) and !params.dig(:part).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: parts must be an Integer") if params.dig(:parts) and !params.dig(:parts).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: provided_mtime must be an String") if params.dig(:provided_mtime) and !params.dig(:provided_mtime).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: ref must be an String") if params.dig(:ref) and !params.dig(:ref).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: restart must be an Integer") if params.dig(:restart) and !params.dig(:restart).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: size must be an Integer") if params.dig(:size) and !params.dig(:size).is_a?(Integer)
  raise InvalidParameterError.new("Bad parameter: structure must be an String") if params.dig(:structure) and !params.dig(:structure).is_a?(String)
  raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)

  Api.send_request("/files/#{Addressable::URI.encode_component(params[:path])}", :post, params, @options)
end

#ctime(*_args) ⇒ Object



287
288
289
# File 'lib/files.com/models/file.rb', line 287

def ctime(*_args)
  mtime
end

#delete(params = {}) ⇒ Object

Parameters:

recursive - boolean - If true, will recursively delete folers.  Otherwise, will error on non-empty folders.  For legacy reasons, this parameter may also be provided as the HTTP header `Depth: Infinity`


891
892
893
894
895
896
897
898
899
# File 'lib/files.com/models/file.rb', line 891

def delete(params = {})
  params ||= {}
  params[:path] = @attributes[:path]
  raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
  raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
  raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)

  Api.send_request("/files/#{Addressable::URI.encode_component(params[:path])}", :delete, params, @options)
end

#destroy(params = {}) ⇒ Object



901
902
903
# File 'lib/files.com/models/file.rb', line 901

def destroy(params = {})
  delete(params)
end

#display_nameObject

string - File/Folder display name



605
606
607
# File 'lib/files.com/models/file.rb', line 605

def display_name
  @attributes[:display_name]
end

#display_name=(value) ⇒ Object



609
610
611
# File 'lib/files.com/models/file.rb', line 609

def display_name=(value)
  @attributes[:display_name] = value
end

#download(params = {}) ⇒ Object

Download file

Parameters:

action - string - Can be blank, `redirect` or `stat`.  If set to `stat`, we will return file information but without a download URL, and without logging a download.  If set to `redirect` we will serve a 302 redirect directly to the file.  This is used for integrations with Zapier, and is not recommended for most integrations.
id - integer - If provided, lookup the file by id instead of path.
with_previews - boolean - Include file preview information?
with_priority_color - boolean - Include file priority color information?


827
828
829
830
831
832
833
834
835
836
837
# File 'lib/files.com/models/file.rb', line 827

def download(params = {})
  params ||= {}
  params[:path] = @attributes[:path]
  raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
  raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: action must be an String") if params.dig(:action) and !params.dig(:action).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params.dig(:id) and !params.dig(:id).is_a?(Integer)
  raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)

  Api.send_request("/files/#{Addressable::URI.encode_component(params[:path])}", :get, params, @options)
end

#download_content(io) ⇒ Object



305
306
307
308
# File 'lib/files.com/models/file.rb', line 305

def download_content(io)
  response = client.remote_request(:get, download_uri_with_load)
  io.write(response.body)
end

#download_file(output_file) ⇒ Object



299
300
301
302
303
# File 'lib/files.com/models/file.rb', line 299

def download_file(output_file)
  ::File.open(output_file, 'wb') do |file|
    download_content(file)
  end
end

#download_uriObject

string - Link to download file. Provided only in response to a download request.



704
705
706
# File 'lib/files.com/models/file.rb', line 704

def download_uri
  @attributes[:download_uri]
end

#download_uri=(value) ⇒ Object



708
709
710
# File 'lib/files.com/models/file.rb', line 708

def download_uri=(value)
  @attributes[:download_uri] = value
end

#download_uri_with_loadObject



291
292
293
294
295
296
297
# File 'lib/files.com/models/file.rb', line 291

def download_uri_with_load
  return download_uri if download_uri

  file = File.download(path, {}, @options)
  @attributes = file.attributes
  download_uri
end

#each(*args, &block) ⇒ Object



310
311
312
# File 'lib/files.com/models/file.rb', line 310

def each(*args, &block)
  read_io.each *args, &block
end

#each_byte(*args, &block) ⇒ Object



314
315
316
# File 'lib/files.com/models/file.rb', line 314

def each_byte(*args, &block)
  read_io.each_byte *args, &block
end

#each_char(*args, &block) ⇒ Object



318
319
320
# File 'lib/files.com/models/file.rb', line 318

def each_char(*args, &block)
  read_io.each_char *args, &block
end

#each_codepoint(*args, &block) ⇒ Object



322
323
324
# File 'lib/files.com/models/file.rb', line 322

def each_codepoint(*args, &block)
  read_io.each_codepoint *args, &block
end

#each_line(*args, &block) ⇒ Object



326
327
328
# File 'lib/files.com/models/file.rb', line 326

def each_line(*args, &block)
  each(*args, &block)
end

#empty?Boolean

Returns:

  • (Boolean)


330
331
332
# File 'lib/files.com/models/file.rb', line 330

def empty?
  size == 0
end

#eofObject



334
335
336
# File 'lib/files.com/models/file.rb', line 334

def eof
  eof?
end

#eof?Boolean

Returns:

  • (Boolean)


338
339
340
# File 'lib/files.com/models/file.rb', line 338

def eof?
  @write_io.eof?
end

#external_encoding(*args) ⇒ Object



342
343
344
# File 'lib/files.com/models/file.rb', line 342

def external_encoding(*args)
  internal_encoding *args
end

#fcntl(*_args) ⇒ Object



346
347
348
# File 'lib/files.com/models/file.rb', line 346

def fcntl(*_args)
  raise NotImplementedError
end

#fdatasync(*_args) ⇒ Object



350
351
352
# File 'lib/files.com/models/file.rb', line 350

def fdatasync(*_args)
  flush
end

#fileno(*_args) ⇒ Object



354
355
356
# File 'lib/files.com/models/file.rb', line 354

def fileno(*_args)
  id
end

#flock(*_args) ⇒ Object



358
359
360
# File 'lib/files.com/models/file.rb', line 358

def flock(*_args)
  raise NotImplementedError
end

#flush(*_args) ⇒ Object



362
363
364
365
366
367
368
369
370
371
# File 'lib/files.com/models/file.rb', line 362

def flush(*_args)
  if mode.include? "w"
    @write_io.rewind if @write_io.is_a?(StringIO)

    @bytes_written += @write_io.size
    @upload, @etags = File.upload_chunks(@write_io, path, options, @upload, @etags)
  elsif mode.include? "a"
    raise NotImplementedError
  end
end

#fsync(*args) ⇒ Object



373
374
375
# File 'lib/files.com/models/file.rb', line 373

def fsync(*args)
  flush *args
end

#getbyte(*args) ⇒ Object



377
378
379
# File 'lib/files.com/models/file.rb', line 377

def getbyte(*args)
  read_io.getbyte *args
end

#getc(*args) ⇒ Object



381
382
383
# File 'lib/files.com/models/file.rb', line 381

def getc(*args)
  read_io.getc *args
end

#gets(*args) ⇒ Object



385
386
387
# File 'lib/files.com/models/file.rb', line 385

def gets(*args)
  read_io.gets *args
end

#idObject

int64 - File/Folder ID



587
588
589
# File 'lib/files.com/models/file.rb', line 587

def id
  @attributes[:id]
end

#id=(value) ⇒ Object



591
592
593
# File 'lib/files.com/models/file.rb', line 591

def id=(value)
  @attributes[:id] = value
end

#internal_encoding(*_args) ⇒ Object



398
399
400
# File 'lib/files.com/models/file.rb', line 398

def internal_encoding(*_args)
  "".encoding
end

#ioctl(*_args) ⇒ Object



402
403
404
# File 'lib/files.com/models/file.rb', line 402

def ioctl(*_args)
  raise NotImplementedError
end

#isatty(*_args) ⇒ Object



406
407
408
# File 'lib/files.com/models/file.rb', line 406

def isatty(*_args)
  false
end

#lengthObject

int64 - Length of file.



749
750
751
# File 'lib/files.com/models/file.rb', line 749

def length
  @attributes[:length]
end

#length=(value) ⇒ Object



753
754
755
# File 'lib/files.com/models/file.rb', line 753

def length=(value)
  @attributes[:length] = value
end

#lines(*args, &block) ⇒ Object



416
417
418
# File 'lib/files.com/models/file.rb', line 416

def lines(*args, &block)
  each_line *args, &block
end

#lstat(*_args) ⇒ Object



420
421
422
# File 'lib/files.com/models/file.rb', line 420

def lstat(*_args)
  stats
end

#md5Object

string - File MD5 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.



659
660
661
# File 'lib/files.com/models/file.rb', line 659

def md5
  @attributes[:md5]
end

#md5=(value) ⇒ Object



663
664
665
# File 'lib/files.com/models/file.rb', line 663

def md5=(value)
  @attributes[:md5] = value
end

#mime_typeObject

string - MIME Type. This is determined by the filename extension and is not stored separately internally.



668
669
670
# File 'lib/files.com/models/file.rb', line 668

def mime_type
  @attributes[:mime_type]
end

#mime_type=(value) ⇒ Object



672
673
674
# File 'lib/files.com/models/file.rb', line 672

def mime_type=(value)
  @attributes[:mime_type] = value
end

#mkdir_parentsObject

boolean - Create parent directories if they do not exist?



758
759
760
# File 'lib/files.com/models/file.rb', line 758

def mkdir_parents
  @attributes[:mkdir_parents]
end

#mkdir_parents=(value) ⇒ Object



762
763
764
# File 'lib/files.com/models/file.rb', line 762

def mkdir_parents=(value)
  @attributes[:mkdir_parents] = value
end

#move(destination) ⇒ Object



424
425
426
# File 'lib/files.com/models/file.rb', line 424

def move(destination)
  File.move(path, destination)
end

#mtimeObject

date-time - File last modified date/time, according to the server. This is the timestamp of the last Files.com operation of the file, regardless of what modified timestamp was sent.



632
633
634
# File 'lib/files.com/models/file.rb', line 632

def mtime
  @attributes[:mtime]
end

#mtime=(value) ⇒ Object



636
637
638
# File 'lib/files.com/models/file.rb', line 636

def mtime=(value)
  @attributes[:mtime] = value
end

#mv(destination) ⇒ Object



428
429
430
# File 'lib/files.com/models/file.rb', line 428

def mv(destination)
  File.move(path, destination)
end

#partObject

int64 - Part if uploading a part.



767
768
769
# File 'lib/files.com/models/file.rb', line 767

def part
  @attributes[:part]
end

#part=(value) ⇒ Object



771
772
773
# File 'lib/files.com/models/file.rb', line 771

def part=(value)
  @attributes[:part] = value
end

#partsObject

int64 - How many parts to fetch?



776
777
778
# File 'lib/files.com/models/file.rb', line 776

def parts
  @attributes[:parts]
end

#parts=(value) ⇒ Object



780
781
782
# File 'lib/files.com/models/file.rb', line 780

def parts=(value)
  @attributes[:parts] = value
end

#pathObject

string - File/Folder path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.



596
597
598
# File 'lib/files.com/models/file.rb', line 596

def path
  @attributes[:path]
end

#path=(value) ⇒ Object



600
601
602
# File 'lib/files.com/models/file.rb', line 600

def path=(value)
  @attributes[:path] = value
end

#permissionsObject

string - A short string representing the current user’s permissions. Can be ‘r`,`w`,`p`, or any combination



686
687
688
# File 'lib/files.com/models/file.rb', line 686

def permissions
  @attributes[:permissions]
end

#permissions=(value) ⇒ Object



690
691
692
# File 'lib/files.com/models/file.rb', line 690

def permissions=(value)
  @attributes[:permissions] = value
end

#pid(*_args) ⇒ Object



432
433
434
# File 'lib/files.com/models/file.rb', line 432

def pid(*_args)
  Process.pid
end

#pread(*args) ⇒ Object



442
443
444
# File 'lib/files.com/models/file.rb', line 442

def pread(*args)
  read_io.pread *args
end

#previewObject

File preview



731
732
733
# File 'lib/files.com/models/file.rb', line 731

def preview
  @attributes[:preview]
end

#preview=(value) ⇒ Object



735
736
737
# File 'lib/files.com/models/file.rb', line 735

def preview=(value)
  @attributes[:preview] = value
end

#preview_idObject

int64 - File preview ID



722
723
724
# File 'lib/files.com/models/file.rb', line 722

def preview_id
  @attributes[:preview_id]
end

#preview_id=(value) ⇒ Object



726
727
728
# File 'lib/files.com/models/file.rb', line 726

def preview_id=(value)
  @attributes[:preview_id] = value
end


446
447
448
# File 'lib/files.com/models/file.rb', line 446

def print(*args)
  @write_io.print *args
end

#printf(*args) ⇒ Object



450
451
452
# File 'lib/files.com/models/file.rb', line 450

def printf(*args)
  @write_io.printf *args
end

#priority_colorObject

string - Bookmark/priority color of file/folder



713
714
715
# File 'lib/files.com/models/file.rb', line 713

def priority_color
  @attributes[:priority_color]
end

#priority_color=(value) ⇒ Object



717
718
719
# File 'lib/files.com/models/file.rb', line 717

def priority_color=(value)
  @attributes[:priority_color] = value
end

#provided_mtimeObject

date-time - File last modified date/time, according to the client who set it. Files.com allows desktop, FTP, SFTP, and WebDAV clients to set modified at times. This allows Desktop<->Cloud syncing to preserve modified at times.



641
642
643
# File 'lib/files.com/models/file.rb', line 641

def provided_mtime
  @attributes[:provided_mtime]
end

#provided_mtime=(value) ⇒ Object



645
646
647
# File 'lib/files.com/models/file.rb', line 645

def provided_mtime=(value)
  @attributes[:provided_mtime] = value
end

#putc(*args) ⇒ Object



454
455
456
# File 'lib/files.com/models/file.rb', line 454

def putc(*args)
  @write_io.putc *args
end

#puts(*args) ⇒ Object



458
459
460
# File 'lib/files.com/models/file.rb', line 458

def puts(*args)
  @write_io.puts *args
end

#pwrite(*args) ⇒ Object



462
463
464
# File 'lib/files.com/models/file.rb', line 462

def pwrite(*args)
  @write_io.pwrite *args
end

#read(*args) ⇒ Object



466
467
468
# File 'lib/files.com/models/file.rb', line 466

def read(*args)
  read_io.read *args
end

#read_ioObject



389
390
391
392
393
394
395
396
# File 'lib/files.com/models/file.rb', line 389

def read_io
  @read_io ||= begin
    io = StringIO.new
    download_content(io)
    io.rewind
    io
  end
end

#read_nonblock(*args) ⇒ Object



470
471
472
# File 'lib/files.com/models/file.rb', line 470

def read_nonblock(*args)
  read_io.read_nonblock *args
end

#readbyte(*args) ⇒ Object



474
475
476
# File 'lib/files.com/models/file.rb', line 474

def readbyte(*args)
  read_io.readbyte *args
end

#readchar(*args) ⇒ Object



478
479
480
# File 'lib/files.com/models/file.rb', line 478

def readchar(*args)
  read_io.readchar *args
end

#readline(*args) ⇒ Object



482
483
484
# File 'lib/files.com/models/file.rb', line 482

def readline(*args)
  read_io.readline *args
end

#readlines(*args) ⇒ Object



486
487
488
# File 'lib/files.com/models/file.rb', line 486

def readlines(*args)
  io.readlines(*args)
end

#readpartial(*args) ⇒ Object



490
491
492
# File 'lib/files.com/models/file.rb', line 490

def readpartial(*args)
  read_io.readpartial *args
end

#refObject

string -



785
786
787
# File 'lib/files.com/models/file.rb', line 785

def ref
  @attributes[:ref]
end

#ref=(value) ⇒ Object



789
790
791
# File 'lib/files.com/models/file.rb', line 789

def ref=(value)
  @attributes[:ref] = value
end

#regionObject

string - Region location



677
678
679
# File 'lib/files.com/models/file.rb', line 677

def region
  @attributes[:region]
end

#region=(value) ⇒ Object



681
682
683
# File 'lib/files.com/models/file.rb', line 681

def region=(value)
  @attributes[:region] = value
end

#rename(destination) ⇒ Object



494
495
496
# File 'lib/files.com/models/file.rb', line 494

def rename(destination)
  File.rename(path, destination)
end

#reopen(*_args) ⇒ Object



498
499
500
# File 'lib/files.com/models/file.rb', line 498

def reopen(*_args)
  raise NotImplementedError
end

#restartObject

int64 - File byte offset to restart from.



794
795
796
# File 'lib/files.com/models/file.rb', line 794

def restart
  @attributes[:restart]
end

#restart=(value) ⇒ Object



798
799
800
# File 'lib/files.com/models/file.rb', line 798

def restart=(value)
  @attributes[:restart] = value
end

#rewindObject



502
503
504
# File 'lib/files.com/models/file.rb', line 502

def rewind
  @pos = 0
end

#saveObject



905
906
907
908
909
910
911
912
# File 'lib/files.com/models/file.rb', line 905

def save
  if @attributes[:path]
    update(@attributes)
  else
    new_obj = File.create(@attributes, @options)
    @attributes = new_obj.attributes
  end
end

#seek(pos) ⇒ Object



506
507
508
# File 'lib/files.com/models/file.rb', line 506

def seek(pos)
  @pos = pos
end

#set_encoding(*_args) ⇒ Object

rubocop:disable Naming/AccessorMethodName



510
511
512
# File 'lib/files.com/models/file.rb', line 510

def set_encoding(*_args) # rubocop:disable Naming/AccessorMethodName
  raise NotImplementedError
end

#sizeObject

int64 - File/Folder size



623
624
625
# File 'lib/files.com/models/file.rb', line 623

def size
  @attributes[:size]
end

#size=(value) ⇒ Object



627
628
629
# File 'lib/files.com/models/file.rb', line 627

def size=(value)
  @attributes[:size] = value
end

#stat(*_args) ⇒ Object



514
515
516
# File 'lib/files.com/models/file.rb', line 514

def stat(*_args)
  stats
end

#structureObject

string - If copying folder, copy just the structure?



803
804
805
# File 'lib/files.com/models/file.rb', line 803

def structure
  @attributes[:structure]
end

#structure=(value) ⇒ Object



807
808
809
# File 'lib/files.com/models/file.rb', line 807

def structure=(value)
  @attributes[:structure] = value
end

#subfolders_locked=(value) ⇒ Object



699
700
701
# File 'lib/files.com/models/file.rb', line 699

def subfolders_locked=(value)
  @attributes[:subfolders_locked?] = value
end

#subfolders_locked?Boolean

boolean - Are subfolders locked and unable to be modified?

Returns:

  • (Boolean)


695
696
697
# File 'lib/files.com/models/file.rb', line 695

def subfolders_locked?
  @attributes[:subfolders_locked?]
end

#sysread(*args) ⇒ Object



524
525
526
# File 'lib/files.com/models/file.rb', line 524

def sysread(*args)
  read *args
end

#sysseek(*args) ⇒ Object



528
529
530
# File 'lib/files.com/models/file.rb', line 528

def sysseek(*args)
  seek *args
end

#syswrite(*_args) ⇒ Object



532
533
534
# File 'lib/files.com/models/file.rb', line 532

def syswrite(*_args)
  raise NotImplementedError
end

#tellObject



536
537
538
# File 'lib/files.com/models/file.rb', line 536

def tell
  pos
end

#to_i(*_args) ⇒ Object



540
541
542
# File 'lib/files.com/models/file.rb', line 540

def to_i(*_args)
  fileno
end

#to_io(*_args) ⇒ Object



544
545
546
# File 'lib/files.com/models/file.rb', line 544

def to_io(*_args)
  @write_io
end

#to_path(*_args) ⇒ Object



548
549
550
# File 'lib/files.com/models/file.rb', line 548

def to_path(*_args)
  path
end

#truncate(*_args) ⇒ Object



552
553
554
# File 'lib/files.com/models/file.rb', line 552

def truncate(*_args)
  raise NotImplementedError
end

#tty?(*_args) ⇒ Boolean

Returns:

  • (Boolean)


556
557
558
# File 'lib/files.com/models/file.rb', line 556

def tty?(*_args)
  false
end

#typeObject

string - Type: ‘directory` or `file`.



614
615
616
# File 'lib/files.com/models/file.rb', line 614

def type
  @attributes[:type]
end

#type=(value) ⇒ Object



618
619
620
# File 'lib/files.com/models/file.rb', line 618

def type=(value)
  @attributes[:type] = value
end

#ungetbyte(*_args) ⇒ Object



560
561
562
# File 'lib/files.com/models/file.rb', line 560

def ungetbyte(*_args)
  raise NotImplementedError
end

#ungetc(*_args) ⇒ Object



564
565
566
# File 'lib/files.com/models/file.rb', line 564

def ungetc(*_args)
  raise NotImplementedError
end

#update(params = {}) ⇒ Object

Parameters:

provided_mtime - string - Modified time of file.
priority_color - string - Priority/Bookmark color of file.


877
878
879
880
881
882
883
884
885
886
887
# File 'lib/files.com/models/file.rb', line 877

def update(params = {})
  params ||= {}
  params[:path] = @attributes[:path]
  raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
  raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: provided_mtime must be an String") if params.dig(:provided_mtime) and !params.dig(:provided_mtime).is_a?(String)
  raise InvalidParameterError.new("Bad parameter: priority_color must be an String") if params.dig(:priority_color) and !params.dig(:priority_color).is_a?(String)
  raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)

  Api.send_request("/files/#{Addressable::URI.encode_component(params[:path])}", :patch, params, @options)
end

#upload_file(local_file) ⇒ Object



568
569
570
# File 'lib/files.com/models/file.rb', line 568

def upload_file(local_file)
  File.upload_file(local_file. path)
end

#with_renameObject

boolean - Allow file rename instead of overwrite?



812
813
814
# File 'lib/files.com/models/file.rb', line 812

def with_rename
  @attributes[:with_rename]
end

#with_rename=(value) ⇒ Object



816
817
818
# File 'lib/files.com/models/file.rb', line 816

def with_rename=(value)
  @attributes[:with_rename] = value
end

#write(*args) ⇒ Object



572
573
574
575
576
577
578
579
580
# File 'lib/files.com/models/file.rb', line 572

def write(*args)
  @mode ||= 'w'
  if args[0].respond_to?(:read)
    flush if @write_io.size > 0
    @write_io = args[0]
  else
    @write_io.write *args
  end
end

#write_nonblock(*args) ⇒ Object



582
583
584
# File 'lib/files.com/models/file.rb', line 582

def write_nonblock(*args)
  @write_io.write_nonblock *args
end