qiniu-s3 0.1.2

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+*.swp
+.DS_Store
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--colour -f nested

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in qiniu-s3.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 why404
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,38 @@
+# 关于
+
+此 Ruby SDK 适用于 Ruby 1.8.x, 1.9.x 版本，基于 [七牛云存储官方API](http://docs.qiniutek.com/v1/api/) 构建。使用此 SDK 构建您的网络应用程序，能让您以非常便捷地方式将数据安全地存储到七牛云存储上。无论您的网络应用是一个网站程序，还是包括从云端（服务端程序）到终端（手持设备应用）的架构的服务或应用，通过七牛云存储及其 SDK，都能让您应用程序的终端用户高速上传和下载，同时也让您的服务端更加轻盈。
+
+## 安装
+
+在您 Ruby 应用程序的 `Gemfile` 文件中，添加如下一行代码：
+
+    gem 'qiniu-s3'
+
+然后，在应用程序所在的目录下，可以运行 `bundle` 安装依赖包：
+
+    $ bundle
+
+或者，可以使用 Ruby 的包管理器 `gem` 进行安装：
+
+    $ gem install qiniu-s3
+
+## 使用
+
+参考文档：[七牛云存储 Ruby SDK 使用指南](http://docs.qiniutek.com/v1/sdk/ruby/)
+
+## 贡献代码
+
+1. Fork
+2. 创建您的特性分支 (`git checkout -b my-new-feature`)
+3. 提交您的改动 (`git commit -am 'Added some feature'`)
+4. 将您的修改记录提交到远程 `git` 仓库 (`git push origin my-new-feature`)
+5. 然后到 github 网站的该 `git` 远程仓库的 `my-new-feature` 分支下发起 Pull Request
+
+## 许可证
+
+Copyright (c) 2012 why404
+
+基于 MIT 协议发布:
+
+* [www.opensource.org/licenses/MIT](http://www.opensource.org/licenses/MIT)
+

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/qiniu-s3.rb

@@ -0,0 +1,2 @@
+# More logical way to require 'qiniu-s3'
+require File.join(File.dirname(__FILE__), 'qiniu', 's3')

data/lib/qiniu/s3.rb

@@ -0,0 +1,114 @@
+# -*- encoding: utf-8 -*-
+
+require 'qiniu/s3/version'
+
+module Qiniu
+  module S3
+    autoload :Config, 'qiniu/s3/config'
+    autoload :Log, 'qiniu/s3/log'
+    autoload :Exception, 'qiniu/s3/exceptions'
+    autoload :Utils, 'qiniu/s3/utils'
+    autoload :Auth, 'qiniu/s3/auth'
+    autoload :IO, 'qiniu/s3/io'
+    autoload :RS, 'qiniu/s3/rs'
+    autoload :Image, 'qiniu/s3/image'
+
+    class << self
+
+      StatusOK = 200
+
+      def establish_connection!(opts = {})
+        Config.initialize_connect opts
+      end
+
+      def login!(user, pwd)
+        code, data = Auth.exchange_by_password!(user, pwd)
+        code == StatusOK
+      end
+
+      def put_auth(expires_in = nil, callback_url = nil)
+        code, data = IO.put_auth(expires_in, callback_url)
+        code == StatusOK ? data["url"] : false
+      end
+
+      def upload(url, local_file, bucket = '', key = '', mime_type = '', custom_meta = '', callback_params = {})
+        code, data = IO.put_file(url, local_file, bucket, key, mime_type, custom_meta, callback_params)
+        code == StatusOK
+      end
+
+      def stat(bucket, key)
+        code, data = RS.stat(bucket, key)
+        code == StatusOK ? data : false
+      end
+
+      def get(bucket, key, save_as = nil, expires_in = nil, version = nil)
+        code, data = RS.get(bucket, key, save_as, expires_in, version)
+        code == StatusOK ? data : false
+      end
+
+      def download(bucket, key, save_as = nil, expires_in = nil, version = nil)
+        code, data = RS.get(bucket, key, save_as, expires_in, version)
+        code == StatusOK ? data["url"] : false
+      end
+
+      def delete(bucket, key)
+        code, data = RS.delete(bucket, key)
+        code == StatusOK
+      end
+
+      def batch(command, bucket, keys)
+        code, data = RS.batch(command, bucket, keys)
+        code == StatusOK ? data : false
+      end
+
+      def batch_stat(bucket, keys)
+        code, data = RS.batch_stat(bucket, keys)
+        code == StatusOK ? data : false
+      end
+
+      def batch_get(bucket, keys)
+        code, data = RS.batch_get(bucket, keys)
+        code == StatusOK ? data : false
+      end
+
+      def batch_download(bucket, keys)
+        code, data = RS.batch_get(bucket, keys)
+        return false unless code == StatusOK
+        links = []
+        data.each { |e| links << e["data"]["url"] }
+        links
+      end
+
+      def batch_delete(bucket, keys)
+        code, data = RS.batch_delete(bucket, keys)
+        code == StatusOK ? data : false
+      end
+
+      def publish(domain, bucket)
+        code, data = RS.publish(domain, bucket)
+        code == StatusOK
+      end
+
+      def unpublish(domain)
+        code, data = RS.unpublish(domain)
+        code == StatusOK
+      end
+
+      def drop(bucket)
+        code, data = RS.drop(bucket)
+        code == StatusOK
+      end
+
+      def image_info(url)
+        code, data = Image.info(url)
+        code == StatusOK ? data : false
+      end
+
+      def image_preview_url(url, spec)
+        Image.preivew_url(url, spec)
+      end
+
+    end
+
+  end
+end

data/lib/qiniu/s3/auth.rb

@@ -0,0 +1,74 @@
+# -*- encoding: utf-8 -*-
+
+require 'qiniu/s3/exceptions'
+
+module Qiniu
+  module S3
+    module Auth
+      class << self
+        include Utils
+
+        def exchange_by_password!(username, password)
+          @username = username
+          @password = password
+          post_data = {
+            :client_id  => Config.settings[:client_id],
+            :grant_type => "password",
+            :username   => username,
+            :password   => password
+          }
+          code, data = http_request Config.settings[:auth_url], post_data
+          reset_token(data["access_token"], data["refresh_token"]) if code == 200
+          [code, data]
+        end
+
+        def exchange_by_refresh_token!(refresh_token)
+          post_data = {
+            :client_id     => Config.settings[:client_id],
+            :grant_type    => "refresh_token",
+            :refresh_token => refresh_token
+          }
+          code, data = http_request Config.settings[:auth_url], post_data
+          reset_token(data["access_token"], data["refresh_token"]) if code == 200
+          [code, data]
+        end
+
+        def reset_token(access_token, refresh_token)
+          @access_token  = access_token
+          @refresh_token = refresh_token
+        end
+
+        def call(url, data, retry_times = 0)
+          raise MissingAccessToken if @access_token.nil?
+          code, data = http_request url, data, {:access_token => @access_token}
+          if code == 401
+            raise MissingRefreshToken if @refresh_token.nil?
+            code, data = exchange_by_refresh_token!(@refresh_token)
+            if code == 401
+              raise MissingUsernameOrPassword if (@username.nil? || @password.nil?)
+              code, data = exchange_by_password!(@username, @password)
+            end
+            if code == 200
+              retry_times += 1
+              if Config.settings[:auto_reconnect] && retry_times < Config.settings[:max_retry_times]
+                return call(url, data, retry_times)
+              end
+            end
+          end
+          [code, data]
+        end
+
+        def request(url, data = nil)
+          begin
+            code, data = Auth.call(url, data)
+          rescue [MissingAccessToken, MissingRefreshToken, MissingUsernameOrPassword] => e
+            Log.logger.error e
+            code, data = 401, {}
+          end
+          [code, data]
+        end
+
+      end
+    end
+  end
+end

data/lib/qiniu/s3/config.rb

@@ -0,0 +1,54 @@
+# -*- encoding: utf-8 -*-
+#
+# USAGE WAY 1:
+# Qbox::Config.initialize_connect :client_id => "<ClientID>",
+#                                 :client_secret => "<ClientSecret>"
+#
+# USAGE WAY 2:
+# Qbox::Config.load "path/to/your_project/config/qiniu.yml"
+#
+
+require "qiniu/s3/version"
+
+module Qiniu
+  module S3
+    module Config
+      class << self
+
+        DEFAULT_OPTIONS = {
+          :user_agent      => 'Qiniu-S3-Ruby-SDK-' + VERSION + '()',
+          :method          => :post,
+          :content_type    => 'application/x-www-form-urlencoded',
+          :auth_url        => "https://acc.qbox.me/oauth2/token",
+          :rs_host         => "http://rs.qbox.me:10100",
+          :io_host         => "http://io.qbox.me",
+          :client_id       => "<YOUR_APP_CLIENT_ID>",
+          :client_secret   => "<YOUR_APP_CLIENT_SECRET>",
+          :auto_reconnect  => true,
+          :max_retry_times => 5
+        }
+
+        REQUIRED_OPTION_KEYS = [:client_id, :client_secret, :auth_url, :rs_host, :io_host]
+
+        attr_reader :settings, :default_params
+
+        def load config_file
+          if File.exist?(config_file)
+            config_options = YAML.load_file(config_file)
+            initialize_connect(config_options)
+          else
+            raise MissingConfError, config_file
+          end
+        end
+
+        def initialize_connect options = {}
+          @settings = DEFAULT_OPTIONS.merge(options)
+          REQUIRED_OPTION_KEYS.each do |opt|
+            raise MissingArgsError, [opt] unless @settings.has_key?(opt)
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/qiniu/s3/exceptions.rb

@@ -0,0 +1,88 @@
+# -*- encoding: utf-8 -*-
+
+module Qiniu
+  module S3
+
+    class Exception < RuntimeError
+      def to_s
+        inspect
+      end
+    end
+
+    class ResponseError < Exception
+      attr_reader :response
+
+      def initialize(message, response = nil)
+        @response = response
+        super(message)
+      end
+
+      def http_code
+        @response.code.to_i if @response
+      end
+
+      def http_body
+        @response.body if @response
+      end
+
+      def inspect
+        "#{message}: #{http_body}"
+      end
+    end
+
+    class RequestFailed < ResponseError
+      def message
+        "HTTP status code #{http_code}"
+      end
+
+      def to_s
+        message
+      end
+    end
+
+    class MissingArgsError < Exception
+      def initialize(missing_keys)
+        key_list = missing_keys.map {|key| key.to_s}.join(' and the ')
+        super("You did not provide both required args. Please provide the #{key_list}.")
+      end
+    end
+
+    class MissingAccessToken < MissingArgsError
+      def initialize
+        super([:access_token])
+      end
+    end
+
+    class MissingRefreshToken < MissingArgsError
+      def initialize
+        super([:refresh_token])
+      end
+    end
+
+    class MissingUsernameOrPassword < MissingArgsError
+      def initialize
+        super([:username, :password])
+      end
+    end
+
+    class InvalidArgsError < Exception
+      def initialize(invalid_keys)
+        key_list = invalid_keys.map {|key| key.to_s}.join(' and the ')
+        super("#{key_list} should not be empty.")
+      end
+    end
+
+    class MissingConfError < Exception
+      def initialize(missing_conf_file)
+        super("Error, missing #{missing_conf_file}. You must have #{missing_conf_file} to configure your client id and secret.")
+      end
+    end
+
+    class NoSuchFileError < Exception
+      def initialize(missing_file)
+        super("Error, no such file #{missing_file}.")
+      end
+    end
+
+  end
+end

data/lib/qiniu/s3/image.rb

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+
+module Qiniu
+  module S3
+    module Image
+      class << self
+        include Utils
+
+        def info(url)
+          Utils.http_request url + '/imageInfo', nil, {:method => :get}
+        end
+
+        def preivew_url(url, spec)
+          url + '/imagePreview/' + spec.to_s
+        end
+
+      end
+    end
+  end
+end