vk_music 3.1.6 → 4.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6142de69f08e3ca82697048c3062fc42eea675370f64e678433f8587edc4011e
-  data.tar.gz: 8321b28592040daf8af1880c0fb15a1969ba33017cdd9a2919063c43f446ce9e
+  metadata.gz: 067f26c1a3f2e46794a61c4a62fae7dd40f190e70e91b7331c4891f83cf3bd9f
+  data.tar.gz: 2942d5b5999a65a8fd29b8eebc2e632b44c944d204984d0d85df4a3fdf74c437
 SHA512:
-  metadata.gz: 21d19b28d4141f33ae545a5216ec6ee192df00de769b9f8cb2f9b856a997662d8bd31560f1846dac7370b142d8182baa0789d3dfa2599afc7d8bf8408f142ea5
-  data.tar.gz: e431fd771443125940ef2bb3fc611b63d3f9c7d3818caf0712af3103331f6d0643c02b3bdf5aacba61852447e10ef854cfeeb9b47a3a63278a9349585094f751
+  metadata.gz: 512889a498b3d0aa5c3413e24596b660d312acddb450052f8d1d44315c1e84d89749fbdb9d225b2e21555eb83efbca6d77922c0227a287154dee78991786250f
+  data.tar.gz: e3bf4628feccd1120a9afaedfebe3a5d9d9b9f6965b13dd3bcec58526bbcf2fdcd943577e33b2b398227f7c48fd60577ecf81686b42283540e0ef6308df26132

data/.env.example

@@ -0,0 +1,3 @@
+# VkMusic spcification loads ENV variables from .env files
+VK_LOGIN=+79991234567
+VK_PASSWORD=password

data/.github/workflows/ruby.yml

@@ -0,0 +1,35 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Ruby
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
+    # change this to (see https://github.com/ruby/setup-ruby#versioning):
+    # uses: ruby/setup-ruby@v1
+      uses: ruby/setup-ruby@v1.52.0
+      with:
+        ruby-version: 2.7.2
+    - name: Install dependencies
+      run: bundle install
+    - name: Run rubocop
+      run: bundle exec rake rubocop
+    - name: Run yarddoc
+      run: bundle exec rake yard

data/.gitignore

@@ -1,8 +1,14 @@
+/.env
+/.byebug_history
 /.bundle/
+/.legacy/
 /.yardoc
 /_yardoc/
 /coverage/
 /doc/
 /pkg/
 /spec/reports/
+/spec/.cookies
+/spec/cassetes/*
+!/spec/cassetes/README.md
 /tmp/

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,56 @@
+# The behavior of RuboCop can be controlled via the .rubocop.yml
+# configuration file. It makes it possible to enable/disable
+# certain cops (checks) and to alter their behavior if they accept
+# any parameters. The file can be placed either in your home
+# directory or in some project directory.
+#
+# RuboCop will start looking for the configuration file in the directory
+# where the inspected file is and continue its way up to the root directory.
+#
+# See https://docs.rubocop.org/rubocop/configuration
+
+AllCops:
+  TargetRubyVersion: 2.7
+  EnabledByDefault: true
+
+Layout/FirstMethodParameterLineBreak:
+  Enabled: false
+Layout/FirstMethodArgumentLineBreak:
+  Enabled: false
+Layout/MultilineMethodArgumentLineBreaks:
+  Enabled: false
+Layout/EndOfLine:
+  Enabled: false
+Layout/EndAlignment:
+  EnforcedStyleAlignWith: variable
+Layout/FirstHashElementIndentation:
+  Enabled: false
+Layout/MultilineAssignmentLayout:
+  EnforcedStyle: same_line
+Layout/CaseIndentation:
+  EnforcedStyle: end
+Lint/ConstantResolution:
+  Enabled: false
+Metrics/ParameterLists:
+  Enabled: false
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*_spec.rb'
+Style/MethodCallWithArgsParentheses:
+  Enabled: false
+Style/Copyright:
+  Enabled: false
+Style/ClassVars:
+  Enabled: false
+Style/MissingElse:
+  Enabled: false
+Style/StringHashKeys:
+  Enabled: false
+Style/ImplicitRuntimeError:
+  Enabled: false
+Style/NumericLiterals:
+  Enabled: false
+Style/DisableCopsWithinSourceCodeDirective:
+  Enabled: false
+Layout/MultilineHashKeyLineBreaks:
+  Enabled: false

data/Gemfile

@@ -1,10 +1,38 @@
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in vk_music.gemspec
-gemspec
-
-gem "logger", "~> 1.4"
-
-gem "mechanize", "~> 2.7"
-
-gem "pry", "~> 0.12.2"
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in vk_music.gemspec
+gemspec
+
+group :test, :development do
+  # Debugging console
+  gem 'pry'
+
+  # Another debugging console
+  gem 'byebug'
+
+  # The thing, forcing you to write good code
+  gem 'rubocop', require: false
+
+  # Rake tasks
+  gem 'rake', require: false
+
+  # Testing
+  gem 'rspec', require: false
+
+  # Docs
+  gem 'yard', require: false
+
+  # .env support
+  gem 'dotenv'
+
+  # Save web requests for fast and reliable testing
+  gem 'vcr'
+
+  # Stub web requests
+  gem 'webmock'
+
+  # Test coverage
+  gem 'simplecov', require: false, group: :test
+end

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    vk_music (3.1.5)
+    vk_music (4.0.3)
       execjs (~> 2.7)
-      json (~> 2.0)
+      json (~> 2.3)
       logger (~> 1.4)
       mechanize (~> 2.7)
       net-http-persistent (= 2.9.4)
@@ -11,14 +11,23 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    ast (2.4.1)
+    byebug (11.1.3)
     coderay (1.1.3)
+    crack (0.4.4)
+    diff-lcs (1.4.4)
+    docile (1.3.2)
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
+    dotenv (2.7.6)
     execjs (2.7.0)
+    hashdiff (1.0.1)
     http-cookie (1.0.3)
       domain_name (~> 0.5)
-    json (2.3.1)
-    logger (1.4.2)
+    json (2.5.1)
+    logger (1.4.3)
     mechanize (2.7.6)
       domain_name (~> 0.5, >= 0.5.1)
       http-cookie (~> 1.0)
@@ -28,43 +37,85 @@ GEM
       nokogiri (~> 1.6)
       ntlm-http (~> 0.1, >= 0.1.1)
       webrobots (>= 0.0.9, < 0.2)
-    method_source (0.9.2)
+    method_source (1.0.0)
     mime-types (3.3.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2020.0512)
+    mime-types-data (3.2020.1104)
     mini_portile2 (2.4.0)
-    minitest (5.14.1)
     net-http-digest_auth (1.4.1)
     net-http-persistent (2.9.4)
     nokogiri (1.10.10)
       mini_portile2 (~> 2.4.0)
-    nokogiri (1.10.10-x64-mingw32)
-      mini_portile2 (~> 2.4.0)
     ntlm-http (0.1.1)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
+    parallel (1.20.1)
+    parser (2.7.2.0)
+      ast (~> 2.4.1)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (4.0.6)
+    rainbow (3.0.0)
     rake (13.0.1)
+    regexp_parser (2.0.0)
+    rexml (3.2.4)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.0)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.0)
+    rubocop (1.6.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.1.5)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.2.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.3.0)
+      parser (>= 2.7.1.5)
+    ruby-progressbar (1.10.1)
+    simplecov (0.20.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.2)
     unf (0.1.4)
       unf_ext
     unf_ext (0.0.7.7)
-    unf_ext (0.0.7.7-x64-mingw32)
+    unicode-display_width (1.7.0)
+    vcr (6.0.0)
+    webmock (3.10.0)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
     webrobots (0.1.2)
     yard (0.9.25)
 
 PLATFORMS
   ruby
-  x64-mingw32
 
 DEPENDENCIES
-  bundler (~> 2.0)
-  logger (~> 1.4)
-  mechanize (~> 2.7)
-  minitest (~> 5.0)
-  pry (~> 0.12.2)
-  rake (~> 13.0)
+  byebug
+  dotenv
+  pry
+  rake
+  rspec
+  rubocop
+  simplecov
+  vcr
   vk_music!
-  yard (~> 0.9)
+  webmock
+  yard
 
 BUNDLED WITH
    2.1.4

data/README.md

@@ -1,94 +1,113 @@
-# VkMusic
-
-*vk_music* gem is a library to work with audios on popular Russian social network [vk.com](https://www.vk.com "vk.com"). VK disabled their public API for audios, so it is now necessary to use parsers instead.
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'vk_music'
-```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install vk_music
-
-## Usage
-
-You can take a look on documentation [here](https://www.rubydoc.info/gems/vk_music/).
-
-### Logging in
-Firstly, it is required to create new *VkMusic::Client* and provide login credentials:
-
-```ruby
-client = VkMusic::Client.new(username: "+71234567890", password: "password")
-```
-
-### Searching for audios
-You can search audios by name with following method:
-
-```ruby
-audios = client.find("Acid Spit - Mega Drive")
-puts audios[0]     # Basic information about audio
-puts audios[0].url # URL to access audio. Notice that it is only accessible from your IP
-```
-
-### Parsing playlists
-You can load all the audios from playlist using following method:
-
-```ruby
-playlist = client.playlist(url: "https://vk.com/audio?z=audio_playlist-37661843_1/0e420c32c8b69e6637")
-last_audios = playlist.first(10) # => Array<Audio>
-client.update_urls(last_audios) # We have to manually retrieve URLs for playlists
-urls = last_audios.map(&:url) # URLs for every audio
-```
-
-### User or group audios
-You can load audios from user or group page. Those audios will be returned as playlist. To do it simply pass user or group id:
-
-```ruby
-playlist = client.audios(owner_id: 8024985)
-last_audios = playlist.first(10) # => Array<Audio>
-client.update_urls(last_audios) # We have to manually retrieve URLs for playlists
-urls = last_audios.map(&:url) # URLs for every audio
-```
-You can set how many audios you actually need as well:
-
-```ruby
-user_playlist = client.audios(url: "vk.com/id8024985", up_to: 10)
-```
-
-### Audios from post
-You can load up to 10 audios attached to some post. Those audios will be returned as array:
-
-```ruby
-audios = client.post(url: "https://vk.com/wall-4790861_5453")
-urls = audios.map(&:url) # URLs for every audio
-```
-
-### Recommended audios and etc
-You can load audios from recommended sections, novices and VK charts:
-
-```ruby
-audios = client.block(url: "https://m.vk.com/audio?act=block&block=PUlQVA8GR0R3W0tMF2teRGpJUVQPGVpfdF1YRwMGXUpkXktMF2tYUWRHS0IXDlpKZFpcVA8FFg")
-```
-
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/fizvlad/vk-music-rb/issues.
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+![Gem](https://img.shields.io/gem/v/vk_music) ![GitHub Workflow Status](https://img.shields.io/github/workflow/status/fizvlad/vk-music-rb/Ruby) ![Lines of code](https://img.shields.io/tokei/lines/github/fizvlad/vk-music-rb) ![Gem](https://img.shields.io/gem/dtv/vk_music)
+
+# VkMusic
+
+*vk_music* gem is a library to work with audios on popular Russian social network
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'vk_music'
+```
+
+And then execute:
+```
+$ bundle
+```
+
+Or install it using `gem`:
+
+```
+$ gem install vk_music
+```
+
+## Usage
+
+You can take a look on documentation at [rubydoc](https://www.rubydoc.info/gems/vk_music/).
+
+### Logging in
+
+Firstly, it is required to create new `VkMusic::Client` instance and provide login credentials:
+
+```ruby
+client = VkMusic::Client.new(username: "+79991234567", password: "password")
+```
+
+### Search
+
+You can search audios using `Client#find`:
+
+```ruby
+audios = client.find("Acid Spit - Mega Drive")
+```
+
+You can also search for playlists using same method:
+
+```ruby
+playlists = client.find("Jazz", type: :playlist)
+```
+
+### Playlists
+
+You can load playlist audios with `Client#playlist`
+
+```ruby
+playlist = client.playlist(url: "link")
+```
+
+### User or group audios
+
+You can load profile audios with `Client#audios`
+
+```ruby
+playlist = client.audios(owner_id: 8024985)
+```
+
+### Wall audios
+
+You can load audios from profile wall with `Client#wall`
+
+```ruby
+playlist = client.wall(owner_id: 8024985)
+```
+
+### Audios from post
+
+You can load up to 10 audios attached to some post. Those audios will be returned as array:
+
+```ruby
+audios = client.post(url: "link")
+```
+
+### Getting audio URL
+
+To get audio URL you should go through following chain:
+1. Get audio ID
+2. Get audio encrypted URL
+3. Get audio decrypted URL
+
+Usually most of audios already go with ID. Getting encrypted URL requires additional request to web, so it is performed with `Client#update_urls`, which will mutate provided array of audios:
+
+```ruby
+client.update_urls(audios_array)
+```
+
+After this you can get decrypted URL using `Audio#url`
+
+## Development
+
+Feel free to add features. However, please make sure all your code is covered with tests.
+
+### Testing
+
+This gem uses `rspec` and `vcr` for easy testing. *Be careful*, though, running `rspec` in clean repo may result in lot of requests to web and rate limiting or ban
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/fizvlad/vk-music-rb/issues.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).