markevans/dragonfly


A Ruby gem for on-the-fly processing - suitable for image uploading in Rails, Sinatra and much more!

http://markevans.github.io/dragonfly

License: MIT

Language: Ruby


Dragonfly

Build Status

Hello!! Dragonfly is a highly customizable ruby gem for handling images and other attachments and is already in use on thousands of websites.

If you want to generate image thumbnails in Rails ...

class User < ActiveRecord::Base  # model
  dragonfly_accessor :photo
end
<%= image_tag @user.photo.thumb('300x200#').url if @user.photo_stored? # view %>

... or generate text images on-demand in Sinatra ...

get "/:text" do |text|
  Dragonfly.app.generate(:text, text, "font-size" => 32).to_response(env)
end

... or just generally manage attachments in your web app ...

wav = Dragonfly.app.fetch_url("http://free.music/lard.wav")  # GET from t'interwebs
mp3 = wav.to_mp3  # to_mp3 is a custom processor
uid = mp3.store   # store in the configured datastore, e.g. S3

url = Dragonfly.app.remote_url_for(uid)  # ===> http://s3.amazon.com/my-stuff/lard.mp3

... then Dragonfly is for you! See the documentation to get started!

Documentation

THE MAIN DOCUMENTATION IS HERE!!!

RDoc documentation is here

Installation

gem install dragonfly

or in your Gemfile

gem 'dragonfly', '~> 1.2.0'

Require with

require 'dragonfly'

Articles

See the Articles wiki for articles and tutorials.

Please feel free to contribute!!

Examples

See the Wiki and see the pages list for examples.

Please feel free to contribute!!

Plugins / add-ons

See the Add-ons wiki.

Please feel free to contribute!!

Issues

Please use the github issue tracker if you have any issues.

Known Issues

There are known issues when using with json gem version 1.5.2 which can potentially cause an "incorrect sha" error for files with non-ascii characters in the name. Please see https://github.com/markevans/dragonfly/issues/387 for more information.

Suggestions/Questions

Google group dragonfly-users

Ruby Versions

See Travis-CI for tested versions.

Upgrading from v0.9 to v1.0

Dragonfly has changed somewhat since version 0.9. See the Upgrading wiki for notes on changes, and feel free to add anything you come across while upgrading!

Changes are listed in History.md

If for whatever reason you can't upgrade, then the docs for version 0.9.x are here.

Credits

Mark Evans (author) with awesome contributions from these guys

Project Statistics

Sourcerank 15
Repository Size 6.32 MB
Stars 2,085
Forks 231
Watchers 36
Open issues 60
Dependencies 7
Contributors 58
Tags 83
Created
Last updated
Last pushed

Top Contributors See all

Mark Evans Henry Phan Philip Arndt Ben Pickles Michael Rykov Aidan Feldman Frederick Cheung Louis Coquio Kennon Ballou Oliver Legg Malcolm Locke Jon Rowe Thomas Bukowski Daniel Libanori Cyril Mougel Trevor Johnston Adrien Coquio Simon Perepelitsa Jan Raasch Andrew McCloud

Packages Referencing this Repo

oahu-dragonfly
Dragonfly is a framework that enables on-the-fly processing for any content type. It is especia...
Latest release 0.8.2 - Published - 2.09K stars
dragonfly
Dragonfly is a framework that enables on-the-fly processing for any content type. It is especia...
Latest release 1.2.0 - Updated - 2.09K stars
fog-dragonfly
Dragonfly is an on-the-fly Rack-based image handling framework. It is suitable for use with Rails...
Latest release 0.8.2 - Updated - 2.09K stars

Recent Tags See all

v1.2.0 November 13, 2018
v1.1.5 March 23, 2018
v1.1.4 December 31, 2017
v1.1.3 June 02, 2017
v1.1.2 May 06, 2017
v1.1.1 October 26, 2016
v1.1.0 October 24, 2016
v1.0.12 September 16, 2015
v1.0.11 September 04, 2015
v1.0.10 May 14, 2015
v1.0.9 April 29, 2015
v1.0.8 April 23, 2015
v1.0.7 August 26, 2014
v1.0.6 August 22, 2014
v1.0.5 May 15, 2014

Interesting Forks See all

myabc/dragonfly
An on-the-fly processing/encoding framework written as a Rack application.
Ruby - MIT - Last pushed - 3 stars - 3 forks
afeld/dragonfly
An on-the-fly processing/encoding framework written as a Rack application.
Ruby - MIT - Last pushed - 2 stars
altlabs/dragonfly
An on-the-fly processing/encoding framework written as a Rack application.
Ruby - MIT - Last pushed - 2 stars
isotope11/dragonfly
A Ruby Rack-based gem for on-the-fly processing - suitable for image uploading in Rails, Sinatra ...
Ruby - MIT - Last pushed - 2 stars
benpickles/dragonfly
A Ruby Rack-based gem for on-the-fly processing - suitable for image uploading in Rails, Sinatra ...
Ruby - MIT - Last pushed - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2018-11-15 17:53:13 UTC

Login to resync this repository