ehbrs_ruby_utils 0.9.0 → 0.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0f0bf8ac8c8902aea1601e17b525b178db51cce6fbea9f205a64afb0b4f75c4d
-  data.tar.gz: 64f23644c1f126638f5cde4ddb8adce6df449fb0cb5e6e148fc67ca1678e9cfe
+  metadata.gz: b04c8994ff027248ae7a38e28ac25b0b6e895b78c01fbf60ef61eebfe520efd1
+  data.tar.gz: af8ada82641ddd7f247d2d0182d71a1a8a5b0e9bd6931dd3cc136ffa0e058140
 SHA512:
-  metadata.gz: 37fabbe2868285dc7c616dd9682c0c129b8d107985f66e9b59abd88fbdfed81d463b55b2daa388ca65f142e0eb29beee8598a0cfa24d278624f802253d6edaa3
-  data.tar.gz: e1cdb672ff5affda1cfc7e55b546dda9f79c64d61cee0ccc1a0c9df16c10e6090c8d6bf058acf7354db122c3e00083377a04d904e3062b03b5bfee90fd2952be
+  metadata.gz: b0448fc34d7c469378b4ec8e2251c20c1ba63a8fd6461cab3dfa2520a08d8e76574eb4d19d50cd876d691ee2a4e9b8af45bc09baa5d76132985ac3552e06f3b3
+  data.tar.gz: f4b0758f258963daf7e48a171fecd3774d141c351acb0bbc5d571d732f97255c9628b2852bcfcb3d95cd472d58d29465bf7cb959ac439bc2ebb86c1d9610f92a

data/lib/ehbrs_ruby_utils/core_ext.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_templates/patches'
+require 'ehbrs_ruby_utils/patches'

data/lib/ehbrs_ruby_utils/fs/compressed_package.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'eac_fs/file_info'
+require 'eac_ruby_utils/core_ext'
+
+module EhbrsRubyUtils
+  module Fs
+    class CompressedPackage < ::EacFs::FileInfo
+      MIME_TYPES = {
+        'application/zip' => :zip,
+        'application/x-7z-compressed' => :sevenzip,
+        'application/x-rar' => :rar,
+        'application/x-tar' => :tar
+      }.freeze
+
+      def extract_to(target)
+        target = target.to_pathname
+        target.mkpath
+        sub_extract_to(target)
+      end
+
+      private
+
+      def sub_extract_to(target)
+        MIME_TYPES[content_type.mime_type].if_present do |v|
+          return send("#{v}_extract_command", target).execute!
+        end
+        raise "Unknown how to extract \"#{path}\" (#{content_type})"
+      end
+
+      def sevenzip_extract_command(target_dir)
+        ::Ehbrs::Executables.sevenzip.command('x', path, '-o', target_dir)
+      end
+
+      def tar_extract_command(target_dir)
+        ::Ehbrs::Executables.tar.command('-xf', path, '-C', target_dir)
+      end
+
+      def rar_extract_command(target_dir)
+        ::Ehbrs::Executables.rar.command('x', path.expand_path).chdir(target_dir)
+      end
+
+      def zip_extract_command(target_dir)
+        ::Ehbrs::Executables.unzip.command(path, '-d', target_dir)
+      end
+    end
+  end
+end

data/lib/ehbrs_ruby_utils/fs/selected/build.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'ehbrs_ruby_utils/fs/selected/build_file'
+
+module EhbrsRubyUtils
+  module Fs
+    class Selected
+      class Build
+        DEFAULT_TARGET_BASENAME_PROC = ::Proc.new { |path| path.basename.to_path }
+
+        attr_reader :selected, :target_dir, :target_basename_proc
+
+        def initialize(selected, target_dir, &target_basename_proc)
+          @selected = selected
+          @target_dir = target_dir.to_pathname
+          @target_basename_proc = target_basename_proc.presence || DEFAULT_TARGET_BASENAME_PROC
+        end
+
+        def perform
+          clear_target_dir
+          link_selected_found
+        end
+
+        private
+
+        def clear_target_dir
+          target_dir.children.each do |c|
+            c.unlink if c.symlink? && c.directory?
+          end
+        end
+
+        def link_selected_found
+          selected.found.each do |found|
+            ::EhbrsRubyUtils::Fs::Selected::BuildFile.new(self, found).perform
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ehbrs_ruby_utils/fs/selected/build_file.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EhbrsRubyUtils
+  module Fs
+    class Selected
+      class BuildFile
+        common_constructor :build, :path do
+          self.path = path.to_pathname
+        end
+
+        def perform
+          target_path.make_symlink(path)
+        end
+
+        def target_path
+          build.target_dir.join(target_basename)
+        end
+
+        def target_basename
+          build.target_basename_proc.call(path)
+        end
+      end
+    end
+  end
+end

data/lib/ehbrs_ruby_utils/fs/selected.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EhbrsRubyUtils
+  module Fs
+    class Selected
+      require_sub __FILE__
+      DEFAULT_FILENAME = '.selected'
+
+      enable_listable
+      enable_simple_cache
+      lists.add_symbol :option, :filename, :target_name_builder
+      common_constructor :root_path, :options, default: [{}] do
+        self.root_path = root_path.to_pathname
+        self.options = self.class.lists.option.hash_keys_validate!(options)
+      end
+
+      def build(target_dir, &directory_target_basename)
+        ::EhbrsRubyUtils::Fs::Selected::Build.new(self, target_dir, &directory_target_basename)
+      end
+
+      def filename
+        options[OPTION_FILENAME].if_present(DEFAULT_FILENAME)
+      end
+
+      private
+
+      # @return [Pathname]
+      def found_uncached
+        root_path.glob("**/#{filename}").map(&:parent).sort
+      end
+    end
+  end
+end

data/lib/ehbrs_ruby_utils/fs.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EhbrsRubyUtils
+  # Filesystem utilities.
+  module Fs
+    require_sub __FILE__
+  end
+end

data/lib/ehbrs_ruby_utils/music/lyrics_book/album.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'ehbrs_ruby_utils/core_ext'
+require 'ehbrs_ruby_utils/music/lyrics_book/resource'
+
+module EhbrsRubyUtils
+  module Music
+    class LyricsBook
+      class Album < ::EhbrsRubyUtils::Music::LyricsBook::Resource
+        enable_simple_cache
+
+        def book
+          parent
+        end
+
+        def first_previous
+          previous.if_present { |v| v.songs.last }
+        end
+
+        def valid?
+          songs.any?
+        end
+
+        def header_title
+          "#{songs.first.number}-#{songs.last.number} | #{artist} | #{title}"
+        end
+
+        def artist
+          songs.lazy.map { |v| v.tag.artist }.find(&:present?)
+        end
+
+        def title
+          songs.lazy.map { |v| v.tag.album }.find(&:present?)
+        end
+
+        def songs_uncached
+          ::EhbrsRubyUtils::Music::LyricsBook::Song.create_list(self, path.children)
+        end
+      end
+    end
+  end
+end

data/lib/ehbrs_ruby_utils/music/lyrics_book/resource.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require 'ehbrs_ruby_utils/core_ext'
+
+module EhbrsRubyUtils
+  module Music
+    class LyricsBook
+      class Resource
+        class << self
+          def create_list(parent, files)
+            r = files.sort.map { |path| new(parent, path) }.select(&:valid?)
+            previous = parent.first_previous
+            r.map do |e|
+              e.reset_cache
+              e.previous = previous
+              previous = e
+            end
+          end
+        end
+
+        enable_simple_cache
+        include ::Comparable
+        common_constructor :parent, :path
+        attr_accessor :previous
+
+        def filename
+          path.relative_path_from(parent.path)
+        end
+
+        def <=>(other)
+          path <=> other.path
+        end
+
+        def link_to_header
+          "<a href=\"\##{header_id}\" id=\"#{index_id}\">#{header_title}</a>"
+        end
+
+        def index_id
+          "index_#{header_id}"
+        end
+
+        def header_id
+          header_title.variableize
+        end
+
+        def header_index
+          parent.header_index + 1
+        end
+
+        def output_main
+          ::EhbrsRubyUtils::Music::LyricsBook::Resource.erb_template('main.html.erb', binding)
+        end
+
+        def output_index
+          erb_template('index.html.erb')
+        end
+
+        def type
+          self.class.name.demodulize.underscore
+        end
+      end
+    end
+  end
+end

data/lib/ehbrs_ruby_utils/music/lyrics_book/song.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'ehbrs_ruby_utils/core_ext'
+require 'ehbrs_ruby_utils/music/lyrics_book/resource'
+
+module EhbrsRubyUtils
+  module Music
+    class LyricsBook
+      class Song < ::EhbrsRubyUtils::Music::LyricsBook::Resource
+        enable_simple_cache
+        delegate :book, to: :album
+        delegate :provider, to: :book
+        delegate :tag, :to_s, to: :container
+
+        def album
+          parent
+        end
+
+        def lyrics
+          fetch_lyrics unless lyrics_cached?
+          cached_lyrics
+        end
+
+        def valid?
+          tag.present?
+        end
+
+        def lyrics_cached?
+          lyrics_cache.cached?
+        end
+
+        def cached_lyrics
+          ::YAML.load_file(lyrics_cache.content_path)
+        end
+
+        def header_title
+          "#{number} - #{title}"
+        end
+
+        delegate :title, to: :tag
+
+        private
+
+        def container_uncached
+          ::EhbrsRubyUtils::Videos::Container.new(path)
+        end
+
+        def fetch_lyrics
+          lyrics = fetched_lyrics
+          lyrics_cache.write(lyrics.to_yaml)
+        end
+
+        def fetched_lyrics
+          container.lyrics_by_provider(provider)
+        end
+
+        def lyrics_cache
+          (%w[artist album title].map { |k| tag.send(k) } + [provider.identifier])
+            .inject(fs_cache) { |a, e| a.child(e) }
+        end
+
+        def number_uncached
+          previous.if_present(0, &:number) + 1
+        end
+      end
+    end
+  end
+end

data/lib/ehbrs_ruby_utils/music/lyrics_book.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require 'ehbrs_ruby_utils/core_ext'
+
+module EhbrsRubyUtils
+  module Music
+    class LyricsBook
+      require_sub __FILE__
+
+      DEFAULT_PROVIDER_NAME = 'lyrics.com'
+      DEFAULT_TITLE = 'Letras de músicas'
+
+      enable_listable
+      lists.add_symbol :option, :provider_name, :title
+      enable_simple_cache
+      common_constructor :source_dir, :options, default: [{}] do
+        self.source_dir = source_dir.to_pathname
+        self.options = self.class.lists.option.hash_keys_validate!(options)
+      end
+
+      def first_previous
+        nil
+      end
+
+      def header_index
+        1
+      end
+
+      def output
+        erb_template('main.html.erb')
+      end
+
+      def path
+        source_dir
+      end
+
+      def title
+        options[OPTION_TITLE].if_present(DEFAULT_TITLE)
+      end
+
+      private
+
+      def albums_directories_uncached
+        r = []
+        t = ::EacRubyUtils::Fs::Traverser.new
+        t.recursive = true
+        t.check_directory = ->(directory) { r << directory }
+        t.check_path(source_dir)
+        r
+      end
+
+      def albums_uncached
+        ::EhbrsRubyUtils::Music::LyricsBook::Album.create_list(self, albums_directories)
+      end
+
+      def provider_uncached
+        ::UltimateLyrics::Provider.by_name(provider_name)
+      end
+
+      def provider_name
+        options[OPTION_PROVIDER_NAME].if_present(DEFAULT_PROVIDER_NAME)
+      end
+    end
+  end
+end

data/lib/ehbrs_ruby_utils/music.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EhbrsRubyUtils
+  module Music
+    require_sub __FILE__
+  end
+end

data/lib/ehbrs_ruby_utils/patches/object.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/require_sub'
+::EacRubyUtils.require_sub __FILE__

data/lib/ehbrs_ruby_utils/patches.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/require_sub'
+::EacRubyUtils.require_sub __FILE__

data/lib/ehbrs_ruby_utils/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EhbrsRubyUtils
-  VERSION = '0.9.0'
+  VERSION = '0.12.1'
 end

data/lib/ehbrs_ruby_utils/videos/container.rb

@@ -4,23 +4,49 @@ require 'eac_ruby_utils/core_ext'
 require 'ehbrs_ruby_utils/executables'
 require 'ehbrs_ruby_utils/videos/stream'
 require 'json'
+require 'taglib'
+require 'ultimate_lyrics/provider_search'
+require 'ultimate_lyrics/song_metadata'
 
 module EhbrsRubyUtils
   module Videos
     class Container
+      class << self
+        def from_file(path)
+          new(path)
+        end
+      end
+
       enable_simple_cache
       common_constructor :path do
         self.path = path.to_pathname
       end
 
+      delegate :tag, to: :tag_file
+      delegate :to_s, to: :path
+
       ::EhbrsRubyUtils::Videos::Stream.lists.codec_type.each_value do |stream_type|
         define_method stream_type.to_s.pluralize do
           streams.select { |stream| stream.codec_type == stream_type }
         end
       end
 
+      # @param provider [UltimateLyrics::Provider]
+      # @return [UltimateLyrics::Lyrics]
+      def lyrics_by_provider(provider)
+        ::UltimateLyrics::ProviderSearch.new(provider, song_metadata).lyrics
+      end
+
       private
 
+      # @return [UltimateLyrics::SongMetadata]
+      def song_metadata_uncached
+        ::UltimateLyrics::SongMetadata.new(
+          ::UltimateLyrics::SongMetadata::Field.lists.sources.values
+          .map { |source| [source, tag.send(source)] }.to_h
+        )
+      end
+
       def probe_data_uncached
         ::JSON.parse(
           ::EhbrsRubyUtils::Executables.ffprobe.command(
@@ -34,6 +60,11 @@ module EhbrsRubyUtils
           ::EhbrsRubyUtils::Videos::Stream.new(stream_ffprobe_data)
         end
       end
+
+      # @return [TagLib::FileRef]
+      def tag_file_uncached
+        ::TagLib::FileRef.new(path.to_path)
+      end
     end
   end
 end

data/template/ehbrs_ruby_utils/music/lyrics_book/album/inner.html.erb

@@ -0,0 +1,3 @@
+<% songs.each do |song| %>
+  <%= song.output_main %>
+<% end %>

data/template/ehbrs_ruby_utils/music/lyrics_book/custom_style.css

@@ -0,0 +1,15 @@
+.album h2 {
+  background-color: lightgoldenrodyellow;
+  text-align: center;
+}
+
+.song {
+  margin-top: 4.0em;
+}
+
+.filename {
+  display: block;
+  font-size: small;
+  text-align: right;
+  font-style: italic;
+}

data/template/ehbrs_ruby_utils/music/lyrics_book/index.html.erb

@@ -0,0 +1,14 @@
+<div class="index" >
+  <ul>
+    <% albums.each do |album| %>
+      <li>
+        <%= album.link_to_header %>
+        <ul>
+          <% album.songs.each do |song| %>
+            <li><%= song.link_to_header %></li>
+          <% end %>
+        </ul>
+      </li>
+    <% end %>
+  </ul>
+</div>

data/template/ehbrs_ruby_utils/music/lyrics_book/main.html.erb

@@ -0,0 +1,24 @@
+<!doctype html>
+<html>
+  <head>
+    <title><%= title %></title>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.5.0/font/bootstrap-icons.css">
+    <style>
+      <%= template.child('custom_style.css').content %>
+    </style>
+  </head>
+  <body>
+    <div class="container" >
+      <h1><%= title %></h1>
+      <h2>Índice</h2>
+      <%= erb_template('index.html.erb')  %>
+      <% albums.each do |album| %>
+        <%= album.output_main %>
+      <% end %>
+    </div>
+  </body>
+</html>

data/template/ehbrs_ruby_utils/music/lyrics_book/resource/main.html.erb

@@ -0,0 +1,8 @@
+<div class="<%= type %>">
+  <h<%= header_index %> id='<%= header_id %>' >
+    <%= header_title %>
+    <a href="#<%= index_id %>" ><i class="bi-arrow-up-circle-fill"></i></a>
+  </h<%= header_index %>>
+  <span class="filename"><%= filename %></span>
+  <%= erb_template('inner.html.erb') %>
+</div>

data/template/ehbrs_ruby_utils/music/lyrics_book/song/inner.html.erb

@@ -0,0 +1,9 @@
+<% if lyrics.found? %>
+  <p class="lyrics">
+    <% lyrics.text.each_line do |line| %>
+      <%= line.strip %><br/>
+    <% end %>
+  </p>
+<% else %>
+  <p><em>Letra indisponível.</em></p>
+<% end %>

metadata

@@ -1,15 +1,69 @@
 --- !ruby/object:Gem::Specification
 name: ehbrs_ruby_utils
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.12.1
 platform: ruby
 authors:
 - Eduardo H. Bogoni
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-09 00:00:00.000000000 Z
+date: 2021-10-07 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: aranha-parsers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.5
+- !ruby/object:Gem::Dependency
+  name: avm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+- !ruby/object:Gem::Dependency
+  name: eac_fs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: eac_ruby_utils
   requirement: !ruby/object:Gem::Requirement
@@ -44,6 +98,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.1.1
+- !ruby/object:Gem::Dependency
+  name: taglib-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: ultimate_lyrics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: aranha-parsers
   requirement: !ruby/object:Gem::Requirement
@@ -81,8 +163,21 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - lib/ehbrs_ruby_utils.rb
+- lib/ehbrs_ruby_utils/core_ext.rb
 - lib/ehbrs_ruby_utils/executables.rb
 - lib/ehbrs_ruby_utils/finances/bb_browser/docker_image.rb
+- lib/ehbrs_ruby_utils/fs.rb
+- lib/ehbrs_ruby_utils/fs/compressed_package.rb
+- lib/ehbrs_ruby_utils/fs/selected.rb
+- lib/ehbrs_ruby_utils/fs/selected/build.rb
+- lib/ehbrs_ruby_utils/fs/selected/build_file.rb
+- lib/ehbrs_ruby_utils/music.rb
+- lib/ehbrs_ruby_utils/music/lyrics_book.rb
+- lib/ehbrs_ruby_utils/music/lyrics_book/album.rb
+- lib/ehbrs_ruby_utils/music/lyrics_book/resource.rb
+- lib/ehbrs_ruby_utils/music/lyrics_book/song.rb
+- lib/ehbrs_ruby_utils/patches.rb
+- lib/ehbrs_ruby_utils/patches/object.rb
 - lib/ehbrs_ruby_utils/patches/object/template.rb
 - lib/ehbrs_ruby_utils/version.rb
 - lib/ehbrs_ruby_utils/videos.rb
@@ -114,6 +209,12 @@ files:
 - template/ehbrs_ruby_utils/finances/bb_browser/docker_image/README.md
 - template/ehbrs_ruby_utils/finances/bb_browser/docker_image/context/firefox.service
 - template/ehbrs_ruby_utils/finances/bb_browser/docker_image/context/startbrowser.sh
+- template/ehbrs_ruby_utils/music/lyrics_book/album/inner.html.erb
+- template/ehbrs_ruby_utils/music/lyrics_book/custom_style.css
+- template/ehbrs_ruby_utils/music/lyrics_book/index.html.erb
+- template/ehbrs_ruby_utils/music/lyrics_book/main.html.erb
+- template/ehbrs_ruby_utils/music/lyrics_book/resource/main.html.erb
+- template/ehbrs_ruby_utils/music/lyrics_book/song/inner.html.erb
 homepage: 
 licenses: []
 metadata: {}