vim-addon-manager 0.4.4 / usr / bin / vim-addons

#!/usr/bin/ruby -w
#
# vim-addons: command line manager of Vim addons
#
# Copyright (C) 2007 Stefano Zacchiroli
# Copyright (C) 2009 James Vega
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Created:    Tue, 16 Jan 2007 10:04:20 +0100 zack
#

=begin

== NAME

vim-addons - command line manager of Vim add-ons

== SYNOPSIS

vim-addons [OPTION ...] [COMMAND [ADDON ...]]

== DESCRIPTION

Manage Vim addons installed system-wide, enabling on a per-user basis their
installation, removal, ...

vim-addons is capable of managing all Vim addons registered in the system-wide
registry of Vim addons (see vim-registry(5)). Each system-wide addon can be,
with respect to a user Vim configuration, in one of the following states:

:installed
  all of the files composing the addon are installed (i.e. symlinked) to their
  respective places under the target directory. The addon is fully functional
  for the current user

:removed
  the files composing the addon are not installed under the target directory.
  The addon might still be working for the current user if it is installed
  system-wide by the local administrator

:disabled
  the files composing the addon are not installed under the target directory,
  but the addon is installed system-wide. However, the addon has been disabled
  for the current user explicitly via some configuration line in
  plugin/vim-addons.vim under the target directory. The addon is not working
  for the current user

:broken
  only some of the files composing the addon are installed under the target
  directory. The addon is probably not working for the current user

:unavailable
  some (or all) of the files composing the addon are missing from the source
  directory

=== COMMANDS

A number of commands can be given to vim-addons to inspect or alter the status
of the addons: list, status, install, remove, disable, amend, files, show.

A description of the semantics of each command is reported below.

:list
  list, one per line, the names of the addons available in the system (i.e. of
  all the addons mentioned in the registry, not necessarily of all enabled
  addons)

:status
  show, one per line, the status of the addons available in the system. If one
  or more addon arguments are specified only show the status of those addons.
  This is the default command if nothing is specified.

:install
  install one or more addons under the target directory. Requires at least one
  addon argument

:remove
  remove one or more addons from the target directory. Requires at least one
  addon argument

:disable
  disable one or more addons to be used by the current user. Usually used for
  addons which are system-wide enabled by the local administrator but that the
  current user does not want to be used. Using this command will automatically
  change the content of plugin/vim-addons.vim under the target directory,
  probably adding ":let" commands which will inhibit the given addon from being
  used.  Requires at least one addon argument

:enable
  undo the effects of a previous disable command. Requires at least one addon
  argument

:files
  list, one per line, the files composing the specified addons. Files are
  listed relative to components of the Vim runtimepath (see 'runtimepath' in
  the Vim help). Requires at least one addon argument

:show
  displays detailed information about the specified addons

== OPTIONS

All commands accept the following options:

:-h, --help
  show this usage message and exit

:-q, --query
  be quiet and make the output more parseable (for "status")

:-r, --registry-dir
  set the registry directory (default: /usr/share/vim/registry)

:-s, --source-dir
  set the addons source directory (default: /usr/share/vim/addons)

:-t, --target-dir
  set the addons target directory (default: $HOME/.vim)

:-v, --verbose
  increase verbosity level

:-y, --system-dir
  set the system-wide target directory (default: /var/lib/vim/addons)

:-w, --system-wide
  set the addons target directory to the system-wide target directory, possibly
  overriding the -t option

== AUTHOR

Stefano Zacchiroli <zack@debian.org>
James Vega <jamessan@debian.org>

== SEE ALSO

vim(1), vim-registry(5)

== COPYRIGHT

Copyright (C) 2007 Stefano Zacchiroli
Copyright (C) 2009 James Vega

This program is free software, you can redistribute it and/or modify it under
the terms of the GNU General Public License version 3 as published by the
Free Software Foundation; either version 3 of the License, or (at your
option) any later version.

=end

require 'getoptlong'

require 'vim/addon-manager'
require 'vim/common'
require 'vim/registry'

def die_usage
  print <<EOS
Usage:
  vim-addons [OPTION ...] [COMMAND [ADDON ...]]
Commands:
  list, status (default command), install, remove, disable, enable, files, show
Options:
  -h, --help          show this usage message and exit
  -q, --query         be quiet and make the output more parseable
  -r, --registry-dir  set the registry directory
                        (default: /usr/share/vim/registry)
  -s, --source-dir    set the addons source directory
                        (default: /usr/share/vim/addons)
  -t, --target-dir    set the addons target directory
                        (default: $HOME/.vim)
  -v, --verbose       increase verbosity
  -y, --system-dir    set the system-wide target directory
                        (default: /var/lib/vim/addons)
  -w, --system-wide   set target directory to the system-wide one
                        (overrides -t setting)
EOS
  exit 1
end

def parse_cmdline
  options = { # defaults
    :registry_dir => '/usr/share/vim/registry',
    :source_dir   => '/usr/share/vim/addons',
    :system_dir   => '/var/lib/vim/addons',
    :target_dir   => File.join(ENV['HOME'], '.vim'),
    :query        => false,
    :system_wide  => false,
  }
  cmds = %w{install remove disable enable list status files show}
  req_arg_cmds = # commands requiring >= 1 arg
    %w{install remove disable amend files}
  cmdline =
    GetoptLong.new(['--help', '-h', GetoptLong::NO_ARGUMENT],
                   ['--registry-dir', '-r', GetoptLong::REQUIRED_ARGUMENT],
                   ['--source-dir', '-s', GetoptLong::REQUIRED_ARGUMENT],
                   ['--target-dir', '-t', GetoptLong::REQUIRED_ARGUMENT],
                   ['--query', '-q', GetoptLong::NO_ARGUMENT],
                   ['--verbose', '-v', GetoptLong::NO_ARGUMENT],
                   ['--system-dir', '-y', GetoptLong::REQUIRED_ARGUMENT],
                   ['--system-wide', '-w', GetoptLong::NO_ARGUMENT])
  begin
    cmdline.each do |opt, arg|
      case opt
      when '--help'
        die_usage
      when '--registry-dir'
        options[:registry_dir] = arg
      when '--source-dir'
        options[:source_dir] = arg
      when '--target-dir'
        options[:target_dir] = arg
      when '--query'
        options[:query] = true
      when '--verbose'
        Vim.increase_verbosity
      when '--system-dir'
        options[:system_dir] = arg
      when '--system-wide'
        options[:system_wide] = true
      end
    end
  rescue GetoptLong::Error
    die_usage
  end
  options[:target_dir] = options[:system_dir] if options[:system_wide]
  cmd = 'status' unless cmd = ARGV.shift
  die_usage unless cmds.member? cmd
  die_usage if req_arg_cmds.member? cmd and ARGV.empty?
  [cmd, ARGV, options]
end

cmd, args, options = parse_cmdline
registry = Vim::AddonRegistry.new(options[:registry_dir], options[:source_dir])
selected_addons =
  args.empty? ? registry.to_a : registry.select {|a| args.member? a.name}
unknown = args.select {|name| not (registry.any? {|a| a.name == name})}
Vim.warn "Ignoring unknown addons: #{unknown.join ', '}" unless unknown.empty?

case cmd
when 'list'
  puts registry.sort
when 'status'
  if options[:query]
    selected_addons.sort.each do |a|
      printf("%s\t%s\n", a, options[:system_wide] ? \
             a.status(options[:system_dir]) : a.status(options[:target_dir]))
    end
  else
    printf("# %-25s%-13s%-14s\n", 'Name', 'User Status', 'System Status')
    selected_addons.sort.each do |a|
      printf("%-28s%-14s%-14s\n", a, a.status(options[:target_dir]),
             a.status(options[:system_dir]))
    end
  end
when 'files'
  selected_addons.each {|a| puts a.files.to_a}
else
  mgr = Vim::AddonManager.new options[:source_dir], options[:target_dir]
  mgr.send cmd, selected_addons
end