holodex 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8fd9580663797301e759f8cac86325513e4c3fcd5a260a16a87b12bb35da8cde
+  data.tar.gz: cbaf60bf00bb2a4091656949fca714eb9c956ae3fd819fbe5a2f94f217087477
+SHA512:
+  metadata.gz: f5ba962f644112ae78ae5c001ebc7135adaa3264f007b51c45e92e198c271f29cc65ff5e85fecde93d80f03e4a10c3cc7e4ffe9a7b0035deb13db7afe8aed8ac
+  data.tar.gz: 960505befea5cd64e1b1c7c8ccfa8b094ebdbec166710e0f400a06f1b1cca3f8ddc44e53279c97e2212210fbaab769e663d63bfbb9bfe40c174221557e13a757

data/lib/holodex/resource/channel.rb

@@ -0,0 +1,4 @@
+class Holodex
+  # https://docs.holodex.net/docs/holodex/5dfaf299ea9fd-get-channel-information
+  def channel(id) = get("/channels/#{id}")
+end

data/lib/holodex/resource/channels.rb

@@ -0,0 +1,4 @@
+class Holodex
+  # https://docs.holodex.net/docs/holodex/4fd0f20623a29-list-channels
+  def channels(**) = get('/channels', **)
+end

data/lib/holodex/resource/comment_search.rb

@@ -0,0 +1,4 @@
+class Holodex
+  # https://docs.holodex.net/#operation/post-search-commentSearch
+  def comment_search(**) = post('/search/commentSearch', **)
+end

data/lib/holodex/resource/error.rb

@@ -0,0 +1,15 @@
+class Holodex
+  class ResourceError < StandardError
+    attr_reader :http_code, :data
+
+    def initialize(http_code, data)
+      @http_code = http_code
+      @data = data
+      super("Holodex returned an HTTP #@http_code with the following payload: #@data")
+    end
+
+    def [](key)
+      @data[key]
+    end
+  end # Error
+end

data/lib/holodex/resource/live.rb

@@ -0,0 +1,4 @@
+class Holodex
+  # https://docs.holodex.net/docs/holodex/b675902a04ca9-query-live-and-upcoming-videos
+  def live(**) = get('/live', **)
+end

data/lib/holodex/resource/related_videos.rb

@@ -0,0 +1,4 @@
+class Holodex
+  # https://docs.holodex.net/#operation/get-v2-channels-channelId-clips
+  def related_videos(id:, type:, **) = get("channels/#{id}/#{type}", **)
+end

data/lib/holodex/resource/users_live.rb

@@ -0,0 +1,4 @@
+class Holodex
+  # https://docs.holodex.net/docs/holodex/f1e355dc4cb79-quickly-access-live-upcoming-for-a-set-of-channels
+  def users_live(*channels) = get('/users/live', channels:)
+end

data/lib/holodex/resource/video.rb

@@ -0,0 +1,4 @@
+class Holodex
+  # https://docs.holodex.net/docs/holodex/d18465c977416-get-a-single-video-s-metadata
+  def video(id, lang: nil, c: nil) = get("/videos/#{id}", lang:, c:)
+end

data/lib/holodex/resource/video_search.rb

@@ -0,0 +1,4 @@
+class Holodex
+  # https://docs.holodex.net/#operation/post-search-videoSearch
+  def video_search(**) = post('/search/videoSearch', **)
+end

data/lib/holodex/resource/videos.rb

@@ -0,0 +1,4 @@
+class Holodex
+  # https://docs.holodex.net/docs/holodex/ba328f7332280-query-videos
+  def videos(**) = get('/videos', **)
+end

data/lib/holodex.rb

@@ -0,0 +1,67 @@
+require 'net/http'
+require 'json'
+
+require_relative 'holodex/resource/error'
+
+require_relative 'holodex/resource/live'
+require_relative 'holodex/resource/videos'
+require_relative 'holodex/resource/channel'
+require_relative 'holodex/resource/related_videos'
+require_relative 'holodex/resource/users_live'
+require_relative 'holodex/resource/video'
+require_relative 'holodex/resource/channels'
+require_relative 'holodex/resource/video_search'
+require_relative 'holodex/resource/comment_search'
+
+# https://docs.holodex.net/
+class Holodex
+  BASE_API = 'https://holodex.net/api/v2'
+  DEFAULT_HEADERS = { 'Content-Type' => 'application/json; charset=utf-8' }
+
+  def initialize(api_key)
+    @headers = DEFAULT_HEADERS.merge('X-APIKEY' => api_key)
+  end
+
+  private
+
+  def encode_query(data)
+    data.transform_keys!(&:to_s)
+    data.transform_values! do |value|
+      case value
+      when Array then value.join(',')
+      when true  then 1
+      when false then 0
+      else
+        value
+      end
+    end
+
+    URI.encode_www_form(data)
+  end
+
+  # Takes the reponse object from Net::HTTP.
+  # By overloading this method, one can change how responses are parsed.
+  def parse(response)
+    if Net::HTTPSuccess === response
+      JSON.parse(response.body)
+    else
+      raise ResourceError.new(response.code, JSON.parse(response.body))
+    end
+  end
+
+  def get(path, **)
+    query    = encode_query(**)
+    uri      = URI(BASE_API + path + "#{'?' << query unless query.empty?}")
+    response = Net::HTTP.get_response(uri, @headers)
+
+    parse(response)
+  end
+
+  def post(path, **)
+    payload  = JSON.generate(**)
+    uri      = URI(BASE_API + path)
+    response = Net::HTTP.post(uri, payload, @headers)
+
+    parse(response)
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: holodex
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Akseluhreyter
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2023-08-07 00:00:00.000000000 Z
+dependencies: []
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/holodex.rb
+- lib/holodex/resource/channel.rb
+- lib/holodex/resource/channels.rb
+- lib/holodex/resource/comment_search.rb
+- lib/holodex/resource/error.rb
+- lib/holodex/resource/live.rb
+- lib/holodex/resource/related_videos.rb
+- lib/holodex/resource/users_live.rb
+- lib/holodex/resource/video.rb
+- lib/holodex/resource/video_search.rb
+- lib/holodex/resource/videos.rb
+homepage: 
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.17
+signing_key: 
+specification_version: 4
+summary: Wrapper for the Holodex API.
+test_files: []