Metadata-Version: 2.1
Name: virtbulk
Version: 0.0.3
Summary: CLI to operate libvirt machines matched with globs
Home-page: https://gitlab.com/bergentroll/virtbulk
Author: Anton Karmanov
Author-email: a.karmanov@inventati.org
License: Apache
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
Provides-Extra: dev
License-File: LICENSE

﻿# VirtBulk

## Description

`virtbulk` is a CLI to apply basic operations on multiple libvirt virtual
machines (so called "domains") matched with globs.

## Installation

```shell
pip3 install virtbulk
```

## Usage

```shell
virtbulk FLAGS COMMAND TARGET [TARGET ...]
```

Most useful flags:
  - `-c`, `--uri` to set alternative libvirt URI
  - `-n`, `--dry-run` to show assumed changes and exit
  - `-f`,  `--format` to change output format
  - `-h`, `--help` to show comprehensive options and commans list
  - ...

Most useful commands:
  - `state` shows current states of machines
  - `start` turns machines on
  - `shutdown` sends command to shutdown
  - ...

Some commands provides `STATE_1 -> STATE_2` output format.
  - `->` means a state change
  - `-X` means the requested change can not be commit
  - `-!` means error while applying the change

## TODO

- Unit tests
- `help` command
- man page

## Links

- [virsh](https://www.libvirt.org/manpages/virsh.html)
- [libvirt Python API](https://libvirt.org/python.html)
