https://github.com/gryf/vboxmanage-bash-completion

VBoxManage bash completion
https://github.com/gryf/vboxmanage-bash-completion

bash bash-completion virtualbox

Last synced: about 24 hours ago
JSON representation

VBoxManage bash completion

• Host: GitHub
• URL: https://github.com/gryf/vboxmanage-bash-completion
• Owner: gryf
• License: other
• Created: 2015-04-13T14:48:04.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-10-07T09:16:33.000Z (3 months ago)
• Last Synced: 2024-12-16T01:05:28.360Z (8 days ago)
• Topics: bash, bash-completion, virtualbox
• Language: Shell
• Homepage: https://github.org/gryf/vboxmanage-bash-completion
• Size: 1.79 MB
• Stars: 110
• Watchers: 11
• Forks: 21
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
VBoxManage bash completion script

=================================

This version of the completion was initially based on Sebastian T. Hafner

script. However, in some point of time I've decided to rewrite it almost from

scratch.

Current version of script was written and tested against VBoxManage in version

7.0.20, and should contain all commands and their options.

Unlike other attempts, I've tried to make the script context aware. See the

simple session with the VBoxManage command below, to have an idea how it works:

.. image:: /images/vboxmanage_session.gif?raw=true

   :alt: VBoxManage session

Note, that ``startvm`` command proposes only VMs, which are not running, while

``controlvm`` will complete only running VMs.

What is worth to mention, this completion script is a real thing, so it only

offer things which have sense for particular commands, for example:

.. image:: /images/vboxmanage_snapshot.gif?raw=true

   :alt: Take a snapshot

For ``snapshot take`` subcommand, the only options which are proposed are

``--live`` and ``--description``. Other commands and subcommands are behaving in

similar way.

Installation

============

Either source the file::

    $ . /path/to/this/repo/VBoxManage

or add it to a proper place depending on your distribution. Usual place would

be:

* ~/bash-completion.d/

* /usr/local/etc/bash-completion.d/

* /etc/bash_completion.d/

* etc.

It's also okay to copy it into some directory, and place proper line in

``.profile`` or ``.bashrc``::

    source /some/directory/VBoxManage

License

=======

This software is licensed under 3-clause BSD license. See LICENSE file for

details.