social_net 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 26881d44493639d136df86db159bcb5d40efa27f
+  data.tar.gz: f2d57936c89e67e93d214ad47327753f644d32f3
+SHA512:
+  metadata.gz: 9beafaaacab822d3c1aaf277514e80ac3d88b47903dc2730c0ca1bc808663fa8c6596ab35a77a727c90639c6802178cea090977a66bbe23e527cb92fae490d4d
+  data.tar.gz: 445b6d640dbc4a09347954b441f8d96b07d5065515643246f7d5314b958c664829539068eda8233a7ac6f99fa7ddaf0af736ea9e6fad67867149771f7140f92d

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+For more information about changelogs, check
+[Keep a Changelog](http://keepachangelog.com) and
+[Vandamme](http://tech-angels.github.io/vandamme).
+
+## 0.1.0 - 2017-3-13
+
+* Initial release with `Instagram::User` supporting `find_by`, `find_by!` and `where`.

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,94 @@
+PATH
+  remote: .
+  specs:
+    social_net (0.1.0)
+      activesupport
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (5.0.2)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (~> 0.7)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    addressable (2.5.0)
+      public_suffix (~> 2.0, >= 2.0.2)
+    concurrent-ruby (1.0.5)
+    coveralls (0.7.12)
+      multi_json (~> 1.10)
+      rest-client (>= 1.6.8, < 2)
+      simplecov (~> 0.9.1)
+      term-ansicolor (~> 1.3)
+      thor (~> 0.19.1)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.3)
+    docile (1.1.5)
+    domain_name (0.5.20170223)
+      unf (>= 0.0.5, < 1.0.0)
+    hashdiff (0.3.2)
+    http-cookie (1.0.3)
+      domain_name (~> 0.5)
+    i18n (0.8.1)
+    mime-types (2.99.3)
+    minitest (5.10.1)
+    multi_json (1.12.1)
+    netrc (0.11.0)
+    public_suffix (2.0.5)
+    rake (10.5.0)
+    rest-client (1.8.0)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.4)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    safe_yaml (1.0.4)
+    simplecov (0.9.2)
+      docile (~> 1.1.0)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.9.0)
+    simplecov-html (0.9.0)
+    term-ansicolor (1.4.0)
+      tins (~> 1.0)
+    thor (0.19.4)
+    thread_safe (0.3.6)
+    tins (1.13.2)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.2)
+    vcr (2.9.3)
+    webmock (1.24.6)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff
+    yard (0.8.7.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.6)
+  coveralls (~> 0.7.1)
+  rake (~> 10.3)
+  rspec (~> 3.1)
+  social_net!
+  vcr (~> 2.9)
+  webmock (~> 1.19)
+  yard (~> 0.8.7)
+
+BUNDLED WITH
+   1.10.6

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2017 Collab, Inc.
+
+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,264 @@
+SocialNet - a Ruby client for social networks API
+===========================================
+
+SocialNet helps you write apps that need to interact with Twitter, Instagram and Facebook.
+
+
+After [configuring your Twitter app](#configuring-your-twitter-app), you can run commands like:
+
+```ruby
+user = SocialNet::Twitter::User.find_by screen_name: 'collab'
+user.screen_name #=> "Collab"
+user.follower_count #=> 48_200
+```
+After [configuring your Instagram app](#configuring-your-instagram-app), you can run commands like:
+
+```ruby
+user = SocialNet::Instagram::User.find_by username: 'Collab'
+user.username #=> "Collab"
+user.follower_count #=> 7025
+```
+
+After [configuring your Facebook app](#configuring-your-facebook-app), you can run commands like:
+
+```ruby
+page = SocialNet::Facebook::Page.find_by username: 'collab'
+page.username #=> "collab"
+page.likes #=> 30094
+```
+
+How to install
+==============
+
+To install on your system, run
+
+    gem install net
+
+To use inside a bundled Ruby project, add this line to the Gemfile:
+
+    gem 'social_net', '~> 0.1.0'
+
+Since the gem follows [Semantic Versioning](http://semver.org),
+indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
+guarantees that your project won’t occur in any error when you `bundle update`
+and a new version of SocialNet is released.
+
+Available resources
+===================
+
+SocialNet::Twitter::User
+------------------
+
+Use [SocialNet::Twitter::User]() to:
+
+* retrieve a Twitter user by screen name
+* retrieve a list of Twitter users by screen names
+* access the number of followers of a Twitter user
+
+```ruby
+user = SocialNet::Twitter::User.find_by screen_name: 'collab'
+user.follower_count #=> 48_200
+
+users = SocialNet::Twitter::User.where screen_name: ['collab', 'brohemian6']
+users.map(&:follower_count).sort #=> [12, 48_200]
+```
+
+*The methods above require a configured Twitter app (see below).*
+
+SocialNet::Instagram::User
+--------------------
+
+Use [SocialNet::Instagram::User]() to:
+
+* retrieve an Instagram user by username
+* retrieve an Instagram user by id
+* access the number of followers of an Instagram user
+
+```ruby
+user = SocialNet::Instagram::User.find_by username: 'collab'
+user.follower_count #=> 24198
+
+user = SocialNet::Instagram::User.find_by id: 270587948
+user.follower_count #=> 24198
+```
+
+*The methods above require a configured Instagram app (see below).*
+
+SocialNet::Facebook::Page
+--------------------
+
+Use [SocialNet::Facebook::Page]() to:
+
+* retrieve a Facebook page by username
+* access the number of likes of a Facebook user
+
+```ruby
+page = SocialNet::Facebook::Page.find_by username: 'collab'
+page.likes #=> 7025
+```
+
+SocialNet::Facebook::User
+--------------------
+
+Use [SocialNet::Facebook::User]() to:
+
+* retrieve a Facebook user by username
+
+```ruby
+user = SocialNet::Facebook::User.find_by username: '10100829454613149'
+user.first_name #=> Jeremy
+```
+
+* Include a Facebook access_token parameter in order to access pages information for a certain user
+
+```ruby
+user = SocialNet::Facebook::User.find_by username: '10100829454613149', access_token: 'abc123'
+user.pages #=> [{"name"=>"Jeremy Video Game", "id"=>"1627249647512991"}, {"name"=>"Influencer Plus", "id"=>"629655227132365"}]
+```
+
+*The methods above require a configured Facebook app (see below).*
+
+Configuring your Twitter app
+============================
+
+In order to use SocialNet you must create an app in the [Twitter Application Manager](https://apps.twitter.com/app/new).
+
+Once the app is created, copy the API key and secret and add them to your
+code with the following snippet of code (replacing with your own key and secret)
+:
+
+```ruby
+SocialNet::Twitter.configure do |config|
+  config.apps.push key: 'abcd', secret: 'efgh'
+end
+```
+
+Configuring with environment variables
+--------------------------------------
+
+As an alternative to the approach above, you can configure your app with
+variables. Setting the following environment variables:
+
+```bash
+export TWITTER_API_KEY='abcd'
+export TWITTER_API_SECRET='efgh'
+```
+
+is equivalent to configuring your app with the initializer:
+
+```ruby
+SocialNet::Twitter.configure do |config|
+  config.apps.push key: 'abcd', secret: 'efgh'
+end
+```
+
+so use the approach that you prefer.
+If a variable is set in both places, then `SocialNet::Twitter.configure` takes precedence.
+
+Configuring your Instagram app
+============================
+
+In order to use SocialNet you must create an app in the
+[Instagram Client Manager](http://instagram.com/developer/clients/register).
+
+Once the app is created, copy the Client ID and add it to your
+code with the following snippet of code (replacing with your own client id)
+:
+
+```ruby
+SocialNet::Instagram.configure do |config|
+  config.client_id = 'abcdefg'
+end
+```
+
+Configuring with environment variables
+--------------------------------------
+
+As an alternative to the approach above, you can configure your app with
+a variable. Setting the following environment variable:
+
+```bash
+export INSTAGRAM_CLIENT_ID='abcdefg'
+```
+
+is equivalent to configuring your app with the initializer:
+
+```ruby
+SocialNet::Instagram.configure do |config|
+  config.client_id = 'abcdefg'
+end
+```
+
+so use the approach that you prefer.
+If a variable is set in both places, then `SocialNet::Instagram.configure` takes precedence.
+
+Configuring your Facebook app
+============================
+
+In order to use SocialNet you must create an app in the [Facebook Application Manager](https://developers.facebook.com/apps/).
+
+Once the app is created, copy the API key and secret and add them to your
+code with the following snippet of code (replacing with your own key and secret)
+:
+
+```ruby
+SocialNet::Facebook.configure do |config|
+  config.client_id = 'abcdefg'
+  config.client_secret = 'abcdefg'
+end
+```
+
+Configuring with environment variables
+--------------------------------------
+
+As an alternative to the approach above, you can configure your app with
+variables. Setting the following environment variables:
+
+```bash
+export FACEBOOK_CLIENT_ID='abcd'
+export FACEBOOK_CLIENT_SECRET='efgh'
+```
+
+is equivalent to configuring your app with the initializer:
+
+```ruby
+SocialNet::Facebook.configure do |config|
+  config.client_id = 'abcd'
+  config.client_secret = 'efgh'
+end
+```
+
+so use the approach that you prefer.
+If a variable is set in both places, then `SocialNet::Facebook.configure` takes precedence.
+
+How to test
+===========
+
+To run tests, type:
+
+```bash
+rspec
+```
+
+SocialNet uses [VCR](https://github.com/vcr/vcr) so by default tests do not run
+HTTP requests.
+
+If you need to run tests against the live Twitter API or Instagram API,
+configure your [Twitter app](#configuring-your-twitter-app) or your [Instagram app](#configuring-your-instagram-app)  using environment variables,
+erase the cassettes, then run `rspec`.
+
+
+How to release new versions
+===========================
+
+If you are a manager of this project, remember to upgrade the [SocialNet gem](http://rubygems.org/gems/net)
+whenever a new feature is added or a bug gets fixed.
+
+Make sure all the tests are passing, document the changes in CHANGELOG.md and
+README.md, bump the version, then run
+
+    rake release
+
+Remember that the net gem follows [Semantic Versioning](http://semver.org).
+Any new release that is fully backward-compatible should bump the *patch* version (0.1.x).
+Any new version that breaks compatibility should bump the *minor* version (0.x.0)

data/Rakefile

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

data/coverage/.last_run.json

@@ -0,0 +1,5 @@
+{
+  "result": {
+    "covered_percent": 64.08
+  }
+}