tests/test-completion.t

interfaces: add the optional `bdiff.xdiffblocks()` method

PyCharm flagged where this was called on the protocol class in `mdiff.py` in the
previous commit, but pytype completely missed it.  PyCharm is correct here, but
I'm committing this separately to highlight this potential problem- some of the
implementations don't implement _all_ of the methods the others do, and there's
not a great way to indicate on a protocol class that a method or attribute is
optional- that's kinda the opposite of what static typing is about.

Making the method an `Optional[Callable]` attribute works here, and keeps both
PyCharm and pytype happy, and the generated `mdiff.pyi` and `modules.pyi` look
reasonable.  We might be getting a little lucky, because the method isn't
invoked directly- it is returned from another method that selects which block
function to use.  Except since it is declared on the protocol class, every
module needs this attribute (in theory, but in practice this doesn't seem to be
checked), so the check for it on the module has to change from `hasattr()` to
`getattr(..., None)`.  We defer defining the optional attrs to the type checking
phase as an extra precaution- that way it isn't an attr with a `None` value at
runtime if someone is still using `hasattr()`.

As to why pytype missed this, I have no clue.  The generated `mdiff.pyi` even
has the global variable typed as `bdiff: intmod.BDiff`, so uses of it really
should comply with what is on the class, protocol class or not.

Show all commands except debug commands
  $ hg debugcomplete
  abort
  add
  addremove
  admin::chainsaw-update
  admin::verify
  annotate
  archive
  backout
  bisect
  bookmarks
  branch
  branches
  bundle
  cat
  clone
  commit
  config
  continue
  copy
  diff
  export
  files
  forget
  graft
  grep
  heads
  help
  identify
  import
  incoming
  init
  locate
  log
  manifest
  merge
  outgoing
  parents
  paths
  phase
  pull
  purge
  push
  recover
  remove
  rename
  resolve
  revert
  rollback
  root
  serve
  shelve
  status
  summary
  tag
  tags
  tip
  unbundle
  unshelve
  update
  verify
  version

Show all commands that start with "a"
  $ hg debugcomplete a
  abort
  add
  addremove
  admin::chainsaw-update
  admin::verify
  annotate
  archive

Do not show debug commands if there are other candidates
  $ hg debugcomplete d
  diff

Show debug commands if there are no other candidates
  $ hg debugcomplete debug
  debug-delta-find
  debug-repair-issue6528
  debug-revlog-index
  debug-revlog-stats
  debug::stable-tail-sort
  debug::stable-tail-sort-leaps
  debug::unbundle
  debugancestor
  debugantivirusrunning
  debugapplystreamclonebundle
  debugbackupbundle
  debugbuilddag
  debugbundle
  debugcapabilities
  debugchangedfiles
  debugcheckstate
  debugcolor
  debugcommands
  debugcomplete
  debugconfig
  debugcreatestreamclonebundle
  debugdag
  debugdata
  debugdate
  debugdeltachain
  debugdirstate
  debugdirstateignorepatternshash
  debugdiscovery
  debugdownload
  debugextensions
  debugfileset
  debugformat
  debugfsinfo
  debuggetbundle
  debugignore
  debugindexdot
  debugindexstats
  debuginstall
  debugknown
  debuglabelcomplete
  debuglocks
  debugmanifestfulltextcache
  debugmergestate
  debugnamecomplete
  debugnodemap
  debugobsolete
  debugp1copies
  debugp2copies
  debugpathcomplete
  debugpathcopies
  debugpeer
  debugpickmergetool
  debugpushkey
  debugpvec
  debugrebuilddirstate
  debugrebuildfncache
  debugrename
  debugrequires
  debugrevlog
  debugrevlogindex
  debugrevspec
  debugserve
  debugsetparents
  debugshell
  debugsidedata
  debugssl
  debugstrip
  debugsub
  debugsuccessorssets
  debugtagscache
  debugtemplate
  debuguigetpass
  debuguiprompt
  debugupdatecaches
  debugupgraderepo
  debugwalk
  debugwhyunstable
  debugwireargs
  debugwireproto

Do not show the alias of a debug command if there are other candidates
(this should hide rawcommit)
  $ hg debugcomplete r
  recover
  remove
  rename
  resolve
  revert
  rollback
  root
Show the alias of a debug command if there are no other candidates
  $ hg debugcomplete rawc
  

Show the global options
  $ hg debugcomplete --options | sort
  --color
  --config
  --cwd
  --debug
  --debugger
  --encoding
  --encodingmode
  --help
  --hidden
  --noninteractive
  --pager
  --profile
  --quiet
  --repository
  --time
  --traceback
  --verbose
  --version
  -R
  -h
  -q
  -v
  -y

Show the options for the "serve" command
  $ hg debugcomplete --options serve | sort
  --accesslog
  --address
  --certificate
  --cmdserver
  --color
  --config
  --cwd
  --daemon
  --daemon-postexec
  --debug
  --debugger
  --encoding
  --encodingmode
  --errorlog
  --help
  --hidden
  --ipv6
  --name
  --noninteractive
  --pager
  --pid-file
  --port
  --prefix
  --print-url
  --profile
  --quiet
  --repository
  --stdio
  --style
  --subrepos
  --templates
  --time
  --traceback
  --verbose
  --version
  --web-conf
  -6
  -A
  -E
  -R
  -S
  -a
  -d
  -h
  -n
  -p
  -q
  -t
  -v
  -y

Show an error if we use --options with an ambiguous abbreviation
  $ hg debugcomplete --options s
  hg: command 's' is ambiguous:
      serve shelve showconfig status summary
  [10]

Show all commands + options
  $ hg debugcommands
  abort: dry-run
  add: include, exclude, subrepos, dry-run
  addremove: similarity, subrepos, include, exclude, dry-run
  admin::chainsaw-update: purge-unknown, purge-ignored, rev, source, dest, initial-clone-minimal
  admin::verify: check, option
  annotate: rev, follow, no-follow, text, user, file, date, number, changeset, line-number, skip, line-range, ignore-all-space, ignore-space-change, ignore-blank-lines, ignore-space-at-eol, include, exclude, template
  archive: no-decode, prefix, rev, type, subrepos, include, exclude
  backout: merge, commit, no-commit, parent, rev, edit, tool, include, exclude, message, logfile, date, user
  bisect: reset, good, bad, skip, extend, command, noupdate
  bookmarks: force, rev, delete, rename, inactive, list, template
  branch: force, clean, rev
  branches: active, closed, rev, template
  bundle: exact, force, rev, branch, base, all, type, ssh, remotecmd, insecure
  cat: output, rev, decode, include, exclude, template
  clone: noupdate, updaterev, rev, branch, pull, uncompressed, stream, ssh, remotecmd, insecure
  commit: addremove, close-branch, amend, secret, draft, edit, force-close-branch, interactive, include, exclude, message, logfile, date, user, subrepos
  config: untrusted, exp-all-known, edit, local, source, shared, non-shared, global, template
  continue: dry-run
  copy: forget, after, at-rev, force, include, exclude, dry-run
  debug-delta-find: changelog, manifest, dir, template, source
  debug-repair-issue6528: to-report, from-report, paranoid, dry-run
  debug-revlog-index: changelog, manifest, dir, template
  debug-revlog-stats: changelog, manifest, filelogs, template
  debug::stable-tail-sort: template
  debug::stable-tail-sort-leaps: template, specific
  debug::unbundle: 
  debugancestor: 
  debugantivirusrunning: 
  debugapplystreamclonebundle: 
  debugbackupbundle: recover, patch, git, limit, no-merges, stat, graph, style, template
  debugbuilddag: mergeable-file, overwritten-file, new-file, from-existing
  debugbundle: all, part-type, spec
  debugcapabilities: 
  debugchangedfiles: compute
  debugcheckstate: 
  debugcolor: style
  debugcommands: 
  debugcomplete: options
  debugcreatestreamclonebundle: 
  debugdag: tags, branches, dots, spaces
  debugdata: changelog, manifest, dir
  debugdate: extended
  debugdeltachain: rev, all-info, size-info, dist-info, sparse-info, changelog, manifest, dir, template
  debugdirstateignorepatternshash: 
  debugdirstate: nodates, dates, datesort, docket, all
  debugdiscovery: old, nonheads, rev, seed, local-as-revs, remote-as-revs, ssh, remotecmd, insecure, template
  debugdownload: output
  debugextensions: template
  debugfileset: rev, all-files, show-matcher, show-stage
  debugformat: template
  debugfsinfo: 
  debuggetbundle: head, common, type
  debugignore: 
  debugindexdot: changelog, manifest, dir
  debugindexstats: 
  debuginstall: template
  debugknown: 
  debuglabelcomplete: 
  debuglocks: force-free-lock, force-free-wlock, set-lock, set-wlock
  debugmanifestfulltextcache: clear, add
  debugmergestate: style, template
  debugnamecomplete: 
  debugnodemap: changelog, manifest, dir, dump-new, dump-disk, check, metadata
  debugobsolete: flags, record-parents, rev, exclusive, index, delete, date, user, template
  debugp1copies: rev
  debugp2copies: rev
  debugpathcomplete: full, normal, added, removed
  debugpathcopies: include, exclude
  debugpeer: 
  debugpickmergetool: rev, changedelete, include, exclude, tool
  debugpushkey: 
  debugpvec: 
  debugrebuilddirstate: rev, minimal
  debugrebuildfncache: only-data
  debugrename: rev
  debugrequires: 
  debugrevlog: changelog, manifest, dir, dump
  debugrevlogindex: changelog, manifest, dir, format
  debugrevspec: optimize, show-revs, show-set, show-stage, no-optimized, verify-optimized
  debugserve: sshstdio, logiofd, logiofile
  debugsetparents: 
  debugshell: command
  debugsidedata: changelog, manifest, dir
  debugssl: 
  debugstrip: rev, force, no-backup, nobackup, , keep, bookmark, soft
  debugsub: rev
  debugsuccessorssets: closest
  debugtagscache: 
  debugtemplate: rev, define
  debuguigetpass: prompt
  debuguiprompt: prompt
  debugupdatecaches: 
  debugupgraderepo: optimize, run, backup, changelog, manifest, filelogs
  debugwalk: include, exclude
  debugwhyunstable: 
  debugwireargs: three, four, five, ssh, remotecmd, insecure
  debugwireproto: localssh, peer, noreadstderr, nologhandshake, ssh, remotecmd, insecure
  diff: rev, from, to, change, text, git, binary, nodates, noprefix, show-function, reverse, ignore-all-space, ignore-space-change, ignore-blank-lines, ignore-space-at-eol, unified, stat, root, include, exclude, subrepos
  export: bookmark, output, switch-parent, rev, text, git, binary, nodates, template
  files: rev, print0, include, exclude, template, subrepos
  forget: interactive, include, exclude, dry-run
  graft: rev, base, continue, stop, abort, edit, log, no-commit, force, currentdate, currentuser, date, user, tool, dry-run
  grep: print0, all, diff, text, follow, ignore-case, files-with-matches, line-number, rev, all-files, user, date, template, include, exclude
  heads: rev, topo, active, closed, style, template
  help: extension, command, keyword, system
  identify: rev, num, id, branch, tags, bookmarks, ssh, remotecmd, insecure, template
  import: strip, base, secret, edit, force, no-commit, bypass, partial, exact, prefix, import-branch, message, logfile, date, user, similarity
  incoming: force, newest-first, bundle, rev, bookmarks, branch, patch, git, limit, no-merges, stat, graph, style, template, ssh, remotecmd, insecure, subrepos
  init: ssh, remotecmd, insecure
  locate: rev, print0, fullpath, include, exclude
  log: follow, follow-first, date, copies, keyword, rev, line-range, removed, only-merges, user, only-branch, branch, bookmark, prune, patch, git, limit, no-merges, stat, graph, style, template, include, exclude
  manifest: rev, all, template
  merge: force, rev, preview, abort, tool
  outgoing: force, rev, newest-first, bookmarks, branch, patch, git, limit, no-merges, stat, graph, style, template, ssh, remotecmd, insecure, subrepos
  parents: rev, style, template
  paths: template
  phase: public, draft, secret, force, rev
  pull: update, force, confirm, rev, bookmark, branch, remote-hidden, ssh, remotecmd, insecure
  purge: abort-on-err, all, ignored, dirs, files, print, print0, confirm, include, exclude
  push: force, rev, bookmark, all-bookmarks, branch, new-branch, pushvars, publish, ssh, remotecmd, insecure
  recover: verify
  remove: after, force, subrepos, include, exclude, dry-run
  rename: forget, after, at-rev, force, include, exclude, dry-run
  resolve: all, list, mark, unmark, no-status, re-merge, tool, include, exclude, template
  revert: all, date, rev, no-backup, interactive, include, exclude, dry-run
  rollback: dry-run, force
  root: template
  serve: accesslog, daemon, daemon-postexec, errorlog, port, address, prefix, name, web-conf, webdir-conf, pid-file, stdio, cmdserver, templates, style, ipv6, certificate, print-url, subrepos
  shelve: addremove, unknown, cleanup, date, delete, edit, keep, list, message, name, patch, interactive, stat, include, exclude
  status: all, modified, added, removed, deleted, clean, unknown, ignored, no-status, terse, copies, print0, rev, change, include, exclude, subrepos, template
  summary: remote
  tag: force, local, rev, remove, edit, message, date, user
  tags: template
  tip: patch, git, style, template
  unbundle: update
  unshelve: abort, continue, interactive, keep, name, tool, date
  update: clean, check, merge, date, rev, tool
  verify: full
  version: template

  $ hg init a
  $ cd a
  $ echo fee > fee
  $ hg ci -q -Amfee
  $ hg tag fee
  $ mkdir fie
  $ echo dead > fie/dead
  $ echo live > fie/live
  $ hg bookmark fo
  $ hg branch -q fie
  $ hg ci -q -Amfie
  $ echo fo > fo
  $ hg branch -qf default
  $ hg ci -q -Amfo
  $ echo Fum > Fum
  $ hg ci -q -AmFum
  $ hg bookmark Fum

Test debugpathcomplete

  $ hg debugpathcomplete f
  fee
  fie
  fo
  $ hg debugpathcomplete -f f
  fee
  fie/dead
  fie/live
  fo

  $ hg rm Fum
  $ hg debugpathcomplete -r F
  Fum

Test debugnamecomplete

  $ hg debugnamecomplete
  Fum
  default
  fee
  fie
  fo
  tip
  $ hg debugnamecomplete f
  fee
  fie
  fo

Test debuglabelcomplete, a deprecated name for debugnamecomplete that is still
used for completions in some shells.

  $ hg debuglabelcomplete
  Fum
  default
  fee
  fie
  fo
  tip
  $ hg debuglabelcomplete f
  fee
  fie
  fo