Lotus::Shrine

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

For now it's not released to RubyGems so please, use the git version. I promise to release as soon as I think it makes any sense :wink:

Installation

Add this line to your application's Gemfile:

gem 'lotus-shrine', github: 'katafrakt/lotus-shrine'

And then execute:

$ bundle

Usage

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

class ImageAttachment < Shrine
  plugin :lotus
end

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

extend ImageAttachment.repository(:avatar)

And in your entity:

include ImageAttachment[:avatar]

To use validations, enable them during setup of the plugin:

class ImageAttachment < Shrine
  plugin :lotus, validations: true
end

And you can write some validation code. For example:

class ImageAttachment < Shrine
  plugin :validation_helpers
  plugin :determine_mime_type
  plugin :lotus, validations: true

  Attacher.validate do
    validate_max_size 180_000, message: "is too large (max is 2 MB)"
    validate_mime_type_inclusion ["image/jpg", "image/jpeg"]
  end
end

Remember that you have to call valid? or validate yourself. There is not as much magic in Lotus as it is in Rails :wink:

For inspiration look at the specs or example repo.

Development

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 rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/katafrakt/lotus-shrine.

License

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.