squared 0.5.19 → 0.6.0

data/lib/squared/workspace/project/python.rb

@@ -8,24 +8,39 @@ module Squared
         DIR_PYTHON = (DEP_PYTHON + %w[README.rst]).freeze
         OPT_PYTHON = {
           common: %w[b B d E h i I O P q s S u v x c=q m=b W=b X=q check-hash-based-pycs=b].freeze,
-          build: %w[C=bm n|no-isolation s|sdist x|skip-dependency-check v|verbose w|wheel config-setting=q installer=b
+          build: %w[n|no-isolation s|sdist x|skip-dependency-check v|verbose w|wheel C|config-setting=q installer=b
                     o|outdir=p].freeze,
           venv: %w[clear copies symlinks system-site-packages upgrade upgrade-deps without-scm-ignore-files without-pip
                    prompt=q].freeze
         }.freeze
         OPT_PIP = {
-          common: %w[debug disable-pip-version-check isolated no-cache-dir no-color no-input no-python-version-warning
-                     q|quiet require-virtualenv v|verbose cache-dir=p cert=p client-cert=p exists-action=b log=p proxy=q
-                     python=q retries=i timeout=i trusted-host=b use-deprecated=b use-feature=b].freeze,
-          install: %w[break-system-packages check-build-dependencies compile dry-run force-reinstall I|ignore-installed
-                      ignore-requires-python no-build-isolation no-clean no-compile no-deps no-index no-warn-conflicts
-                      no-warn-script-location pre prefer-binary require-hashes U|upgrade use-pep517 user abi=b
-                      config-settings=q c|constraint=p e|editable=v extra-index-url=q f|find-links=q global-option=q
-                      implementation=b i|index-url=q no-binary=q only-binary=q platform=q prefix=p progress-bar=b
-                      python-version=q report=p r|requirement=p root=p root-user-action=b src=p t|target=p
-                      upgrade-strategy=b].freeze,
+          common: %w[debug disable-pip-version-check isolated no-cache-dir no-color no-input q|quiet require-virtualenv
+                     v|verbose cache-dir=p cert=p client-cert=p exists-action=b keyring-provider=b log=p proxy=q
+                     python=q resume-retries=i retries=i timeout=i trusted-host=b use-deprecated=b
+                     use-feature=b].freeze,
+          cache: %w[format=b].freeze,
+          completion: %w[b|bash f|fish p|powershell z|zsh].freeze,
+          config: %w[global user site editor=p].freeze,
+          debug: %w[abi=b implementation=b platform=b python-version=b].freeze,
+          download: %w[d|dest=p].freeze,
+          freeze: %w[all exclude-editable l|local user exclude=b path=p r|requirement=p].freeze,
+          index: %w[json].freeze,
+          inspect: %w[local user path=p].freeze,
+          install: %w[break-system-packages compile dry-run force-reinstall I|ignore-installed no-compile
+                      no-warn-conflicts no-warn-script-location U|upgrade user prefix=p report=p root=p
+                      root-user-action=b t|target=p upgrade-strategy=b].freeze,
+          install_a: %w[ignore-requires-python no-index pre extra-index-url=q f|find-links=q i|index-url=q no-binary=q
+                        only-binary=q].freeze,
+          install_b: %w[check-build-dependencies no-build-isolation no-clean no-deps prefer-binary require-hashes
+                        use-pep517 c|constraint=p group=q progress-bar=b r|requirement=p src=p].freeze,
+          install_c: %w[C|config-settings=q e|editable=v].freeze,
+          hash: %w[a|algorithm].freeze,
+          list: %w[e|editable exclude-editable include-editable l|local no-index not-required o|outdated pre u|uptodate
+                   user exclude=b extra-index-url=q format=b f|find-links=q i|index-url=q path=p].freeze,
+          lock: %w[o|output=p].freeze,
+          show: %w[f|files].freeze,
           uninstall: %w[break-system-packages y|yes r|requirement=p root-user-action=b].freeze,
-          freeze: %w[all exclude-editable l|local user exclude=b path=p r|requirement=p].freeze
+          wheel: %w[no-verify w|wheel-dir=p].freeze
         }.freeze
         OPT_POETRY = {
           common: %w[ansi no-ansi no-cache n|no-interaction no-plugins q|quiet v|verbose P|project=p].freeze,
@@ -52,11 +67,18 @@ module Squared
                       client-cert=p c|comment=q config-file=p i|identity=b p|password=q r|repository=b repository-url=q
                       sign-with=b u|username=q].freeze
         }.freeze
-        private_constant :DEP_PYTHON, :DIR_PYTHON, :OPT_PYTHON, :OPT_PIP, :OPT_POETRY, :OPT_PDM, :OPT_HATCH, :OPT_TWINE
+        PASS_PYTHON = {
+          pip: {
+            debug: %w[platform].freeze,
+            install: %w[C config-settings c constraint extra-index-url no-binary only-binary platform
+                        r requirement].freeze,
+            list: %w[exclude extra-index-url].freeze
+          }.freeze
+        }.freeze
+        private_constant :DEP_PYTHON, :DIR_PYTHON, :OPT_PYTHON, :OPT_PIP, :OPT_POETRY, :OPT_PDM, :OPT_HATCH, :OPT_TWINE,
+                         :PASS_PYTHON
 
         class << self
-          def populate(*); end
-
           def tasks
             [:outdated].freeze
           end
@@ -78,7 +100,7 @@ module Squared
 
         attr_reader :venv, :editable
 
-        def initialize(*, editable: '.', asdf: 'python', **kwargs)
+        def initialize(*, editable: '.', verbose: nil, asdf: 'python', **kwargs)
           super
           if @pass.include?(Python.ref)
             initialize_ref Python.ref
@@ -94,10 +116,10 @@ module Squared
 
         subtasks({
           'venv' => %i[exec create remove show].freeze,
-          'pip' => %i[upgrade uninstall freeze].freeze,
+          'pip' => %i[upgrade uninstall wheel reinstall freeze].freeze,
           'install' => %i[user force upgrade target editable].freeze,
           'outdated' => %i[major minor patch].freeze,
-          'build' => %i[python poetry pdm hatch].freeze,
+          'build' => %i[poetry pdm hatch python].freeze,
           'publish' => %i[poetry pdm hatch twine].freeze,
           'run' => nil,
           'exec' => nil
@@ -132,7 +154,7 @@ module Squared
                   format_desc action, nil, "script+|#{indexchar}index+|#,pattern*"
                   task action, [:command] do |_, args|
                     found = 0
-                    %w[tool.poetry.scripts tool.pdm.scripts project.scripts].each_with_index do |table, index|
+                    %w[tool.poetry.scripts tool.pdm.scripts project.scripts].each_with_index do |table, i|
                       next if (list = read_pyproject(table)).empty?
 
                       if args.command == '#'
@@ -141,8 +163,8 @@ module Squared
                       else
                         args.to_a.each do |val|
                           if (n, = indexitem(val))
-                            if (script, = list[n - 1])
-                              case index
+                            if (script, = list[n.pred])
+                              case i
                               when 0
                                 script = session_output 'poetry', 'run', script
                               when 1
@@ -159,7 +181,7 @@ module Squared
                               log.warn "run script #{n} of #{list.size} (out of range)"
                             end
                           else
-                            case index
+                            case i
                             when 0
                               found |= 1
                               run(session_output('poetry', 'run', val), from: :run)
@@ -183,24 +205,21 @@ module Squared
                     end
                   end
                 when 'exec'
-                  format_desc action, nil, 'command|:,args*'
+                  format_desc action, nil, ':|command,args*'
                   task action do |_, args|
-                    i = (args = args.to_a).delete(':')
-                    cmd = if i && !workspace.windows?
-                            readline('Enter script', force: true, multiline: ['##', ';'])
+                    args = args.to_a
+                    cmd = if (i = args.delete(':')) && !workspace.windows?
+                            readline('Enter script', force: true, multiline: %w[## ;])
                           elsif i || args.empty?
                             readline('Enter command', force: true)
                           else
-                            if (val = command_args(args, min: 1, prefix: 'python'))
-                              args << val
-                            end
-                            args.join(' ')
+                            (args << command_args(args, min: 1, prefix: 'python')).compact.join(' ')
                           end
                     shell(cmd, name: :exec, chdir: path)
                   end
                 end
               else
-                namespace action do
+                namespace action do |ns|
                   flags.each do |flag|
                     case action
                     when 'venv'
@@ -215,11 +234,11 @@ module Squared
                         when :remove
                           next unless projectpath?(venv)
 
-                          format_desc action, flag, 'c|create?,d|depend?'
+                          format_desc action, flag, 'c/reate?,d/epend?'
                           task flag do |_, args|
                             rm_rf(venv, verbose: true)
-                            venv_init if has_value?(%w[c create], args.to_a)
-                            depend if has_value?(%w[d depend], args.to_a)
+                            venv_init if has_value?(args = args.to_a, 'c', 'create')
+                            depend if has_value?(args, 'd', 'depend')
                           end
                         when :exec
                           format_desc action, flag, 'command,args*'
@@ -227,7 +246,7 @@ module Squared
                             args = args.to_a
                             if args.empty?
                               args = readline('Enter command', force: true).split(' ', 2)
-                            elsif args.size == 1 && !option('interactive', prefix: 'venv', equals: '0')
+                            elsif args.size == 1 && !option('interactive', equals: '0', prefix: ref)
                               args << readline('Enter arguments', force: false)
                             end
                             venv_init
@@ -250,21 +269,35 @@ module Squared
                       when :freeze
                         format_desc action, flag, "file?=#{DEP_PYTHON[4]},opts*"
                         task flag do |_, args|
-                          if (file = pip(flag, args.to_a)) && verbose
+                          if (file = pip(flag, opts: args.to_a, banner: true)) && verbose
                             puts File.read(file)
                           end
                         end
                       when :uninstall
                         format_desc action, flag, 'package+,opts*'
                         task flag do |_, args|
-                          pip flag, args.to_a
+                          pip(flag, opts: args.to_a, banner: true)
+                        end
+                      when :wheel
+                        next unless pyprojectfile || setuptools?
+
+                        format_desc action, flag, 'opts*,args*'
+                        task flag do |_, args|
+                          pip(flag, opts: args.to_a, banner: true)
+                        end
+                      when :reinstall
+                        if venv && projectpath?(venv)
+                          format_desc action, flag
+                          task flag do
+                            ns['venv:remove'].invoke('depend')
+                          end
                         end
                       end
                     when 'install'
                       format_desc(action, flag, 'opts*', before: case flag
                                                                  when :target then 'dir'
-                                                                 when :editable then 'path/url?'
-                                                                 when :upgrade then 'strategy?,package+'
+                                                                 when :editable then 'path/url?,opts*'
+                                                                 when :upgrade then 'strategy?,opts*,package+'
                                                                  end)
                       case flag
                       when :editable
@@ -273,17 +306,18 @@ module Squared
                         end
                       when :upgrade
                         task flag, [:strategy] do |_, args|
-                          args = case (strategy = args.strategy)
-                                 when 'eager', 'only-if-needed'
-                                   args.extras
-                                 when 'needed'
-                                   strategy = 'only-if-needed'
-                                   args.extras
-                                 else
-                                   strategy = nil
-                                   args.to_a
-                                 end
-                          install(flag, args, strategy: strategy)
+                          install flag, (case args.strategy
+                                         when 'eager'
+                                           'eager'
+                                         when /(?:\Aonly-if|needed\z)/
+                                           'only-if-needed'
+                                         end.yield_self do |val|
+                                           if val
+                                             args.extras << "upgrade-strategy=#{val}"
+                                           else
+                                             args.to_a
+                                           end
+                                         end)
                         end
                       when :target
                         task flag, [:dir] do |_, args|
@@ -296,30 +330,26 @@ module Squared
                         end
                       end
                     when 'outdated'
-                      format_desc action, flag, 'eager?,user?'
+                      format_desc action, flag, 'eager?,user?,s/elect'
                       task flag do |_, args|
                         outdated flag, args.to_a
                       end
                     when 'build'
-                      case flag
-                      when :poetry
-                        next unless build_backend == 'poetry.core.masonry.api'
-                      when :pdm
-                        next unless build_backend == 'pdm.backend'
-                      when :hatch
-                        next unless build_backend == 'hatchling.build'
-                      end
+                      next if (be = backend?(flag)) == false
+
                       format_desc(action, flag, 'opts*', after: case flag
                                                                 when :poetry then 'output?'
                                                                 when :pdm then 'dest?'
                                                                 when :hatch then 'location?'
-                                                                else 'outdir?'
+                                                                else 'srcdir?'
                                                                 end)
                       task flag do |_, args|
                         build! flag, args.to_a
                       end
-                      break unless flag == :python
+                      break if be
                     when 'publish'
+                      next if (be = backend?(flag)) == false
+
                       format_desc(action, flag, 'test?,opts*', after: case flag
                                                                       when :hatch then 'artifacts?'
                                                                       when :twine then 'dist?'
@@ -333,6 +363,7 @@ module Squared
                                                     false
                                                   end)
                       end
+                      break if be
                     end
                   end
                 end
@@ -361,11 +392,12 @@ module Squared
                 when :force
                   cmd << '--force-reinstall'
                 end
-                append_pip(flag, opts, from: :install)
+                op = append_pip(flag, opts, from: :install)
+                op.clear
               else
                 append_global
               end
-              cmd << "-r #{DEP_PYTHON[4]}" if basepath(DEP_PYTHON[4]).exist? && !session_arg?('r', 'requirement')
+              cmd << "-r #{DEP_PYTHON[4]}" if exist?(DEP_PYTHON[4]) && !session_arg?('r', 'requirement')
               append_editable
             end
             run(from: :depend, sync: sync)
@@ -374,18 +406,24 @@ module Squared
 
         def outdated(flag = nil, opts = [], sync: invoked_sync?('outdated', flag))
           cmd = pip_session 'list --outdated'
+          cmd << '--not-required' unless flag || option('not-required', equals: '0')
+          cmd << '--local' if option('l', 'local')
           append_global
           cmd = session_done cmd
           log.info cmd
           on :first, :outdated
           banner = format_banner cmd
-          print_item banner if sync
-          start = 0
-          found = 0
-          major = []
-          minor = []
-          patch = []
+          items = if sync
+                    print_item banner
+                    [] if flag && has_value?(opts, 's', 'select') && !stdin?
+                  end
           pwd_set(from: :outdated) do
+            tc = theme[:current]
+            start = 0
+            found = 0
+            major = []
+            minor = []
+            patch = []
             buffer = []
             out = ->(val) { sync ? puts(val) : buffer << val }
             if workspace.windows?
@@ -419,26 +457,27 @@ module Squared
                     styles = color(:yellow)
                   else
                     styles = color(:green)
-                    line = sub_style(line, pat: /^(\S+)(.+)$/, styles: if type == 2
-                                                                         styles << :bold
-                                                                         theme[:major]
-                                                                       else
-                                                                         theme[:active]
-                                                                       end)
+                    line = sub_style(line, styles: if type == 2
+                                                     styles += [:bold]
+                                                     theme[:major]
+                                                   else
+                                                     theme[:active]
+                                                   end, pat: /^(\S+)(.+)$/)
                   end
-                  if theme[:current]
-                    line = sub_style(line, pat: /^(.+)(#{Regexp.escape(current)})(.+)$/, styles: theme[:current],
-                                           index: 2)
-                  end
-                  line = sub_style(line, pat: /^(.+)(#{Regexp.escape(latest)})(.+)$/, styles: styles, index: 2)
+                  line = sub_style(line, **opt_style(tc, /^(.+)(#{Regexp.escape(current)})(.+)$/, 2)) if tc
+                  line = sub_style(line, **opt_style(styles, /^(.+)(#{Regexp.escape(latest)})(.+)$/, 2))
                   found += 1
                 end
-                out.call("#{start.to_s.rjust(2)}. #{line}")
+                if items
+                  items << [line, name]
+                else
+                  out.call("#{start.to_s.rjust(2)}. #{line}")
+                end
                 start += 1
               elsif line.start_with?('Package')
                 unless stdin?
-                  sub = { pat: /^(.*)(?<!\dm)(Package|Latest)(.+)$/, styles: theme[:header], index: 2 }
-                  out.call(print_footer(" #  #{line.chomp}", reverse: true, sub: [sub, sub]))
+                  sub = [opt_style(theme[:header], /^(.*)(?<!\dm)(Package|Latest)(.+)$/, 2)] * 2
+                  out.call(print_footer(" #  #{line.chomp}", reverse: true, sub: sub))
                 end
                 start += 1
               end
@@ -448,17 +487,23 @@ module Squared
               puts buffer
             end
             if found > 0
-              print_status(major.size, minor.size, patch.size, from: :outdated)
-              pkg = case flag
-                    when :major
-                      major + minor + patch
-                    when :minor
-                      minor + patch
-                    when :patch
-                      patch
-                    end
-              unless !pkg || pkg.empty?
-                install(:upgrade, pkg, strategy: opts.include?('eager') ? 'eager' : nil, user: opts.include?('user'))
+              if items
+                choice('Select a package', items.map(&:first),
+                       multiple: true, force: false, index: true, border: true).map! { |n| items[n.pred].last }
+              else
+                case flag
+                when :major
+                  major + minor + patch
+                when :minor
+                  minor + patch
+                else
+                  patch
+                end
+              end.tap do |packages|
+                unless packages.empty?
+                  install(:upgrade, opts.grep(/^(?:eager|user)$/), packages: packages, banner: false)
+                end
+                print_status(major.size, minor.size, patch.size, from: :outdated)
               end
             elsif start == 0
               puts 'No updates were found'
@@ -467,84 +512,95 @@ module Squared
           on :last, :outdated
         end
 
-        def install(flag, opts = [], strategy: nil, user: nil)
-          cmd = pip_session 'install'
-          out = append_pip(flag, opts, from: :install)
+        def install(flag, opts = [], packages: [], banner: true)
+          op = append_pip(flag, opts, target: pip_session('install'), from: :install)
           case flag
           when :editable
-            cmd << quote_option('e', out.pop || editable || '.')
-            option_clear out
+            op << quote_option('e', op.pop || editable || '.')
+            op.clear
           when :upgrade
-            raise_error('no packages listed', hint: flag) if out.empty?
-            cmd << '--upgrade'
-            cmd << '--user' if user
-            cmd << basic_option('upgrade-strategy', strategy) if strategy
-            append_value out
-            python_session('-m pip', *cmd.to_a.drop(1)) if workspace.windows?
+            op.concat(packages)
+            raise_error 'no packages listed', hint: flag if op.empty?
+            op << '--upgrade'
+            op.append
+            python_session('-m pip', *op.to_a.drop(1)) if workspace.windows?
           end
-          run(from: :install)
+          run(banner: banner, from: :install)
         end
 
         def build!(flag, opts = [])
-          case flag
-          when :poetry
-            cmd = poetry_session 'build'
-            list = OPT_POETRY[:build] + OPT_POETRY[:common]
-          when :pdm
-            cmd, opts = pdm_session('build', opts: opts)
-            list = OPT_PDM[:build]
-          when :hatch
-            cmd, opts = hatch_session('build', opts: opts)
-            list = OPT_HATCH[:build]
-          else
-            cmd, opts = python_session('-m build', opts: opts)
-            list = OPT_PYTHON[:build]
-          end
+          list = case flag
+                 when :poetry
+                   cmd = poetry_session 'build'
+                   OPT_POETRY[:build] + OPT_POETRY[:common]
+                 when :pdm
+                   cmd, opts = pdm_session('build', opts: opts)
+                   OPT_PDM[:build]
+                 when :hatch
+                   cmd, opts = hatch_session('build', opts: opts)
+                   OPT_HATCH[:build]
+                 else
+                   cmd, opts = python_session('-m build', opts: opts)
+                   OPT_PYTHON[:build]
+                 end
+          srcdir = nil
           op = OptionPartition.new(opts, list, cmd, project: self, single: singleopt(flag))
+          op.each do |opt|
+            if !srcdir && exist?(opt.chomp('*')) && projectpath?(opt.chomp('*'))
+              srcdir = opt
+            else
+              op.found << opt
+            end
+          end
+          op.swap
           case flag
+          when :poetry, :pdm
+            if srcdir
+              args = flag == :pdm ? %w[d dest] : %w[o output]
+              if op.arg?(*args)
+                op.push(srcdir)
+              else
+                op << quote_option(args.last, basepath(srcdir))
+              end
+              srcdir = nil
+            end
           when :hatch
-            if !ENV['HATCH_BUILD_LOCATION'] && (outdir ||= op.shift)
-              op.add_path(outdir)
+            if ENV['HATCH_BUILD_LOCATION']
+              srcdir = nil
+            else
+              srcdir ||= path
             end
             op << basic_option('p', project) unless ENV['HATCH_PROJECT'] || op.arg?('p', 'project')
-          else
-            unless op.empty?
-              args = case flag
-                     when :poetry
-                       %w[o output]
-                     when :pdm
-                       %w[d dest]
-                     else
-                       srcdir = true
-                       %w[o outdir]
-                     end
-              op << quote_option(args.last, basepath(op.shift)) unless op.arg?(*args)
-            end
           end
-          op.exist?(add: true, first: true) if srcdir
+          op.add_path(srcdir) if srcdir
           op.clear
           run(from: :"#{flag}:build")
         end
 
         def publish(flag, opts = [], test: false)
-          case flag
-          when :poetry
-            poetry_session 'publish'
-            list = OPT_POETRY[:publish] + OPT_POETRY[:common]
-          when :pdm
-            opts = pdm_session('publish', opts: opts).last
-            list = OPT_PDM[:publish]
-          when :hatch
-            opts = hatch_session('publish', opts: opts).last
-            list = OPT_HATCH[:publish]
-          when :twine
-            session 'twine', 'upload'
-            list = OPT_TWINE[:publish]
-          end
+          list = case flag
+                 when :poetry
+                   poetry_session 'publish'
+                   OPT_POETRY[:publish] + OPT_POETRY[:common]
+                 when :pdm
+                   opts = pdm_session('publish', opts: opts).last
+                   OPT_PDM[:publish]
+                 when :hatch
+                   opts = hatch_session('publish', opts: opts).last
+                   OPT_HATCH[:publish]
+                 else
+                   session 'twine', 'upload'
+                   OPT_TWINE[:publish]
+                 end
           op = OptionPartition.new(opts, list, @session, project: self, single: singleopt(flag))
           dist = lambda do
-            basepath('dist').tap do |dir|
-              raise_error('no source files found', hint: dir) unless dir.directory? && !dir.empty?
+            dir = basepath 'dist'
+            return dir if dir.directory? && !dir.empty?
+
+            if dir.exist?
+              raise_error 'no source to publish', hint: dir
+            else
+              raise_error Errno::ENOENT, dir, hint: 'publish'
             end
           end
           if test
@@ -555,35 +611,93 @@ module Squared
             end
           end
           case flag
-          when :hatch, :twine
+          when :poetry, :pdm
+            dist.call unless op.arg?(*(flag == :poetry ? ['dist-dir'] : %w[d dest]))
+            op.clear(pass: false)
+          else
             if op.empty?
-              op.push("#{dist.call}/*")
+              op << "#{dist.call}/*"
             else
-              op.map! { |val| basepath(val) }
+              op.add_path
             end
-            op.append
-          else
-            dist.call unless op.arg?(*(flag == :poetry ? ['dist-dir'] : ['d', 'dest']))
-            op.clear(pass: false)
           end
-          run(from: :"#{flag}:publish", interactive: "Publish #{sub_style(project, styles: theme[:active])}")
+          run(from: :"#{flag}:publish", interactive: ['Publish', 'N', project])
         end
 
-        def pip(flag, opts = [])
-          cmd = pip_session flag
-          out = append_pip(nil, opts, from: flag)
+        def pip(flag, *args, sync: true, banner: verbose?, with: nil, pass: nil, **kwargs)
+          flag = flag.to_sym
+          pass = PASS_PYTHON[:pip].fetch(pip_install?(flag) ? :install : flag, []) + %w[v verbose] if pass.nil?
+          opts = session_opts(with, args: args, kwargs: kwargs, pass: pass)
+          case flag
+          when :freeze, :inspect, :list, :check, :completion, :debug
+            opts.concat(args)
+          end
+          op = append_pip(flag, opts, target: pip_session(flag), from: flag)
           case flag
-          when :uninstall
-            raise_error('no packages listed', hint: flag) if out.empty?
-            cmd.merge(out)
+          when :install, :uninstall, :show, :index
+            op.concat(args)
+            if op.empty?
+              case flag
+              when :install, :uninstall
+                op << '.' if installable? && !op.arg?('r', 'requirement')
+              else
+                raise_error 'no packages listed', hint: flag
+              end
+            elsif flag == :install
+              op.append_any
+            elsif flag == :index
+              op.adjoin('versions', with: 'index')
+                .add_first
+                .clear
+            else
+              op.append
+            end
           when :freeze
             venv_init
-            ret = basepath(out.shift || DEP_PYTHON[4])
-            cmd << '>' << shell_quote(ret)
-            option_clear out
+            op << '>'
+            op.add_quote(ret = basepath(op.detect { |val| op.exist?(val) } || DEP_PYTHON[4]))
+              .clear
+          when :cache
+            op.concat(args)
+            raise_error 'no subcommand', hint: flag if op.empty?
+            op << (action = op.shift)
+            case action
+            when 'dir', 'info', 'purge'
+              nil
+            when 'list', 'remove'
+              op.add_first(quote: true)
+            else
+              raise_error ArgumentError, "unrecognized args: #{action}", hint: flag
+            end
+            op.clear
+          when :config
+            op.concat(args)
+            raise_error 'no subcommand', hint: flag if op.empty?
+            op << (action = op.shift)
+            case action
+            when 'list', 'edit', 'debug'
+              nil
+            when 'get', 'unset', 'set'
+              op.add_first
+              op.add_first(quote: true, expect: true) if action == 'set'
+            else
+              raise_error ArgumentError, "unrecognized args: #{action}", hint: flag
+            end
+            op.clear
+          when :hash
+            op.append(projectmap(op.concat(args), parent: true))
+          when :wheel, :lock, :download
+            op.concat(args)
+            if !op.empty?
+              op.append
+            elsif installable? && !op.arg?('r', 'requirement')
+              op << '.'
+            end
+          else
+            op.clear
           end
-          run(from: :"pip:#{flag}")
-          ret
+          print_run(op, banner, **kwargs)
+          run(sync: sync, banner: banner, from: :"pip:#{flag}").yield_self { |val| ret || val }
         end
 
         def variable_set(key, *val, **, &blk)
@@ -605,7 +719,7 @@ module Squared
           when :editable
             editable_set val.first
           when :venv
-            instance_variable_set(:"@#{key}", val.empty? ? nil : basepath(*val))
+            instance_variable_set(:"@#{key}", (basepath(*val) unless val.empty?))
           else
             super
           end
@@ -616,7 +730,7 @@ module Squared
         end
 
         def outdated?
-          dependtype > 0 && !task_pass?('outdated')
+          dependtype > 0
         end
 
         private
@@ -628,15 +742,14 @@ module Squared
         def python_session(*cmd, opts: nil)
           return session('python', *preopts(quiet: false), *cmd, path: venv.nil?) unless opts
 
-          op = OptionPartition.new(opts, OPT_PYTHON[:common], project: self, single: singleopt(:python))
-          ret = session('python', *op.to_a, *cmd, path: venv.nil?)
-          [ret, op.extras]
+          op = OptionPartition.new(opts, OPT_PYTHON[:common], project: self, single: /\A(?:v+|OO)\z/)
+          [session('python', *op.to_a, *cmd, path: venv.nil?), op.extras]
         end
 
         def poetry_session(*cmd)
-          ret = session('poetry', *cmd, *preopts)
-          option('project', ignore: false) { |val| ret << quote_option('project', basepath(val)) }
-          ret
+          session('poetry', *cmd, *preopts).tap do |ret|
+            option('project', ignore: false) { |val| ret << quote_option('project', basepath(val)) }
+          end
         end
 
         def pdm_session(*cmd, opts: nil)
@@ -651,18 +764,28 @@ module Squared
           return session(name, *preopts, *cmd, path: venv.nil?) unless opts
 
           op = OptionPartition.new(opts, common, project: self, single: singleopt)
-          ret = session(name, *op.to_a, *cmd, path: venv.nil?)
-          [ret, op.extras]
+          [session(name, *op.to_a, *cmd, path: venv.nil?), op.extras]
         end
 
         def append_pip(flag, opts, target: @session, from: nil)
-          unless from && !opts.empty?
-            append_global(target: target)
-            return []
+          list = OPT_PIP.fetch(from, []) + OPT_PIP[:common]
+          if pip_install?(flag)
+            list.concat(OPT_PIP[:install_a])
+            list.concat(OPT_PIP[:install_b]) unless flag == :index
+            case flag
+            when :install
+              list.concat(OPT_PIP[:install_c] + OPT_PIP[:debug])
+            when :lock, :wheel
+              list.concat(OPT_PIP[:install_c])
+            when :download, :index
+              list.concat(OPT_PIP[:debug])
+            end
+            opts << 'no-build-isolation' if option('build-isolation', equals: '0')
           end
-          op = OptionPartition.new(opts, OPT_PIP[from] + OPT_PIP[:common], target, project: self, single: singleopt)
+          op = OptionPartition.new(opts, list, target, project: self, single: singleopt)
           append_global(target: target)
-          if from == :install
+          case flag
+          when :install, :lock, :wheel
             edit = nil
             op.each do |opt|
               if opt =~ op.values
@@ -677,7 +800,6 @@ module Squared
                 op.found << opt
               end
             end
-            op << '--no-build-isolation' if option('build-isolation', equals: '0')
             op.swap
             if edit
               edit = basepath(edit) unless %r{\A[a-z]+(?:\+[a-z]+)?://}i.match?(edit)
@@ -687,16 +809,8 @@ module Squared
                 op << quote_option('e', edit)
               end
             end
-            case flag
-            when :editable, :upgrade
-              op.extras
-            else
-              op.clear
-              []
-            end
-          else
-            op.extras
           end
+          op
         end
 
         def append_editable(target: @session)
@@ -717,16 +831,18 @@ module Squared
         end
 
         def append_global(target: @session)
-          option('cache-dir', target: target) do |val|
-            target << case val
-                      when '0', 'false'
-                        '--no-cache-dir'
-                      else
-                        quote_option('cache-dir', basepath(val))
-                      end
-          end
-          option('proxy', target: target) { |val| target << quote_option('proxy', val) }
-          option('python', target: target) { |val| target << quote_option('python', basepath(val)) }
+          target.merge([
+            option('cache-dir', target: target) do |val|
+              case val
+              when '0', 'false'
+                '--no-cache-dir'
+              else
+                quote_option 'cache-dir', basepath(val)
+              end
+            end,
+            option('proxy', target: target) { |val| shell_option('proxy', val) },
+            option('python', target: target) { |val| quote_option('python', basepath(val)) }
+          ])
           append_nocolor(target: target)
         end
 
@@ -775,13 +891,13 @@ module Squared
                       end
                     end
                   else
-                    val = case (val = data[2])
+                    val = case (ch = data[2])
                           when 'true'
                             true
                           when 'false'
                             false
                           else
-                            val.include?('.') ? val.to_f : val.to_i
+                            ch.include?('.') ? ch.to_f : ch.to_i
                           end
                   end
                   ret << [data[1], val]
@@ -798,15 +914,15 @@ module Squared
         end
 
         def pyprojectfile
-          return unless (ret = basepath(DEP_PYTHON[2])).exist?
+          return @pyprojectfile || nil unless @pyprojectfile.nil?
 
-          ret
+          @pyprojectfile = (file = basepath(DEP_PYTHON[2])).exist? ? file : false
         end
 
         def singleopt(flag = nil)
           case flag
           when :python
-            /\A(?:v+|q+|b+|V+|O+)\z/
+            /\A(?:v+|q+|b+)\z/
           when :twine
             nil
           else
@@ -815,14 +931,14 @@ module Squared
         end
 
         def preopts(quiet: true)
-          ret = []
-          case verbose
-          when FalseClass
-            ret << '--quiet' if quiet
-          when Numeric
-            ret << "-#{'v' * verbose}" if verbose > 0
+          [].tap do |ret|
+            case verbose
+            when FalseClass
+              ret << '--quiet' if quiet
+            when Numeric
+              ret << "-#{'v' * verbose}" if verbose > 0
+            end
           end
-          ret
         end
 
         def variables
@@ -892,6 +1008,27 @@ module Squared
           puts(dir.directory? ? "Success: #{dir}" : 'Failed') if banner && !status
         end
 
+        def pip_install?(flag)
+          %i[install download index lock wheel].include?(flag)
+        end
+
+        def backend?(flag)
+          case flag
+          when :poetry
+            build_backend == 'poetry.core.masonry.api'
+          when :pdm
+            build_backend == 'pdm.backend'
+          when :hatch
+            build_backend == 'hatchling.build'
+          when :setuptools
+            build_backend == 'setuptools.build_meta'
+          end
+        end
+
+        def installable?
+          setuptools? || !pyprojectfile.nil?
+        end
+
         def setuptools?
           dependtype == 2 || dependtype == 4
         end