file-digests 0.0.7 → 0.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 182ed181e50c1af8f9c9d395a4ba2536b78b69c6996e7d5852277b5bd19f3d88
-  data.tar.gz: 772b324b0821699e451db68b2859506b56d975843e925601afc3889fe94f0631
+  metadata.gz: 5b7e14619d7b7a27805bd7cf3a27240df66b3e6144063d356f04912df21be688
+  data.tar.gz: 0ee51f824ffb7b159ef4f147aaa46e239f367388e3531440918fda3756340002
 SHA512:
-  metadata.gz: 448f9c73ea520b6a68165c6b94f3509ef561085c069613d8bdc5e34c0f40f61073cb2b105d0bb488c7a4dba00cd8c87a693ec3fe59db74f2f6ed54784cbe4c8e
-  data.tar.gz: cf10a1d008765c3f0296401e6c2d3f0d90acb24aa94664be313657e5f698e40ea457b7e38e65cc74815689c3e1764708ed579953ba28ccdb894163914d614c3e
+  metadata.gz: 80debef1838828adc8eefcc1c16f8a4467d4b7f871475d26af80a07bace18541673ae331260908a66e4942dd396d997a383dd9a3a4a1e73a5ff9fa253b87fe94
+  data.tar.gz: f1df92ff7323f09673dcb81cdaf33511cf4cdd0ffbc78b1c84955885bad6408c693e6abca1b4d39ea9bbfe4ea70d1cf82d62d91c6c65c130c96422c77b8f8a17

data/bin/file-digests

@@ -1,219 +1,8 @@
 #!/usr/bin/env ruby
 
-require 'date'
-require 'set'
-require 'digest'
-require 'fileutils'
-require 'pathname'
-require 'sqlite3'
-
-def ensure_dir_exists path
-  if File.exist?(path)
-    unless File.directory?(path)
-      raise "#{path} is not a directory"
-    end
-  else
-    FileUtils.mkdir_p path
-  end
-end
-
-def measure_time
-  start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-  yield
-  elapsed = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - start).to_i
-  puts "Elapsed time: #{elapsed / 3600}h #{(elapsed % 3600) / 60}m #{elapsed % 60}s" unless QUIET
-end
-
-def patch_path_string path
-  Gem.win_platform? ? path.gsub(/\\/, '/') : path
-end
-
-class DigestDatabase
-  def initialize path
-    @db = SQLite3::Database.new(path.to_s)
-
-    unless @db.execute("SELECT name FROM sqlite_master WHERE type='table' AND name = 'digests'").length == 1
-      @db.execute 'PRAGMA encoding = "UTF-8"'
-      @db.execute "CREATE TABLE digests (
-        id INTEGER PRIMARY KEY,
-        filename TEXT,
-        mtime TEXT,
-        digest TEXT,
-        digest_check_time TEXT)"
-      @db.execute "CREATE UNIQUE INDEX digests_filename ON digests(filename)"
-    end
-
-    @db.execute 'PRAGMA journal_mode = "WAL"'
-    @db.execute 'PRAGMA synchronous = "NORMAL"'
-    @db.execute 'PRAGMA locking_mode = "EXCLUSIVE"'
-    @db.execute 'PRAGMA cache_size = "5000"'
-
-    @db.results_as_hash = true
-    @missing_files = Hash[@db.prepare("SELECT filename, digest FROM digests").execute!]
-    @new_files = {}
-
-
-    @insert = @db.prepare("INSERT INTO digests (filename, mtime, digest, digest_check_time) VALUES (?, ?, ?, datetime('now'))")
-    @find_by_filename = @db.prepare("SELECT id, mtime, digest FROM digests WHERE filename = ?")
-    @touch_digest_check_time = @db.prepare("UPDATE digests SET digest_check_time = datetime('now') WHERE id = ?")
-    @update_mtime_and_digest = @db.prepare("UPDATE digests SET mtime = ?, digest = ?, digest_check_time = datetime('now') WHERE id = ?")
-    @update_mtime = @db.prepare("UPDATE digests SET mtime = ?, digest_check_time = datetime('now') WHERE id = ?")
-    @delete_by_filename = @db.prepare("DELETE FROM digests WHERE filename = ?")
-  end
-
-  def insert_or_update file_path, mtime, digest
-    result = @find_by_filename.execute file_path
-
-    if found = result.next_hash
-      raise "Multiple records found" if result.next
-
-      @missing_files.delete(file_path)
-
-      if found['digest'] == digest
-        COUNTS[:good] += 1
-        # puts "GOOD: #{file_path}" unless QUIET
-        unless TEST_ONLY
-          if found['mtime'] == mtime
-            @touch_digest_check_time.execute found['id']
-          else
-            @update_mtime.execute mtime, found['id']
-          end
-        end
-      else
-        if found['mtime'] == mtime # Digest is different and mtime is the same
-          COUNTS[:likely_damaged] += 1
-          STDERR.puts "LIKELY DAMAGED: #{file_path}"
-        else
-          COUNTS[:updated] += 1
-          puts "UPDATED: #{file_path}" unless QUIET
-          unless TEST_ONLY
-            @update_mtime_and_digest.execute mtime, digest, found['id']
-          end
-        end
-      end
-    else
-      COUNTS[:new] += 1
-      puts "NEW: #{file_path}" unless QUIET
-      unless TEST_ONLY
-        @new_files[file_path] = digest
-        @insert.execute! file_path, mtime, digest
-      end
-    end
-  end
-
-  def process_missing_files
-    @missing_files.delete_if do |filename, digest|
-      if @new_files.value?(digest)
-        COUNTS[:renamed] += 1
-        unless TEST_ONLY
-          @delete_by_filename.execute filename
-        end
-        true
-      end
-    end
-
-    if (COUNTS[:missing] = @missing_files.length) > 0
-      puts "MISSING FILES:"
-      @missing_files.sort.to_h.each do |filename, digest|
-        puts filename
-      end
-      unless TEST_ONLY
-        puts "Remove missing files from the database (y/n)?"
-        if STDIN.gets.strip == "y"
-          @missing_files.each do |filename, digest|
-            @delete_by_filename.execute filename
-          end
-        end
-      end
-    end
-  end
-end
-
-class Checker
-  def initialize files_path, digest_database_path
-    @files_path = files_path
-    ensure_dir_exists @files_path
-
-    if digest_database_path
-      @digest_database_path = digest_database_path
-      ensure_dir_exists @digest_database_path.dirname
-    else
-      @digest_database_path = @files_path + '.file-digests.sqlite'
-      @skip_file_digests_sqlite = true
-    end
-
-    @digest_database = DigestDatabase.new @digest_database_path
-  end
-
-  def check
-    walk_files do |filename|
-      begin
-        process_file filename
-      rescue => exception
-        COUNTS[:exceptions] += 1
-        STDERR.puts "EXCEPTION: #{filename}: #{exception.message}"
-      end
-    end
-
-    @digest_database.process_missing_files
-  end
-
-  def walk_files
-    Dir.glob(@files_path + '**' + '*', File::FNM_DOTMATCH) do |filename|
-      next unless File.file? filename
-      next if @skip_file_digests_sqlite && filename == '.file-digests.sqlite'
-      next if @skip_file_digests_sqlite && filename == '.file-digests.sqlite-wal'
-      yield filename
-    end
-  end
-
-  def process_file filename
-    @digest_database.insert_or_update(
-      filename.delete_prefix(@files_path.to_s + '/'),
-      File.mtime(filename).utc.strftime('%Y-%m-%d %H:%M:%S'),
-      get_file_digest(filename)
-      )
-  end
-
-  def get_file_digest filename
-    File.open(filename, 'rb') do |io|
-      digest = Digest::SHA512.new
-      buffer = ""
-      while io.read(40960, buffer)
-        digest.update(buffer)
-      end
-      return digest.hexdigest
-    end
-  end
-
-end
-
 QUIET = (ENV["QUIET"] == "true")
 TEST_ONLY = (ENV["TEST_ONLY"] == "true")
 
-COUNTS = {good: 0, updated: 0, new: 0, missing: 0, renamed: 0, likely_damaged: 0, exceptions: 0}
-
-begin
-  if ARGV[0]
-    files_path = Pathname.new patch_path_string(ARGV[0])
-  else
-    files_path = Pathname.new patch_path_string(".")
-  end
-
-  digest_database_path = Pathname.new patch_path_string(ARGV[1]) if ARGV[1]
-
-  measure_time do
-    checker = Checker.new files_path, digest_database_path
-    checker.check
-  end
-
-  if COUNTS[:likely_damaged] > 0 || COUNTS[:exceptions] > 0
-    STDERR.puts "ERRORS WERE OCCURRED"
-  end
-
-  puts COUNTS.inspect
+require 'file-digests'
 
-rescue => exception
-  STDERR.puts "EXCEPTION: #{exception.message}"
-  raise exception
-end
+FileDigests.perform_check

data/bin/file-digests-test

@@ -1,219 +1,8 @@
 #!/usr/bin/env ruby
 
-require 'date'
-require 'set'
-require 'digest'
-require 'fileutils'
-require 'pathname'
-require 'sqlite3'
-
-def ensure_dir_exists path
-  if File.exist?(path)
-    unless File.directory?(path)
-      raise "#{path} is not a directory"
-    end
-  else
-    FileUtils.mkdir_p path
-  end
-end
-
-def measure_time
-  start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-  yield
-  elapsed = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - start).to_i
-  puts "Elapsed time: #{elapsed / 3600}h #{(elapsed % 3600) / 60}m #{elapsed % 60}s" unless QUIET
-end
-
-def patch_path_string path
-  Gem.win_platform? ? path.gsub(/\\/, '/') : path
-end
-
-class DigestDatabase
-  def initialize path
-    @db = SQLite3::Database.new(path.to_s)
-
-    unless @db.execute("SELECT name FROM sqlite_master WHERE type='table' AND name = 'digests'").length == 1
-      @db.execute 'PRAGMA encoding = "UTF-8"'
-      @db.execute "CREATE TABLE digests (
-        id INTEGER PRIMARY KEY,
-        filename TEXT,
-        mtime TEXT,
-        digest TEXT,
-        digest_check_time TEXT)"
-      @db.execute "CREATE UNIQUE INDEX digests_filename ON digests(filename)"
-    end
-
-    @db.execute 'PRAGMA journal_mode = "WAL"'
-    @db.execute 'PRAGMA synchronous = "NORMAL"'
-    @db.execute 'PRAGMA locking_mode = "EXCLUSIVE"'
-    @db.execute 'PRAGMA cache_size = "5000"'
-
-    @db.results_as_hash = true
-    @missing_files = Hash[@db.prepare("SELECT filename, digest FROM digests").execute!]
-    @new_files = {}
-
-
-    @insert = @db.prepare("INSERT INTO digests (filename, mtime, digest, digest_check_time) VALUES (?, ?, ?, datetime('now'))")
-    @find_by_filename = @db.prepare("SELECT id, mtime, digest FROM digests WHERE filename = ?")
-    @touch_digest_check_time = @db.prepare("UPDATE digests SET digest_check_time = datetime('now') WHERE id = ?")
-    @update_mtime_and_digest = @db.prepare("UPDATE digests SET mtime = ?, digest = ?, digest_check_time = datetime('now') WHERE id = ?")
-    @update_mtime = @db.prepare("UPDATE digests SET mtime = ?, digest_check_time = datetime('now') WHERE id = ?")
-    @delete_by_filename = @db.prepare("DELETE FROM digests WHERE filename = ?")
-  end
-
-  def insert_or_update file_path, mtime, digest
-    result = @find_by_filename.execute file_path
-
-    if found = result.next_hash
-      raise "Multiple records found" if result.next
-
-      @missing_files.delete(file_path)
-
-      if found['digest'] == digest
-        COUNTS[:good] += 1
-        # puts "GOOD: #{file_path}" unless QUIET
-        unless TEST_ONLY
-          if found['mtime'] == mtime
-            @touch_digest_check_time.execute found['id']
-          else
-            @update_mtime.execute mtime, found['id']
-          end
-        end
-      else
-        if found['mtime'] == mtime # Digest is different and mtime is the same
-          COUNTS[:likely_damaged] += 1
-          STDERR.puts "LIKELY DAMAGED: #{file_path}"
-        else
-          COUNTS[:updated] += 1
-          puts "UPDATED: #{file_path}" unless QUIET
-          unless TEST_ONLY
-            @update_mtime_and_digest.execute mtime, digest, found['id']
-          end
-        end
-      end
-    else
-      COUNTS[:new] += 1
-      puts "NEW: #{file_path}" unless QUIET
-      unless TEST_ONLY
-        @new_files[file_path] = digest
-        @insert.execute! file_path, mtime, digest
-      end
-    end
-  end
-
-  def process_missing_files
-    @missing_files.delete_if do |filename, digest|
-      if @new_files.value?(digest)
-        COUNTS[:renamed] += 1
-        unless TEST_ONLY
-          @delete_by_filename.execute filename
-        end
-        true
-      end
-    end
-
-    if (COUNTS[:missing] = @missing_files.length) > 0
-      puts "MISSING FILES:"
-      @missing_files.sort.to_h.each do |filename, digest|
-        puts filename
-      end
-      unless TEST_ONLY
-        puts "Remove missing files from the database (y/n)?"
-        if STDIN.gets.strip == "y"
-          @missing_files.each do |filename, digest|
-            @delete_by_filename.execute filename
-          end
-        end
-      end
-    end
-  end
-end
-
-class Checker
-  def initialize files_path, digest_database_path
-    @files_path = files_path
-    ensure_dir_exists @files_path
-
-    if digest_database_path
-      @digest_database_path = digest_database_path
-      ensure_dir_exists @digest_database_path.dirname
-    else
-      @digest_database_path = @files_path + '.file-digests.sqlite'
-      @skip_file_digests_sqlite = true
-    end
-
-    @digest_database = DigestDatabase.new @digest_database_path
-  end
-
-  def check
-    walk_files do |filename|
-      begin
-        process_file filename
-      rescue => exception
-        COUNTS[:exceptions] += 1
-        STDERR.puts "EXCEPTION: #{filename}: #{exception.message}"
-      end
-    end
-
-    @digest_database.process_missing_files
-  end
-
-  def walk_files
-    Dir.glob(@files_path + '**' + '*', File::FNM_DOTMATCH) do |filename|
-      next unless File.file? filename
-      next if @skip_file_digests_sqlite && filename == '.file-digests.sqlite'
-      next if @skip_file_digests_sqlite && filename == '.file-digests.sqlite-wal'
-      yield filename
-    end
-  end
-
-  def process_file filename
-    @digest_database.insert_or_update(
-      filename.delete_prefix(@files_path.to_s + '/'),
-      File.mtime(filename).utc.strftime('%Y-%m-%d %H:%M:%S'),
-      get_file_digest(filename)
-      )
-  end
-
-  def get_file_digest filename
-    File.open(filename, 'rb') do |io|
-      digest = Digest::SHA512.new
-      buffer = ""
-      while io.read(40960, buffer)
-        digest.update(buffer)
-      end
-      return digest.hexdigest
-    end
-  end
-
-end
-
 QUIET = (ENV["QUIET"] == "true")
 TEST_ONLY = true
 
-COUNTS = {good: 0, updated: 0, new: 0, missing: 0, renamed: 0, likely_damaged: 0, exceptions: 0}
-
-begin
-  if ARGV[0]
-    files_path = Pathname.new patch_path_string(ARGV[0])
-  else
-    files_path = Pathname.new patch_path_string(".")
-  end
-
-  digest_database_path = Pathname.new patch_path_string(ARGV[1]) if ARGV[1]
-
-  measure_time do
-    checker = Checker.new files_path, digest_database_path
-    checker.check
-  end
-
-  if COUNTS[:likely_damaged] > 0 || COUNTS[:exceptions] > 0
-    STDERR.puts "ERRORS WERE OCCURRED"
-  end
-
-  puts COUNTS.inspect
+require 'file-digests'
 
-rescue => exception
-  STDERR.puts "EXCEPTION: #{exception.message}"
-  raise exception
-end
+FileDigests.perform_check

data/lib/file-digests.rb

@@ -0,0 +1,247 @@
+
+require 'date'
+require 'set'
+require 'digest'
+require 'fileutils'
+require 'pathname'
+require 'sqlite3'
+
+module FileDigests
+
+  def self.ensure_dir_exists path
+    if File.exist?(path)
+      unless File.directory?(path)
+        raise "#{path} is not a directory"
+      end
+    else
+      FileUtils.mkdir_p path
+    end
+  end
+
+  def self.measure_time
+    start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    yield
+    elapsed = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - start).to_i
+    puts "Elapsed time: #{elapsed / 3600}h #{(elapsed % 3600) / 60}m #{elapsed % 60}s" unless QUIET
+  end
+
+  def self.patch_path_string path
+    Gem.win_platform? ? path.gsub(/\\/, '/') : path
+  end
+
+  def self.perform_check
+    checker = Checker.new ARGV[0], ARGV[1]
+    checker.perform_check
+  end
+
+  class DigestDatabase
+    def initialize path
+      @db = SQLite3::Database.new path.to_s
+      @db.results_as_hash = true
+
+      execute 'PRAGMA journal_mode = "WAL"'
+      execute 'PRAGMA synchronous = "NORMAL"'
+      execute 'PRAGMA locking_mode = "EXCLUSIVE"'
+      execute 'PRAGMA cache_size = "5000"'
+
+      unless execute("SELECT name FROM sqlite_master WHERE type='table' AND name = 'digests'").length == 1
+        execute 'PRAGMA encoding = "UTF-8"'
+        execute "CREATE TABLE digests (
+          id INTEGER PRIMARY KEY,
+          filename TEXT,
+          mtime TEXT,
+          digest TEXT,
+          digest_check_time TEXT)"
+        execute "CREATE UNIQUE INDEX digests_filename ON digests(filename)"
+      end
+
+      @missing_files = Hash[@db.prepare("SELECT filename, digest FROM digests").execute!]
+      @new_files = {}
+
+      prepare_method :insert, "INSERT INTO digests (filename, mtime, digest, digest_check_time) VALUES (?, ?, ?, datetime('now'))"
+      prepare_method :find_by_filename, "SELECT id, mtime, digest FROM digests WHERE filename = ?"
+      prepare_method :touch_digest_check_time, "UPDATE digests SET digest_check_time = datetime('now') WHERE id = ?"
+      prepare_method :update_mtime_and_digest, "UPDATE digests SET mtime = ?, digest = ?, digest_check_time = datetime('now') WHERE id = ?"
+      prepare_method :update_mtime, "UPDATE digests SET mtime = ?, digest_check_time = datetime('now') WHERE id = ?"
+      prepare_method :delete_by_filename, "DELETE FROM digests WHERE filename = ?"
+    end
+
+    def insert_or_update file_path, mtime, digest, counters
+      result = find_by_filename file_path
+
+      if found = result.next_hash
+        raise "Multiple records found" if result.next
+
+        @missing_files.delete(file_path)
+
+        if found['digest'] == digest
+          counters[:good] += 1
+          # puts "GOOD: #{file_path}" unless QUIET
+          unless TEST_ONLY
+            if found['mtime'] == mtime
+              touch_digest_check_time found['id']
+            else
+              update_mtime mtime, found['id']
+            end
+          end
+        else
+          if found['mtime'] == mtime # Digest is different and mtime is the same
+            counters[:likely_damaged] += 1
+            STDERR.puts "LIKELY DAMAGED: #{file_path}"
+          else
+            counters[:updated] += 1
+            puts "UPDATED: #{file_path}" unless QUIET
+            unless TEST_ONLY
+              update_mtime_and_digest mtime, digest, found['id']
+            end
+          end
+        end
+      else
+        counters[:new] += 1
+        puts "NEW: #{file_path}" unless QUIET
+        unless TEST_ONLY
+          @new_files[file_path] = digest
+          insert file_path, mtime, digest
+        end
+      end
+    end
+
+    def process_missing_files counters
+      @missing_files.delete_if do |filename, digest|
+        if @new_files.value?(digest)
+          counters[:renamed] += 1
+          unless TEST_ONLY
+            delete_by_filename filename
+          end
+          true
+        end
+      end
+
+      if (counters[:missing] = @missing_files.length) > 0
+        puts "\nMISSING FILES:"
+        @missing_files.sort.to_h.each do |filename, digest|
+          puts filename
+        end
+        unless TEST_ONLY
+          puts "Remove missing files from the database (y/n)?"
+          if STDIN.gets.strip.downcase == "y"
+            @db.transaction do
+              @missing_files.each do |filename, digest|
+                delete_by_filename filename
+              end
+            end
+          end
+        end
+      end
+    end
+
+    private
+
+    def execute *args, &block
+      @db.execute *args, &block
+    end
+
+    def prepare_method name, query
+      variable = "@#{name}"
+      instance_variable_set(variable, @db.prepare(query))
+      define_singleton_method name do |*args, &block|
+        instance_variable_get(variable).execute(*args, &block)
+      end
+    end
+  end
+
+  class Checker
+    def initialize files_path, digest_database_path
+      @files_path = Pathname.new(FileDigests::patch_path_string(files_path || ".")).cleanpath
+      @prefix_to_remove = @files_path.to_s + '/'
+
+      raise "Files path must be a readable directory" unless (File.directory?(@files_path) && File.readable?(@files_path))
+
+      @digest_database_path = if digest_database_path
+        Pathname.new(FileDigests::patch_path_string(digest_database_path)).cleanpath
+      else
+        @files_path + '.file-digests.sqlite'
+      end
+
+      if @files_path == @digest_database_path.dirname
+        @skip_file_digests_sqlite = true
+      end
+
+      FileDigests::ensure_dir_exists @digest_database_path.dirname
+
+      if File.exist?(@digest_database_path.dirname + '.file-digests.sha512')
+        @use_sha512 = true
+      end
+
+      @digest_database = DigestDatabase.new @digest_database_path
+      @counters = {good: 0, updated: 0, new: 0, missing: 0, renamed: 0, likely_damaged: 0, exceptions: 0}
+    end
+
+    def perform_check
+      FileDigests::measure_time do
+        walk_files do |filename|
+          process_file filename
+        end
+      end
+
+      @digest_database.process_missing_files @counters
+
+      if @counters[:likely_damaged] > 0 || @counters[:exceptions] > 0
+        STDERR.puts "ERRORS WERE OCCURRED"
+      end
+
+      puts @counters.inspect
+    end
+
+    def walk_files
+      Dir.glob(@files_path + '**' + '*', File::FNM_DOTMATCH) do |filename|
+        yield filename
+      end
+    end
+
+    def process_file filename
+      return if File.symlink? filename
+
+      stat = File.stat filename
+
+      return if stat.blockdev?
+      return if stat.chardev?
+      return if stat.directory?
+      return if stat.pipe?
+      unless stat.readable?
+        raise "File is not readable"
+      end
+      return if stat.socket?
+
+      if @skip_file_digests_sqlite
+        basename = File.basename(filename)
+        return if basename == '.file-digests.sha512'
+        return if basename == '.file-digests.sqlite'
+        return if basename == '.file-digests.sqlite-wal'
+        return if basename == '.file-digests.sqlite-shm'
+      end
+
+      @digest_database.insert_or_update(
+        filename.delete_prefix(@prefix_to_remove).encode('utf-8', universal_newline: true).unicode_normalize(:nfkc),
+        stat.mtime.utc.strftime('%Y-%m-%d %H:%M:%S'),
+        get_file_digest(filename),
+        @counters
+        )
+    rescue => exception
+      @counters[:exceptions] += 1
+      STDERR.puts "EXCEPTION: #{filename}: #{exception.message}"
+    end
+
+    def get_file_digest filename
+      File.open(filename, 'rb') do |io|
+        digest = (@use_sha512 ? Digest::SHA512 : Digest::SHA256).new
+        buffer = ""
+        while io.read(40960, buffer)
+          digest.update(buffer)
+        end
+        return digest.hexdigest
+      end
+    end
+
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: file-digests
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.12
 platform: ruby
 authors:
 - Stanislav Senotrusov
@@ -34,6 +34,7 @@ extra_rdoc_files: []
 files:
 - bin/file-digests
 - bin/file-digests-test
+- lib/file-digests.rb
 homepage: https://github.com/senotrusov/file-digests
 licenses:
 - Apache-2.0