1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00
Ruby on Rails
Find a file
David Heinemeier Hansson c624df326a ActiveVault -> ActiveStorage
Yaroslav agreed to hand over the gem name ❤️
2017-07-06 11:33:29 +02:00
lib ActiveVault -> ActiveStorage 2017-07-06 11:33:29 +02:00
test ActiveVault -> ActiveStorage 2017-07-06 11:33:29 +02:00
.gitignore Ignore byebug history 2017-07-01 12:09:54 +02:00
activestorage.gemspec ActiveVault -> ActiveStorage 2017-07-06 11:33:29 +02:00
Gemfile Use lazy-loaded factory method for site configuration 2017-07-04 16:44:50 +02:00
Gemfile.lock ActiveVault -> ActiveStorage 2017-07-06 11:33:29 +02:00
MIT-LICENSE First sketching 2017-06-30 19:12:58 +02:00
Rakefile Extract shared tests 2017-07-04 15:28:47 +02:00
README.md ActiveVault -> ActiveStorage 2017-07-06 11:33:29 +02:00

Active Vault

Active Vault makes it simple to upload and reference files in cloud sites, like Amazon S3 or Google Cloud Storage, and attach those files to Active Records. It also provides a disk site for testing or local deployments, but the focus is on cloud storage.

Example

One attachment:

class User < ApplicationRecord
  has_one_attached :avatar
end

user.avatar.attach io: File.open("~/face.jpg"), filename: "avatar.jpg", content_type: "image/jpg"
user.avatar.exist? # => true

user.avatar.purge
user.avatar.exist? # => false

user.avatar.url(expires_in: 5.minutes) # => /rails/blobs/<encoded-key>

class AvatarsController < ApplicationController
  def update
    Current.user.avatar.attach(params.require(:avatar))
    redirect_to Current.user
  end
end

Many attachments:

class Message < ApplicationRecord
  has_many_attached :images
end

<%= form_with model: @message do |form| %>
  <%= form.text_field :title, placeholder: "Title" %><br>
  <%= form.text_area :content %><br><br>
  
  <%= form.file_field :images, multiple: true %><br>
  <%= form.submit %>
<% end %>

class MessagesController < ApplicationController
  def create
    message = Message.create! params.require(:message).permit(:title, :content)
    message.images.attach(params[:message][:images])
    redirect_to message
  end
end

Configuration

Add require "active_storage" to config/application.rb and create a config/initializers/active_storage_sites.rb with the following:

  

Todos

  • Strip Download of its resposibilities and delete class
  • Proper logging
  • Convert MirrorSite to use threading
  • Read metadata via Marcel?
  • Copy over migration to app via rake task
  • Add Migrator to copy/move between sites
  • Explore direct uploads to cloud
  • Extract VerifiedKeyWithExpiration into Rails as a feature of MessageVerifier

License

Active Vault is released under the MIT License.