quick_and_ruby 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c685bd6937aa82ca104aa4d885bb6cb150e465d61dafe2fc4c5bcd18f2a19cc5
-  data.tar.gz: c6e90670c6447c6261fb3c25be94d7617c0c4a4042da22cd302f5c9a9c906481
+  metadata.gz: 7ca92f547a72562016dbe6ae7c6565066c2b4677133db05202de86d5471c228b
+  data.tar.gz: 9f60ad5846b8102a14b5a9de65b9a8e5db4bc71aaba14280196ec3739d83cb41
 SHA512:
-  metadata.gz: '03189ba3378295c3358c4449d30d6c2c6075f1c292f83b6f5db7f4cedcac775e3bc6cfd0d639cb50d54fcbe56f77aa70df2eaad3fe17263286bb968f34097933'
-  data.tar.gz: 00b294e7bc307dbb19947dfc48dd49cdd0b803fc5c69258ddcf6d5596b2df9923fb2be3e86921b3784ccef348d78f2d5865fe13c3a3cba15c5927e42b7f8278d
+  metadata.gz: 2d093d56fb8ccb86f8f6a9b37e2caf034a89742d8aae6cadaa7fc200c24f1ace18cd8fbee4e536f94e39364bb551335be14e6818892b671990a3024f49968680
+  data.tar.gz: 60884d29f116d6adf7f41d59795d4a33ff6153fc089b4365ae57d6f1f4f3bbcb87f14d0aef95a70eb6d6b95121bb06e978aaadcace76e20e76a906cb3bd2a48d

data/.rubocop.yml

@@ -1,10 +1,12 @@
-require:
+---
+
+plugins:
   - rubocop-rake
   - rubocop-rspec
 
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 2.7
+  TargetRubyVersion: 3.1
 
 Gemspec/DevelopmentDependencies:
   Enabled: false

data/Gemfile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 # Specify your gem's dependencies in quick_and_ruby.gemspec

data/README.md

@@ -8,7 +8,7 @@ Gem to group utilities in ruby.
 gem install quick_and_ruby
 ```
 
-## bins
+## bin's
 
 ### proxy
 
@@ -25,6 +25,30 @@ datetime -o <offset> -i <incr> -f "<format>" <from>|now <to>|now
 datetime -o <offset> -i <incr> -f "<format>" <from>|now
 ```
 
+### epoch
+
+Convert epoch and time.
+
+Usage:
+
+``` shell
+# time to epoch
+epoch 2025-01-01T01:01:01.000Z
+1735693261
+
+# epoch to time UTC
+epoch -u 1735693261
+2025-01-01T01:01:01.000Z
+
+# epoch to time (local time zone)
+epoch 1735693261
+2025-01-01T02:01:01.000+01:00
+
+# time to epoch millis
+epoch -m 2025-01-01T01:01:01.123Z
+1735693261123
+```
+
 ### yaml2json
 
 Convert yaml formated string, file or stdin to json format.

data/bin/epoch

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'quick_and_ruby/time'
+
+QuickAndRuby::Time::EpochCli.new.run

data/bin/quickpdf

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+
+require 'gli'
+require 'quick_and_ruby'
+require 'quick_and_ruby/pdf'
+
+class App
+  extend GLI::App
+
+  program_desc 'A quick PDF utility.'
+
+  version QuickAndRuby::VERSION
+
+  subcommand_option_handling :normal
+  arguments :strict
+
+  desc 'Extract links from a PDF document'
+  arg_name 'pdf_file [pdf_file2 ...]'
+  command:'extract-links' do |c|
+    c.desc 'URL schemes to extract (http, https, ftp, etc.). Can be specified multiple times'
+    c.flag [:s, :scheme], multiple: true, default_value: ['http', 'https']
+
+    c.action do |global_options, options, args|
+      raise GLI::BadCommandLine, "Missing required argument <PDF_FILE>" if args.empty?
+
+      schemes = options[:scheme].map(&:downcase)
+
+      error_count = 0
+      args.each do |pdf_filepath|
+        puts QuickAndRuby::Pdf::Document
+          .new(pdf_filepath)
+          .extract_links(schemes: schemes)
+          .compact
+      rescue StandardError => e
+        error_count += 1
+        puts "error: while processing #{pdf_filepath}: #{e}"
+      end
+      raise "error: #{error_count} errors while processing" if error_count.positive?
+    end
+  end
+
+  pre do |global,command,options,args|
+    true
+  end
+
+  post do |global,command,options,args|
+    true
+  end
+
+  on_error do |exception|
+    true
+  end
+end
+
+exit App.run(ARGV)

data/lib/quick_and_ruby/pdf/document.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'pdf-reader'
+
+module QuickAndRuby
+  module Pdf
+    class Document
+      DEFAULT_SCHEMES = %w[http https].freeze
+
+      attr_reader :filepath
+
+      def initialize(filepath)
+        @filepath = filepath
+      end
+
+      def extract_links(schemes: DEFAULT_SCHEMES)
+        links = []
+
+        doc_reader.pages.each do |page|
+          text = page.text
+          links += URI.extract(text, schemes)
+
+          annots = page.attributes[:Annots] || []
+          annots.each do |annot_ref|
+            annot = doc_reader.objects.deref(annot_ref)
+            next unless annot.is_a?(Hash) && annot[:A] && annot[:A][:URI]
+
+            target_uri = annot[:A][:URI]
+
+            links += URI.extract(target_uri, schemes)
+          end
+        end
+        links.uniq
+      end
+
+      def doc_reader
+        @doc_reader ||= PDF::Reader.new(filepath)
+      end
+    end
+  end
+end

data/lib/quick_and_ruby/pdf.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative 'pdf/document'
+
+module QuickAndRuby
+  module Pdf
+  end
+end

data/lib/quick_and_ruby/time/epoch_cli.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'optparse'
+
+# Usage example:
+#
+# epoch
+#   => 1740485717
+# epoch -ms
+#   => 1740485775670
+# epoch 1740485717
+#   => 2025-02-25T13:17:14.508+01:00
+# epoch -u 1740485717
+#   => 2025-02-25T12:18:21.954Z
+# epoch [-d|--diff] 1740485717
+#   => 30sec ago
+# epoch [-v|--verbose] 1740485717
+#   => 2025-02-25T12:18:21.954Z
+#   => 30sec ago
+
+module QuickAndRuby
+  module Time
+    class EpochCli
+      attr_reader :argv, :env
+
+      def initialize(argv: ARGV, env: ENV)
+        @argv = argv.clone
+        @env = env.to_h.clone
+      end
+
+      def run
+        options = parse_options
+        puts EpochConverter.new(**options.to_h).convert_all(*argv)
+      end
+
+      def parse_options(options: Options.new)
+        parser = OptionParser.new do |opts|
+          opts.banner = 'Usage: epoch [options]'
+
+          opts.on('-h', '--help', 'Prints this help') do
+            puts parser
+            exit
+          end
+
+          opts.on('-m', '--millis', 'Display epoch in milliseconds') do |_millis|
+            options.millis = true
+          end
+
+          opts.on('-u', '--utc', 'Display time in UTC') do
+            options.utc = true
+          end
+        end
+
+        parser.parse!(argv)
+        options
+      end
+
+      class Options
+        DEFAULT_MILLIS = false
+        DEFAULT_UTC = false
+
+        attr_accessor :millis, :utc
+
+        def initialize(millis: DEFAULT_MILLIS, utc: DEFAULT_UTC)
+          @millis = millis
+          @utc = utc
+        end
+
+        def to_h
+          { millis: millis,
+            utc: utc }
+        end
+      end
+    end
+  end
+end

data/lib/quick_and_ruby/time/epoch_converter.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'time'
+
+module QuickAndRuby
+  module Time
+    class EpochConverter
+      attr_reader :millis, :utc
+
+      def initialize(millis:, utc:)
+        @millis = millis
+        @utc = utc
+      end
+
+      def convert_all(*values)
+        values.map { |value_str| convert(value_str) }
+      end
+
+      def convert(value_str)
+        if value_str.match(/\D/)
+          convert_time(value_str)
+        else
+          convert_epoch(value_str)
+        end
+      end
+
+      def convert_time(time_str)
+        time = ::Time.parse(time_str)
+        epoch = time.to_f
+        epoch *= 1000 if millis
+        epoch.to_i
+      end
+
+      def convert_epoch(epoch_str)
+        epoch = epoch_str.to_i
+        epoch /= 1000.0 if epoch_str.size > 10
+        time = ::Time.at(epoch)
+        time = time.utc if utc
+        time.iso8601(3)
+      end
+    end
+  end
+end

data/lib/quick_and_ruby/time.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative 'version'
+require_relative 'time/epoch_converter'
+require_relative 'time/epoch_cli'
+
+module QuickAndRuby
+  module Time
+  end
+end

data/lib/quick_and_ruby/version.rb

@@ -1,3 +1,3 @@
 module QuickAndRuby
-  VERSION = '0.5.1'.freeze
+  VERSION = '0.7.0'.freeze
 end

data/quick_and_ruby.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/ttych/quick_and_ruby'
   spec.license       = 'MIT'
 
-  spec.required_ruby_version = '> 2.7'
+  spec.required_ruby_version = '> 3.1'
 
   if spec.respond_to?(:metadata)
     spec.metadata['allowed_push_host'] = 'https://rubygems.org'
@@ -42,13 +42,22 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^#{spec.bindir}/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bump', '~> 0.10.0'
-  spec.add_development_dependency 'bundler', '~> 2.2', '>= 2.2.31'
+  spec.add_dependency 'gli', '~> 2.22', '>= 2.22.2'
+  # spec.add_dependency 'hexapdf', '~> 1.3'
+  spec.add_dependency 'ostruct', '~> 0.6', '>= 0.6.1'
+  spec.add_dependency 'pdf-reader', '~> 2.14', '>= 2.14.1'
+  spec.add_dependency 'webrick', '~> 1.9', '>= 1.9.1'
+
+  spec.add_development_dependency 'bump', '~> 0.10'
+  spec.add_development_dependency 'bundler', '~> 2.6', '>= 2.6.5'
   spec.add_development_dependency 'byebug', '~> 11.1', '>= 11.1.3'
-  spec.add_development_dependency 'rake', '~> 13.0', '>= 13.0.6'
-  spec.add_development_dependency 'reek', '~> 6.0', '>= 6.0.6'
-  spec.add_development_dependency 'rspec', '~> 3.10'
-  spec.add_development_dependency 'rubocop', '~> 1.22', '>= 1.22.3'
-  spec.add_development_dependency 'rubocop-rake', '~> 0.6.0'
-  spec.add_development_dependency 'rubocop-rspec', '~> 2.6'
+  spec.add_development_dependency 'rake', '~> 13.3', '>= 13.3.0'
+  spec.add_development_dependency 'reek', '~> 6.5'
+  spec.add_development_dependency 'rspec', '~> 3.13', '>= 3.13.1'
+  spec.add_development_dependency 'rubocop', '~> 1.76', '>= 1.76.1'
+  spec.add_development_dependency 'rubocop-rake', '~> 0.7', '>= 0.7.1'
+  spec.add_development_dependency 'rubocop-rspec', '~> 3.6'
+  spec.add_development_dependency 'ruby-lsp', '~> 0.24'
+  spec.add_development_dependency 'ruby-lsp-reek', '~> 0.3', '>= 0.3.1'
+  spec.add_development_dependency 'ruby-lsp-rspec', '~> 0.1', '>= 0.1.25'
 end

metadata

@@ -1,49 +1,128 @@
 --- !ruby/object:Gem::Specification
 name: quick_and_ruby
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.7.0
 platform: ruby
 authors:
 - ttych
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.22'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.22.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.22'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.22.2
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+- !ruby/object:Gem::Dependency
+  name: pdf-reader
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.9.1
 - !ruby/object:Gem::Dependency
   name: bump
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: '0.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: '0.10'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '2.6'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.31
+        version: 2.6.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '2.6'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.31
+        version: 2.6.5
 - !ruby/object:Gem::Dependency
   name: byebug
   requirement: !ruby/object:Gem::Requirement
@@ -70,102 +149,162 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '13.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 13.0.6
+        version: 13.3.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '13.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 13.0.6
+        version: 13.3.0
 - !ruby/object:Gem::Dependency
   name: reek
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 6.0.6
+        version: '6.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 6.0.6
+        version: '6.5'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '3.13'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.13.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '3.13'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.13.1
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.22'
+        version: '1.76'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.22.3
+        version: 1.76.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.22'
+        version: '1.76'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.22.3
+        version: 1.76.1
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: '0.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: '0.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.1
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '3.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: ruby-lsp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.24'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.24'
+- !ruby/object:Gem::Dependency
+  name: ruby-lsp-reek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+- !ruby/object:Gem::Dependency
+  name: ruby-lsp-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.25
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.25
 description: Set of small and standalone utilities in Ruby.
 email:
 - thomas.tych@gmail.com
@@ -173,9 +312,11 @@ executables:
 - cat.rb
 - datetime
 - distinguished_name
+- epoch
 - jb
 - json2yaml
 - proxy
+- quickpdf
 - yaml2json
 - yb
 extensions: []
@@ -194,9 +335,11 @@ files:
 - bin/cat.rb
 - bin/datetime
 - bin/distinguished_name
+- bin/epoch
 - bin/jb
 - bin/json2yaml
 - bin/proxy
+- bin/quickpdf
 - bin/yaml2json
 - bin/yb
 - lib/quick_and_ruby.rb
@@ -210,11 +353,16 @@ files:
 - lib/quick_and_ruby/distinguished_name/attribute.rb
 - lib/quick_and_ruby/distinguished_name/openssl_format.rb
 - lib/quick_and_ruby/distinguished_name/rfc_format.rb
+- lib/quick_and_ruby/pdf.rb
+- lib/quick_and_ruby/pdf/document.rb
 - lib/quick_and_ruby/proxy/arg_parser.rb
 - lib/quick_and_ruby/proxy/env_parser.rb
 - lib/quick_and_ruby/proxy/proxy.rb
 - lib/quick_and_ruby/string.rb
 - lib/quick_and_ruby/string/case.rb
+- lib/quick_and_ruby/time.rb
+- lib/quick_and_ruby/time/epoch_cli.rb
+- lib/quick_and_ruby/time/epoch_converter.rb
 - lib/quick_and_ruby/version.rb
 - man/distinguished_name.1.ronn
 - quick_and_ruby.gemspec
@@ -229,7 +377,6 @@ metadata:
   source_code_uri: https://github.com/ttych/quick_and_ruby
   changelog_uri: https://github.com/ttych/quick_and_ruby/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -237,15 +384,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key:
+rubygems_version: 3.6.8
 specification_version: 4
 summary: Quick and Ruby utilities.
 test_files: []