Class: Saviour::File

Inherits:
Object
  • Object
show all
Defined in:
lib/saviour/file.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(uploader_klass, model, attached_as) ⇒ File

Returns a new instance of File.



8
9
10
11
 
# File 'lib/saviour/file.rb', line 8

def initialize(uploader_klass, model, attached_as)
  @uploader_klass, @model, @attached_as = uploader_klass, model, attached_as
  @source_was = @source = nil
end

Instance Attribute Details

#persisted_path ⇒ Object (readonly)

Returns the value of attribute persisted_path.



5
6
7
 
# File 'lib/saviour/file.rb', line 5

def persisted_path
  @persisted_path
end

#source ⇒ Object (readonly)

Returns the value of attribute source.



6
7
8
 
# File 'lib/saviour/file.rb', line 6

def source
  @source
end

Instance Method Details

#==(another_file) ⇒ Object 



34
35
36
37
38
39
40
41
42
43
 
# File 'lib/saviour/file.rb', line 34

def ==(another_file)
  return false unless another_file.is_a?(Saviour::File)
  return false unless another_file.persisted? == persisted?

  if persisted?
    another_file.persisted_path == persisted_path
  else
    another_file.source == @source
  end
end

#__maybe_with_tmpfile(source_type, file) ⇒ Object 



115
116
117
118
119
120
121
122
123
124
125
126
 
# File 'lib/saviour/file.rb', line 115

def __maybe_with_tmpfile(source_type, file)
  return yield if source_type == :stream

  tmpfile = Tempfile.new([::File.basename(file.path, ".*"), ::File.extname(file.path)])
  FileUtils.cp(file.path, tmpfile.path)

  begin
    yield(tmpfile)
  ensure
    tmpfile.close!
  end
end

#assign(object) ⇒ Object

Raises:



67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
 
# File 'lib/saviour/file.rb', line 67

def assign(object)
  raise(SourceError, "given object to #assign or #<attach_as>= must respond to `read`") if object && !object.respond_to?(:read)

  followers = @model.class.attached_followers_per_leader[@attached_as]
  followers.each { |x| @model.send(x).assign(object) unless @model.send(x).changed? } if followers

  @source_data = nil
  @source = object

  if changed? && @model.respond_to?("#{@attached_as}_will_change!")
    @model.send "#{@attached_as}_will_change!"
  end

  @persisted_path = nil if object

  object
end

#blank? ⇒ Boolean

Returns:

  • (Boolean) 


172
173
174
 
# File 'lib/saviour/file.rb', line 172

def blank?
  !@source && !persisted?
end

#changed? ⇒ Boolean

Returns:

  • (Boolean) 


89
90
91
 
# File 'lib/saviour/file.rb', line 89

def changed?
  @source_was != @source
end

#clone ⇒ Object 



45
46
47
48
49
50
51
 
# File 'lib/saviour/file.rb', line 45

def clone
  return nil unless persisted?

  new_file = Saviour::File.new(@uploader_klass, @model, @attached_as)
  new_file.set_path! @persisted_path
  new_file
end

#delete ⇒ Object 



26
27
28
 
# File 'lib/saviour/file.rb', line 26

def delete
  persisted? && Config.storage.delete(@persisted_path)
end

#dup ⇒ Object 



53
54
55
56
57
58
59
60
61
62
63
 
# File 'lib/saviour/file.rb', line 53

def dup
  new_file = Saviour::File.new(@uploader_klass, @model, @attached_as)

  if persisted?
    new_file.assign(Saviour::StringSource.new(read, filename))
  else
    new_file.assign(Saviour::StringSource.new(source_data, filename_to_be_assigned))
  end

  new_file
end

#exists? ⇒ Boolean

Returns:

  • (Boolean) 


18
19
20
 
# File 'lib/saviour/file.rb', line 18

def exists?
  persisted? && Config.storage.exists?(@persisted_path)
end

#filename ⇒ Object 



93
94
95
 
# File 'lib/saviour/file.rb', line 93

def filename
  ::File.basename(@persisted_path) if persisted?
end

#filename_to_be_assigned ⇒ Object 



111
112
113
 
# File 'lib/saviour/file.rb', line 111

def filename_to_be_assigned
  changed? ? (SourceFilenameExtractor.new(@source).detected_filename || SecureRandom.hex) : nil
end

#persisted? ⇒ Boolean

Returns:

  • (Boolean) 


85
86
87
 
# File 'lib/saviour/file.rb', line 85

def persisted?
  !!@persisted_path
end

#public_url ⇒ Object Also known as: url 



30
31
32
 
# File 'lib/saviour/file.rb', line 30

def public_url
  persisted? && Config.storage.public_url(@persisted_path)
end

#read ⇒ Object 



22
23
24
 
# File 'lib/saviour/file.rb', line 22

def read
  persisted? && Config.storage.read(@persisted_path)
end

#set_path!(path) ⇒ Object 



13
14
15
16
 
# File 'lib/saviour/file.rb', line 13

def set_path!(path)
  @persisted_path = path
  @persisted_path_before_last_save = path
end

#source_data ⇒ Object 



165
166
167
168
169
170
 
# File 'lib/saviour/file.rb', line 165

def source_data
  @source_data ||= begin
    @source.rewind
    @source.read
  end
end

#source_type ⇒ Object 



157
158
159
160
161
162
163
 
# File 'lib/saviour/file.rb', line 157

def source_type
  if @source.respond_to?(:path)
    :file
  else
    :stream
  end
end

#with_copy ⇒ Object

Raises:



97
98
99
100
101
102
103
104
105
106
107
108
109
 
# File 'lib/saviour/file.rb', line 97

def with_copy
  raise CannotCopy, "must be persisted" unless persisted?

  temp_file = Tempfile.new([::File.basename(filename, ".*"), ::File.extname(filename)])

  begin
    Config.storage.read_to_file(@persisted_path, temp_file)

    yield(temp_file)
  ensure
    temp_file.close!
  end
end

#write(before_write: nil) ⇒ Object

Raises:



128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
 
# File 'lib/saviour/file.rb', line 128

def write(before_write: nil)
  raise(MissingSource, "You must provide a source to read from before trying to write") unless @source

  __maybe_with_tmpfile(source_type, @source) do |tmpfile|
    contents, path = case source_type
                       when :stream
                         uploader._process_as_contents(source_data, filename_to_be_assigned)
                       when :file
                         uploader._process_as_file(tmpfile, filename_to_be_assigned)
                     end
    @source_was = @source

    if path
      before_write.call(path) if before_write

      case source_type
        when :stream
          Config.storage.write(contents, path)
        when :file
          Config.storage.write_from_file(contents, path)
      end

      @persisted_path = path
      @persisted_path_before_last_save = path
      path
    end
  end
end