Class: GroupDocs::Storage::Folder

Inherits:
Api::Entity show all
Includes:
Api::Helpers::AccessMode, Api::Helpers::Path
Defined in:
lib/groupdocs/storage/folder.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Api::Helpers::Path

included

Methods inherited from Api::Entity

#initialize, #inspect, #to_hash

Constructor Details

This class inherits a constructor from GroupDocs::Api::Entity

Instance Attribute Details

#access ⇒ Symbol

Converts access mode to human-readable format.

Returns:

  • (Symbol) 


71
72
73
 
# File 'lib/groupdocs/storage/folder.rb', line 71

def access
  @access
end

#created_on ⇒ Time

Converts timestamp which is return by API server to Time object.

Returns:

  • (Time) 


57
58
59
 
# File 'lib/groupdocs/storage/folder.rb', line 57

def created_on
  @created_on
end

#file_count ⇒ Object 



55
56
57
 
# File 'lib/groupdocs/storage/folder.rb', line 55

def file_count
  @file_count
end

#folder_count ⇒ Object 



53
54
55
 
# File 'lib/groupdocs/storage/folder.rb', line 53

def folder_count
  @folder_count
end

#id ⇒ Object 



49
50
51
 
# File 'lib/groupdocs/storage/folder.rb', line 49

def id
  @id
end

#modified_on ⇒ Time

Converts timestamp which is return by API server to Time object.

Returns:

  • (Time) 


59
60
61
 
# File 'lib/groupdocs/storage/folder.rb', line 59

def modified_on
  @modified_on
end

#name ⇒ Object 



63
64
65
 
# File 'lib/groupdocs/storage/folder.rb', line 63

def name
  @name
end

#path ⇒ Object 



65
66
67
 
# File 'lib/groupdocs/storage/folder.rb', line 65

def path
  @path
end

#size ⇒ Object 



51
52
53
 
# File 'lib/groupdocs/storage/folder.rb', line 51

def size
  @size
end

#type ⇒ Object 



69
70
71
 
# File 'lib/groupdocs/storage/folder.rb', line 69

def type
  @type
end

#url ⇒ Object 



61
62
63
 
# File 'lib/groupdocs/storage/folder.rb', line 61

def url
  @url
end

#version ⇒ Object 



67
68
69
 
# File 'lib/groupdocs/storage/folder.rb', line 67

def version
  @version
end

Class Method Details

.create!(path, access = {}) ⇒ GroupDocs::Storage::Folder

Creates folder on server.

Parameters:

  • path (String) —

    Path of folder to create starting with “/”

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:



17
18
19
20
21
22
23
24
25
26
27
 
# File 'lib/groupdocs/storage/folder.rb', line 17

def self.create!(path, access = {})
  path = prepare_path(path)

  json = Api::Request.new do |request|
    request[:access] = access
    request[:method] = :POST
    request[:path] = "/storage/{{client_id}}/paths/#{path}"
  end.execute!

  Storage::Folder.new(json)
end

.list!(path = '', options = {}, access = {}) ⇒ Array<GroupDocs::Storage::Folder, GroupDocs::Storage::File>

Returns a list of all directories and files in the path.

Parameters:

  • path (String) (defaults to: '') —

    Path of directory to list starting from root (‘/’)

  • options (Hash) (defaults to: {}) —

    Hash of options

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (options):

  • :page (Integer) —

    Page to start with

  • :count (Integer) —

    How many items to list

  • :order_by (String) —

    Field name to sort by

  • :order_asc (Boolean) —

    Set to true to return in ascending order

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:



43
44
45
46
 
# File 'lib/groupdocs/storage/folder.rb', line 43

def self.list!(path = '', options = {}, access = {})
  path = prepare_path(path)
  new(path: path).list!(options, access)
end

Instance Method Details

#copy!(destination, access = {}) ⇒ String

Copies folder contents to given path.

Parameters:

  • destination_path (String) —

    Destination to copy contents to

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:

  • (String) —

    Copied to folder path



169
170
171
172
173
174
175
176
177
178
179
180
181
 
# File 'lib/groupdocs/storage/folder.rb', line 169

def copy!(destination, access = {})
  src_path = prepare_path(path)
  dst_path = prepare_path("#{destination}/#{name}")

  Api::Request.new do |request|
    request[:access] = access
    request[:method] = :PUT
    request[:headers] = { :'Groupdocs-Copy' => src_path }
    request[:path] = "/storage/{{client_id}}/folders/#{dst_path}"
  end.execute!

  dst_path
end

#create!(access = {}) ⇒ GroupDocs::Storage::Folder

Creates folder on server.

Note that it doesn’t update self and instead returns new instance.

Examples:

folder = GroupDocs::Storage::Folder.new(name: 'Folder')
folder = folder.create!

Parameters:

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:



197
198
199
 
# File 'lib/groupdocs/storage/folder.rb', line 197

def create!(access = {})
  self.class.create! prepare_path("#{path}/#{name}"), access
end

#delete!(access = {}) ⇒ Object

Deletes folder from server.

Parameters:

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String) 


208
209
210
211
212
213
214
 
# File 'lib/groupdocs/storage/folder.rb', line 208

def delete!(access = {})
  Api::Request.new do |request|
    request[:access] = access
    request[:method] = :DELETE
    request[:path] = "/storage/{{client_id}}/folders/#{prepare_path("#{path}/#{name}")}"
  end.execute!
end

#list!(options = {}, access = {}) ⇒ Array<GroupDocs::Storage::Folder, GroupDocs::Storage::File>

Returns an array of files and folders.

Parameters:

  • options (Hash) (defaults to: {}) —

    Hash of options

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (options):

  • :page (Integer) —

    Page to start with

  • :count (Integer) —

    How many items to list

  • :order_by (String) —

    Field name to sort by

  • :order_asc (Boolean) —

    Set to true to return in ascending order

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:



113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
 
# File 'lib/groupdocs/storage/folder.rb', line 113

def list!(options = {}, access = {})
  options[:order_by].capitalize! if options[:order_by]
  full_path = prepare_path("#{path}/#{name}")

  api = Api::Request.new do |request|
    request[:access] = access
    request[:method] = :GET
    request[:path] = "/storage/{{client_id}}/folders/#{full_path}"
  end
  api.add_params(options)
  json = api.execute!

  folders = json[:folders].map do |folder|
    folder.merge!(path: full_path)
    Storage::Folder.new(folder)
  end
  files = json[:files].map do |file|
    file.merge!(path: full_path)
    Storage::File.new(file)
  end

  folders + files
end

#move!(destination, access = {}) ⇒ String

Moves folder contents to given path.

Parameters:

  • destination (String) —

    Destination to move contents to

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:

  • (String) —

    Moved to folder path



146
147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'lib/groupdocs/storage/folder.rb', line 146

def move!(destination, access = {})
  src_path = prepare_path(path)
  dst_path = prepare_path("#{destination}/#{name}")

  Api::Request.new do |request|
    request[:access] = access
    request[:method] = :PUT
    request[:headers] = { :'Groupdocs-Move' => src_path }
    request[:path] = "/storage/{{client_id}}/folders/#{dst_path}"
  end.execute!

  dst_path
end

#sharers!(access = {}) ⇒ Array<GroupDocs::User>

Returns an array of users a folder is shared with.

Parameters:

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:



224
225
226
227
228
229
230
231
232
233
234
 
# File 'lib/groupdocs/storage/folder.rb', line 224

def sharers!(access = {})
  json = Api::Request.new do |request|
    request[:access] = access
    request[:method] = :GET
    request[:path] = "/doc/{{client_id}}/folders/#{id}/sharers"
  end.execute!

  json[:shared_users].map do |user|
    User.new(user)
  end
end

#sharers_clear!(access = {}) ⇒ Object

Clears sharers list.

Parameters:

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:

  • nil



272
273
274
275
276
277
278
 
# File 'lib/groupdocs/storage/folder.rb', line 272

def sharers_clear!(access = {})
  Api::Request.new do |request|
    request[:access] = access
    request[:method] = :DELETE
    request[:path] = "/doc/{{client_id}}/folders/#{id}/sharers"
  end.execute![:shared_users]
end

#sharers_set!(emails, access = {}) ⇒ Array<GroupDocs::User>

Sets folder sharers to given emails.

If empty array or nil passed, clears sharers.

Parameters:

  • emails (Array) —

    List of email addresses to share with

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:



247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
 
# File 'lib/groupdocs/storage/folder.rb', line 247

def sharers_set!(emails, access = {})
  if emails.nil? || emails.empty?
    sharers_clear!(access)
  else
    json = Api::Request.new do |request|
      request[:access] = access
      request[:method] = :PUT
      request[:path] = "/doc/{{client_id}}/folders/#{id}/sharers"
      request[:request_body] = emails
    end.execute!

    json[:shared_users].map do |user|
      User.new(user)
    end
  end
end