vk_music 3.1.7 → 4.1.0

data/Rakefile

@@ -1,25 +1,18 @@
-require "bundler/gem_tasks"
-require "rake/testtask"
+# frozen_string_literal: true
 
-task :test do
-  puts "Running tests require login credetionals (NOTICE: they won't be hidden in anyway)"
-  
-  print "Login:    "
-  username = STDIN.gets.chomp
-  
-  print "Password: "
-  password = STDIN.gets.chomp
-  puts
-  
-  print "Path to SSL certificate (leave empty if there is no troubles with SSL): "
-  ssl_cert_path = STDIN.gets.chomp
-  puts
-  ENV["SSL_CERT_FILE"] = ssl_cert_path unless ssl_cert_path.empty?
-  
-  Dir[ "test/test_*.rb" ].each do |file|
-    puts "\n\nRunning #{file}:"
-    ruby "-w #{file} '#{username}' '#{password}'"
-  end
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+require 'yard'
+
+RSpec::Core::RakeTask.new(:spec)
+
+RuboCop::RakeTask.new
+
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']
+  t.options = ['--any', '--extra', '--opts']
+  t.stats_options = ['--list-undoc']
 end
 
-task :default => :test
+task default: %i[rubocop spec yard]

data/bin/console

@@ -1,24 +1,18 @@
-#!/usr/bin/env ruby
-
-require "bundler/setup"
-require "vk_music"
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-require "pry"
-
-print "Login (leave this empty if no login required): "
-username = STDIN.gets.chomp
-
-unless username.empty?
-  print "Password: "
-  password = STDIN.gets.chomp
-  puts
-
-  $client = VkMusic::Client.new(username: username, password: password)
-  puts "You can now access client at $client"
-end
-puts
-
-Pry.start
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'vk_music'
+require 'pry'
+require 'dotenv'
+Dotenv.load
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+if ENV['VK_LOGIN'] && ENV['VK_PASSWORD']
+  client = VkMusic::Client.new(login: ENV['VK_LOGIN'], password: ENV['VK_PASSWORD'])
+  puts "You now can access client##{client.id}"
+end
+
+Pry.start(client || Object.new)

data/lib/vk_music.rb

@@ -1,18 +1,32 @@
-require "cgi"
-require "logger"
-require "mechanize"
-require "execjs"
-require "json"
-
-require_relative "vk_music/version"
-require_relative "vk_music/constants"
-require_relative "vk_music/exceptions"
-require_relative "vk_music/utility"
-require_relative "vk_music/link_decoder"
-require_relative "vk_music/audio"
-require_relative "vk_music/playlist"
-require_relative "vk_music/client"
-
-##
-# Main module.
-module VkMusic; end
+# frozen_string_literal: true
+
+require 'execjs'
+require 'mechanize'
+require 'json'
+require 'logger'
+require 'forwardable'
+
+# Main module
+module VkMusic
+  @@log = Logger.new($stdout)
+
+  # Logger of library classes
+  # @return [Logger]
+  def self.log
+    @@log
+  end
+
+  # Replace logger
+  # @param logger [Logger]
+  def self.log=(logger)
+    @@log = logger
+  end
+end
+
+require_relative 'vk_music/version'
+require_relative 'vk_music/utility'
+require_relative 'vk_music/request'
+require_relative 'vk_music/web_parser'
+require_relative 'vk_music/client'
+require_relative 'vk_music/audio'
+require_relative 'vk_music/playlist'

data/lib/vk_music/audio.rb

@@ -1,187 +1,112 @@
-module VkMusic
-  ##
-  # Class representing VK audio.
-  class Audio
-    ##
-    # @return [Integer, nil] ID of audio.
-    attr_reader :id
-    ##
-    # @return [Integer, nil] ID of audio owner.
-    attr_reader :owner_id
-    ##
-    # @return [String, nil] part of secret hash which used when using +act=reload_audio+.
-    attr_reader :secret_1, :secret_2
-    ##
-    # @return [String] name of artist.
-    attr_reader :artist
-    ##
-    # @return [String] title of song.
-    attr_reader :title
-    ##
-    # @return [Integer] duration of track in seconds.
-    attr_reader :duration
-    ##
-    # Read decoded download URL.
-    #
-    # If link was already decoded, returns cached value. Else decodes existing link.
-    # If no link can be provided, returns +nil+.
-    # @return [String, nil] decoded download URL or +nil+ if not available.
-    def url
-      if url_cached?
-        @url
-      elsif @url_encoded && @client_id
-        @url = VkMusic::LinkDecoder.unmask_link(@url_encoded, @client_id)
-      else
-        @url # => nil
-      end
-    end
-    ##
-    # @return [String, nil] encoded download URL.
-    attr_reader :url_encoded
-    ##
-    # @return [Integer, nil] user ID which should be use for decoding.
-    attr_reader :client_id
-    ##
-    # @return [String, nil] full ID of audio or +nil+ if some of components are missing.
-    def full_id
-      return nil unless @owner_id && @id && @secret_1 && @secret_2
-      "#{@owner_id}_#{@id}_#{@secret_1}_#{@secret_2}"
-    end
-
-    ##
-    # @return [Boolean] whether decoded URL is already cached.
-    def url_cached?
-      !!(@url)
-    end
-    ##
-    # @return [Boolean] whether able to get download URL without web requests.
-    def url_available?
-      !!(url_cached? || (@url_encoded && @client_id))
-    end
-    ##
-    # @return [Boolean] whether it's possible to get download URL with {Client#from_id}.
-    def url_accessable?
-      !!(@id && @owner_id && @secret_1 && @secret_2)
-    end
-
-    ##
-    # @return [String] information about audio.
-    def to_s
-      "#{@artist} - #{@title} [#{Utility.format_seconds(@duration)}]"
-    end
-    ##
-    # @return [String] extended information about audio.
-    def pp
-      "#{to_s} (#{
-        if url_available?
-          "Able to get decoded URL right away"
-        elsif url_accessable?
-          "Able to retrieve URL with request"
-        else
-          "URL not accessable"
-        end
-      })"
-    end
-
-    ##
-    # Update audio from another audio or from provided hash.
-    # @param from [Audio, nil]
-    # @param url [String, nil]
-    # @param url_encoded [String, nil]
-    # @param client_id [String, nil]
-    # @return [self]
-    def update(from: nil, url: nil, url_encoded: nil, client_id: nil)
-      if from
-        url_encoded = from.url_encoded
-        url = from.url_cached? ? from.url : nil
-        client_id = from.client_id
-      end
-
-      @url_encoded = url_encoded unless url_encoded.nil?
-      @url = url unless url.nil?
-      @client_id = client_id unless client_id.nil?
-      self
-    end
-
-    ##
-    # Initialize new audio.
-    # @param id [Integer, nil]
-    # @param owner_id [Integer, nil]
-    # @param secret_1 [String, nil]
-    # @param secret_2 [String, nil]
-    # @param artist [String]
-    # @param title [String]
-    # @param duration [Integer]
-    # @param url_encoded [String, nil]
-    # @param url [String, nil]
-    # @param client_id [Integer, nil]
-    def initialize(id: nil, owner_id: nil, secret_1: nil, secret_2: nil, artist: "", title: "", duration: 0, url_encoded: nil, url: nil, client_id: nil)
-      @id = id
-      @owner_id = owner_id
-      @secret_1 = secret_1
-      @secret_2 = secret_2
-      @secret_1 = @secret_2 if @secret_1.nil? || @secret_1.empty?
-      @artist = artist.strip
-      @title = title.strip
-      @duration = duration
-      @url_encoded = url_encoded
-      @url = url
-      @client_id = client_id
-    end
-    ##
-    # Initialize new audio from Nokogiri HTML node.
-    # @param node [Nokogiri::XML::Node] node, which match following CSS selector: +.audio_item.ai_has_btn+
-    # @param client_id [Integer]
-    # @return [Audio]
-    def self.from_node(node, client_id)
-      input = node.at_css("input")
-      if input
-        url_encoded = input.attribute("value").to_s
-        url_encoded = nil if url_encoded == Constants::URL::VK[:audio_unavailable] || url_encoded.empty?
-        id_array = node.attribute("data-id").to_s.split("_")
-
-        new(
-          id: id_array[1].to_i,
-          owner_id: id_array[0].to_i,
-          artist: node.at_css(".ai_artist").text.strip,
-          title: node.at_css(".ai_title").text.strip,
-          duration: node.at_css(".ai_dur").attribute("data-dur").to_s.to_i,
-          url_encoded: url_encoded,
-          url: nil,
-          client_id: client_id
-        )
-      else
-        # Probably audios from some post
-        new(
-          artist: node.at_css(".medias_music_author").text.strip,
-          title: Utility.plain_text(node.at_css(".medias_audio_title")).strip,
-          duration: Utility.parse_duration(node.at_css(".medias_audio_dur").text)
-        )
-      end
-    end
-    ##
-    # Initialize new audio from VK data array.
-    # @param data [Array]
-    # @param client_id [Integer]
-    # @return [Audio]
-    def self.from_data(data, client_id)
-      url_encoded = data[2].to_s
-      url_encoded = nil if url_encoded.empty?
-
-      secrets = data[13].to_s.split("/")
-
-      new(
-        id: data[0].to_i,
-        owner_id: data[1].to_i,
-        secret_1: secrets[3],
-        secret_2: secrets[5],
-        artist: CGI.unescapeHTML(data[4]),
-        title: CGI.unescapeHTML(data[3]),
-        duration: data[5].to_i,
-        url_encoded: url_encoded,
-        url: nil,
-        client_id: client_id
-      )
-    end
-  end
-end
+# frozen_string_literal: true
+
+module VkMusic
+  # Class representing VK audio
+  class Audio
+    # @return [String] name of artist
+    attr_reader :artist
+    # @return [String] title of song
+    attr_reader :title
+    # @return [Integer] duration of track in seconds
+    attr_reader :duration
+    # @return [String?] encoded URL which can be manually decoded if client ID is known
+    attr_reader :url_encoded
+
+    # Initialize new audio
+    # @param id [Integer, nil]
+    # @param owner_id [Integer, nil]
+    # @param secret1 [String, nil]
+    # @param secret2 [String, nil]
+    # @param artist [String]
+    # @param title [String]
+    # @param duration [Integer]
+    # @param url_encoded [String, nil]
+    # @param url [String, nil] decoded URL
+    # @param client_id [Integer, nil]
+    def initialize(id: nil, owner_id: nil, secret1: nil, secret2: nil,
+                   artist: '', title: '', duration: 0,
+                   url_encoded: nil, url: nil, client_id: nil)
+      @id = id
+      @owner_id = owner_id
+      @secret1 = secret1
+      @secret2 = secret2
+      @artist = artist.to_s.strip
+      @title = title.to_s.strip
+      @duration = duration
+      @url_encoded = url_encoded
+      @url_decoded = url
+      @client_id = client_id
+    end
+
+    # @return [String?]
+    def url
+      return @url_decoded if @url_decoded
+
+      return unless @url_encoded && @client_id
+
+      Utility::LinkDecoder.call(@url_encoded, @client_id)
+    end
+
+    # Update audio data from another one
+    def update(audio)
+      VkMusic.log.warn('Audio') { "Performing update of #{self} from #{audio}" } unless like?(audio)
+      @id = audio.id
+      @owner_id = audio.owner_id
+      @secret1 = audio.secret1
+      @secret2 = audio.secret2
+      @url_encoded = audio.url_encoded
+      @url_decoded = audio.url_decoded
+      @client_id = audio.client_id
+    end
+
+    # @return [String?]
+    def full_id
+      return unless @id && @owner_id && @secret1 && @secret2
+
+      "#{@owner_id}_#{@id}_#{@secret1}_#{@secret2}"
+    end
+
+    # @return [Boolean] whether URL saved into url attribute
+    def url_cached?
+      !!@url_decoded
+    end
+
+    # @return [Boolean] whether able to get download URL without web requests
+    def url_available?
+      url_cached? || !!(@url_encoded && @client_id)
+    end
+
+    # @return [Boolean] whether it's possible to get download URL with {Client#from_id}
+    def url_accessable?
+      !!full_id
+    end
+
+    # @param audio [Audio]
+    # @return [Boolean] whether artist, title and duration are same
+    def like?(audio)
+      artist == audio.artist && title == audio.title && duration == audio.duration
+    end
+
+    # @param [Audio, Array(owner_id, audio_id, secret1, secret2), String]
+    # @return [Boolean] id-based comparison
+    def id_matches?(data)
+      data_owner_id, data_id = case data
+      when Audio then [data.owner_id, data.id]
+      when Array then data.first(2).reverse.map(&:to_i)
+      when String then data.split('_').first(2).map(&:to_i)
+      else return false
+      end
+
+      owner_id == data_owner_id && id == data_id
+    end
+
+    # @return [String] pretty-printed audio name
+    def to_s
+      "#{@artist} - #{@title} [#{@duration}s]"
+    end
+
+    protected
+
+    attr_reader :id, :owner_id, :secret1, :secret2, :url_decoded, :client_id
+  end
+end

data/lib/vk_music/client.rb

@@ -1,677 +1,193 @@
-module VkMusic
-  ##
-  # Main class with all the interface.
-  class Client
-    ##
-    # @return [Integer] ID of client.
-    attr_reader :id
-    ##
-    # @return [String] name of client.
-    attr_reader :name
-    ##
-    # @return [Mechanize] client used to access web pages.
-    attr_reader :agent
-
-    ##
-    # Create new client and login.
-    # @param username [String] usually telephone number or email.
-    # @param password [String]
-    # @param user_agent [String]
-    def initialize(username: "", password: "", user_agent: Constants::DEFAULT_USER_AGENT)
-      raise ArgumentError if username.empty? || password.empty?
-      # Setting up client
-      @agent = Mechanize.new
-      @agent.user_agent = user_agent
-      login(username, password)
-    end
-
-    ##
-    #@!group Loading audios
-
-    ##
-    # Search for audio or playlist.
-    # Possible values of +type+ option:
-    # * +:audio+ - search for audios. Returns up to 50 audios.
-    # * +:playlist+ - search for playlists. Returns up to 6 playlists *without* audios (Loaded with +up_to: 0+ option).
-    #   You can get all the audios of selected playlist calling {Client#playlist} method with gained info.
-    # @note some audios and playlists might be removed from search.
-    # @todo search in group audios.
-    # @param query [String] search query.
-    # @param type [Symbol] what to search for.
-    # @return [Array<Audio>, Array<Playlist>] array with audios or playlists
-    #   matching given string.
-    def find(query = "", type: :audio)
-      raise ArgumentError if query.empty?
-      uri = URI(Constants::URL::VK[:audios])
-      search_page = load_ajax(uri, { "q" => query })
-      case type
-      when :audio
-        audios_from_ajax(search_page)
-      when :playlist
-        urls = playlist_urls_from_page(search_page)
-        urls.map { |url| playlist(url: url, up_to: 0, use_web: false) }
-      else
-        raise ArgumentError
-      end
-    end
-    alias_method :search, :find
-
-    ##
-    # Get VK playlist.
-    # Specify either +url+ or +(owner_id,playlist_id,access_hash)+.
-    # @note since updating URLs can take a lot of time in this case, you have to
-    #   do it manually with {Client#update_urls}.
-    # @param url [String, nil] playlist URL.
-    # @param owner_id [Integer, nil] playlist owner ID.
-    # @param playlist_id [Integer, nil] ID of the playlist.
-    # @param access_hash [String, nil] access hash to playlist. Might not exist.
-    # @param up_to [Integer] maximum amount of audios to load.
-    #   If 0, no audios would be loaded (Just information about playlist).
-    #   If less than 0, will load whole playlist.
-    # @param use_web [Boolean, nil] if +true+ web version of pages sill be used, if +false+
-    #   JSON will be used (latter is faster, but using web allow to get URLs instantly).
-    #   If +nil+ mixed algorithm will be used: if provided +up_to+ value is less than 200
-    #   web will be used.
-    # @return [Playlist]
-    def playlist(url: nil, owner_id: nil, playlist_id: nil, access_hash: nil, up_to: Constants::MAXIMUM_PLAYLIST_SIZE, use_web: nil)
-      begin
-        owner_id, playlist_id, access_hash = url.match(Constants::Regex::VK_PLAYLIST_URL_POSTFIX).captures if url
-      rescue
-        raise Exceptions::ParseError
-      end
-      raise ArgumentError unless owner_id && playlist_id
-      use_web ||= (up_to <= 200)
-      if use_web
-        playlist_web(owner_id, playlist_id, access_hash, up_to: up_to)
-      else
-        playlist_json(owner_id, playlist_id, access_hash, up_to: up_to)
-      end
-    end
-
-    ##
-    # Get user or group audios.
-    # Specify either +url+ or +owner_id+.
-    # @note since updating URLs can take a lot of time in this case, you have to
-    #   do it manually with {Client#update_urls}.
-    # @param url [String, nil]
-    # @param owner_id [Integer, nil] numerical ID of owner.
-    # @param up_to [Integer] maximum amount of audios to load.
-    #   If 0, no audios would be loaded (Just information about playlist).
-    #   If less than 0, will load whole playlist.
-    # @return [Playlist]
-    def audios(url: nil, owner_id: nil, up_to: Constants::MAXIMUM_PLAYLIST_SIZE)
-      owner_id = page_id(url) if url
-      playlist_json(owner_id, -1, nil, up_to: up_to)
-    end
-
-    ##
-    # Get audios on wall of user or group starting with given post.
-    # Specify either +url+ or +(owner_id,post_id)+.
-    # @note this method is only able to load up to 91 audios from wall.
-    # @param url [String] URL to post.
-    # @param owner_id [Integer]  numerical ID of wall owner.
-    # @param post_id [Integer] numerical ID of post.
-    # @return [Array<Audio>] array of audios from wall.
-    def wall(url: nil, owner_id: nil, post_id: nil, up_to: 91, with_url: false)
-      if url
-        owner_id = page_id(url)
-        post_id = last_post_id(owner_id: owner_id)
-      end
-      wall_json(owner_id, post_id, up_to: up_to, with_url: with_url)
-    end
-
-    ##
-    # Get audios attached to post.
-    # Specify either +url+ or +(owner_id,post_id)+.
-    # @param url [String] URL to post.
-    # @param owner_id [Integer] numerical ID of wall owner.
-    # @param post_id [Integer] numerical ID of post.
-    # @return [Array<Audio>] array of audios attached to post. Most of audios will
-    #   already have download URLs, but there might be audios which can't be resolved.
-    def post(url: nil, owner_id: nil, post_id: nil)
-      begin
-        owner_id, post_id = url.match(Constants::Regex::VK_WALL_URL_POSTFIX).captures if url
-      rescue
-        raise Exceptions::ParseError
-      end
-
-      attached = attached_audios(owner_id: owner_id, post_id: post_id)
-      wall = wall(owner_id: owner_id, post_id: post_id, with_url: false)
-
-      no_link = attached.map do |a_empty|
-        # Here we just search for matching audios on wall
-        wall.find { |a| a.artist == a_empty.artist && a.title == a_empty.title } || a_empty
-      end
-      loaded_audios = from_id(no_link)
-
-      loaded_audios.map.with_index { |el, i| el || no_link[i] }
-    end
-
-    ##
-    # Get audios with download URLs by their IDs and secrets.
-    # @param args [Array<Audio, Array<(owner_id, audio_id, secret_1, secret_2)>, "#{owner_id}_#{id}_#{secret_1}_#{secret_2}">]
-    # @return [Array<Audio, nil>] array of: audio with download URLs or audio
-    #   without URL if wasn't able to get it for audio or +nil+ if
-    #   matching element can't be retrieved for array or string.
-    def get_urls(args)
-      args_formatted = args.map do |el|
-        case el
-        when Array
-          el.join("_")
-        when Audio
-          el.full_id
-        when String
-          el # Do not change
-        else
-          raise ArgumentError
-        end
-      end
-      args_formatted.compact.uniq # Not dealing with nil or doubled IDs
-
-      audios = []
-      begin
-        args_formatted.each_slice(10) do |subarray|
-          json = load_json_audios_by_id(subarray)
-          subresult = audios_from_data(json["data"][0].to_a)
-          audios.concat(subresult)
-        end
-      rescue
-        raise Exceptions::ParseError
-      end
-      VkMusic.debug("Loaded audios from ids: #{audios.map(&:pp).join(", ")}")
-
-      args.map do |el|
-        case el
-        when Array
-          audios.find { |audio| audio.owner_id == el[0].to_i && audio.id == el[1].to_i }
-        when Audio
-          next el if el.full_id.nil? # Audio was skipped
-          audios.find { |audio| audio.owner_id == el.owner_id && audio.id == el.id }
-        when String
-          audios.find { |audio| [audio.owner_id, audio.id] == el.split("_").first(2).map(&:to_i) }
-        else
-          nil # This shouldn't happen actually
-        end
-      end
-    end
-    alias_method :from_id, :get_urls
-
-    ##
-    # Update download URLs of audios.
-    # @param audios [Array<Audio>]
-    def update_urls(audios)
-      audios_with_urls = get_urls(audios)
-      audios.each.with_index do |a, i|
-        a_u = audios_with_urls[i]
-        a.update(from: a_u) unless a_u.nil?
-      end
-    end
-
-    ##
-    # Retrieve audios from recommendations or alike pages.
-    # Specify either +url+ or +block_id+.
-    # @param url [String] URL.
-    # @param block_id [String] ID of block.
-    # @return [Array<Audio>] array of audios attached to post. Most of audios will
-    #   already have download URLs, but there might be audios which can't be resolved.
-    def block(url: nil, block_id: nil)
-      begin
-        block_id = url.match(Constants::Regex::VK_BLOCK_URL).captures.first if url
-      rescue
-        raise Exceptions::ParseError
-      end
-
-      uri = URI(Constants::URL::VK[:audios])
-      uri.query = Utility.hash_to_params({ "act" => "block", "block" => block_id })
-      audios_from_page(uri)
-    end
-
-    ##
-    # @!endgroup
-
-    ##
-    # @!group Other
-
-    ##
-    # Get user or group ID. Sends one request if custom ID provided.
-    # @param str [String] link, ID with/without prefix or custom ID.
-    # @return [Integer] page ID.
-    def page_id(str)
-      case str
-      when Constants::Regex::VK_URL
-        path = str.match(Constants::Regex::VK_URL)[1]
-        page_id(path) # Recursive call
-      when Constants::Regex::VK_ID_STR
-        str.to_i
-      when Constants::Regex::VK_AUDIOS_URL_POSTFIX
-        str.match(/-?\d+/).to_s.to_i # Numbers with sign
-      when Constants::Regex::VK_PREFIXED_ID_STR
-        id = str.match(/\d+/).to_s.to_i # Just numbers. Sign needed
-        id *= -1 unless str.start_with?("id")
-        id
-      when Constants::Regex::VK_CUSTOM_ID
-        url = "#{Constants::URL::VK[:home]}/#{str}"
-        begin
-          page = load_page(url)
-        rescue Exceptions::RequestError
-          raise Exceptions::ParseError
-        end
-
-        raise Exceptions::ParseError unless page.at_css(".PageBlock .owner_panel")
-
-        begin
-          page.link_with(href: Constants::Regex::VK_HREF_ID_CONTAINING).href.slice(Constants::Regex::VK_ID).to_i # Numbers with sign
-        rescue
-          raise Exceptions::ParseError
-        end
-      else
-        raise Exceptions::ParseError
-      end
-    end
-
-    ##
-    # Get ID of last post.
-    # Specify either +url+ or +owner_id+.
-    # @note requesting for "vk.com/id0" will raise ArgumentError.
-    #   Use +client.last_post_id(owner_id: client.id)+ to get last post of client.
-    # @param url [String] URL to wall owner.
-    # @param owner_id [Integer] numerical ID of wall owner.
-    # @return [Integer, nil] ID of last post or +nil+ if there are no posts.
-    def last_post_id(url: nil, owner_id: nil)
-      path = if url
-        url.match(Constants::Regex::VK_URL)[1]
-      else
-        path = "#{owner_id < 0 ? "club" : "id"}#{owner_id.abs}"
-      end
-      raise ArgumentError, "Requesting this method for id0 is forbidden", caller if path == "id0"
-
-      url = "#{Constants::URL::VK[:home]}/#{path}"
-      page = load_page(url)
-
-      # Ensure this isn't some random vk page
-      raise Exceptions::ParseError unless page.at_css(".PageBlock .owner_panel")
-
-      begin
-        posts = page.css(".wall_posts > .wall_item .anchor")
-        posts_ids = posts.map do |post|
-          post ? post.attribute("name").to_s.match(Constants::Regex::VK_POST_URL_POSTFIX)[2].to_i : 0
-        end
-        # To avoid checking id of pinned post need to take maximum id.
-        return posts_ids.max
-      rescue
-        raise Exceptions::ParseError
-      end
-    end
-
-    ##
-    # Get audios attached to specified post.
-    # Specify either +url+ or +(owner_id,post_id)+.
-    # @param url [String] URL to post.
-    # @param owner_id [Integer] numerical ID of wall owner.
-    # @param post_id [Integer] numerical ID of post.
-    # @return [Array<Audio>] audios with only artist, title and duration.
-    def attached_audios(url: nil, owner_id: nil, post_id: nil)
-      begin
-        owner_id, post_id = url.match(Constants::Regex::VK_WALL_URL_POSTFIX).captures if url
-      rescue
-        raise Exceptions::ParseError
-      end
-
-      url = "#{Constants::URL::VK[:wall]}#{owner_id}_#{post_id}"
-      begin
-        page = load_page(url)
-      rescue Exceptions::RequestError
-        raise Exceptions::ParseError
-      end
-
-      raise Exceptions::ParseError unless page.css(".service_msg_error").empty?
-      begin
-        page.css(".wi_body > .pi_medias .medias_audio").map { |e| Audio.from_node(e, @id) }
-      rescue
-        raise Exceptions::ParseError
-      end
-    end
-
-    ##
-    # @!endgroup
-
-    private
-
-    ##
-    # Load page web page.
-    # @param url [String, URI]
-    # @return [Mechanize::Page]
-    def load_page(url)
-      uri = URI(url) if url.class != URI
-      VkMusic.debug("Loading #{uri}")
-      begin
-        @agent.get(uri)
-      rescue
-        raise Exceptions::RequestError
-      end
-    end
-    ##
-    # Load JSON from web page.
-    # @param url [String, URI]
-    # @return [Hash]
-    def load_json(url)
-      page = load_page(url)
-      begin
-        JSON.parse(page.body.strip)
-      rescue Exception => error
-        raise Exceptions::ParseError, error.message, caller
-      end
-    end
-    ##
-    # Load response to AJAX post request.
-    # @param url [String, URI]
-    # @return [Nokogiri::XML::Document]
-    def load_ajax(url, query = {})
-      uri = URI(url) if url.class != URI
-      query["_ajax"] = 1
-      headers = { "Content-Type" => "application/x-www-form-urlencoded", "x-requested-with" => "XMLHttpRequest" }
-      VkMusic.debug("Loading #{uri} with query #{query}")
-      begin
-        page = @agent.post(uri, query, headers)
-        str = JSON.parse(page.body.strip)["data"][2]
-        Nokogiri::XML("<body>#{CGI.unescapeElement(str)}</body>")
-      rescue
-        raise Exceptions::RequestError
-      end
-    end
-
-    ##
-    # Load playlist web page.
-    # @param owner_id [Integer]
-    # @param playlist_id [Integer]
-    # @param access_hash [String, nil]
-    # @param offset [Integer]
-    # @return [Mechanize::Page]
-    def load_page_playlist(owner_id, playlist_id, access_hash = nil, offset: 0)
-      uri = URI(Constants::URL::VK[:audios])
-      uri.query = Utility.hash_to_params({
-        act: "audio_playlist#{owner_id}_#{playlist_id}",
-        access_hash: access_hash.to_s,
-        offset: offset
-      })
-      load_page(uri)
-    end
-    ##
-    # Load JSON playlist section with +load_section+ request.
-    # @param owner_id [Integer]
-    # @param playlist_id [Integer]
-    # @param access_hash [String, nil]
-    # @param offset [Integer]
-    # @return [Hash]
-    def load_json_playlist_section(owner_id, playlist_id, access_hash = nil, offset: 0)
-      uri = URI(Constants::URL::VK[:audios])
-      uri.query = Utility.hash_to_params({
-        act: "load_section",
-        owner_id: owner_id,
-        playlist_id: playlist_id,
-        access_hash: access_hash.to_s,
-        type: "playlist",
-        offset: offset,
-        utf8: true
-      })
-      load_json(uri)
-    end
-
-    ##
-    # Load JSON audios with +reload_audio+ request.
-    # @param ids [Array<String>]
-    # @return [Hash]
-    def load_json_audios_by_id(ids)
-      uri = URI(Constants::URL::VK[:audios])
-      uri.query = Utility.hash_to_params({
-        act: "reload_audio",
-        ids: ids,
-        utf8: true
-      })
-      load_json(uri)
-    end
-    ##
-    # Load JSON audios with +load_section+ from wall.
-    # @param owner_id [Integer]
-    # @param post_id [Integer]
-    # @return [Hash]
-    def load_json_audios_wall(owner_id, post_id)
-      uri = URI(Constants::URL::VK[:audios])
-      uri.query = Utility.hash_to_params({
-        act: "load_section",
-        owner_id: owner_id,
-        post_id: post_id,
-        type: "wall",
-        wall_type: "own",
-        utf8: true
-      })
-      load_json(uri)
-    end
-
-    ##
-    # Load audios from web page.
-    # @param obj [Mechanize::Page, String, URI]
-    # @return [Array<Audio>]
-    def audios_from_page(obj)
-      page = obj.is_a?(Mechanize::Page) ? obj : load_page(obj)
-      begin
-        page.css(".audio_item.ai_has_btn").map do |elem|
-          data = JSON.parse(elem.attribute("data-audio"))
-          Audio.from_data(data, @id)
-        end
-      rescue
-        raise Exceptions::ParseError
-      end
-    end
-    ##
-    # Load audios from JSON data.
-    # @param data [Hash]
-    # @return [Array<Audio>]
-    def audios_from_data(data)
-      begin
-        data.map { |audio_data| Audio.from_data(audio_data, @id) }
-      rescue
-        raise Exceptions::ParseError
-      end
-    end
-    ##
-    # Load audios from AJAX data.
-    # @param page [Nokogiri::XML::Document]
-    # @return [Array<Audio>]
-    def audios_from_ajax(page)
-      begin
-        page.css(".audio_item.ai_has_btn").map do |elem|
-          data = JSON.parse(elem.attribute("data-audio"))
-          Audio.from_data(data, @id)
-        end
-      rescue
-        raise Exceptions::ParseError
-      end
-    end
-
-    ##
-    # Load playlist through web page requests.
-    # @param owner_id [Integer]
-    # @param playlist_id [Integer]
-    # @param access_hash [String, nil]
-    # @param up_to [Integer] if less than 0, all audios will be loaded.
-    # @return [Playlist]
-    def playlist_web(owner_id, playlist_id, access_hash = nil, up_to: -1)
-      first_page_audios, title, subtitle, real_size = playlist_first_page_web(owner_id, playlist_id, access_hash || "")
-
-      # Check whether need to make additional requests
-      up_to = real_size if (up_to < 0 || up_to > real_size)
-      list = first_page_audios.first(up_to)
-      while list.length < up_to do
-        playlist_page = load_page_playlist(owner_id, playlist_id, access_hash, offset: list.length)
-        list.concat(audios_from_page(playlist_page).first(up_to - list.length))
-      end
-
-      Playlist.new(list,
-        id: id,
-        owner_id: owner_id,
-        access_hash: access_hash,
-        title: title,
-        subtitle: subtitle,
-        real_size: real_size
-      )
-    end
-
-    ##
-    # Load playlist through JSON requests.
-    # @param owner_id [Integer]
-    # @param playlist_id [Integer]
-    # @param access_hash [String, nil]
-    # @param up_to [Integer] if less than 0, all audios will be loaded.
-    # @return [Playlist]
-    def playlist_json(owner_id, playlist_id, access_hash, up_to: -1)
-      if playlist_id == -1
-        first_audios, title, subtitle, real_size = playlist_first_page_json(owner_id, playlist_id, access_hash || "")
-      else
-        first_audios, title, subtitle, real_size = playlist_first_page_web(owner_id, playlist_id, access_hash || "")
-      end
-      # NOTE: We need to load first page from web to be able to unmask links in future
-
-      # Check whether need to make additional requests
-      up_to = real_size if (up_to < 0 || up_to > real_size)
-      list = first_audios.first(up_to)
-      while list.length < up_to do
-        json = load_json_playlist_section(owner_id, playlist_id, access_hash, offset: list.length)
-        audios = begin
-          audios_from_data(json["data"][0]["list"])
-        rescue
-          raise Exceptions::ParseError
-        end
-        list.concat(audios.first(up_to - list.length))
-      end
-
-      begin
-        Playlist.new(list,
-          id: playlist_id,
-          owner_id: owner_id,
-          access_hash: access_hash,
-          title: title,
-          subtitle: subtitle,
-          real_size: real_size
-        )
-      rescue
-        raise Exceptions::ParseError
-      end
-    end
-
-    ##
-    # Load playlist first page in web and return essential data.
-    # @note not suitable for user audios
-    # @param owner_id [Integer]
-    # @param playlist_id [Integer]
-    # @param access_hash [String, nil]
-    # @return [Array<Array, String, String, Integer>] array with audios from first page, title, subtitle and playlist real size.
-    def playlist_first_page_web(owner_id, playlist_id, access_hash)
-      first_page = load_page_playlist(owner_id, playlist_id, access_hash, offset: 0)
-      begin
-        # Parse out essential data
-        title = first_page.at_css(".audioPlaylist__title").text.strip
-        subtitle = first_page.at_css(".audioPlaylist__subtitle").text.strip
-
-        footer_node = first_page.at_css(".audioPlaylist__footer")
-        if footer_node
-          footer_text = footer_node.text.strip
-          footer_text.gsub!(/\s/, "") # Removing all whitespace to get rid of delimiters ('1 042 audios')
-          footer_match = footer_text.match(/^\d+/)
-          real_size = footer_match ? footer_match[0].to_i : 0
-        else
-          real_size = 0
-        end
-
-        first_audios = audios_from_page(first_page)
-      rescue
-        raise Exceptions::ParseError
-      end
-      [first_audios, title, subtitle, real_size]
-    end
-
-    ##
-    # Load playlist first page in JSON and return essential data.
-    # @param owner_id [Integer]
-    # @param playlist_id [Integer]
-    # @param access_hash [String, nil]
-    # @return [Array<Array, String, String, Integer>] array with audios from first page, title, subtitle and playlist real size.
-    def playlist_first_page_json(owner_id, playlist_id, access_hash)
-      first_json = load_json_playlist_section(owner_id, playlist_id, access_hash, offset: 0)
-      begin
-        first_data = first_json["data"][0]
-        first_data_audios = audios_from_data(first_data["list"])
-      rescue
-        raise Exceptions::ParseError
-      end
-
-      real_size = first_data["totalCount"]
-      title = CGI.unescapeHTML(first_data["title"].to_s)
-      subtitle = CGI.unescapeHTML(first_data["subtitle"].to_s)
-
-      [first_data_audios, title, subtitle, real_size]
-    end
-
-    ##
-    # Found playlist URLs on *global* search page.
-    # @param obj [Mechanize::Page, String, URI]
-    # @return [Array<String>]
-    def playlist_urls_from_page(obj)
-      page = obj.is_a?(Mechanize::Page) ? obj : load_page(obj)
-      begin
-        page.css(".AudioBlock_music_playlists .AudioPlaylistSlider .al_playlist").map { |elem| elem.attribute("href").to_s }
-      rescue
-        raise Exceptions::ParseError
-      end
-    end
-
-    ##
-    # Load audios from wall using JSON request.
-    # @param owner_id [Integer]
-    # @param post_id [Intger]
-    # @param up_to [Integer]
-    # @param with_url [Boolean] whether to retrieve URLs with {Client#from_id} method
-    # @return [Array<Audio>]
-    def wall_json(owner_id, post_id, up_to: 91, with_url: false)
-      if up_to < 0 || up_to > 91
-        up_to = 91
-        VkMusic.warn("Current implementation of this method is not able to return more than 91 audios from wall.")
-      end
-
-      json = load_json_audios_wall(owner_id, post_id)
-      begin
-        data = json["data"][0]
-        audios = audios_from_data(data["list"]).first(up_to)
-      rescue
-        raise Exceptions::ParseError
-      end
-      with_url ? from_id(audios) : audios
-    end
-
-    ##
-    # Login to VK.
-    def login(username, password)
-      VkMusic.debug("Logging in.")
-      # Loading login page
-      homepage = load_page(Constants::URL::VK[:login])
-      # Submitting login form
-      login_form = homepage.forms.find { |form| form.action.start_with?(Constants::URL::VK[:login_action]) }
-      login_form[Constants::VK_LOGIN_FORM_NAMES[:username]] = username.to_s
-      login_form[Constants::VK_LOGIN_FORM_NAMES[:password]] = password.to_s
-      after_login = @agent.submit(login_form)
-
-      # Checking whether logged in
-      raise Exceptions::LoginError, "Unable to login. Redirected to #{after_login.uri.to_s}", caller unless after_login.uri.to_s == Constants::URL::VK[:feed]
-
-      # Parsing information about this profile
-      profile = load_page(Constants::URL::VK[:profile])
-      @name = profile.title.to_s
-      @id = profile.link_with(href: Constants::Regex::VK_HREF_ID_CONTAINING).href.slice(/\d+/).to_i
-    end
-
-    # Shortcut
-    def unmask_link(link)
-      VkMusic::LinkDecoder.unmask_link(link, @id)
-    end
-  end
-end
+# frozen_string_literal: true
+
+module VkMusic
+  # VK client
+  class Client
+    # Default user agent to use
+    DEFAULT_USERAGENT = 'Mozilla/5.0 (Linux; Android 5.0; SM-G900P Build/LRX21T) ' \
+                        'AppleWebKit/537.36 (KHTML, like Gecko) ' \
+                        'Chrome/86.0.4240.111 Mobile Safari/537.36'
+    public_constant :DEFAULT_USERAGENT
+    # Mximum size of VK playlist
+    MAXIMUM_PLAYLIST_SIZE = 10_000
+    public_constant :MAXIMUM_PLAYLIST_SIZE
+
+    # @return [Integer] ID of client
+    attr_reader :id
+    # @return [String] name of client
+    attr_reader :name
+    # @return [Mechanize] client used to access web pages
+    attr_reader :agent
+
+    # @param login [String, nil]
+    # @param password [String, nil]
+    # @param user_agent [String]
+    # @param agent [Mechanize?] if specified, provided agent will be used
+    def initialize(login: nil, password: nil, user_agent: DEFAULT_USERAGENT, agent: nil)
+      @login = login
+      @password = password
+      @agent = agent
+      if @agent.nil?
+        @agent = Mechanize.new
+        @agent.user_agent = user_agent
+
+        raise('Failed to login!') unless self.login
+      end
+
+      load_id_and_name
+      VkMusic.log.info("Client#{@id}") { "Logged in as User##{@id} (#{@name})" }
+    end
+
+    # Make a login request
+    # @return [Boolean] whether login was successful
+    def login
+      VkMusic.log.info("Client#{@id}") { 'Logging in...' }
+      login = Request::Login.new
+      login.call(agent)
+      login.send_form(@login, @password, agent)
+      return true if login.success?
+
+      VkMusic.log.warn("Client#{@id}") { "Login failed. Redirected to #{login.response.uri}" }
+      false
+    end
+
+    # Search for audio or playlist
+    #
+    # Possible values of +type+ option:
+    # * +:audio+ - search for audios
+    # * +:playlist+ - search for playlists
+    # @note some audios and playlists might be removed from search
+    # @todo search in group audios
+    # @param query [String]
+    # @param type [Symbol]
+    # @return [Array<Audio>, Array<Playlist>]
+    def find(query = '', type: :audio)
+      return [] if query.empty?
+
+      page = Request::Search.new(query, id)
+      page.call(agent)
+
+      case type
+      when :audio, :audios then page.audios
+      when :playlist, :playlists then page.playlists
+      else []
+      end
+    end
+    alias search find
+
+    # Get VK playlist. Specify either +url+ or +(owner_id,playlist_id,access_hash)+
+    # @param url [String, nil]
+    # @param owner_id [Integer, nil]
+    # @param playlist_id [Integer, nil]
+    # @param access_hash [String, nil] access hash for the playlist. Might not exist
+    # @param up_to [Integer] maximum amount of audios to load. If 0, no audios
+    #   would be loaded (plain information about playlist)
+    # @return [Playlist?]
+    def playlist(url: nil, owner_id: nil, playlist_id: nil, access_hash: nil,
+                 up_to: MAXIMUM_PLAYLIST_SIZE)
+      owner_id, playlist_id, access_hash = Utility::PlaylistUrlParser.call(url) if url
+      return if owner_id.nil? || playlist_id.nil?
+
+      Utility::PlaylistLoader.call(agent, id, owner_id, playlist_id, access_hash, up_to)
+    end
+
+    # Get user or group audios. Specify either +url+ or +owner_id+
+    # @param url [String, nil]
+    # @param owner_id [Integer, nil]
+    # @param up_to [Integer] maximum amount of audios to load. If 0, no audios
+    #   would be loaded (plain information about playlist)
+    # @return [Playlist?]
+    def audios(url: nil, owner_id: nil, up_to: MAXIMUM_PLAYLIST_SIZE)
+      owner_id = Utility::ProfileIdResolver.call(agent, url) if url
+      return if owner_id.nil?
+
+      Utility::AudiosLoader.call(agent, id, owner_id, up_to)
+    end
+
+    # Get audios on wall of user or group starting. Specify either +url+ or +owner_id+
+    #   or +(owner_id,post_id)+
+    # @param url [String] URL to post or profile page
+    # @param owner_id [Integer] numerical ID of wall owner
+    # @param owner_id [Integer] ID of post to start looking from. If not specified, will be
+    #   used ID of last post
+    # @return [Playlist?]
+    def wall(url: nil, owner_id: nil, post_id: nil)
+      owner_id, post_id = Utility::PostUrlParser.call(url) if url
+      if post_id.nil?
+        if url
+          owner_id, post_id = Utility::LastProfilePostLoader.call(agent, url: url)
+        elsif owner_id
+          owner_id, post_id = Utility::LastProfilePostLoader.call(agent, owner_id: owner_id)
+        end
+      end
+      return if owner_id.nil? || post_id.nil?
+
+      Utility::WallLoader.call(agent, id, owner_id, post_id)
+    end
+
+    # Get audios attached to post. Specify either +url+ or +(owner_id,post_id)+
+    # @param url [String]
+    # @param owner_id [Integer]
+    # @param post_id [Integer]
+    # @return [Array<Audio>] array of audios attached to post
+    def post(url: nil, owner_id: nil, post_id: nil)
+      owner_id, post_id = Utility::PostUrlParser.call(url) if url
+
+      return [] if owner_id.nil? || post_id.nil?
+
+      Utility::PostLoader.call(agent, id, owner_id, post_id)
+    end
+
+    # Artist top audios. Specify either +url+ or +name+ of the artist
+    # @param url [String]
+    # @param name [String]
+    # @return [Array<Audio>] array of audios attached to post
+    def artist(url: nil, name: nil)
+      name = Utility::ArtistUrlParser.call(url) if url
+
+      return [] if name.nil? || name.empty?
+
+      Utility::ArtistLoader.call(agent, id, name)
+    end
+
+    # Get audios with download URLs by their IDs and secrets
+    # @param args [Array<Audio, (owner_id, audio_id, secret_1, secret_2),
+    #   "#{owner_id}_#{id}_#{secret_1}_#{secret_2}">]
+    # @return [Array<Audio, nil>] array of: audio with download URLs or audio
+    #   without URL if wasn't able to get it for audio or +nil+ if
+    #   matching element can't be retrieved for array or string
+    def get_urls(args)
+      ids = Utility::AudiosIdsGetter.call(args)
+      audios = Utility::AudiosFromIdsLoader.call(agent, ids, id)
+
+      args.map do |el|
+        # NOTE: can not load unaccessable audio, so just returning it
+        next el if el.is_a?(Audio) && !el.url_accessable?
+
+        audios.find { |a| a.id_matches?(el) }
+      end
+    end
+    alias from_id get_urls
+
+    # Update download URLs of provided audios
+    # @param audios [Array<Audio>]
+    def update_urls(audios)
+      with_url = get_urls(audios)
+      audios.each.with_index do |audio, i|
+        audio_with_url = with_url[i]
+        audio.update(audio_with_url) if audio_with_url
+      end
+      audios
+    end
+
+    private
+
+    def load_id_and_name
+      VkMusic.log.info("Client#{@id}") { 'Loading user id and name' }
+      my_page = Request::MyPage.new
+      my_page.call(agent)
+      @id = my_page.id
+      @name = my_page.name
+    end
+  end
+end