social_shares 0.1.0 → 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6b30b6f300dea16a77d0c94336c2d6d702db679f
+  data.tar.gz: 6a66438d21a2ed96e9edb06c8b9993c6358407e1
+SHA512:
+  metadata.gz: b7382f31c5ecea6af8b42a229ab6eb7e94d637304737cc32b4c314f94dc1ecd1a2b487d7df14d3c68066671a90056497f094485643296123e33186c7cc1a418a
+  data.tar.gz: 0d2572ae7a55547f5958153765f7d49abe2d430a5c66b537b48eb498757e1f4d5696966ea2341edc1e858c684e4d21888068ceb062f7721289e671a2e7c96457

data/README.md

@@ -2,7 +2,9 @@ Social Shares
 =============
 Social shares is intended to easily check social sharings of an url.
 
-Supported networks:
+Supported networks
+------
+International:
 * [facebook](http://www.facebook.com/)
 * [google plus](https://plus.google.com)
 * [twitter](https://twitter.com/)
@@ -10,53 +12,89 @@ Supported networks:
 * [linkedin](https://www.linkedin.com/)
 * [pinterest](http://www.pinterest.com/)
 * [stumbleupon](http://www.stumbleupon.com/)
+* [buffer](https://bufferapp.com/)
+
+Russian:
 * [vkontakte](http://vkontakte.ru/)
 * [mail.ru](http://mail.ru/)
 * [odnoklassniki](http://www.odnoklassniki.ru/)
 
-Usage
+Chinese:
+* [weibo](http://www.weibo.com)
+
+Basic usage
 -----
 ```ruby
 :000 > require 'social_shares'
  => true
-:000 > SocialShares.supported_networks
- => [:vkontakte, :facebook, :google, :twitter, :mail_ru, :odnoklassniki, :reddit, :linkedin, :pinterest, :stumbleupon]
+
 :000 > url = 'http://www.apple.com/'
  => "http://www.apple.com/"
+
 :000 > SocialShares.facebook url
  => 394927
+
 :000 > SocialShares.google url
  => 28289
+
 :000 > SocialShares.twitter url
  => 1164675
-# in case of exception it will return nil value
+```
+In case of exception:
+```ruby
 :000 > SocialShares.twitter url
  => nil
-# but this method will raise it
+
 :000 > SocialShares.twitter! url
   => RestClient::RequestTimeout: Request Timeout
+```
+
+Advanced usage
+-----
+List of all supported networks:
+```ruby
+:000 > SocialShares.supported_networks
+ => [:vkontakte, :facebook, :google, :twitter, :mail_ru, :odnoklassniki, :reddit, :linkedin, :pinterest, :stumbleupon, :buffer]
+```
+
+Fetch all shares by one method (#all, #all!):
+```ruby
+# in case of exception it will return nil
 :000 > SocialShares.all url
- => {:vkontakte=>44, :facebook=>399027, :google=>28346, :twitter=>1836, :mail_ru=>37, :odnoklassniki=>1, :reddit=>2361, :linkedin=>nil, :pinterest=>21011, :stumbleupon=>43035}
-# same for #all! method, it will not handle exceptions
+ => {:vkontakte=>nil, :facebook=>399027, :google=>28346, :twitter=>1836, :mail_ru=>37, :odnoklassniki=>1, :reddit=>2361, :linkedin=>33, :pinterest=>21011, :stumbleupon=>43035, :weibo=>12760, :buffer=>1662}
+
+# and this will raise it
 :000 > SocialShares.all! url
  => RestClient::RequestTimeout: Request Timeout
+```
+
+Fetch shares of selected networks(#selected, #selected!):
+```ruby
 :000 > SocialShares.selected url, %w(facebook google linkedin)
  => {:facebook=>394927, :google=>28289, :linkedin=>nil}
+
+# same here
 :000 > SocialShares.selected! url, %w(facebook google linkedin)
  => RestClient::RequestTimeout: Request Timeout
-# Total sum of sharings in selected networks
+```
+Total sum of sharings in selected networks:
+```ruby
 :000 > SocialShares.total url, %w(facebook google)
  => 423216
+
 # Second arg is optional, by default it takes all networks
 :000 > SocialShares.total url
  => 1631102
-# Note that #has_any? is faster than (#total > 0), coz it stops on first network that has at least 1 sharing
+```
+Does any network have at least one link?
+```ruby
 :000 > SocialShares.has_any? url, %w(facebook google)
  => true
 # Second arg is optional, by default it takes all networks
 :000 > SocialShares.has_any? url
  => true
 ```
+Note that #has_any? is faster than (#total > 0), because it stops on first network that has at least 1 sharing
 
 Instalation
 -----
@@ -65,6 +103,32 @@ Include the gem in your Gemfile:
 gem 'social_shares'
 ```
 
+Contributing
+-----
+* Create provider class in lib/social_shares/foo.rb with method #shares!, that return Integer value. #checked_url is accessed attribute.
+```ruby
+module SocialShares
+  class Foo < Base
+    def shares!
+      response = RestClient.get(url)
+      JSON.parse(response)["shares"] || 0
+    end
+
+  private
+
+    def url
+      "http://foo.com/?url=#{checked_url}"
+    end
+  end
+end
+```
+* Add it to lib/social_shares.rb
+```
+require 'social_shares/foo'
+SUPPORTED_NETWORKS = [:foo, :vkontakte, :facebook]
+```
+* Update README: add link to list, possible answer in #all method, etc.
+
 Authors
 ----
 * [Timur Kozmenko](https://twitter.com/Timrael)

data/lib/social_shares/buffer.rb

@@ -0,0 +1,14 @@
+module SocialShares
+  class Buffer < Base
+    def shares!
+      response = RestClient.get(url)
+      JSON.parse(response)['shares']
+    end
+
+  private
+
+    def url
+      "https://api.bufferapp.com/1/links/shares.json?url=#{checked_url}"
+    end
+  end
+end

data/lib/social_shares/version.rb

@@ -1,3 +1,3 @@
 module SocialShares
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 end

data/lib/social_shares/weibo.rb

@@ -0,0 +1,23 @@
+module SocialShares
+  class Weibo < Base
+    def shares!
+      response = RestClient.get(url_for_share)
+      JSON.parse(response)['urls'].first['share_counts'].to_i
+    end
+
+  private
+
+    def url_for_short
+      "https://api.weibo.com/2/short_url/shorten.json?_=1414437609673&source=8003029170&url_long=#{checked_url}"
+    end
+
+    def short_url
+      response = RestClient.get(url_for_short)
+      JSON.parse(response)['urls'].first['url_short']
+    end
+
+    def url_for_share
+      "https://api.weibo.com/2/short_url/share/counts.json?_=1414437609900&source=8003029170&url_short=#{short_url}"
+    end
+  end
+end

data/lib/social_shares.rb

@@ -12,6 +12,8 @@ require 'social_shares/reddit'
 require 'social_shares/linkedin'
 require 'social_shares/pinterest'
 require 'social_shares/stumbleupon'
+require 'social_shares/weibo'
+require 'social_shares/buffer'
 
 module SocialShares
   class << self
@@ -25,7 +27,9 @@ module SocialShares
       :reddit,
       :linkedin,
       :pinterest,
-      :stumbleupon
+      :stumbleupon,
+      :weibo,
+      :buffer,
     ]
 
     def supported_networks

metadata

@@ -1,78 +1,69 @@
 --- !ruby/object:Gem::Specification
 name: social_shares
 version: !ruby/object:Gem::Version
-  version: 0.1.0
-  prerelease: 
+  version: 0.1.1
 platform: ruby
 authors:
 - Timur Kozmenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-18 00:00:00.000000000 Z
+date: 2014-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
   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: 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: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.6'
 - !ruby/object:Gem::Dependency
   name: rake
   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: Check how many times url was shared in social networks, e.g. share counts.
@@ -82,13 +73,14 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - lib/social_shares.rb
 - lib/social_shares/base.rb
+- lib/social_shares/buffer.rb
 - lib/social_shares/facebook.rb
 - lib/social_shares/google.rb
 - lib/social_shares/linkedin.rb
@@ -100,31 +92,30 @@ files:
 - lib/social_shares/twitter.rb
 - lib/social_shares/version.rb
 - lib/social_shares/vkontakte.rb
+- lib/social_shares/weibo.rb
 - social_shares.gemspec
 homepage: https://github.com/Timrael/social_shares
 licenses:
 - MIT
+metadata: {}
 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.25
+rubygems_version: 2.4.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Check how many times url was shared in social networks.
 test_files: []
-has_rdoc: