Skip to content
Upload solution for Hanami using Shrine library
Ruby Shell
Branch: master
Clone or download
taman9333 and katafrakt Fix error undefined method merge (#11)
remove shrine from gemfile as it's included in gemspec with the right version
Latest commit 6b40aba Nov 6, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.


This gem aims at providing support for Shrine uploader in Hanami applications. It also tries to be as simple as possible, without polluting the world around.

Build Status Gem Version Code Climate


Add this line to your application's Gemfile:

gem 'hanami-shrine'

And then execute:

$ bundle


Setup Shrine with hanami plugin enabled. Check Shrine's repository for more detailed description of the process.

class ImageAttachment < Shrine
  plugin :hanami

Then, in your repository add (assuming your attachment is avatar):

prepend ImageAttachment.repository(:avatar)

And in your entity:

include ImageAttachment[:avatar]

For inspiration read a blog post, look at the specs or example repo.

Important changes since 0.1 version

As Hanami has been upgraded to 0.9, it started to use new engine for the entities in hanami-model. It required heavy changes in hanami-shrine to accomodate to new paradigm. Unfortunately, some of them are breaking. Here's a summary list:

  • Validations are gone (for now, hopefully)
  • You need to use prepend instead of extend in your repository
  • Entities are now read-only. You need to initialize them with the attachment, not add it later:'my_avatar.png'). This is a Hanami change, but it's worth mentioning here as well.


After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to


Testing is done against 3 major database engines: PostgreSQL, MySQL and sqlite3. It is steered by environment variable DB. To run locally, first cp .env.travis .env, then put values matching your local configuration there. After that, you can test all three versions:

DB=sqlite bundle exec rake
DB=postgres bundle exec rake
DB=mysql bundle exec rake


Bug reports and pull requests are welcome on GitHub at


The gem is available as open source under the terms of the MIT License.

Cat images (used in tests) are public domain taken from Wikimedia Commons.

You can’t perform that action at this time.