Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/katafrakt/hanami-shrine
Upload solution for Hanami 1 using Shrine library (does not work with Hanami 2)
https://github.com/katafrakt/hanami-shrine
attachment hanami shrine upload
Last synced: 22 days ago
JSON representation
Upload solution for Hanami 1 using Shrine library (does not work with Hanami 2)
- Host: GitHub
- URL: https://github.com/katafrakt/hanami-shrine
- Owner: katafrakt
- License: mit
- Created: 2015-11-02T01:03:37.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2021-04-13T08:00:45.000Z (over 3 years ago)
- Last Synced: 2024-10-29T01:25:16.035Z (about 2 months ago)
- Topics: attachment, hanami, shrine, upload
- Language: Ruby
- Homepage:
- Size: 264 KB
- Stars: 28
- Watchers: 6
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-hanami - hanami-shrine - Upload solution for Hanami using Shrine library (Hanami Gem List / File Uploading)
README
# Hanami::Shrine
**Current status**: this gem's development is currently on hold, waiting for Hanami 2 to be released (which will probably make it obsolete anyway).
This gem aims at providing support for [Shrine](https://github.com/shrinerb/shrine) uploader in Hanami applications. It also tries to be as simple as possible, without polluting the world around.
[](https://travis-ci.org/katafrakt/hanami-shrine)
[](https://badge.fury.io/rb/hanami-shrine)
[](https://codeclimate.com/github/katafrakt/hanami-shrine)
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'hanami-shrine'
```
And then execute:
$ bundle
## Usage
Setup Shrine with `hanami` plugin enabled. Check [Shrine's repository](https://github.com/shrinerb/shrine) for more detailed description of the process.
```ruby
class ImageAttachment < Shrine
plugin :hanami
end
```
Then, in your repository add (assuming your attachment is `avatar`):
```ruby
prepend ImageAttachment.repository(:avatar)
```
And in your entity:
```ruby
include ImageAttachment[:avatar]
```
For inspiration read a [blog post](http://katafrakt.me/2016/02/04/shrine-hanami-uploads/), look at [the specs](https://github.com/katafrakt/hanami-shrine/tree/master/spec/hanami) or [example repo](https://github.com/katafrakt/hanami-shrine-example).
## 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: `MyEntity.new(avatar: File.open('my_avatar.png')`. This is a Hanami change, but it's worth mentioning here as well.
## 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](https://rubygems.org).
### Testing
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
```
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/katafrakt/hanami-shrine.
## License
The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
Cat images (used in tests) are public domain taken from [Wikimedia Commons](http://commons.wikimedia.org).