{"id":13463317,"url":"https://github.com/markevans/dragonfly","last_synced_at":"2025-05-08T22:18:54.135Z","repository":{"id":649504,"uuid":"291884","full_name":"markevans/dragonfly","owner":"markevans","description":"A Ruby gem for on-the-fly processing - suitable for image uploading in Rails, Sinatra and much more!","archived":false,"fork":false,"pushed_at":"2025-01-03T10:16:36.000Z","size":6751,"stargazers_count":2115,"open_issues_count":68,"forks_count":244,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-04-17T12:20:53.290Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://markevans.github.io/dragonfly","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/markevans.png","metadata":{"files":{"readme":"README.md","changelog":"History.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2009-08-29T19:15:08.000Z","updated_at":"2025-04-12T09:48:35.000Z","dependencies_parsed_at":"2024-04-10T06:39:14.736Z","dependency_job_id":"1b31e151-ddf7-48c3-8a69-d4239f2bb104","html_url":"https://github.com/markevans/dragonfly","commit_stats":{"total_commits":2279,"total_committers":76,"mean_commits":"29.986842105263158","dds":"0.10355419043440106","last_synced_commit":"788e7399c92fd24c4c83aaf854f9167ac400922e"},"previous_names":[],"tags_count":87,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markevans%2Fdragonfly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markevans%2Fdragonfly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markevans%2Fdragonfly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markevans%2Fdragonfly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/markevans","download_url":"https://codeload.github.com/markevans/dragonfly/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249509474,"owners_count":21283587,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T13:00:50.770Z","updated_at":"2025-04-22T18:20:59.822Z","avatar_url":"https://github.com/markevans.png","language":"Ruby","funding_links":[],"categories":["File Upload","Rails Plugins","Usage","Ruby","File Uploading"],"sub_categories":["Rails File Uploads","If you're using images"],"readme":"Dragonfly\n===========\n\n[![Build Status](https://travis-ci.org/markevans/dragonfly.svg?branch=master)](https://travis-ci.org/markevans/dragonfly)\n\nHello!!\nDragonfly is a highly customizable ruby gem for handling images and other attachments and is already in use on thousands of websites.\n\nIf you want to generate image thumbnails in Rails ...\n```ruby\nclass User \u003c ActiveRecord::Base  # model\n  dragonfly_accessor :photo\nend\n```\n```erb\n\u003c%= image_tag @user.photo.thumb('300x200#').url if @user.photo_stored? # view %\u003e\n```\n\n... or generate text images on-demand in Sinatra ...\n```ruby\nget \"/:text\" do |text|\n  Dragonfly.app.generate(:text, text, \"font-size\" =\u003e 32).to_response(env)\nend\n```\n\n... or just generally manage attachments in your web app ...\n```ruby\nwav = Dragonfly.app.fetch_url(\"http://free.music/lard.wav\")  # GET from t'interwebs\nmp3 = wav.to_mp3  # to_mp3 is a custom processor\nuid = mp3.store   # store in the configured datastore, e.g. S3\n\nurl = Dragonfly.app.remote_url_for(uid)  # ===\u003e http://s3.amazon.com/my-stuff/lard.mp3\n```\n\n... then Dragonfly is for you! See [the documentation](http://markevans.github.io/dragonfly) to get started!\n\nDocumentation\n=============\n\u003ca href=\"http://markevans.github.io/dragonfly\"\u003e\u003cbig\u003e\u003cstrong\u003eTHE MAIN DOCUMENTATION IS HERE!!!\u003c/strong\u003e\u003c/big\u003e\u003c/a\u003e\n\n\u003ca href=\"http://rubydoc.info/github/markevans/dragonfly/frames\"\u003eRDoc documentation is here\u003c/a\u003e\n\nInstallation\n============\n\n    gem install dragonfly\n\nor in your Gemfile\n```ruby\ngem 'dragonfly', '~\u003e 1.4.0'\n```\n\nRequire with\n```ruby\nrequire 'dragonfly'\n```\nArticles\n========\nSee [the Articles wiki](http://github.com/markevans/dragonfly/wiki/Articles) for articles and tutorials.\n\nPlease feel free to contribute!!\n\nExamples\n========\nSee [the Wiki](http://github.com/markevans/dragonfly/wiki) and see the pages list for examples.\n\nPlease feel free to contribute!!\n\nPlugins / add-ons\n=================\nSee [the Add-ons wiki](http://github.com/markevans/dragonfly/wiki/Dragonfly-add-ons).\n\nPlease feel free to contribute!!\n\nSecurity notice!\n=================\nIf you have set `verify_urls` to `false` (which is **not** recommended) then you should upgrade to version `1.4.x` for a security fix ([CVE-2021-33564](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-33564)).\n\nIssues\n======\nPlease use the \u003ca href=\"http://github.com/markevans/dragonfly/issues\"\u003egithub issue tracker\u003c/a\u003e if you have any issues.\n\nKnown Issues\n============\nThere 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.\n\nSuggestions/Questions\n=====================\n\u003ca href=\"http://groups.google.com/group/dragonfly-users\"\u003eGoogle group dragonfly-users\u003c/a\u003e\n\nRuby Versions\n=============\nSee [Travis-CI](https://travis-ci.org/markevans/dragonfly) for tested versions.\n\nUpgrading from v0.9 to v1.0\n===========================\nDragonfly has changed somewhat since version 0.9.\nSee [the Upgrading wiki](http://github.com/markevans/dragonfly/wiki/Upgrading-from-0.9-to-1.0) for notes on changes, and feel free to add anything you come across while upgrading!\n\nChanges are listed in [History.md](https://github.com/markevans/dragonfly/blob/master/History.md)\n\nIf for whatever reason you can't upgrade, then\n\u003ca href=\"http://markevans.github.io/dragonfly/v0.9.15\"\u003ethe docs for version 0.9.x are here\u003c/a\u003e.\n\nCredits\n=======\n[Mark Evans](http://github.com/markevans) (author) with awesome contributions from\n\u003ca href=\"https://github.com/markevans/dragonfly/graphs/contributors\"\u003ethese guys\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkevans%2Fdragonfly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarkevans%2Fdragonfly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkevans%2Fdragonfly/lists"}