wordpress-com 0.0.1

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in wordpress-com.gemspec
+gemspec
+
+gem "sinatra"
+gem "haml"

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Maciej Pasternacki
+
+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,77 @@
+# Wordpress::Com
+
+Library to access WordPress.com's REST API
+
+https://developer.wordpress.com/
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'wordpress-com'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install wordpress-com
+
+## Usage
+
+To authorize your token, register your application at
+https://developers.wordpress.com/. Make sure that redirect URL is
+yours - user will be redirected there, and it has to match. Then do this:
+
+    require 'wordpress-com'
+    wpc = WordpressCom.new(client_id, client_secret)
+    url = wpc.authorize(redirect_uri)
+    # or: wpc.authorize(redirect_uri, :blog => 'http://foobar.wordpress.com/')
+
+Make your user redirect to the returned `url`. User will be redirected
+to the `redirect_url` and given a `code` GET parameter. Use this
+parameter to obtain a token:
+
+    wpc = WordpressCom.new(client_id, client_secret)
+    wpc.get_token(code, redirect_uri)
+
+You can then save complete authorization data, store it somewhere, and
+reuse it later on. The authorization data is JSON and YAML safe.
+
+    wordpress_auth = wpc.serialize
+    
+    wpc = WordPressCom.deserialize(wordpress_auth)
+
+If you are writing a desktop or headless application and want to just
+have the authorization data without any hassle, you can use provided
+`examples/authorizer.rb` Sinatra app. Set your redirect URL to
+`http://localhost:4567/' and run the app:
+
+    $ cd examples/
+    $ ruby authorizer.rb
+
+Browse to http://localhost:4567/, follow the instructions, and after
+successfully authorizing you will see serialized authentication data
+as a YAML snippet.
+
+To actually call the API, use `.request`, `.get`, `.post`, `.put`, and
+`.delete` methods of the WordPressCom instance, or use the `token`
+attribute to get to OAuth2 token itself:
+
+    wpc.post('posts/new', :body => {
+      :title => "Hello, World!",
+      :content => "Lorem ipsum dolor sit amet",
+      :tags => 'foo,bar,xyzzy'})
+      
+The request methods are automatically prefixed with
+`/rest/v1/sites/$site_id/`. To get rid of the `/sites/$site_id/` part,
+provide `:root_path => true` keyword parameter.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

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

data/examples/authorizer.rb

@@ -0,0 +1,38 @@
+require 'sinatra'
+require 'wordpress-com'
+
+set :views, File.dirname(__FILE__)
+enable :sessions
+
+get '/' do
+  if params[:code]
+    wpc = WordpressCom.new(session[:client_id], session[:client_secret])
+    wpc.get_token(params[:code], session[:redirect_uri])
+    session[:wpc] = wpc.serialize
+    redirect to('/')
+  elsif session[:wpc]
+    haml :authorizer_result
+  else
+    haml :authorizer_form
+  end
+end
+
+post '/' do
+  session[:client_id] = params[:client_id]
+  session[:client_secret] = params[:client_secret]
+  session[:blog] = params[:blog]
+  session[:redirect_uri] = request.url
+
+  wpc = WordpressCom.new(session[:client_id], session[:client_secret])
+  redirect to(
+    if session[:blog]
+      wpc.authorize_url(request.url, :blog => session[:blog])
+    else 
+      wpc.authorize_url(request.url)
+    end )
+end
+
+post '/forget' do
+  session.clear
+  redirect to('/')
+end

data/examples/authorizer_form.haml

@@ -0,0 +1,22 @@
+!!! 5
+%html
+  %head
+    %title WordPress.com authorizer
+    %link{:rel => "stylesheet",
+          :href => "http://www.blueprintcss.org/blueprint/screen.css",
+          :type => "text/css",
+          :media => "screen, projection"}
+  %body
+    .container
+      %h1 Example authorizer for WordPress.com REST API
+      %form(method="POST")
+        %table
+          - [[:client_id, "Client ID"], [:client_secret, "Client secret"], [:blog, 'WordPress.com Blog URL <span class="quiet">(optional)</span>' ]].each do |name, title|
+            %tr
+              %td(style="text-align: right")
+                %label{ :for => name }= title
+              %td
+                %input.text{ :name=> name, :value => session[name] }
+          %tr
+            %td(colspan="2" style="text-align: center")
+              %input(type="submit" value="Get authorization!")

data/examples/authorizer_result.haml

@@ -0,0 +1,15 @@
+!!! 5
+%html
+  %head
+    %title WordPress.com authorizer
+    %link{:rel => "stylesheet",
+          :href => "http://www.blueprintcss.org/blueprint/screen.css",
+          :type => "text/css",
+          :media => "screen, projection"}
+  %body
+    .container
+      %h1 Example authorizer for WordPress.com REST API
+      %h2 Authorized successfully
+      %pre.success= YAML::dump(session[:wpc])
+      %form(method="POST" action="/forget")
+        %input(type="submit" value="Forget it!")

data/lib/wordpress-com.rb

@@ -0,0 +1,43 @@
+require 'oauth2'
+
+require "wordpress-com/version"
+require "wordpress-com/access_token"
+
+class WordpressCom
+  extend Forwardable
+  attr_reader :client, :token
+  def_delegators :@token, :request, :get, :post, :put, :delete
+
+  def initialize(client_id, client_secret, token=nil)
+    @client = OAuth2::Client.new(client_id, client_secret,
+      :site          => 'https://public-api.wordpress.com/',
+      :authorize_url => '/oauth2/authorize',
+      :token_url     => '/oauth2/token')
+    @token = AccessToken.from_hash(client, token) if token
+  end
+
+  def self.deserialize(data)
+    self.new(*data)
+  end
+
+  def authorize_url(redirect_uri, opts={})
+    opts[:redirect_uri] = @redirect_uri = redirect_uri
+    client.auth_code.authorize_url(opts)
+  end
+
+  def get_token(code, redirect_uri=nil)
+    redirect_uri ||= @redirect_uri
+    @token = AccessToken.from_hash( @client,
+      client.auth_code.get_token(code,
+        :redirect_uri => redirect_uri,
+        :parse => :json).to_hash)
+  end
+
+  def serialize
+    [ client.id, client.secret, token.to_hash ]
+  end
+
+  def blog_id
+    token['blog_id']
+  end
+end

data/lib/wordpress-com/access_token.rb

@@ -0,0 +1,26 @@
+require "oauth2"
+
+class OAuth2::AccessToken
+  # Returns serialization of the token as a Hash
+  def to_hash
+    rv = { :access_token => token }
+    rv[:refresh_token] = refresh_token if refresh_token
+    rv[:expires_in] = expires_in if expires_in
+    rv[:expires_at] = expires_at if expires_at
+    rv[:mode] = options[:mode] if options[:mode] != :header
+    rv[:header_format] = options[:header_format] if options[:header_format] != 'Bearer %s'
+    rv[:param_name] = options[:param_name] if options[:param_name] != 'bearer_token'
+    rv.merge(params)
+  end
+end
+
+class WordpressCom
+  class AccessToken < OAuth2::AccessToken
+    def request(verb, path, opts={}, &block)
+      full_path = "/rest/v1/"
+      full_path << "sites/#{self['blog_id']}/" unless opts.delete('root_path')
+      full_path << path.gsub(/^\/*/, '')
+      super(verb, full_path, opts, &block)
+    end
+  end
+end

data/lib/wordpress-com/version.rb

@@ -0,0 +1,3 @@
+class WordpressCom
+  VERSION = "0.0.1"
+end

data/wordpress-com.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/wordpress-com/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Maciej Pasternacki"]
+  gem.email         = ["maciej@pasternacki.net"]
+  gem.description   = 'Ruby client for WordPress.com REST API'
+  gem.summary       = 'WordPress.com REST API client'
+  gem.homepage      = "https://github.com/mpasternacki/wordpress-com/"
+  gem.licenses      = ['MIT']
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "wordpress-com"
+  gem.require_paths = ["lib"]
+  gem.version       = WordpressCom::VERSION
+
+  gem.add_dependency "json"
+  gem.add_dependency "oauth2"
+
+  gem.add_development_dependency "pry"
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: wordpress-com
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Maciej Pasternacki
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby client for WordPress.com REST API
+email:
+- maciej@pasternacki.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- examples/authorizer.rb
+- examples/authorizer_form.haml
+- examples/authorizer_result.haml
+- lib/wordpress-com.rb
+- lib/wordpress-com/access_token.rb
+- lib/wordpress-com/version.rb
+- wordpress-com.gemspec
+homepage: https://github.com/mpasternacki/wordpress-com/
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: WordPress.com REST API client
+test_files: []