balloon 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b9a840a4692178db52423213fcf6ead8d068f889
+  data.tar.gz: 514e31edc3e12d36b7622282e62bf726e80553d2
+SHA512:
+  metadata.gz: 1747c58e04a86ab1a498686714535e271e6ad964f1451bb1e8c0f4050a0a14f44a6baf696163b00f11588ec347d7beb19be49e305001f87f525fcbe71a4c92e1
+  data.tar.gz: bd76ecc3b4244ca575d20f853b02e67575290464198543efcee59294484f770485174cea200e70368085bbdb3fb0e3286993e40cbe26607a0b6e033223447150

data/.gitignore

@@ -0,0 +1,10 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.*.swp
+.swp
+spec/fixtures/tmp
+spec/fixtures/public
+spec/fixtures/cache
+spec/config/balloon.yml

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in balloon.gemspec
+gemspec

data/README.md

@@ -0,0 +1,185 @@
+# Balloon 
+
+
+Balloon是基于Ruby的图片上传插件， 并且可以完美配合Rails使用。
+
+
+## 安装
+
+
+将下列文字添加到你程序中的Gemfile里
+
+```
+  gem 'balloon'
+  
+  或者
+  
+  gem 'ballon', github: 'yeeli/balloon'
+```
+
+并执行:
+
+    $ bundle
+
+或者直接通过命令安装:
+
+    $ gem install balloon
+
+## 单独使用
+
+```
+require 'balloon'
+
+Balloon.configure do |config|
+  config.store_storage = :file
+end
+
+class Upload < Balloon::Base
+  uploader :avatar
+  uploader_size t: "100x100"
+  uploader_name_format 
+end
+
+file = File.new("file.jpg")
+
+upload = Upload.new("file")
+
+upload.upload_store #上传图片
+
+upload.from_store(:t) #获得图片Path
+
+```
+
+## 在Rails中使用
+
+
+在Rails应用程序中运行下述命令来完成Balloon插件的初始化
+
+	$ rails g balloon:config
+	
+在运行命令后， 会在config目录中生成一个balloon.yml配置文件
+
+###### 默认生成balloon.yml文件
+
+````
+defaults: &defaults
+  store_storage: 'file' 
+  
+development:
+  <<: *defaults
+
+test:
+  <<: *defaults
+
+production:
+  <<: *defaults
+````
+
+balloon.yml 配置介绍
+
+```
+store_storage:  设置 文件储存位置， file: 文件储存， upyun: 又拍云存储
+
+asset_host : 设置 asset
+  
+root: 设置主目录， 默认为当前应用程序的主目录
+  
+permissions: 设置生成文件目录权限， 默认为0777
+
+store_dir: 设置存储目录， 默认为主目录下的"public"目录
+  
+cache_dir: "tmp" # 设置临时文件储存目录， 默认为主目录下的“tmp”目录
+```
+
+###### 在为model文件添加下列格式
+  
+Mongomapper, Mongoid
+
+```
+  class Image 
+    include MongoMapper::Document
+    include Balloon::Up
+    
+    uploader :image, :db 
+    uploader_size t: "45", s: "450", m: "770"
+    uploader_dir "uploads/product"
+    uploader_mimetype_white %w{image/jpeg image/png image/gif}
+    uploader_name_format name: Proc.new{|p| p.id.to_s }
+  end 
+```
+
+model 配置介绍
+
+```
+uploder 设置uploader名称， :db 后台生成数据key
+
+uploader_size #设置文件裁切大小及文件名, 裁切格式参考
+
+uploader_dir #设置上传目录， 未指定，默认为uploader设置的name为目录名
+
+uploader_mimetype_white #设置上传白名单
+
+uploader_name_format #对上传文件进行重命名， 
+```
+
+
+ActiveRecord
+
+先生成 model文件
+
+	$ rails g model image
+
+并修改migration文件, 为下列格式
+
+```
+
+class CreateImages < ActiveRecord::Migration
+  def change
+    create_table :pictures do |t|
+      t.string :file_name
+      t.string :content_type
+      t.integer :file_size
+      t.string :storage
+      t.datetime :created_at
+      t.timestamps
+    end
+  end
+end
+
+```
+
+在 model 文件
+
+```
+class Image < ActiveRecord::Base
+  include Balloon::Up
+    
+  uploader :image
+end
+
+```
+
+###### rails实现图片上传
+
+直接试用model原生操作， 用uploader设置的参数作为上传参数
+  
+ 	@image = Images.new(image: file)
+ 	@image.save
+
+###### 又拍云支持
+
+将store_storage 修改为 ‘upyun’, 在config/balloon.yml内添加下列内容
+
+```
+  upyun_domain: ""
+  upyun_bucket: "" 
+  upyun_username: ""
+  upyun_password: ""
+  upyun_timeout: 600
+  upyun_is_image: true # true: 又拍云为图片空间Balloon将只上传原图， false: 又拍云为普通空间， 将会上传所有图片
+```
+
+
+
+
+ 

data/README_EN.md

@@ -0,0 +1,4 @@
+Balloon 
+=======
+
+This gem is a sample upload libary for ruby

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/balloon.gemspec

@@ -0,0 +1,35 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "balloon/version"
+
+Gem::Specification.new do |s|
+  s.name        = "balloon"
+  s.version     = Balloon::VERSION
+  s.authors     = ["yeeli"]
+  s.email       = ["yeeli@outlook.com"]
+  s.homepage    = ""
+  s.summary     = "Ruby image upload libary"
+  s.description = %q{Ruby image upload libary}
+
+  s.rubyforge_project = "balloon"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+
+  s.add_dependency "activesupport"
+  s.add_dependency "mini_magick"
+  s.add_dependency "faraday"
+  s.add_dependency "mime-types"
+  
+  #development
+  s.add_development_dependency "rails"
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "mysql2"
+  s.add_development_dependency "mongo_mapper"
+  s.add_development_dependency "mongoid"
+  s.add_development_dependency "bson_ext"
+  s.add_development_dependency "activerecord"
+end

data/lib/balloon.rb

@@ -0,0 +1,42 @@
+#coding:utf-8
+require "balloon/version"
+require 'active_support'
+require 'active_support/core_ext'
+
+module Balloon
+  class << self
+    attr_accessor :root
+    def configure(&block)
+      Balloon::Base.configure &block   
+    end
+
+    def configure_load(config, env)
+      Balloon::Base.setup config, env
+    end
+  end
+
+  autoload :Uploader, 'balloon/uploader'
+  autoload :Base, 'balloon/base'
+  autoload :Configuration, 'balloon/configuration'
+  autoload :Processing, 'balloon/processing'
+  autoload :Cache, 'balloon/cache'
+  autoload :FileExtension, 'balloon/file_extension'
+  autoload :Download, 'balloon/download'
+  autoload :Validate, 'balloon/validate'
+
+  module Http
+    autoload :Client, 'balloon/http/client'
+    autoload :Response, 'balloon/http/response'
+  end
+
+  module Storage
+    autoload :Store, 'balloon/storage/store'
+    autoload :File, 'balloon/storage/file'
+    autoload :Upyun, 'balloon/storage/upyun'
+  end
+
+  autoload :Up, 'balloon/up'
+end
+
+require 'balloon/load'
+require 'balloon/error'

data/lib/balloon/base.rb

@@ -0,0 +1,43 @@
+module Balloon
+  class Base
+    include Balloon::Uploader
+
+    def self.uploader(name)
+      class_eval <<-RUBY
+        def initialize(upload_file = nil)
+          set_storage_engine
+          @file = upload_file.is_a?(Hash) ? upload_file[:#{name}] : upload_file 
+        end
+
+        def uploader_name
+          "#{name}".pluralize
+        end
+
+        def set_storage_engine
+          return if respond_to?(:@storage_engine)
+          @storage_engine = eval(STORAGE_EGINE[store_storage.to_sym]).new(self) 
+        end
+      RUBY
+    end
+
+    # upload file save storage
+    #
+    # @param [File] upload_file the upload file
+    #
+    def upload_store(upload_file = nil)
+      uploader_file = upload_file.nil? ? @file : upload_file
+      save_to_cache(uploader_file)
+      store_info = storage_engine.store!
+      @info[:filename] = store_info[:filename]
+      @info[:basename] = store_info[:basename]
+    end
+    
+    def from_store(size_name = nil)
+      storage_engine.retrieve!(size_name)
+    end
+
+    def upload_delete
+      storage_engine.delete!
+    end
+  end
+end

data/lib/balloon/cache.rb

@@ -0,0 +1,44 @@
+module Balloon
+  module Cache
+    extend ActiveSupport::Concern
+
+    attr_reader :cache_cid
+
+    # generate cache directory in system
+    #
+    # @return 
+    def generate_cache_directory
+      @cache_cid = generate_cid
+      FileUtils.mkdir_p(cache_path)
+      FileUtils.chmod dir_permissions.to_i, cache_path
+    end
+
+    def cache_path
+      File.expand_path cache_directory, root
+    end
+
+    def cache_directory
+      File.join cache_dir, "images", cache_cid
+    end
+
+    def generate_down_cache_directory
+      FileUtils.mkdir_p(down_cache_path)
+      FileUtils.chmod dir_permissions.to_i, down_cache_path
+    end
+
+    def down_cache_path
+      File.expand_path down_cache_directory, root
+    end
+
+    def down_cache_directory
+      File.join cache_dir, "net"
+    end
+
+    private
+
+    def generate_cid
+      now = Time.now
+      "#{now.to_i}.#{now.usec}.#{Process.pid}"      
+    end
+  end
+end

data/lib/balloon/configuration.rb

@@ -0,0 +1,85 @@
+module Balloon
+  module Configuration
+
+    STORAGE_EGINE = { file: "Balloon::Storage::File", upyun: "Balloon::Storage::Upyun" }
+
+    class << self
+      def included(base)
+        base.extend ClassMethods
+        set_config :root
+        set_config :permissions
+        set_config :dir_permissions
+        set_config :store_storage
+        set_config :cache_dir
+        set_config :store_dir
+        set_config :asset_host
+
+        set_config :upyun_api_host
+        set_config :upyun_username
+        set_config :upyun_password
+        set_config :upyun_bucket
+        set_config :upyun_timeout
+        set_config :upyun_domain
+        set_config :upyun_thumb_symbol
+        set_config :upyun_is_image
+        set_config :upyun_headers
+
+        reset_config if base == Balloon::Base
+      end
+
+      def set_config(name)
+        ClassMethods.class_eval <<-RUBY
+          attr_writer :#{name}
+          alias :uploader_#{name} :#{name}=
+          def #{name}; @#{name}; end
+        RUBY
+
+        class_eval <<-RUBY
+          def #{name}
+            value = self.class.#{name}
+            value.nil? ? Balloon::Base.#{name} : value
+          end
+        RUBY
+      end
+
+      def reset_config
+        Balloon.configure do |config|
+          config.root = Balloon.root 
+          config.permissions = 0644
+          config.dir_permissions = 0755
+          config.store_storage = :file
+          config.store_dir = "public"
+          config.cache_dir = "tmp"
+
+          config.upyun_headers = {}
+          config.upyun_thumb_symbol = '!'
+          config.upyun_is_image = false
+        end
+      end
+    end
+
+    module ClassMethods
+      def configure; yield self; end
+
+      def setup(configure, env)
+        conf = configure[env]
+        conf = configure['defaults'] if conf.nil?
+        Balloon.configure do |config|
+          conf.each do | n, v |
+            if !v.blank? || v ==true || v == false
+              if v ==true || v == false
+                class_eval <<-RUBY
+                  config.#{n} = #{v}
+                  RUBY
+              else
+                class_eval <<-RUBY
+                  config.#{n} = '#{v}'
+                RUBY
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end