webmaster 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,24 @@
+source "http://rubygems.org"
+
+gem 'faraday'
+gem 'oauth2'
+gem 'libxml-ruby'
+gem 'virtus'
+
+group :development do
+  gem "shoulda"
+  gem "rdoc"
+  gem "bundler"
+  gem "jeweler"
+end
+
+group :documentation do
+  gem "yard"
+end
+
+group :test do
+  gem 'vcr'
+  gem 'webmock'
+end
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,85 @@
+PATH
+  remote: .
+  specs:
+    webmaster (0.0.1)
+      faraday
+      libxml-ruby
+      oauth2
+      virtus
+      webmaster
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.2.13)
+      i18n (= 0.6.1)
+      multi_json (~> 1.0)
+    addressable (2.3.4)
+    backports (2.6.7)
+    bourne (1.4.0)
+      mocha (~> 0.13.2)
+    crack (0.3.2)
+    descendants_tracker (0.0.1)
+    faraday (0.8.7)
+      multipart-post (~> 1.1)
+    git (1.2.5)
+    httpauth (0.2.0)
+    i18n (0.6.1)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.7)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    libxml-ruby (2.6.0)
+    metaclass (0.0.1)
+    mocha (0.13.3)
+      metaclass (~> 0.0.1)
+    multi_json (1.7.2)
+    multi_xml (0.5.3)
+    multipart-post (1.2.0)
+    oauth2 (0.9.1)
+      faraday (~> 0.8)
+      httpauth (~> 0.1)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (10.0.4)
+    rdoc (4.0.1)
+      json (~> 1.4)
+    shoulda (3.4.0)
+      shoulda-context (~> 1.0, >= 1.0.1)
+      shoulda-matchers (~> 1.0, >= 1.4.1)
+    shoulda-context (1.1.1)
+    shoulda-matchers (1.5.6)
+      activesupport (>= 3.0.0)
+      bourne (~> 1.3)
+    vcr (2.4.0)
+    virtus (0.5.4)
+      backports (~> 2.6.1)
+      descendants_tracker (~> 0.0.1)
+    webmock (1.11.0)
+      addressable (>= 2.2.7)
+      crack (>= 0.3.2)
+    yard (0.8.6.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  faraday
+  jeweler
+  libxml-ruby
+  oauth2
+  rdoc
+  shoulda
+  vcr
+  virtus
+  webmaster!
+  webmock
+  yard

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Igor Alexandrov
+
+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,94 @@
+[![Dependency Status](https://gemnasium.com/igor-alexandrov/webmaster.png)](http://gemnasium.com/igor-alexandrov/webmaster)
+[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/igor-alexandrov/webmaster)
+
+# webmaster
+
+Wrapper for Yandex.Webmaster API. 
+
+**About Yandex.Webmaster**
+
+* [Russian](http://webmaster.yandex.ru/)
+* [English](http://webmaster.yandex.com/)
+
+**API Documentation**
+
+* [Russian](http://api.yandex.ru/webmaster/)
+* [English](http://api.yandex.com/webmaster/)
+
+## Installation
+
+    [sudo] gem install webmaster
+
+## Usage
+
+### Authentication
+
+Yandex's API uses OAuth for authentication. Luckily, the Webmaster gem hides most of the details from you.
+
+If you have never used Webmaster API or you want to change your authentication credentials or your authorization token expired, then you should create new one:
+
+```ruby    
+require 'rubygems'
+require 'webmaster'
+
+# Get your API credentials at https://oauth.yandex.ru/
+client = Webmaster.new(:app_id => 'your_app_id', :app_password => 'your_app_password')
+  => #<Webmaster::Client>
+
+# Follow the authorization url, you will be redirected to the callback url, specified in your application settings.
+client.authorize_url
+  => "https://oauth.yandex.ru/authorize?response_type=code&client_id=your_app_id"
+
+# Use authorization code from params to get authorization token
+client.authenticate(params[:code])
+  => #<Webmaster::Client>
+
+# If no error is raised then you are free to use any API method
+# Too see what token is now used call for client configuration
+token = client.configuration.oauth_token	
+  => "82af4af2a42e4019bd59a325da0f31d8"
+```
+
+If you want to restore previously used token, it can be easily done too:
+
+```ruby
+require 'rubygems'
+require 'webmaster'
+
+# get your API credentials at https://oauth.yandex.ru/
+client = Webmaster.new(:oauth_token => 'token')
+```    
+
+To check whether you client is authenticated or not, use `authenticated?` method.
+
+```ruby
+# We have already initialized client before.
+client.authenticated?
+  => true
+```    
+
+
+## Note on Patches / Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Credits
+
+![JetRockets](http://www.jetrockets.ru/public/logo.png)
+
+Webmaster is maintained by [JetRockets](http://www.jetrockets.ru/en).
+
+Contributors:
+
+* [Igor Alexandrov](http://igor-alexandrov.github.com/)
+
+## License
+
+It is free software, and may be redistributed under the terms specified in the LICENSE file.

data/Rakefile

@@ -0,0 +1,46 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+require './lib/webmaster/version.rb'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "webmaster"
+  gem.homepage = "http://github.com/igor-alexandrov/webmaster"
+  gem.license = "MIT"
+  gem.summary = %Q{Ruby wrapper for Yandex.Webmaster API}
+  gem.email = "igor.alexandrov@gmail.com"
+  gem.authors = ["Igor Alexandrov"]
+  gem.version = Webmaster::Version::STRING
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :install
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|  
+  version = Webmaster::Version::STRING
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "webmaster #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/webmaster.rb

@@ -0,0 +1,66 @@
+require 'webmaster/version'
+require 'webmaster/configuration'
+require 'webmaster/errors'
+
+require 'webmaster/core_ext/hash'
+require 'webmaster/core_ext/object'
+require 'webmaster/core_ext/string'
+
+module Webmaster
+  # extend Configuration
+
+  class << self
+    # Alias for Webmaster::Client.new
+    #
+    # @return [Github::Client]
+    def new(options = {}, &block)
+      Webmaster::Client.new(:configuration => options, &block)
+    end
+
+    # Delegate to Webmaster::Client
+    #
+    def method_missing(method, *args, &block)
+      return super unless new.respond_to?(method)
+      new.send(method, *args, &block)
+    end
+
+    def respond_to?(method, include_private = false)
+      new.respond_to?(method, include_private) || super(method, include_private)
+    end
+
+    # config/initializers/webmaster.rb (for instance)
+    #
+    # Webmaster.configure do |config|
+    #   config.application_id = 'application_id'
+    #   config.application_password = 'application_password'    
+    # end
+    #
+    # elsewhere
+    #
+    # client = Webmaster::Client.new
+
+    def configure
+      yield self
+      true
+    end
+  end
+
+  autoload :Base, 'webmaster/base'
+  autoload :ApiFactory, 'webmaster/api_factory'
+  autoload :Client, 'webmaster/client'  
+
+  autoload :Host, 'webmaster/host'
+
+  module Hosts
+    autoload :Crawling, 'webmaster/hosts/crawling'
+    autoload :Verification, 'webmaster/hosts/verification'
+  end
+
+  module Request
+    autoload :OAuth2, 'webmaster/request/oauth2'  
+  end
+
+  module Response
+    autoload :Hashify, 'webmaster/response/hashify'  
+  end
+end

data/lib/webmaster/api/authorization.rb

@@ -0,0 +1,59 @@
+# encoding: utf-8
+
+module Webmaster
+  module Api
+    module Authorization
+
+      attr_accessor :scopes
+
+      # Setup OAuth2 instance
+      def oauth
+        @client ||= ::OAuth2::Client.new(self.configuration.app_id, self.configuration.app_password,
+          {
+            :site          => self.configuration.site || Webmaster::Configuration.size,
+            :authorize_url => '/authorize',
+            :token_url     => '/token',
+            :ssl           => { :verify => false }          
+          }
+        )
+      end
+
+      # Strategy token
+      # 
+      def auth_code
+        self.verify_oauth!
+        self.oauth.auth_code
+      end
+
+      # Sends authorization request to Yandex.Webmaster.    
+      #
+      def authorize_url(params = {})
+        self.verify_oauth!
+        self.oauth.auth_code.authorize_url(params)
+      end
+
+      # Makes request to token endpoint and retrieves access token value
+      def token(authorization_code, params = {})
+        self.verify_oauth!
+        self.oauth.auth_code.get_token(authorization_code, params)
+      end
+
+      def authenticate(authorization_code, params = {})
+        self.configuration.oauth_token = (self.token(authorization_code, params).token)
+        self
+      end
+
+      # Check whether authentication credentials are present
+      def authenticated?
+        self.configuration.oauth_token?
+      end    
+
+    protected
+
+      def verify_oauth! # :nodoc:
+        raise ArgumentError, 'Need to provide app_id and app_password' unless self.configuration.app_id? && self.configuration.app_password?
+      end
+
+    end
+  end
+end

data/lib/webmaster/api/connection.rb

@@ -0,0 +1,87 @@
+# encoding: utf-8
+
+require 'faraday'
+
+module Webmaster
+  module Api
+    module Connection
+      extend self
+
+      USER_AGENT = 'User-Agent'.freeze
+
+      ACCEPT = 'Accept'.freeze
+
+      ACCEPT_CHARSET = 'Accept-Charset'.freeze
+
+      CONTENT_TYPE = 'Content-Type'.freeze
+
+      ALLOWED_OPTIONS = [
+        :headers,
+        :url,
+        :params,
+        :request,
+        :ssl
+      ].freeze
+
+      # Returns a Fraday::Connection object
+      #
+      def connection(options = {})
+
+        options = self.connection_options(options)
+        
+        if @connection_options != options        
+          @connection = nil
+          @connection_options = options          
+        end
+
+        @connection ||= Faraday.new(@connection_options.merge(:builder => self.stack))
+      end
+
+    protected
+        
+      def connection_options(options = {})
+        options.slice!(*ALLOWED_OPTIONS)
+
+        {
+          :headers => {            
+            ACCEPT_CHARSET   => "utf-8",
+            USER_AGENT       => self.configuration.user_agent,
+            # Due to error in Yandex.Webmaster API I had to change this header
+            # http://clubs.ya.ru/webmaster-api/replies.xml?item_no=150
+            # CONTENT_TYPE     => 'application/xml'
+            CONTENT_TYPE     => 'application/x-www-form-urlencoded'
+          },
+          :ssl => options.fetch(:ssl) { self.configuration.ssl },
+          :url => options.fetch(:endpoint) { self.configuration.endpoint }
+        }.merge(options)
+      end
+
+      # Exposes middleware builder to facilitate custom stacks and easy
+      # addition of new extensions such as cache adapter.
+      #
+      def stack(&block)
+        @stack ||= begin
+          block_given? ? Faraday::Builder.new(&block) : Faraday::Builder.new(&default_middleware)
+        end
+      end
+
+      # Default middleware stack that uses default adapter as specified at
+      # configuration stage.
+      #
+      def default_middleware
+        Proc.new do |builder|          
+          builder.use Faraday::Request::Multipart
+          builder.use Faraday::Request::UrlEncoded
+          builder.use Webmaster::Request::OAuth2, self.configuration.oauth_token
+
+          builder.use Faraday::Response::Logger if ENV['DEBUG']
+          builder.use Webmaster::Response::Hashify
+          # builder.use Webmaster::Response::RaiseError
+          
+          builder.adapter self.configuration.adapter
+        end
+      end  
+
+    end
+  end
+end