@shopify/cli-kit 3.39.0 → 3.40.0

package/assets/cli-ruby/vendor/deps/webrick/lib/webrick.rb

@@ -0,0 +1,232 @@
+# frozen_string_literal: false
+##
+# = WEB server toolkit.
+#
+# WEBrick is an HTTP server toolkit that can be configured as an HTTPS server,
+# a proxy server, and a virtual-host server.  WEBrick features complete
+# logging of both server operations and HTTP access.  WEBrick supports both
+# basic and digest authentication in addition to algorithms not in RFC 2617.
+#
+# A WEBrick server can be composed of multiple WEBrick servers or servlets to
+# provide differing behavior on a per-host or per-path basis.  WEBrick
+# includes servlets for handling CGI scripts, ERB pages, Ruby blocks and
+# directory listings.
+#
+# WEBrick also includes tools for daemonizing a process and starting a process
+# at a higher privilege level and dropping permissions.
+#
+# == Security
+#
+# *Warning:* WEBrick is not recommended for production.  It only implements
+# basic security checks.
+#
+# == Starting an HTTP server
+#
+# To create a new WEBrick::HTTPServer that will listen to connections on port
+# 8000 and serve documents from the current user's public_html folder:
+#
+#   require 'webrick'
+#
+#   root = File.expand_path '~/public_html'
+#   server = WEBrick::HTTPServer.new :Port => 8000, :DocumentRoot => root
+#
+# To run the server you will need to provide a suitable shutdown hook as
+# starting the server blocks the current thread:
+#
+#   trap 'INT' do server.shutdown end
+#
+#   server.start
+#
+# == Custom Behavior
+#
+# The easiest way to have a server perform custom operations is through
+# WEBrick::HTTPServer#mount_proc.  The block given will be called with a
+# WEBrick::HTTPRequest with request info and a WEBrick::HTTPResponse which
+# must be filled in appropriately:
+#
+#   server.mount_proc '/' do |req, res|
+#     res.body = 'Hello, world!'
+#   end
+#
+# Remember that +server.mount_proc+ must precede +server.start+.
+#
+# == Servlets
+#
+# Advanced custom behavior can be obtained through mounting a subclass of
+# WEBrick::HTTPServlet::AbstractServlet.  Servlets provide more modularity
+# when writing an HTTP server than mount_proc allows.  Here is a simple
+# servlet:
+#
+#   class Simple < WEBrick::HTTPServlet::AbstractServlet
+#     def do_GET request, response
+#       status, content_type, body = do_stuff_with request
+#
+#       response.status = 200
+#       response['Content-Type'] = 'text/plain'
+#       response.body = 'Hello, World!'
+#     end
+#   end
+#
+# To initialize the servlet you mount it on the server:
+#
+#   server.mount '/simple', Simple
+#
+# See WEBrick::HTTPServlet::AbstractServlet for more details.
+#
+# == Virtual Hosts
+#
+# A server can act as a virtual host for multiple host names.  After creating
+# the listening host, additional hosts that do not listen can be created and
+# attached as virtual hosts:
+#
+#   server = WEBrick::HTTPServer.new # ...
+#
+#   vhost = WEBrick::HTTPServer.new :ServerName => 'vhost.example',
+#                                   :DoNotListen => true, # ...
+#   vhost.mount '/', ...
+#
+#   server.virtual_host vhost
+#
+# If no +:DocumentRoot+ is provided and no servlets or procs are mounted on the
+# main server it will return 404 for all URLs.
+#
+# == HTTPS
+#
+# To create an HTTPS server you only need to enable SSL and provide an SSL
+# certificate name:
+#
+#   require 'webrick'
+#   require 'webrick/https'
+#
+#   cert_name = [
+#     %w[CN localhost],
+#   ]
+#
+#   server = WEBrick::HTTPServer.new(:Port => 8000,
+#                                    :SSLEnable => true,
+#                                    :SSLCertName => cert_name)
+#
+# This will start the server with a self-generated self-signed certificate.
+# The certificate will be changed every time the server is restarted.
+#
+# To create a server with a pre-determined key and certificate you can provide
+# them:
+#
+#   require 'webrick'
+#   require 'webrick/https'
+#   require 'openssl'
+#
+#   cert = OpenSSL::X509::Certificate.new File.read '/path/to/cert.pem'
+#   pkey = OpenSSL::PKey::RSA.new File.read '/path/to/pkey.pem'
+#
+#   server = WEBrick::HTTPServer.new(:Port => 8000,
+#                                    :SSLEnable => true,
+#                                    :SSLCertificate => cert,
+#                                    :SSLPrivateKey => pkey)
+#
+# == Proxy Server
+#
+# WEBrick can act as a proxy server:
+#
+#   require 'webrick'
+#   require 'webrick/httpproxy'
+#
+#   proxy = WEBrick::HTTPProxyServer.new :Port => 8000
+#
+#   trap 'INT' do proxy.shutdown end
+#
+# See WEBrick::HTTPProxy for further details including modifying proxied
+# responses.
+#
+# == Basic and Digest authentication
+#
+# WEBrick provides both Basic and Digest authentication for regular and proxy
+# servers.  See WEBrick::HTTPAuth, WEBrick::HTTPAuth::BasicAuth and
+# WEBrick::HTTPAuth::DigestAuth.
+#
+# == WEBrick as a daemonized Web Server
+#
+# WEBrick can be run as a daemonized server for small loads.
+#
+# === Daemonizing
+#
+# To start a WEBrick server as a daemon simple run WEBrick::Daemon.start
+# before starting the server.
+#
+# === Dropping Permissions
+#
+# WEBrick can be started as one user to gain permission to bind to port 80 or
+# 443 for serving HTTP or HTTPS traffic then can drop these permissions for
+# regular operation.  To listen on all interfaces for HTTP traffic:
+#
+#   sockets = WEBrick::Utils.create_listeners nil, 80
+#
+# Then drop privileges:
+#
+#   WEBrick::Utils.su 'www'
+#
+# Then create a server that does not listen by default:
+#
+#   server = WEBrick::HTTPServer.new :DoNotListen => true, # ...
+#
+# Then overwrite the listening sockets with the port 80 sockets:
+#
+#   server.listeners.replace sockets
+#
+# === Logging
+#
+# WEBrick can separately log server operations and end-user access.  For
+# server operations:
+#
+#   log_file = File.open '/var/log/webrick.log', 'a+'
+#   log = WEBrick::Log.new log_file
+#
+# For user access logging:
+#
+#   access_log = [
+#     [log_file, WEBrick::AccessLog::COMBINED_LOG_FORMAT],
+#   ]
+#
+#   server = WEBrick::HTTPServer.new :Logger => log, :AccessLog => access_log
+#
+# See WEBrick::AccessLog for further log formats.
+#
+# === Log Rotation
+#
+# To rotate logs in WEBrick on a HUP signal (like syslogd can send), open the
+# log file in 'a+' mode (as above) and trap 'HUP' to reopen the log file:
+#
+#   trap 'HUP' do log_file.reopen '/path/to/webrick.log', 'a+'
+#
+# == Copyright
+#
+# Author: IPR -- Internet Programming with Ruby -- writers
+#
+# Copyright (c) 2000 TAKAHASHI Masayoshi, GOTOU YUUZOU
+# Copyright (c) 2002 Internet Programming with Ruby writers. All rights
+# reserved.
+#--
+# $IPR: webrick.rb,v 1.12 2002/10/01 17:16:31 gotoyuzo Exp $
+
+module WEBrick
+end
+
+require 'webrick/compat.rb'
+
+require 'webrick/version.rb'
+require 'webrick/config.rb'
+require 'webrick/log.rb'
+require 'webrick/server.rb'
+require_relative 'webrick/utils.rb'
+require 'webrick/accesslog'
+
+require 'webrick/htmlutils.rb'
+require 'webrick/httputils.rb'
+require 'webrick/cookie.rb'
+require 'webrick/httpversion.rb'
+require 'webrick/httpstatus.rb'
+require 'webrick/httprequest.rb'
+require 'webrick/httpresponse.rb'
+require 'webrick/httpserver.rb'
+require 'webrick/httpservlet.rb'
+require 'webrick/httpauth.rb'

package/assets/cli-ruby/vendor/deps/webrick/webrick.gemspec

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+begin
+  require_relative 'lib/webrick/version'
+rescue LoadError
+  # for Ruby core repository
+  require_relative 'version'
+end
+
+Gem::Specification.new do |s|
+  s.name = "webrick"
+  s.version = WEBrick::VERSION
+  s.summary = "HTTP server toolkit"
+  s.description = "WEBrick is an HTTP server toolkit that can be configured as an HTTPS server, a proxy server, and a virtual-host server."
+
+  s.require_path = %w{lib}
+  s.files =  [
+    "Gemfile",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "bin/console",
+    "bin/setup",
+    "lib/webrick.rb",
+    "lib/webrick/accesslog.rb",
+    "lib/webrick/cgi.rb",
+    "lib/webrick/compat.rb",
+    "lib/webrick/config.rb",
+    "lib/webrick/cookie.rb",
+    "lib/webrick/htmlutils.rb",
+    "lib/webrick/httpauth.rb",
+    "lib/webrick/httpauth/authenticator.rb",
+    "lib/webrick/httpauth/basicauth.rb",
+    "lib/webrick/httpauth/digestauth.rb",
+    "lib/webrick/httpauth/htdigest.rb",
+    "lib/webrick/httpauth/htgroup.rb",
+    "lib/webrick/httpauth/htpasswd.rb",
+    "lib/webrick/httpauth/userdb.rb",
+    "lib/webrick/httpproxy.rb",
+    "lib/webrick/httprequest.rb",
+    "lib/webrick/httpresponse.rb",
+    "lib/webrick/https.rb",
+    "lib/webrick/httpserver.rb",
+    "lib/webrick/httpservlet.rb",
+    "lib/webrick/httpservlet/abstract.rb",
+    "lib/webrick/httpservlet/cgi_runner.rb",
+    "lib/webrick/httpservlet/cgihandler.rb",
+    "lib/webrick/httpservlet/erbhandler.rb",
+    "lib/webrick/httpservlet/filehandler.rb",
+    "lib/webrick/httpservlet/prochandler.rb",
+    "lib/webrick/httpstatus.rb",
+    "lib/webrick/httputils.rb",
+    "lib/webrick/httpversion.rb",
+    "lib/webrick/log.rb",
+    "lib/webrick/server.rb",
+    "lib/webrick/ssl.rb",
+    "lib/webrick/utils.rb",
+    "lib/webrick/version.rb",
+    "webrick.gemspec",
+  ]
+  s.required_ruby_version = ">= 2.3.0"
+
+  s.authors = ["TAKAHASHI Masayoshi", "GOTOU YUUZOU", "Eric Wong"]
+  s.email = [nil, nil, 'normal@ruby-lang.org']
+  s.homepage = "https://github.com/ruby/webrick"
+  s.licenses = ["Ruby", "BSD-2-Clause"]
+
+  if s.respond_to?(:metadata=)
+    s.metadata = {
+      "bug_tracker_uri" => "https://github.com/ruby/webrick/issues",
+    }
+  end
+
+  s.add_development_dependency "rake"
+end

package/assets/cli-ruby/vendor/gen/lib/gen/commands/help.rb

@@ -0,0 +1,20 @@
+require 'gen'
+
+module Gen
+  module Commands
+    class Help < Gen::Command
+      def call(_args, _name)
+        puts CLI::UI.fmt("{{bold:Available commands}}")
+        puts ""
+
+        Gen::Commands::Registry.resolved_commands.each do |name, klass|
+          puts CLI::UI.fmt("{{command:#{Gen::TOOL_NAME} #{name}}}")
+          if klass.respond_to?(:help) && (help = klass.help)
+            puts CLI::UI.fmt(help)
+          end
+          puts ""
+        end
+      end
+    end
+  end
+end

package/assets/cli-ruby/vendor/gen/lib/gen/commands/new.rb

@@ -0,0 +1,21 @@
+require 'gen'
+
+module Gen
+  module Commands
+    class New < Gen::Command
+      def call(args, _name)
+        unless args.size == 1
+          puts CLI::UI.fmt(self.class.help)
+          raise(CLI::Kit::AbortSilent)
+        end
+        project = args.first
+
+        Gen::Generator.run(project)
+      end
+
+      def self.help
+        "Generate a new cli-kit project.\nUsage: {{command:#{Gen::TOOL_NAME} new <name>}}"
+      end
+    end
+  end
+end

package/assets/cli-ruby/vendor/gen/lib/gen/commands.rb

@@ -0,0 +1,18 @@
+require 'gen'
+
+module Gen
+  module Commands
+    Registry = CLI::Kit::CommandRegistry.new(
+      default: 'help',
+      contextual_resolver: nil
+    )
+
+    def self.register(const, cmd, path)
+      autoload(const, path)
+      Registry.add(->() { const_get(const) }, cmd)
+    end
+
+    register :Help, 'help', 'gen/commands/help'
+    register :New,  'new',  'gen/commands/new'
+  end
+end

package/assets/cli-ruby/vendor/gen/lib/gen/entry_point.rb

@@ -0,0 +1,10 @@
+require 'gen'
+
+module Gen
+  module EntryPoint
+    def self.call(args)
+      cmd, command_name, args = Gen::Resolver.call(args)
+      Gen::Executor.call(cmd, command_name, args)
+    end
+  end
+end

package/assets/cli-ruby/vendor/gen/lib/gen/generator.rb

@@ -0,0 +1,165 @@
+require 'gen'
+require 'fileutils'
+require 'open3'
+require 'pathname'
+require 'tmpdir'
+
+module Gen
+  class Generator
+    def self.run(project_name)
+      new(project_name).run
+    end
+
+    TEMPLATE_ROOT = File.expand_path('gen/template', Gen::ROOT)
+
+    VALID_PROJECT_NAME = /\A[a-z][a-z0-9]*\z/
+    private_constant :VALID_PROJECT_NAME
+
+    # false  -> delete file
+    # string -> rename file before applying template substitutions
+    VENDOR_TRANSLATIONS = {
+      'Gemfile' => false,
+      'exe/__app__-gems' => false,
+      'exe/__app__-vendor' => 'exe/__app__',
+      'dev-gems.yml' => false,
+      'dev-vendor.yml' => 'dev.yml',
+    }.freeze
+    private_constant :VENDOR_TRANSLATIONS
+
+    BUNDLER_TRANSLATIONS = {
+      'bin/update-deps' => false,
+      'exe/__app__-gems' => 'exe/__app__',
+      'exe/__app__-vendor' => false,
+      'dev-gems.yml' => 'dev.yml',
+      'dev-vendor.yml' => false,
+    }.freeze
+    private_constant :BUNDLER_TRANSLATIONS
+
+    def initialize(project_name)
+      raise(
+        CLI::Kit::Abort,
+        "project name must match {{bold:#{VALID_PROJECT_NAME}}} (but can be changed later)"
+      ) unless project_name =~ VALID_PROJECT_NAME
+      @project_name = project_name
+      @title_case_project_name = @project_name.sub(/^./, &:upcase)
+    end
+
+    def run
+      vendor = ask_vendor?
+      create_project_dir
+      if vendor
+        copy_files(translations: VENDOR_TRANSLATIONS)
+        update_deps
+      else
+        copy_files(translations: BUNDLER_TRANSLATIONS)
+      end
+    end
+
+    private
+
+    def ask_vendor?
+      return 'vendor' if ENV['DEPS'] == 'vendor'
+      return 'bundler' if ENV['DEPS'] == 'bundler'
+
+      vendor = nil
+      CLI::UI::Frame.open('Configuration') do
+        q = 'How would you like the application to consume {{command:cli-kit}} and {{command:cli-ui}}?'
+        vendor = CLI::UI::Prompt.ask(q) do |c|
+          c.option('Vendor  {{italic:(faster execution, more difficult to update deps)}}') { 'vendor' }
+          c.option('Bundler {{italic:(slower execution, easier dep management)}}') { 'bundler' }
+        end
+      end
+      vendor == 'vendor'
+    end
+
+    def create_project_dir
+      info(create: '')
+      FileUtils.mkdir(@project_name)
+    rescue Errno::EEXIST
+      error("directory already exists: #{@project_name}")
+    end
+
+    def copy_files(translations:)
+      each_template_file do |source_name|
+        target_name = translations.fetch(source_name, source_name)
+        next if target_name == false
+        target_name = apply_template_variables(target_name)
+
+        source = File.join(TEMPLATE_ROOT, source_name)
+        target = File.join(@project_name, target_name)
+
+        info(create: target_name)
+
+        if Dir.exist?(source)
+          FileUtils.mkdir(target)
+        else
+          content = apply_template_variables(File.read(source))
+          File.write(target, content)
+        end
+        File.chmod(File.stat(source).mode, target)
+      end
+    end
+
+    def update_deps
+      Dir.mktmpdir do |tmp|
+        clone(tmp, 'cli-ui')
+        clone(tmp, 'cli-kit')
+        info(run: 'bin/update-deps')
+        Dir.chdir(@project_name) do
+          system({ 'SOURCE_ROOT' => tmp }, 'bin/update-deps')
+        end
+      end
+    end
+
+    def clone(dir, repo)
+      info(clone: repo)
+      out, stat = Open3.capture2e('git', '-C', dir, 'clone', "https://github.com/shopify/#{repo}")
+      unless stat.success?
+        STDERR.puts(out)
+        error("git clone failed")
+      end
+    end
+
+    def each_template_file
+      return enum_for(:each_template_file) unless block_given?
+
+      root = Pathname.new(TEMPLATE_ROOT)
+      Dir.glob("#{TEMPLATE_ROOT}/**/*").each do |f|
+        el = Pathname.new(f)
+        yield(el.relative_path_from(root).to_s)
+      end
+    end
+
+    def apply_template_variables(s)
+      s
+        .gsub(/__app__/, @project_name)
+        .gsub(/__App__/, @title_case_project_name)
+        .gsub(/__cli-kit-version__/, cli_kit_version)
+        .gsub(/__cli-ui-version__/, cli_ui_version)
+    end
+
+    def cli_kit_version
+      require 'cli/kit/version'
+      CLI::Kit::VERSION.to_s
+    end
+
+    def cli_ui_version
+      require 'cli/ui/version'
+      CLI::UI::VERSION.to_s
+    end
+
+    def info(create: nil, clone: nil, run: nil)
+      if clone
+        puts(CLI::UI.fmt("\t{{bold:{{yellow:clone}}\t#{clone}}}"))
+      elsif create
+        puts(CLI::UI.fmt("\t{{bold:{{blue:create}}\t#{create}}}"))
+      elsif run
+        puts(CLI::UI.fmt("\t{{bold:{{green:run}}\t#{run}}}"))
+      end
+    end
+
+    def error(msg)
+      raise(CLI::Kit::Abort, msg)
+    end
+  end
+end

package/assets/cli-ruby/vendor/gen/lib/gen.rb

@@ -0,0 +1,39 @@
+require 'cli/ui'
+require 'cli/kit'
+
+CLI::UI::StdoutRouter.enable
+
+module Gen
+  extend CLI::Kit::Autocall
+
+  TOOL_NAME = 'cli-kit'
+  ROOT      = File.expand_path('../../..', __FILE__)
+
+  TOOL_CONFIG_PATH = File.expand_path(File.join('~', '.config', TOOL_NAME))
+  LOG_FILE = File.join(TOOL_CONFIG_PATH, 'logs', 'log.log')
+  DEBUG_LOG_FILE = File.join(TOOL_CONFIG_PATH, 'logs', 'debug.log')
+
+  autoload(:Generator, 'gen/generator')
+
+  autoload(:EntryPoint, 'gen/entry_point')
+  autoload(:Commands,   'gen/commands')
+
+  autocall(:Config)  { CLI::Kit::Config.new(tool_name: TOOL_NAME) }
+  autocall(:Command) { CLI::Kit::BaseCommand }
+  autocall(:Logger)  { CLI::Kit::Logger.new(debug_log_file: DEBUG_LOG_FILE) }
+
+  autocall(:Executor) { CLI::Kit::Executor.new(log_file: LOG_FILE) }
+  autocall(:Resolver) do
+    CLI::Kit::Resolver.new(
+      tool_name: TOOL_NAME,
+      command_registry: Gen::Commands::Registry
+    )
+  end
+
+  autocall(:ErrorHandler) do
+    CLI::Kit::ErrorHandler.new(
+      log_file: LOG_FILE,
+      exception_reporter: nil
+    )
+  end
+end

package/assets/cli-ruby/vendor/gen/template/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+gem 'cli-kit', '~> __cli-kit-version__'
+gem 'cli-ui', '~> __cli-ui-version__'
+
+group :test do
+  gem 'mocha', '~> 1.5.0', require: false
+  gem 'minitest', '>= 5.0.0', require: false
+  gem 'minitest-reporters', require: false
+end

package/assets/cli-ruby/vendor/gen/template/README.md

@@ -0,0 +1 @@
+# __app__

package/assets/cli-ruby/vendor/gen/template/bin/testunit

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'bundler/setup'
+
+root = File.expand_path('../..', __FILE__)
+TEST_ROOT = root + '/test'
+
+$LOAD_PATH.unshift(TEST_ROOT)
+
+def test_files
+  Dir.glob(TEST_ROOT + "/**/*_test.rb")
+end
+
+if ARGV.empty?
+  test_files.each { |f| require(f) }
+  exit 0
+end
+
+# A list of files is presumed to be specified
+ARGV.each do |a|
+  require a.sub(%r{^test/}, '')
+end