funky 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 46500b4ee5d1c68792512b9cf131180960761e1f
-  data.tar.gz: 0a189efa28c00babc417f76508e6086d714143fe
+  metadata.gz: d76c2fdd3918dd49adec887a52a8cd55d1062658
+  data.tar.gz: 60c4af9c11e05e4d40c9d077e03a5847131580bb
 SHA512:
-  metadata.gz: 6253eaff7e502716d92bd33c5147da6e57fbb400fc7ca7b0bffe8fd3862f738546563b8e7069aa74ae60ff174832951019998ebfd8393bab0d8ae84871acf56d
-  data.tar.gz: cd773bba9f1f366dee400e473d052bf8065c502eb8dd740e38a24ef2e7015fb293a58c35c6aa1869a5bbbc4ac177a38c7cf9f6f2f519d144e1fd3ef72a590bbd
+  metadata.gz: f0a9bdfdc29390b523a28d83af059744a3b7ede1a55089881aa83e2b94b0195dfd4acdd93b3cdbcc38f6653fc23ffdf320862fd89fb63d73939e0d7fded85c0e
+  data.tar.gz: b62532c7eeeb17680771a2d30b40cc2a82c6f06b2cce55594d6855bff4d4f6d6e9e8b0318eb7c12a42fd95bbd2506d9a11bdeb0d6488ba6a3d591e0c9503a7d9

data/CHANGELOG.md

@@ -6,6 +6,15 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.2.1  - 2016/06/16
+
+* [FEATURE] Add method to find video by url, `Funky::Video.find_by_url!(url)`.
+The following URL formats are currently supported:
+- `https://www.facebook.com/{page_name}/videos/vb.{alt_page_id}/{video_id}/`
+- `https://www.facebook.com/{page_name}/videos/{video_id}/`
+- `https://www.facebook.com/{page_id}/videos/{video_id}/`
+- `https://www.facebook.com/video.php?v={video_id}`
+
 ## 0.2.0  - 2016/06/07
 
 **How to upgrade**

data/README.md

@@ -1,6 +1,7 @@
 [![Build Status](https://travis-ci.org/Fullscreen/funky.svg?branch=master)](https://travis-ci.org/Fullscreen/funky)
 [![Coverage Status](https://coveralls.io/repos/github/Fullscreen/funky/badge.svg?branch=master)](https://coveralls.io/github/Fullscreen/funky?branch=master)
 [![Dependency Status](https://gemnasium.com/badges/github.com/Fullscreen/funky.svg)](https://gemnasium.com/github.com/Fullscreen/funky)
+[![Code Climate](http://img.shields.io/codeclimate/github/Fullscreen/funky.svg)](https://codeclimate.com/github/Fullscreen/funky)
 [![Gem Version](https://badge.fury.io/rb/funky.svg)](https://badge.fury.io/rb/funky)
 
 # Funky
@@ -94,6 +95,32 @@ If a non-existing video ID is passed into #find, Funky::ContentNotFound will be
 Funky::Video.find('doesnotexist') # => raises Funky::ContentNotFound
 ```
 
+### Use #find_by_url!(url) to get a single video from a url
+
+```ruby
+video = Funky::Video.find_by_url!('https://www.facebook.com/video.php?v=10154439119663508')
+video.id            # => '10154439119663508'
+video.like_count    # => 1169
+video.comment_count # => 65
+video.share_count   # => 348
+video.view_count    # => 10121
+```
+
+If a non-existing video url is passed into #find_by, Funky::ContentNotFound will be raised.
+
+```ruby
+Funky::Video.find_by_url!('https://www.facebook.com/video.php?v=doesnotexist')
+  # => raises Funky::ContentNotFound
+```
+
+The current URL formats are supported:
+
+- `https://www.facebook.com/{page_name}/videos/vb.{alt_page_id}/{video_id}`
+- `https://www.facebook.com/{page_name}/videos/{video_id}`
+- `https://www.facebook.com/{page_id}/videos/{video_id}`
+- `https://www.facebook.com/video.php?v={video_id}`
+
+
 ### Connection error
 
 Should there be a case where Funky is unable to connect to Facebook, `Funky::ConnectionError` will be raised.

data/lib/funky/url.rb

@@ -0,0 +1,19 @@
+module Funky
+  class URL
+    attr_reader :url
+    VIDEO_ID_REGEXES = [/videos\/(\d*)/i, /v=(\d*)/i, /\/v.\..*\/(\d*)\b/i]
+
+    def initialize(url)
+      @url = url
+    end
+
+    def video_id
+      return unless url.include? 'facebook.com'
+      VIDEO_ID_REGEXES.each do |regex|
+        url.match regex
+        return $1 unless $1.nil? || $1.empty? || !$1.size.between?(15,17)
+      end
+      nil
+    end
+  end
+end

data/lib/funky/version.rb

@@ -1,3 +1,3 @@
 module Funky
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/funky/video.rb

@@ -1,5 +1,6 @@
 require 'funky/html/page'
 require 'funky/html/parser'
+require 'funky/url'
 
 module Funky
   class Video
@@ -90,6 +91,21 @@ module Funky
       new counters.merge(id: video_id)
     end
 
+    # Similar to #find, but it finds the video by url instead of video id.
+    # Fetches the data from Facebook's HTML and instantiates the data
+    # into a single Funky::Video object. It can accept one only video url.
+    #
+    # @example Getting a video by url
+    #   url = 'https://www.facebook.com/video.php?v=203203106739575'
+    #   Funky::Video.find_by_url!(url) # => #<Funky::Video>
+    #
+    # @return [Funky::Video] the data scraped from Facebook's HTML
+    #   and encapsulated into a Funky::Video object.
+    def self.find_by_url!(url)
+      url = URL.new(url)
+      find(url.video_id)
+    end
+
   private
 
     def self.fetch_and_parse_data(ids)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: funky
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Philip Nguyen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-06-08 00:00:00.000000000 Z
+date: 2016-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -123,6 +123,7 @@ files:
 - lib/funky/errors.rb
 - lib/funky/html/page.rb
 - lib/funky/html/parser.rb
+- lib/funky/url.rb
 - lib/funky/version.rb
 - lib/funky/video.rb
 homepage: https://github.com/Fullscreen/funky