qihu360 0.3.12

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 75934d4a842a4445106351a4edc180730f4f7a41
+  data.tar.gz: 0de587d05e405d23a6046d67dbfbe443f4a7783d
+SHA512:
+  metadata.gz: 3b395d6b45abc7a5b133c0ffd3a340f17281f92c22218b16f01825610d4f7b7c04c3c2acd0e88ebc264e5611881a6518890b584b39db69d76ab97f871c99f3b8
+  data.tar.gz: 2c0355500aee76b999069411976d2095a663349d1fcfc790f81a3a4069e4540ba4612c16d6b710f4b8f55b7f82950f77af149e6b37e1e4516afe49af782d30a9

data/.gitignore

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

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--fail-fast
+--order random

data/.rvmrc

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+
+# This is an RVM Project .rvmrc file, used to automatically load the ruby
+# development environment upon cd'ing into the directory
+
+# First we specify our desired <ruby>[@<gemset>], the @gemset name is optional,
+# Only full ruby name is supported here, for short names use:
+#     echo "rvm use 2.0.0" > .rvmrc
+environment_id="ruby-2.0.0-p247@test"
+
+# Uncomment the following lines if you want to verify rvm version per project
+# rvmrc_rvm_version="1.22.1 (master)" # 1.10.1 seems like a safe start
+# eval "$(echo ${rvm_version}.${rvmrc_rvm_version} | __rvm_awk -F. '{print "[[ "$1*65536+$2*256+$3" -ge "$4*65536+$5*256+$6" ]]"}' )" || {
+#   echo "This .rvmrc file requires at least RVM ${rvmrc_rvm_version}, aborting loading."
+#   return 1
+# }
+
+# First we attempt to load the desired environment directly from the environment
+# file. This is very fast and efficient compared to running through the entire
+# CLI and selector. If you want feedback on which environment was used then
+# insert the word 'use' after --create as this triggers verbose mode.
+if [[ -d "${rvm_path:-$HOME/.rvm}/environments"
+  && -s "${rvm_path:-$HOME/.rvm}/environments/$environment_id" ]]
+then
+  \. "${rvm_path:-$HOME/.rvm}/environments/$environment_id"
+  for __hook in "${rvm_path:-$HOME/.rvm}/hooks/after_use"*
+  do
+    if [[ -f "${__hook}" && -x "${__hook}" && -s "${__hook}" ]]
+    then \. "${__hook}" || true
+    fi
+  done
+  unset __hook
+  if (( ${rvm_use_flag:=1} >= 2 )) # display only when forced
+  then
+    if [[ $- == *i* ]] # check for interactive shells
+    then printf "%b" "Using: \E[32m$GEM_HOME\E[0m
+" # show the user the ruby and gemset they are using in green
+    else printf "%b" "Using: $GEM_HOME
+" # don't use colors in non-interactive shells
+    fi
+  fi
+else
+  # If the environment file has not yet been created, use the RVM CLI to select.
+  rvm --create  "$environment_id" || {
+    echo "Failed to create RVM environment '${environment_id}'."
+    return 1
+  }
+fi
+
+# If you use bundler, this might be useful to you:
+# if [[ -s Gemfile ]] && {
+#   ! builtin command -v bundle >/dev/null ||
+#   builtin command -v bundle | GREP_OPTIONS="" \grep $rvm_path/bin/bundle >/dev/null
+# }
+# then
+#   printf "%b" "The rubygem 'bundler' is not installed. Installing it now.\n"
+#   gem install bundler
+# fi
+# if [[ -s Gemfile ]] && builtin command -v bundle >/dev/null
+# then
+#   bundle install | GREP_OPTIONS="" \grep -vE '^Using|Your bundle is complete'
+# fi

data/Gemfile

@@ -0,0 +1,12 @@
+source 'http://ruby.taobao.org'
+
+group :development do
+  gem 'awesome_print'
+  gem 'json_pure'
+end
+
+group :test do
+  gem 'rspec'
+end
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 icyleaf
+
+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,69 @@
+# Qihu360
+
+整合 `open.360.cn` 的一些业务 `Ruby` 封装。
+
+- OAuth2 的封装
+- 点睛营销平台(广告竞价排名系统) API 
+
+
+## 安装
+
+在你项目的 `Gemfile` 文件添加下行内容:
+
+    gem 'qihu360'
+
+保存后执行:
+
+    $ bundle
+
+或者直接执行下行命令安装:
+
+    $ gem install qihu360
+
+
+## 代码实例
+
+### 验证 OAuth 2
+
+    # 处理 oauth2
+    auth = Qihu::Auth.new(id:'xxx', secret:'yyy')
+    
+    # 默认 redirect_uri 是 oob
+    auth_url = auth.authorize_url() 
+
+    # 设置回调网址和验证界面模式 
+    auth_url = auth.authorize_url(redirect_uri:'http://icyleaf.com', display:'desktop')
+
+    # 获取的 access token
+    auth.get_token('code')
+
+
+#### 使用 access token 初始化
+  
+  auth = Qihu::Auth.new(id:'xxx', secret:'yyy', token:{
+      :access_token => 'zzz', :refresh_token => 'qqq', :expires_at => 36000
+  })
+  
+  // 或者这样传递 access token
+  auth.get_token_from_hash(:access_token => 'zzz', :refresh_token => 'qqq', :expires_at => 36000)
+
+### 调用广告系统接口
+
+    # 初始化必须传入获得 access token 的 Qihu::Auth 实例
+    client = Qihu::DianJing::Client(auth)
+
+    # 请求 account 的账户信息，默认返回 json 格式
+    response = client.account.getInfo 
+    # 除了驼峰调用模式，下划线同样适用
+    response = client.account.get_info
+    
+    # 创建一个计划
+    response = client.campign.add(name:'Beijing', budget:10000)
+
+## 贡献代码
+
+1. Fork 本仓库
+2. 创建你自己的 feature 分支 (`git checkout -b my-new-feature`)
+3. 提交你的代码 (`git commit -am 'Add some feature'`)
+4. 提交你的分支 (`git push origin my-new-feature`)
+5. 创建一个新的 Pull Request

data/Rakefile

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

data/lib/qihu/auth.rb

@@ -0,0 +1,47 @@
+require 'oauth2'
+
+module Qihu
+  class Auth
+    attr_reader :oauth2, :access_token, :refresh_token, :expires_at, :expires_in
+    attr_accessor :token, :redirect_uri
+
+    def initialize(client_id, client_secret, token={}, redirect_uri='oob', site='https://openapi.360.cn')
+      @redirect_uri = redirect_uri
+      @oauth2 = OAuth2::Client.new(client_id, client_secret,
+        :site => site,
+        :authorize_url => '/oauth2/authorize',
+        :token_url => '/oauth2/access_token',
+        :ssl => {:verify => false},
+      )
+
+      if token
+        @token = OAuth2::AccessToken.from_hash(@oauth2, token)
+      end
+    end
+
+    def authorize_url(options={})
+      @redirect_uri = options[:redirect_uri] if options[:redirect_uri]
+      scope = options[:scope] ? options[:scope] : 'basic'
+      display = options[:display] ? options[:display] : 'default'
+
+      @oauth2.auth_code.authorize_url(:redirect_uri => @redirect_uri, :scope => scope, :display => display)
+    end
+
+    def get_token(code, redirect_uri='')
+      @redirect_uri = redirect_uri unless redirect_uri.empty?
+      @token = @oauth2.auth_code.get_token(code, :redirect_uri => @redirect_uri)
+
+      @refresh_token = @token.refresh_token
+      @expires_at = @token.expires_at
+      @expires_in = @token.expires_in
+      @access_token = @token.token
+
+      return self
+    end
+
+    def get_token_from_hash(token={})
+      @token = OAuth2::AccessToken.from_hash(@oauth2, token)
+      return self
+    end
+  end
+end

data/lib/qihu/dianjing/api/account.rb

@@ -0,0 +1,8 @@
+module Qihu
+  module DianJing
+    module API
+      class Account < Base
+      end
+    end
+  end
+end

data/lib/qihu/dianjing/api/base.rb

@@ -0,0 +1,44 @@
+module Qihu
+  module DianJing
+    module API
+      class Base
+        def initialize(client, options={})
+          @client = client
+        end
+
+        def method_missing(name, *args, &block)
+          if name.match(/_/)
+            name = name.to_s.split('_').each_with_index.map{|k, i| (i > 0) ? k.capitalize : k}.join("")
+          end
+
+          params = {
+            :format => 'json'
+          }.merge(args[0])
+
+          begin
+            method = name.match(/^get/) ? :get : :post
+            uri_path = uri_path(name)
+
+            @client.auth.token.request(method, uri_path, :headers => client_headers, :params => params)
+          rescue OAuth2::Error
+            raise "Invaild API: #{@client.site}/#{uri_path}"
+          end
+        end
+
+        protected
+          def client_headers
+            {
+              :apiKey => @client.auth.token.client.id,
+              :accessToken => @client.auth.token.token,
+              :serveToken => Time.now.to_i.to_s,
+            }
+          end
+
+          def uri_path(uri)
+            class_name = self.class.name.split("::")[-1].downcase
+            "#{@client.version}/#{class_name}/#{uri}"
+          end
+      end
+    end
+  end
+end

data/lib/qihu/dianjing/api/campaign.rb

@@ -0,0 +1,8 @@
+module Qihu
+  module DianJing
+    module API
+      class Campaign < Base
+      end
+    end
+  end
+end

data/lib/qihu/dianjing/api/creative.rb

@@ -0,0 +1,8 @@
+module Qihu
+  module DianJing
+    module API
+      class Creative < Base
+      end
+    end
+  end
+end

data/lib/qihu/dianjing/api/group.rb

@@ -0,0 +1,8 @@
+module Qihu
+  module DianJing
+    module API
+      class Group < Base
+      end
+    end
+  end
+end

data/lib/qihu/dianjing/api/keyword.rb

@@ -0,0 +1,8 @@
+module Qihu
+  module DianJing
+    module API
+      class Keyword < Base
+      end
+    end
+  end
+end

data/lib/qihu/dianjing/api/report.rb

@@ -0,0 +1,8 @@
+module Qihu
+  module DianJing
+    module API
+      class Report < Base
+      end
+    end
+  end
+end

data/lib/qihu/dianjing/api/tool.rb

@@ -0,0 +1,8 @@
+module Qihu
+  module DianJing
+    module API
+      class Tool < Base
+      end
+    end
+  end
+end

data/lib/qihu/dianjing/client.rb

@@ -0,0 +1,68 @@
+require 'oauth2'
+
+module Qihu
+  module DianJing
+    class Client
+      attr_reader :auth
+      attr_accessor :version, :site, :uri
+
+      def initialize(auth, options={})
+        @site = options[:site] ? options[:site] : 'https://api.e.360.cn'
+        @version = options[:version] ? options[:version] : '1.0'
+
+        if auth.is_a?(Qihu::Auth)
+          auth.token.client.site = @site
+          @auth = auth
+        else
+          raise 'auth must be "DianJing::Auth" instance.'
+        end
+      end
+
+      def authorize_url(redirect_uri:'', scope:'basic', display:'default')
+        @redirect_uri = redirect_uri unless redirect_uri.empty?
+        @oauth2.auth_code.authorize_url(:redirect_uri => @redirect_uri, :scope => scope, :display => display)
+      end
+
+      def get_token(code, redirect_uri:'')
+        @redirect_uri = redirect_uri unless redirect_uri.empty?
+        @token = @oauth2.auth_code.get_token(code, :redirect_uri => @redirect_uri)
+
+        @token = _get_api_token(@token.token)
+      end
+
+      def account
+        @account ||= Qihu::DianJing::API::Account.new(self)
+      end
+
+      def campaign
+        @campaign ||= Qihu::DianJing::API::Campaign.new(self)
+      end
+
+      def group
+        @group ||= Qihu::DianJing::API::Group.new(self)
+      end
+
+      def creative
+        @creative ||= Qihu::DianJing::API::Creative.new(self)
+      end
+
+      def keyword
+        @keyword ||= Qihu::DianJing::API::Keyword.new(self)
+      end
+
+      def report
+        @report ||= Qihu::DianJing::API::Report.new(self)
+      end
+
+      def tool
+        @tool ||= Qihu::DianJing::API::Tool.new(self)
+      end
+
+      private
+        def _get_api_token(access_token)
+          @oauth2.site = @site
+          @token = OAuth2::AccessToken.new(@oauth2, access_token)
+        end
+    end
+  end
+end

data/lib/qihu/dianjing.rb

@@ -0,0 +1,15 @@
+module Qihu
+  module DianJing
+  end
+end
+
+require "qihu/dianjing/client"
+
+require "qihu/dianjing/api/base"
+require "qihu/dianjing/api/account"
+require "qihu/dianjing/api/campaign"
+require "qihu/dianjing/api/group"
+require "qihu/dianjing/api/creative"
+require "qihu/dianjing/api/keyword"
+require "qihu/dianjing/api/report"
+require "qihu/dianjing/api/tool"

data/lib/qihu/version.rb

@@ -0,0 +1,3 @@
+module Qihu
+  VERSION = "0.3.12"
+end

data/lib/qihu.rb

@@ -0,0 +1,3 @@
+require "qihu/version"
+require "qihu/auth"
+require "qihu/dianjing"

data/qihu360.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'qihu/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "qihu360"
+  spec.version       = Qihu::VERSION
+  spec.authors       = ["icyleaf"]
+  spec.email         = ["icyleaf.cn@gmail.com"]
+  spec.description   = %q{Qihu 360.cn OAuth2 & Dianjing(Advertising system) API wrapper}
+  spec.summary       = %q{Qihu 360.cn OAuth2 & Dianjing API wrapper}
+  spec.homepage      = "https://github.com/icyleaf/qihu360"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+
+  spec.add_dependency "oauth2", "~> 0.9.2"
+  spec.add_dependency "multi_json", "~> 1.0"
+  spec.add_dependency "multi_xml", "~> 0.5"
+end

data/spec/qihu/auth_spec.rb

@@ -0,0 +1,47 @@
+require 'spec_helper'
+
+describe Qihu::Auth do
+  client_id     = ""
+  client_secret = ""
+
+  subject do
+    Qihu::Auth.new(client_id, client_secret)
+  end
+
+  describe "#初始化" do
+    it "检查 OAuth2 client id 和 secret" do
+      expect(subject.oauth2.id).to eq(client_id)
+      expect(subject.oauth2.secret).to eq(client_secret)
+    end
+
+    it "检查 OAuth2 域名" do
+      expect(subject.oauth2.site).to eq('https://openapi.360.cn')
+    end
+
+    it "检查 redirect_uri" do
+      expect(subject.redirect_uri).to eq('oob')
+    end
+
+    it "是否可以设置 redirect_uri" do
+      subject.redirect_uri = "http://icyleaf.com"
+      expect(subject.redirect_uri).to eq("http://icyleaf.com")
+    end
+
+    it "是否关闭了 ssl 的验证" do
+      expect(subject.oauth2.connection.ssl).to eq({:verify => false})
+    end
+  end
+
+  describe "#验证" do
+    it "检查默认的 /oauth2/authorize 路径" do
+      expect(subject.authorize_url).to match("https://openapi.360.cn/oauth2/authorize")
+    end
+
+    it "是否可以设置 authorize_url" do
+      expect(subject.authorize_url :display => 'desktop').to match('display=desktop')
+      expect(subject.authorize_url :scope => 'all').to match('scope=all')
+      expect(subject.authorize_url :redirect_uri => 'icyleaf.com').to match('redirect_uri=icyleaf.com')
+    end
+  end
+
+end

data/spec/qihu/dianjing/client_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe Qihu::DianJing::Client do
+  client_id     = ""
+  client_secret = ""
+  access_token  = ""
+
+  subject do
+    auth = Qihu::Auth.new(client_id, client_secret, token={
+      :access_token => access_token,
+    })
+    Qihu::DianJing::Client.new(auth)
+  end
+
+  describe "#初始化" do
+    it "检查 api 版本和域名" do
+      expect(subject.version).to eq('1.0')
+      expect(subject.site).to eq('https://api.e.360.cn')
+    end
+
+    it "是否可以设置 api 版本和域名" do
+      subject.version = '2.0'
+      expect(subject.version).to eq("2.0")
+
+      subject.site = "http://api.360.cn"
+      expect(subject.site).to eq("http://api.360.cn")
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'qihu'

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: qihu360
+version: !ruby/object:Gem::Version
+  version: 0.3.12
+platform: ruby
+authors:
+- icyleaf
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: multi_xml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.5'
+description: Qihu 360.cn OAuth2 & Dianjing(Advertising system) API wrapper
+email:
+- icyleaf.cn@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/qihu.rb
+- lib/qihu/auth.rb
+- lib/qihu/dianjing.rb
+- lib/qihu/dianjing/api/account.rb
+- lib/qihu/dianjing/api/base.rb
+- lib/qihu/dianjing/api/campaign.rb
+- lib/qihu/dianjing/api/creative.rb
+- lib/qihu/dianjing/api/group.rb
+- lib/qihu/dianjing/api/keyword.rb
+- lib/qihu/dianjing/api/report.rb
+- lib/qihu/dianjing/api/tool.rb
+- lib/qihu/dianjing/client.rb
+- lib/qihu/version.rb
+- qihu360.gemspec
+- spec/qihu/auth_spec.rb
+- spec/qihu/dianjing/client_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/icyleaf/qihu360
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.7
+signing_key: 
+specification_version: 4
+summary: Qihu 360.cn OAuth2 & Dianjing API wrapper
+test_files:
+- spec/qihu/auth_spec.rb
+- spec/qihu/dianjing/client_spec.rb
+- spec/spec_helper.rb