vimeo_ruby 0.2.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7000f9130237da5595d223c8a98598720a573a9be750378c37b6d1edb01080b2
-  data.tar.gz: dd9b26623d5bcf4bd80145f9acff65d00593cfdaa412c14f10629aa5f6fe87e2
+  metadata.gz: 7ddc19e27ceb164c54d03fcc8a551873a3c69eb783969cafc95ce644a8f9dfdb
+  data.tar.gz: 407f36cb900c6434cc06190abaf196c5ca1cf5b86a3254da7e49c9da2408c79d
 SHA512:
-  metadata.gz: 21d841070b073578b3c492c4c6f539a926ba9d7c5fc20b2f2784e1155b81a7903d78e0e542c3cd5d1940997b192ae2f9cdab27625a0fe01b32271bae6fbd0d4c
-  data.tar.gz: 2c9b3fb0a8ddaa5df8cc5df83b0658048209d50fea2cf1ca605213cdc2f4ca5bc32ea5b0ffe9e2bccf514150e2c1f8cd3dec68ad8b552469969f5929857c8ec7
+  metadata.gz: ae1f15845f9ab6d34ca9deb873df7632ea549df34e571983b49db4740722a0cff2dfd7c4ac437954d0e8413cbed8a47782d8eee969c0d964aa29fbfb905b2c0d
+  data.tar.gz: ca9d147f701953220ca9add1f8a7d46d31212aefa6da269de66c0ea230884d5a7882b45d1643222090af9d051ad3b02c73821c202c0c10823a39c3f68c62b7f8

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.4.0] - 2022-12-29
+
+- Save unnecessary call to get a users uploaded video collection if we already have it and no additional query params are passed in to `VimeoRuby::User#uploaded_videos`.
+
+## [0.3.0] - 2022-12-29
+
+- Add shorthand methods on `VimeoRuby` module for `get_user(<vimeo_id>)` and `get_video(<vimeo_id>)` to retrieve the appropriate data.
+
 ## [0.2.0] - 2022-12-28
 
 - Initial User and Video classes, with beginning interface to retrieve records from the Vimeo API. Adds a connection class used to hold a collection of a users uploaded videos (VimeoRuby::User::UploadedVideoCollection) accessible by calling `VimeoRuby::User#uploaded_videos`.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    vimeo_ruby (0.1.0)
+    vimeo_ruby (0.4.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,7 +1,14 @@
-# VimeoRuby
+# VimeoRuby 0.3.0
 
 Welcome to VimeoRuby!
 
+## Development Philosophy/Mindset
+
+The mindset of this project at this stage of development is to:
+1. Be simple - Write boring code, resist pulling in additional gems as much as possible, and don't worry about edge cases or handling errors all that much right now.
+2. Try to be as object-oriented as possible. I'm not an OO expert and you don't have to be either but let's try to improve our OO skills.
+3. Have fun. Who wants another job? Not me so let's keep it light and make something cool!
+
 ## Installation
 
 Install the gem and add to the application's Gemfile by executing:
@@ -14,7 +21,82 @@ If bundler is not being used to manage dependencies, install the gem by executin
 
 ## Usage
 
-WIP
+### Configure Credentials
+
+First, make sure you have a Vimeo account and have access to the following credentials from your Vimeo [My Apps dashboard](https://developer.vimeo.com/apps):
+
+`access_token`, `client_identifier`, and `client_secret`
+
+Once you have access to these, assign them to the following environment variables accordingly:
+
+```ruby
+VIMEO_ACCESS_TOKEN=<access_token_value>
+VIMEO_CLIENT_IDENTIFIER=<client_identifier_value>
+VIMEO_CLIENT_SECRET=<client_secrete_value
+```
+
+Now you should be ready to continue onward and experiment with this first iteration of the gem interface.
+
+Currently there are two main classes the you should use to interface with the Vimeo API through which are `VimeoRuby::User` and `VimeoRuby::Video`.
+
+### Working with the VimeoRuby::User class
+
+For example, should you want to find a particular Vimeo user by their `vimeo_id`, you can make the following call:
+```ruby
+vimeo_user = VimeoRuby::User.get_user(<vimeo_id>) # Makes http request to the Vimeo API
+#=> #<VimeoRuby::User:0x000000011230df50
+```
+
+Alternatively, you can call the `get_user` method on the `VimeoRuby` module itself if you wish for something a bit shorter:
+```ruby
+vimeo_user = VimeoRuby.get_user(<vimeo_id>) # Makes http request to the Vimeo API
+#=> #<VimeoRuby::User:0x000000011230df50
+```
+
+With the `VimeoRuby::User` instance that was returned from the successful call we can see what methods are available by running the preceeding and the following code in an irb session with the gem loaded:
+```ruby
+vimeo_user.methods.sort - Object.methods
+=>  [:additional_info,
+     :available_for_hire,
+     :available_for_hire?,
+     :base_uri,
+     :bio,
+     :can_work_remotely,
+     :can_work_remotely?,
+     :location,
+     :profile_link,
+     :uploaded_videos,
+     :vimeo_id]
+```
+
+We can then take the `vimeo_user` that we currently have stored and retrieve a collection of all of the users uploaded videos with the following:
+```ruby
+uploaded_video_collection = vimeo_user.uploaded_videos # Makes http request to the Vimeo API
+# => #<VimeoRuby::User::UploadedVideoCollection:0x00000001130e98b8
+```
+
+The `VimeoRuby::User::UploadedVideoCollection` object stores an array of `VimeoRuby::Video` objects which are accessible by calling:
+```ruby
+uploaded_video_collection.videos # No http request is made to the Vimeo API
+#=> [#<VimeoRuby::Video:0x0000000112fb3228
+#     ....,
+#     ....,
+#    ]
+```
+
+### Working with the VimeoRuby::Video class
+
+To retrieve a particular video from Vimeo you can use the following call:
+```ruby
+vimeo_video = VimeoRuby::Video.get_video(<vimeo_id>)
+#=> #<VimeoRuby::Video:0x000000022341eg61
+```
+
+Alternatively, you can call the `get_video` method on the `VimeoRuby` module itself if you wish for something a bit shorter:
+```ruby
+vimeo_video = VimeoRuby.get_video(<vimeo_id>) # Makes http request to the Vimeo API
+#=> #<VimeoRuby::Video:0x0000000223gc4339
+```
 
 ## Development
 

data/lib/vimeo_ruby/user/uploaded_video_collection.rb

@@ -1,13 +1,17 @@
 module VimeoRuby
-  class User < VimeoRuby::Base
+  class User < Base
     class UploadedVideoCollection
       attr_reader :videos
 
       def initialize(videos_array)
         @videos = videos_array.map do |video_data|
-          VimeoRuby::Video.new(attrs: video_data)
+          Video.new(attrs: video_data)
         end
       end
+
+      def empty?
+        videos.empty?
+      end
     end
   end
 end

data/lib/vimeo_ruby/user.rb

@@ -1,6 +1,6 @@
 module VimeoRuby
-  class User < VimeoRuby::Base
-    attr_reader :vimeo_id, :available_for_hire, :bio, :can_work_remotely, :location, :name, :profile_link, :additional_info
+  class User < Base
+    attr_reader :vimeo_id, :video_collection, :available_for_hire, :bio, :can_work_remotely, :location, :name, :profile_link, :additional_info
 
     def initialize(attrs: {})
       @vimeo_id = extract_vimeo_id_from_uri(attrs.delete("uri"))
@@ -10,7 +10,8 @@ module VimeoRuby
       @location = attrs.delete("location")
       @name = attrs.delete("name")
       @profile_link = attrs.delete("link")
-      @additional_info = attrs
+      @video_collection = nil
+      @additional_info = OpenStruct.new(attrs)
     end
 
     def self.get_user(user_id)
@@ -23,9 +24,13 @@ module VimeoRuby
     end
 
     def uploaded_videos(query_params: {})
-      uploaded_videos_response = self.class.get("#{base_uri}/users/#{vimeo_id}/videos", query_params: query_params)
-      uploaded_videos = uploaded_videos_response["data"]
-      VimeoRuby::User::UploadedVideoCollection.new(uploaded_videos)
+      if @video_collection.nil? || !query_params.empty?
+        uploaded_videos_response = self.class.get("#{base_uri}/users/#{vimeo_id}/videos", query_params: query_params)
+        uploaded_videos = uploaded_videos_response["data"]
+        @video_collection = UploadedVideoCollection.new(uploaded_videos)
+      else
+        @video_collection
+      end
     end
 
     def available_for_hire?

data/lib/vimeo_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module VimeoRuby
-  VERSION = "0.2.0"
+  VERSION = "0.4.1"
 end

data/lib/vimeo_ruby/video.rb

@@ -1,5 +1,5 @@
 module VimeoRuby
-  class Video < VimeoRuby::Base
+  class Video < Base
     attr_reader :vimeo_id, :description, :duration, :embed_html, :link, :name, :player_embed_url, :type, :user, :additional_info
 
     def initialize(attrs: {})
@@ -12,7 +12,7 @@ module VimeoRuby
       @player_embed_url = attrs.delete("player_embed_url")
       @type = attrs.delete("type")
       @user = VimeoRuby::User.new(attrs: attrs.delete("user"))
-      @additional_info = attrs
+      @additional_info = OpenStruct.new(attrs)
     end
 
     def self.get_video(video_id)

data/lib/vimeo_ruby.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "ostruct"
 require "vimeo_ruby/base"
 require "vimeo_ruby/user"
 require "vimeo_ruby/user/uploaded_video_collection"
@@ -8,4 +9,12 @@ require "vimeo_ruby/video"
 
 module VimeoRuby
   class Error < StandardError; end
+
+  def self.get_user(vimeo_id)
+    User.get_user(vimeo_id)
+  end
+
+  def self.get_video(vimeo_id)
+    Video.get_video(vimeo_id)
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vimeo_ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Collin Jilbert
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-12-28 00:00:00.000000000 Z
+date: 2022-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: webmock