getv-rs 2.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1a0f9f67eef721617d91a03f548a9a24488d8e1f74d071b479d4df874fc57578
+  data.tar.gz: c92fc90d57b1b25a4bc6dc1d20400022f7fbfacc52bf300735e1f154b00ba004
+SHA512:
+  metadata.gz: 0df35d693cd27977bf421e154d8be695fd22f85d6cf0945186cd0992221d28bb303451e385e5ed5b5e0c740ef7557184d13fd0b617984284cc6526d076b4c7b5
+  data.tar.gz: fe427c825af69ed7e0b33e2bce52c7e10ceb7c398fc3739ecca315416cb535f907533580af652a59abf461dbb058485f25b92325121f450b0328dcc55997b101

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 Richard Grainger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,166 @@
+# getv
+
+[![Gem Version](https://badge.fury.io/rb/getv.svg)](https://rubygems.org/gems/getv)
+
+The goal of `getv` is to make it easy and quick to pull software package version numbers from various sources on the web. The application is packaged as a [gem](https://rubygems.org/gems/getv) and provides both a Ruby library and an executable command line tool, `getv`.
+
+## Installation
+
+Install `getv` with:
+
+```
+gem install getv
+```
+
+Or add this line to your application's Gemfile:
+
+```ruby
+gem 'getv'
+```
+
+And then execute:
+
+```sh
+bundle install
+```
+
+## CLI
+
+An executable command tool, `getv` is bundled with this gem:
+
+```console
+$ getv
+NAME
+    getv - Get package version numbers from the web in various ways
+
+
+SYNOPSIS
+    getv [global options] command [command options] [arguments...]
+
+
+VERSION
+    2.1.4
+
+
+
+GLOBAL OPTIONS
+    --help          - Show this message
+    -j, --json      - Output in json
+    -l, --latest    - Latest version
+    -p, --proxy=arg - Web proxy (default: none)
+    --version       - Display the program version
+
+
+
+COMMANDS
+    docker         - Get package versions from a Docker or OCI container image registry
+    gem            - Get package versions from RubyGems.org
+    github_commit  - Get package versions from GitHub commits
+    github_release - Get package versions from GitHub releases
+    github_tag     - Get package versions from GitHub tags
+    helm           - Get package versions from a Helm chart repository
+    help           - Shows a list of commands or help for one command
+    npm            - Get package versions from npm at registry.npmjs.org
+    pypi           - Get package versions from the Python Package Index at pypi.org
+    text           - Get package versions from text file URL
+    xml            - Get package versions from XML file URL
+```
+
+### CLI examples
+
+Show the latest available version of the `getv` gem:
+
+```console
+$ getv --latest gem getv
+2.1.4
+```
+
+Show all `dep` GitHub release versions in JSON:
+
+```console
+$ getv --json github_release golang/dep
+{"name":"golang/dep","versions":["0.2.0","0.2.1","0.3.0","0.3.1","0.3.2","0.4.0","0.4.1","0.5.0","0.5.1","0.5.2","0.5.3","0.5.4"]}
+```
+
+Show all AtomicParsley Github release versions:
+
+```console
+$ getv github_release --invalid_versions wez/atomicparsley
+20200701.154658.b0d6223
+20201231.092811.cbecfb1
+20210114.184825.1dbe1be
+20210124.204813.840499f
+20210617.200601.1ac7c08
+20210715.151551.e7ad03a
+```
+
+Show the latest stable version of Kubernetes using the release text file URL:
+
+```console
+$ getv -l text --url=https://storage.googleapis.com/kubernetes-release/release/stable.txt kubernetes
+1.23.2
+```
+
+Show selected semantic versions of the `apache/superset` Docker image in JSON:
+
+```console
+$ getv --json docker --reject '-' --semantic_select '~>1.3.0,!=1.3.1' apache/superset
+{"name":"apache/superset","versions":["1.3.0","1.3.2"]}
+```
+
+Show all versions of `libnetfilter_acct` using selected link values (`<a>` HTML elements) on an indexed web page:
+
+```console
+$ getv xml --url=https://netfilter.org/projects/libnetfilter_acct/files --xpath '//a' --select_search='^.*libnetfilter_acct-([\d\.]*)\.tar\.bz2$' libnetfilter_acct
+1.0.0
+1.0.1
+1.0.2
+1.0.3
+```
+
+Show the latest GitHub commit to the `main` branch of the `getv` project in a useful versioning format:
+
+```console
+# By default the \2 capture group contains the date and \5 contains the short commit hash
+$ getv -l github_commit --select_replace '\2git\5' --branch main liger1978/getv
+20220123git9ed86f0
+```
+
+## Ruby library
+
+Example:
+
+```ruby
+require 'getv'
+
+superset = Getv::Package::Docker.new 'apache/superset', reject: '-'
+puts superset.versions
+puts superset.latest_version
+
+# You can also use the flexible "create" factory method
+Getv::Package.create 'apache/superset', type: 'docker', reject: '-'
+Getv::Package.create 'golang/dep', type: 'github release'
+Getv::Package.create 'golang/dep', type: 'github_release'
+Getv::Package.create 'golang/dep', type: 'GitHub::Release'
+Getv::Package.create 'rubygem-getv'
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake spec` to run the tests. Run `bundle exec rubocop` to run the linter. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+Note that by default, Bundler will attempt to install gems to the system, e.g. `/usr/bin`, `/usr/share`, which requires elevated access and can interfere with files that are managed by the system's package manager. This behaviour can be overridden by creating the file `.bundle/config` and adding the following line:
+```
+BUNDLE_PATH: "./.bundle"
+```
+When you run `bin/setup` or `bundle install`, all gems will be installed inside the .bundle directory of this project.
+
+To make this behaviour a default for all gem projects, the above line can be added to the user's bundle config file in their home directory (`~/.bundle/config`)
+
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/liger1978/getv).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/exe/getv

@@ -0,0 +1,324 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'getv'
+require 'gli'
+
+module Getv
+  # cli class
+  class Cli
+    def self.output(package, latest: false, json: false)
+      key = latest ? 'latest_version' : 'versions'
+      result = package.send(key)
+
+      if json
+        require 'json'
+        result = { 'name' => package.name, key => result }.to_json
+      end
+
+      puts result
+    end
+  end
+end
+
+# app class
+class App # rubocop:disable Metrics/ClassLength
+  extend GLI::App
+
+  program_desc 'Get package version numbers from the web in various ways'
+
+  version Getv::VERSION
+
+  subcommand_option_handling :normal
+  arguments :strict
+
+  switch %i[l latest], desc: 'Latest version', negatable: false
+  switch %i[j json], desc: 'Output in json', negatable: false
+  flag %i[p proxy], desc: 'Web proxy', default_value: nil
+
+  desc 'Get package versions from a Docker or OCI container image registry'
+  arg_name 'package_name'
+  command :docker do |c| # rubocop:disable Metrics/BlockLength
+    defaults = (Getv::Package::Docker.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.switch %i[invalid_versions], desc: 'Include invalid semantic versions', negatable: false, default_value: false
+    c.flag %i[semantic_select], desc: 'Semantic version selection (comma delimited)',
+                                default_value: defaults[:semantic_select]
+    c.flag %i[owner], desc: 'Repository owner',
+                      default_value: "'<owner>' if package_name is in format '<registry>/<owner>/<repo>' or '<owner>/<repo>', otherwise just package_name" # rubocop:disable Layout/LineLength
+    c.flag %i[repo], desc: 'Repository name',
+                     default_value: "'<repo>' if package_name is in format '<registry>/<owner>/<repo>' or <owner>/<repo>, otherwise just package_name" # rubocop:disable Layout/LineLength
+    c.flag %i[url], desc: 'URL',
+                    default_value: "'https://<registry>' if package_name is in format '<registry>/<owner>/<repo>', otherwise #{defaults[:url]}" # rubocop:disable Layout/LineLength
+    c.flag %i[user], desc: 'Username', default_value: defaults[:user]
+    c.flag %i[password], desc: 'Password', default_value: defaults[:password]
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :semantic_only, :semantic_select, :owner, :repo,
+                        :url, :user, :password, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      opts[:semantic_only] = !options[:invalid_versions]
+      opts[:semantic_select] = opts[:semantic_select].split(',') unless opts.fetch(:semantic_select, nil).nil?
+      package = Getv::Package::Docker.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  desc 'Get package versions from RubyGems.org'
+  arg_name 'package_name'
+  command :gem do |c|
+    defaults = (Getv::Package::Gem.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.switch %i[invalid_versions], desc: 'Include invalid semantic versions', negatable: false, default_value: false
+    c.flag %i[semantic_select], desc: 'Semantic version selection (comma delimited)',
+                                default_value: defaults[:semantic_select]
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :semantic_only, :semantic_select, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      opts[:semantic_only] = !options[:invalid_versions]
+      opts[:semantic_select] = opts[:semantic_select].split(',') unless opts.fetch(:semantic_select, nil).nil?
+      package = Getv::Package::Gem.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  desc 'Get package versions from text file URL'
+  arg_name 'package_name'
+  command :text do |c|
+    defaults = (Getv::Package::Text.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.switch %i[invalid_versions], desc: 'Include invalid semantic versions', negatable: false, default_value: false
+    c.flag %i[semantic_select], desc: 'Semantic version selection (comma delimited)',
+                                default_value: defaults[:semantic_select]
+    c.flag %i[url], desc: 'URL', default_value: defaults[:url]
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :semantic_only, :semantic_select, :url, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      opts[:semantic_only] = !options[:invalid_versions]
+      opts[:semantic_select] = opts[:semantic_select].split(',') unless opts.fetch(:semantic_select, nil).nil?
+      package = Getv::Package::Text.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  desc 'Get package versions from GitHub commits'
+  arg_name 'package_name'
+  command :github_commit do |c|
+    defaults = (Getv::Package::GitHub::Commit.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.flag %i[owner], desc: 'Repository owner',
+                      default_value: "'<owner>' if package_name is in format '<owner>/<repo>', otherwise just package_name" # rubocop:disable Layout/LineLength
+    c.flag %i[repo], desc: 'Repository name',
+                     default_value: "'<repo>' if package_name is in format '<owner>/<repo>', otherwise just package_name" # rubocop:disable Layout/LineLength
+    c.flag %i[branch], desc: 'Repository branch', default_value: defaults[:branch]
+    c.flag %i[token], desc: 'Token', default_value: defaults[:token]
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :owner, :repo, :branch, :token, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      package = Getv::Package::GitHub::Commit.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  desc 'Get package versions from GitHub releases'
+  arg_name 'package_name'
+  command :github_release do |c|
+    defaults = (Getv::Package::GitHub::Release.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.switch %i[invalid_versions], desc: 'Include invalid semantic versions', negatable: false, default_value: false
+    c.flag %i[semantic_select], desc: 'Semantic version selection (comma delimited)',
+                                default_value: defaults[:semantic_select]
+    c.flag %i[owner], desc: 'Repository owner',
+                      default_value: "'<owner>' if package_name is in format '<owner>/<repo>', otherwise just package_name" # rubocop:disable Layout/LineLength
+    c.flag %i[repo], desc: 'Repository name',
+                     default_value: "'<repo>' if package_name is in format '<owner>/<repo>', otherwise just package_name" # rubocop:disable Layout/LineLength
+    c.flag %i[token], desc: 'Token', default_value: defaults[:token]
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :semantic_only, :semantic_select, :owner, :repo,
+                        :token, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      opts[:semantic_only] = !options[:invalid_versions]
+      opts[:semantic_select] = opts[:semantic_select].split(',') unless opts.fetch(:semantic_select, nil).nil?
+      package = Getv::Package::GitHub::Release.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  desc 'Get package versions from GitHub tags'
+  arg_name 'package_name'
+  command :github_tag do |c|
+    defaults = (Getv::Package::GitHub::Tag.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.switch %i[invalid_versions], desc: 'Include invalid semantic versions', negatable: false, default_value: false
+    c.flag %i[semantic_select], desc: 'Semantic version selection (comma delimited)',
+                                default_value: defaults[:semantic_select]
+    c.flag %i[owner], desc: 'Repository owner',
+                      default_value: "'<owner>' if package_name is in format '<owner>/<repo>', otherwise just package_name" # rubocop:disable Layout/LineLength
+    c.flag %i[repo], desc: 'Repository name',
+                     default_value: "'<repo>' if package_name is in format '<owner>/<repo>', otherwise just package_name" # rubocop:disable Layout/LineLength
+    c.flag %i[token], desc: 'Token', default_value: defaults[:token]
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :semantic_only, :semantic_select, :owner, :repo,
+                        :token, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      opts[:semantic_only] = !options[:invalid_versions]
+      opts[:semantic_select] = opts[:semantic_select].split(',') unless opts.fetch(:semantic_select, nil).nil?
+      package = Getv::Package::GitHub::Tag.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  desc 'Get package versions from a Helm chart repository'
+  arg_name 'package_name'
+  command :helm do |c|
+    defaults = (Getv::Package::Helm.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.switch %i[invalid_versions], desc: 'Include invalid semantic versions', negatable: false, default_value: false
+    c.flag %i[semantic_select], desc: 'Semantic version selection (comma delimited)',
+                                default_value: defaults[:semantic_select]
+    c.flag %i[chart], desc: 'Chart name', default_value: 'package_name'
+    c.flag %i[url], desc: 'URL', default_value: defaults[:url]
+    c.flag %i[user], desc: 'Username', default_value: defaults[:user]
+    c.flag %i[password], desc: 'Password', default_value: defaults[:password]
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :semantic_only, :semantic_select, :chart, :url,
+                        :user, :password, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      opts[:semantic_only] = !options[:invalid_versions]
+      opts[:semantic_select] = opts[:semantic_select].split(',') unless opts.fetch(:semantic_select, nil).nil?
+      package = Getv::Package::Helm.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  desc 'Get package versions from XML file URL'
+  arg_name 'package_name'
+  command :xml do |c|
+    defaults = (Getv::Package::Xml.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.switch %i[invalid_versions], desc: 'Include invalid semantic versions', negatable: false, default_value: false
+    c.flag %i[semantic_select], desc: 'Semantic version selection (comma delimited)',
+                                default_value: defaults[:semantic_select]
+    c.flag %i[url], desc: 'URL', default_value: defaults[:url]
+    c.flag %i[xpath], desc: 'XPath', default_value: defaults[:xpath]
+    c.switch %i[link_value], desc: 'Use the value (target) of links rather than the content (display text)',
+                             negatable: false, default_value: false
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :semantic_only, :semantic_select, :url, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      opts[:link] == 'value' if options[:link_value]
+      opts[:semantic_only] = !options[:invalid_versions]
+      opts[:semantic_select] = opts[:semantic_select].split(',') unless opts.fetch(:semantic_select, nil).nil?
+      package = Getv::Package::Xml.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  desc 'Get package versions from npm at registry.npmjs.org'
+  arg_name 'package_name'
+  command :npm do |c|
+    defaults = (Getv::Package::Npm.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.switch %i[invalid_versions], desc: 'Include invalid semantic versions', negatable: false, default_value: false
+    c.flag %i[semantic_select], desc: 'Semantic version selection (comma delimited)',
+                                default_value: defaults[:semantic_select]
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :semantic_only, :semantic_select, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      opts[:semantic_only] = !options[:invalid_versions]
+      opts[:semantic_select] = opts[:semantic_select].split(',') unless opts.fetch(:semantic_select, nil).nil?
+      package = Getv::Package::Npm.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  desc 'Get package versions from the Python Package Index at pypi.org'
+  arg_name 'package_name'
+  command :pypi do |c|
+    defaults = (Getv::Package::Pypi.new 'name').opts
+    c.flag %i[select_search], desc: 'Regex version selection search', default_value: defaults[:select_search]
+    c.flag %i[select_replace], desc: 'Regex version selection replace', default_value: defaults[:select_replace]
+    c.flag %i[reject], desc: 'Regex version rejection', default_value: defaults[:reject]
+    c.switch %i[invalid_versions], desc: 'Include invalid semantic versions', negatable: false, default_value: false
+    c.flag %i[semantic_select], desc: 'Semantic version selection (comma delimited)',
+                                default_value: defaults[:semantic_select]
+    c.action do |global_options, options, args|
+      help_now! unless args.size == 1
+
+      opts = global_options.merge(options)
+      opts = opts.slice :select_search, :select_replace, :reject, :semantic_only, :semantic_select, :proxy
+      opts = opts.delete_if { |k, v| v.nil? || v == c.flags[k].default_value }
+      opts[:semantic_only] = !options[:invalid_versions]
+      opts[:semantic_select] = opts[:semantic_select].split(',') unless opts.fetch(:semantic_select, nil).nil?
+      package = Getv::Package::Pypi.new args[0], opts
+      Getv::Cli.output(package, latest: global_options[:latest], json: global_options[:json])
+    end
+  end
+
+  pre do |_global, _command, _options, _args|
+    # Pre logic here
+    # Return true to proceed; false to abort and not call the
+    # chosen command
+    # Use skips_pre before a command to skip this block
+    # on that command only
+    true
+  end
+
+  post do |global, command, options, args|
+    # Post logic here
+    # Use skips_post before a command to skip this
+    # block on that command only
+  end
+
+  on_error do |_exception|
+    # Error logic here
+    # return false to skip default error handling
+    true
+  end
+end
+
+exit App.run(ARGV)

data/lib/getv/package/docker.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    # Getv::Package::Docker class
+    class Docker < Package
+      def initialize(name, opts = {}, no_owner_domains = [])
+        @no_owner_domains = no_owner_domains
+        opts = defaults.merge(opts)
+        opts = { user: nil, password: nil, auto_paginate: true }.merge(opts)
+        opts = docker_defaults(name).merge(opts)
+        super name, opts
+      end
+
+      private
+
+      def docker_defaults(name)
+        case name.count('/')
+        when 0
+          { owner: 'library', repo: name, url: 'https://registry.hub.docker.com' }
+        when 1
+          if @no_owner_domains.include?(name.split('/')[0])
+            { owner: '', repo: name.split('/')[1],
+              url: "https://#{name.split('/')[0]}" }
+          else
+            { owner: name.split('/')[0], repo: name.split('/')[1],
+              url: 'https://registry.hub.docker.com' }
+          end
+        else
+          { owner: name.split('/')[1], repo: name.split('/')[2..].join('/'),
+            url: "https://#{name.split('/')[0]}" }
+        end
+      end
+
+      def docker_opts
+        d_opts = {}
+        d_opts[:http_options] = { proxy: opts[:proxy] } unless opts[:proxy].nil?
+        if opts[:user] && opts[:password]
+          d_opts[:user] = opts[:user]
+          d_opts[:password] = opts[:password]
+        end
+        d_opts
+      end
+
+      def retrieve_versions # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
+        require 'docker_registry2'
+        retries ||= 0
+        docker = DockerRegistry2.connect(opts[:url], docker_opts)
+        full_name = if opts[:owner].empty?
+                      opts[:repo]
+                    else
+                      "#{opts[:owner]}/#{opts[:repo]}"
+                    end
+        docker.tags(full_name, auto_paginate: opts[:auto_paginate])['tags'] || []
+      rescue DockerRegistry2::NotFound
+        []
+      rescue StandardError => e
+        if (retries += 1) < 4
+          retry
+        else
+          puts "Error fetching tags for docker image #{opts[:url]}/#{opts[:owner]}/#{opts[:repo]}:"
+          puts e.message
+        end
+      end
+    end
+  end
+end

data/lib/getv/package/gem.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    # Getv::Package::Gem class
+    class Gem < Package
+      def initialize(name, opts = {})
+        opts = defaults.merge(opts)
+        opts = { gem: name[/ruby(gem)?-(.*)/, 2] || name }.merge(opts)
+        super name, opts
+      end
+
+      private
+
+      def retrieve_versions
+        require 'json'
+        retries ||= 0
+        JSON.parse(get("https://rubygems.org/api/v1/versions/#{opts[:gem]}.json")).map do |v|
+          v['number']
+        end
+      rescue StandardError
+        retry if (retries += 1) < 4
+      end
+    end
+  end
+end

data/lib/getv/package/github/commit.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    class GitHub
+      # Getv::Package::GitHub::Commit class
+      class Commit < Package::GitHub
+        def initialize(name, opts = {})
+          opts = {
+            branch: 'master',
+            select_search: '^((\d{8})(\d{6}),(([a-z\d]{7})(.*)))$',
+            semantic_only: false
+          }.merge(opts)
+          opts = defaults.merge(opts)
+          opts = github_defaults(name).merge(opts)
+          super name, opts
+        end
+
+        private
+
+        def retrieve_versions # rubocop:disable Metrics/AbcSize
+          retries ||= 0
+          github.commits("#{opts[:owner]}/#{opts[:repo]}", opts[:branch]).map do |c|
+            "#{DateTime.parse(c[:commit][:author][:date].to_s).strftime('%Y%m%d%H%M%S')},#{c[:sha]}"
+          end
+        rescue StandardError
+          retry if (retries += 1) < 4
+        end
+      end
+    end
+  end
+end

data/lib/getv/package/github/release.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    class GitHub
+      # Getv::Package::GitHub::Release class
+      class Release < Package::GitHub
+        def initialize(name, opts = {})
+          opts = defaults.merge(opts)
+          opts = github_defaults(name).merge(opts)
+          super name, opts
+        end
+
+        private
+
+        def retrieve_versions
+          retries ||= 0
+          github.releases("#{opts[:owner]}/#{opts[:repo]}").map(&:tag_name)
+        rescue StandardError
+          retry if (retries += 1) < 4
+        end
+      end
+    end
+  end
+end

data/lib/getv/package/github/tag.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    class GitHub
+      # Getv::Package::GitHub::Tag class
+      class Tag < Package::GitHub
+        def initialize(name, opts = {})
+          opts = defaults.merge(opts)
+          opts = github_defaults(name).merge(opts)
+          super name, opts
+        end
+
+        private
+
+        def retrieve_versions
+          retries ||= 0
+          github.tags("#{opts[:owner]}/#{opts[:repo]}").map { |t| t[:name] }
+        rescue StandardError
+          retry if (retries += 1) < 4
+        end
+      end
+    end
+  end
+end

data/lib/getv/package/github.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    # Getv::Package::GitHub class
+    class GitHub < Package
+      def initialize(name, opts = {})
+        super name, opts
+      end
+
+      private
+
+      def github_defaults(name)
+        case name.count('/')
+        when 1
+          { owner: name.split('/')[0], repo: name.split('/')[1], token: nil }
+        else
+          { owner: name, repo: name, token: nil }
+        end
+      end
+
+      def github # rubocop:disable Metrics/MethodLength
+        require 'octokit'
+        if opts[:token]
+          github = Octokit::Client.new(access_token: opts[:token])
+          user = github.user
+          user.login
+        else
+          github = Octokit::Client.new
+        end
+        github.auto_paginate = true
+        github.proxy = opts[:proxy]
+        github
+      end
+    end
+  end
+end

data/lib/getv/package/helm.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    # Getv::Package::Helm class
+    class Helm < Package
+      def initialize(name, opts = {})
+        opts = defaults.merge(opts)
+        opts = { chart: name, url: nil, user: nil, password: nil }.merge(opts)
+        super name, opts
+      end
+
+      private
+
+      def retrieve_versions
+        require 'yaml'
+        retries ||= 0
+        YAML.safe_load(get("#{opts[:url]}/index.yaml")).fetch('entries', {}).fetch(opts[:chart], []).map do |e|
+          e['version']
+        end
+      rescue StandardError
+        retry if (retries += 1) < 4
+      end
+    end
+  end
+end

data/lib/getv/package/npm.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    # Getv::Package::Npm class
+    class Npm < Package
+      def initialize(name, opts = {})
+        opts = defaults.merge(opts)
+        opts = { npm: name[/node(js)?-(.*)/, 2] || name }.merge(opts)
+        super name, opts
+      end
+
+      private
+
+      def retrieve_versions
+        require 'json'
+        retries ||= 0
+        JSON.parse(get("https://registry.npmjs.org/#{opts[:npm]}"))['versions'].keys
+      rescue StandardError
+        retry if (retries += 1) < 4
+      end
+    end
+  end
+end

data/lib/getv/package/pypi.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    # Getv::Package::Pypi class
+    class Pypi < Package
+      def initialize(name, opts = {})
+        opts = defaults.merge(opts)
+        opts = { pypi: name[/python.*-(.*)/, 1] || name }.merge(opts)
+        super name, opts
+      end
+
+      private
+
+      def retrieve_versions
+        require 'json'
+        retries ||= 0
+        JSON.parse(get("https://pypi.org/pypi/#{opts[:pypi]}/json"))['releases'].keys
+      rescue StandardError
+        retry if (retries += 1) < 4
+      end
+    end
+  end
+end

data/lib/getv/package/text.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    # Getv::Package::Text class
+    class Text < Package
+      def initialize(name, opts = {})
+        opts = defaults.merge(opts)
+        opts = { url: nil, user: nil, password: nil }.merge(opts)
+        super name, opts
+      end
+
+      private
+
+      def retrieve_versions
+        retries ||= 0
+        get(opts[:url]).split("\n")
+      rescue StandardError
+        retry if (retries += 1) < 4
+      end
+    end
+  end
+end

data/lib/getv/package/xml.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Getv
+  class Package
+    # Getv::Package::Xml class
+    class Xml < Package
+      def initialize(name, opts = {})
+        opts = defaults.merge(opts)
+        opts = { url: nil, user: nil, password: nil, xpath: '//a/@href' }.merge(opts)
+        super name, opts
+      end
+
+      private
+
+      def retrieve_versions
+        retries ||= 0
+        require 'nokogiri'
+        Nokogiri::XML(get(opts[:url])).xpath(opts[:xpath]).map(&:text)
+      rescue StandardError
+        retry if (retries += 1) < 4
+      end
+    end
+  end
+end

data/lib/getv/package.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Getv
+  # Getv::Package class
+  class Package
+    attr_accessor :name, :opts
+
+    def self.create(name, opts = {})
+      if opts.fetch(:type, nil).nil?
+        opts.delete(:type)
+        create_using_name(name, opts)
+      else
+        type = opts[:type]
+        opts.delete(:type)
+        type_to_class(type).new name, opts
+      end
+    end
+
+    private_class_method def self.create_using_name(name, opts)
+      case name
+      when /ruby(gem)?-.*/
+        Getv::Package::Gem.new name, opts
+      when /node(js)?-.*/
+        Getv::Package::Npm.new name, opts
+      when /python.*-.*/
+        Getv::Package::Pypi.new name, opts
+      else
+        Getv::Package::GitHub::Release.new name, opts
+      end
+    end
+
+    private_class_method def self.type_to_class(type)
+      sections = type.split(/_|::| |-|:/)
+      sections.each(&:capitalize!)
+      sections.each { |section| section.sub! 'Github', 'GitHub' }
+      type = sections.join '::'
+      Object.const_get("Getv::Package::#{type}")
+    end
+
+    def initialize(name, opts = {})
+      @name = name
+      @opts = opts
+    end
+
+    def defaults # rubocop:disable Metrics/MethodLength
+      {
+        select_search: '^\s*v?(.*)\s*$',
+        select_replace: '\1',
+        reject: nil,
+        semantic_only: true,
+        semantic_prefix: nil,
+        semantic_select: ['*'],
+        proxy: nil,
+        versions: nil,
+        latest_version: nil
+      }
+    end
+
+    def latest_version
+      update_versions if opts[:latest_version].nil?
+      opts[:latest_version]
+    end
+
+    def versions
+      update_versions if opts[:versions].nil?
+      opts[:versions]
+    end
+
+    def update_versions # rubocop:disable Metrics/PerceivedComplexity,Metrics/MethodLength,Metrics/CyclomaticComplexity,Metrics/AbcSize
+      versions = retrieve_versions || []
+      versions.sort! if instance_of?(Getv::Package::GitHub::Commit)
+      select_pattern = Regexp.new(opts[:select_search])
+      versions.select! { |v| v =~ select_pattern }
+      versions.map! { |v| v.sub(select_pattern, opts[:select_replace]) }
+      versions.reject! { |v| v =~ Regexp.new(opts[:reject]) } unless opts[:reject].nil?
+
+      if opts[:semantic_only]
+        require 'semantic'
+        require 'semantic/core_ext'
+
+        # remove non semantic version tags
+        versions.select! do |v|
+          v.sub(/^#{opts[:semantic_prefix]}/, '').is_version? && v.start_with?(opts[:semantic_prefix].to_s)
+        end
+
+        opts[:semantic_select].each do |comparator|
+          versions.select! do |v|
+            Semantic::Version.new(v.sub(/^#{opts[:semantic_prefix]}/, '')).satisfies?(comparator)
+          end
+        end
+        versions.sort_by! { |v| Semantic::Version.new(v.sub(/^#{opts[:semantic_prefix]}/, '')) }
+      else
+        versions.sort! unless instance_of?(Getv::Package::GitHub::Commit)
+      end
+      opts[:versions] = versions.uniq
+      opts[:latest_version] = opts[:versions][-1] unless opts[:versions].empty?
+    end
+
+    private
+
+    def get(url) # rubocop:disable Metrics/AbcSize
+      require 'rest-client'
+      if opts[:user] && opts[:password]
+        RestClient::Request.execute(method: :get, url: url, proxy: opts[:proxy], user: opts[:user],
+                                    password: opts[:password]).body
+      else
+        RestClient::Request.execute(method: :get, url: url, proxy: opts[:proxy]).body
+      end
+    end
+  end
+end

data/lib/getv/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Getv
+  VERSION = '2.3.0'
+end

data/lib/getv.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'getv/version'
+require 'getv/package'
+require 'getv/package/docker'
+require 'getv/package/gem'
+require 'getv/package/github'
+require 'getv/package/github/commit'
+require 'getv/package/github/release'
+require 'getv/package/github/tag'
+require 'getv/package/helm'
+require 'getv/package/npm'
+require 'getv/package/pypi'
+require 'getv/package/text'
+require 'getv/package/xml'
+
+module Getv
+  class Error < StandardError; end
+  # Your code goes here...
+end

metadata

@@ -0,0 +1,184 @@
+--- !ruby/object:Gem::Specification
+name: getv-rs
+version: !ruby/object:Gem::Version
+  version: 2.3.0
+platform: ruby
+authors:
+- ryan-scheinberg
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2023-09-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.20.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.20.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: docker_registry2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.10.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.10.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: semantic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+description: Pull package version numbers from the web in various ways.
+email:
+- ryan.scheinberg@gmail.com
+executables:
+- getv
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- exe/getv
+- lib/getv.rb
+- lib/getv/package.rb
+- lib/getv/package/docker.rb
+- lib/getv/package/gem.rb
+- lib/getv/package/github.rb
+- lib/getv/package/github/commit.rb
+- lib/getv/package/github/release.rb
+- lib/getv/package/github/tag.rb
+- lib/getv/package/helm.rb
+- lib/getv/package/npm.rb
+- lib/getv/package/pypi.rb
+- lib/getv/package/text.rb
+- lib/getv/package/xml.rb
+- lib/getv/version.rb
+homepage: https://github.com/ryan-scheinberg/getv
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ryan-scheinberg/getv
+  source_code_uri: https://github.com/ryan-scheinberg/getv
+  changelog_uri: https://github.com/ryan-scheinberg/getv
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Pull package version numbers from the web in various ways.
+test_files: []