nakitwitch 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3970325c621105476820e5a9eb57dccf0898b65a0519c21c79e9e43dd3ab7a03
+  data.tar.gz: 1b7ac3dce0bd24a0e0600a3f35abf2376cb26eaaafcd34ad49b5e8d527093203
+SHA512:
+  metadata.gz: 1dad8a601b2687515443b1bbf83ef04c970e37ad81fa0b8002878d5ed57d07306f17d8b3cd935e6e517f8d48f84a15dabbf4693cd4defed522bfc85063509cec
+  data.tar.gz: d299d0da57e897c025aa6161e9cd378af1dfcf61a0943dc61fdc70af5498342d4cb0480a062e8965578a48871b8c0fb63b14bd0f6c38aba2ccafa2bd6ad6e09a

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Victor Maslov
+
+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/lib/nakitwitch.rb

@@ -0,0 +1,88 @@
+module Twitch
+  Error = ::Class.new ::RuntimeError
+
+  # AUTH
+  def self.configure client_id, client_secret, tokens_filename
+    @client_id = client_id
+    @client_secret = client_secret
+    @tokens_filename = tokens_filename
+  end
+  def self.refresh
+    ::File.write @tokens_filename, ::NetHTTPUtils.request_data("https://id.twitch.tv/oauth2/token", :POST, form: {
+      client_id: @client_id || raise(Error, "missing configuration (#{::Module.nesting}.configure)"),
+      client_secret: @client_secret || raise(Error, "missing configuration (#{::Module.nesting}.configure)"),
+      grant_type: "refresh_token",
+      refresh_token: ::JSON.load(::File.read(@tokens_filename)).fetch("refresh_token")
+    } )
+  end
+  def self.oauth_token
+    unless ::File.exist? @tokens_filename
+      puts <<~HEREDOC
+        1. create app: https://dev.twitch.tv/console/apps/create
+        2. find <client_id> and create client_secret on apps properties page, save both
+        3. set OAuth Redirect URL: http://localhost:3000
+        4. obtain <auth code> by opening in web browser (example scopes are for a chat bot):
+           https://id.twitch.tv/oauth2/authorize?response_type=code&client_id=<client_id>&redirect_uri=http://localhost:3000&scope=chat:read+chat:edit+moderator:read:followers
+        5. get tokens (the auth code is a single time use):
+           $ curl https://id.twitch.tv/oauth2/token -d "client_id=$( \
+               cat client_id.twitch.secret                           \
+             )&client_secret=$(                                      \
+               cat client_secret.twitch.secret                       \
+             )&grant_type=authorization_code&code=<auth code>&redirect_uri=http://localhost:3000" \
+               >tokens.twitch.secret.json
+      HEREDOC
+    end
+    "oauth:#{(::JSON.load ::File.read @tokens_filename)["access_token"]}"
+  end
+
+  def self.banword str
+    str.
+      gsub(/н(ег|иге)р/, "<censored>").
+      gsub(/п[еи]д[ао]рас/, "<censored>")
+  end
+
+  SCHEMA = {
+    "videos" => { hash: {
+      "data" => {
+        size: 0..1,
+        each: { hash_req: {
+        "user_id" => /\A[0-9]+\z/,
+        "user_login" => /\A\S+\z/,
+        "user_name" => /\S/,
+        "title" => /\S/,
+        "published_at" => /\A202\d-(0[1-9]|1[0-2])-([012][0-9]|3[01])T[012][0-9]:[0-5][0-9]:[0-5][0-9]Z\z/,
+        "view_count" => 0..1000000000,
+        } },
+      },
+      "pagination" => { hash: {} }
+    } },
+    "channels/followers" => { hash: {
+      "total" => 0..1000000000,
+      "data" => [[]],
+      "pagination" => { hash: {} },
+    } },
+  }
+  require "nethttputils"
+  require "json"
+  require "nakischema"
+  def self.request mtd, retry_delay = 5, **form
+    ::JSON.load( begin
+      ::NetHTTPUtils.request_data "https://api.twitch.tv/helix/#{mtd}", form: form, header: {
+        "Authorization" => "Bearer #{::JSON.load(::File.read(@tokens_filename)).fetch "access_token"}",
+        "client-id" => @client_id || raise(Error, "missing configuration (#{::Module.nesting}.configure)")
+      }
+    rescue ::NetHTTPUtils::Error
+      fail unless '{"error":"Unauthorized","status":401,"message":"Invalid OAuth token"}' == $!.body
+      refresh
+      sleep retry_delay
+      retry
+    end ).tap do |_|
+      ::Nakischema.validate _, SCHEMA[mtd] if SCHEMA.key? mtd
+    end
+  end
+
+  def self.login_to_id login
+    request("users", "login" => login)["data"][0]["id"]
+  end
+
+end

data/nakitwitch.gemspec

@@ -0,0 +1,15 @@
+Gem::Specification.new do |spec|
+  spec.name         = "nakitwitch"
+  spec.version      = "0.0.0"
+  spec.summary      = "common Twitch API routines"
+
+  spec.author       = "Victor Maslov aka Nakilon"
+  spec.email        = "nakilon@gmail.com"
+  spec.license      = "MIT"
+  spec.metadata     = {"source_code_uri" => "https://github.com/nakilon/nakitwitch"}
+
+  spec.add_dependency "nethttputils"
+  spec.add_dependency "nakischema"
+
+  spec.files        = %w{ LICENSE nakitwitch.gemspec lib/nakitwitch.rb }
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: nakitwitch
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Victor Maslov aka Nakilon
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-09-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nethttputils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nakischema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
+email: nakilon@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- lib/nakitwitch.rb
+- nakitwitch.gemspec
+homepage:
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/nakilon/nakitwitch
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key:
+specification_version: 4
+summary: common Twitch API routines
+test_files: []