<commit_before># packer-post-processor-vhd

Packer post-processor plugin to produce Virtual Hard Disk (VHD) files.

VHD files can be used with the following hypervisors:

* Hyper-V
* VMWare
* VirtualBox
* XenServer

**packer-post-processor-vhd** supports converting [VirtualBox](https://www.packer.io/docs/builders/virtualbox.html) and [QEMU](https://www.packer.io/docs/builders/qemu.html) images to VHDs. It can be used as a post-processor for artifacts from both builders.

## Dependencies

* Packer 0.7+
* VirtualBox (`VBoxManage`) is required to convert VirtualBox artifacts.
* QEMU (`qemu-img`) is required to convert QEMU artifacts.

## Usage

Add a post-processor declaration to your Packer template:

```json
{
  "post-processors": [
    {
      "type": "vhd",
      "only": ["virtualbox-iso"],
    }
  ]
}
```

## Configuration

**packer-post-processor-vhd** supports the following optional configuration items:

* `output` (string)

    The path to the VHD file. This is a [configuration template](https://www.packer.io/docs/templates/configuration-templates.html). The template supports the following variables:

    * `{{ .BuildName }}`

        Replaced by the name of the builder (e.g., `virtualbox-iso` or a custom `name`).

    * `{{ .Provider }}`

        Replaced by the input artifact provider (e.g., `virtualbox`).

    * `{{ .ArtifactId }}`

        Replaced by the ID of the input artifact.

    Defaults to `packer_{{ .BuildName }}_{{ .Provider }}.vhd`.

* `force` (boolean)

    Whether to overwrite a pre-existing VHD file at `output` if it exists. Defaults to `false`.

* `keep_input_artifact` (boolean)

    Whether to keep the input artifact (e.g., VirtualBox image) after processing. Defaults to `false`.

## Installation

1. [Install Packer](https://packer.io/docs/installation.html).

1. Install the [Go toolchain](https://golang.org/doc/install), then install the package:

    ```
    go get github.com/benwebber/packer-post-processor-vhd
    go install github.com/benwebber/packer-post-processor-vhd
    ```

2. Copy the binary to your [Packer plugins directory](https://www.packer.io/docs/extend/plugins.html).

    * Linux and Mac OS X:

        ```
        cp $GOPATH/bin/packer-post-processor-vhd ~/packer.d/plugins
        ```
    * Windows:

        ```
        Copy-Item %GOPATH%\bin\packer-post-processor-vhd %APPDATA%\packer.d\plugins
        ```
<commit_msg>Document --force/force parameter equality<commit_after># packer-post-processor-vhd

Packer post-processor plugin to produce Virtual Hard Disk (VHD) files.

VHD files can be used with the following hypervisors:

* Hyper-V
* VMWare
* VirtualBox
* XenServer

**packer-post-processor-vhd** supports converting [VirtualBox](https://www.packer.io/docs/builders/virtualbox.html) and [QEMU](https://www.packer.io/docs/builders/qemu.html) images to VHDs. It can be used as a post-processor for artifacts from both builders.

## Dependencies

* Packer 0.7+
* VirtualBox (`VBoxManage`) is required to convert VirtualBox artifacts.
* QEMU (`qemu-img`) is required to convert QEMU artifacts.

## Usage

Add a post-processor declaration to your Packer template:

```json
{
  "post-processors": [
    {
      "type": "vhd",
      "only": ["virtualbox-iso"],
    }
  ]
}
```

## Configuration

**packer-post-processor-vhd** supports the following optional configuration items:

* `output` (string)

    The path to the VHD file. This is a [configuration template](https://www.packer.io/docs/templates/configuration-templates.html). The template supports the following variables:

    * `{{ .BuildName }}`

        Replaced by the name of the builder (e.g., `virtualbox-iso` or a custom `name`).

    * `{{ .Provider }}`

        Replaced by the input artifact provider (e.g., `virtualbox`).

    * `{{ .ArtifactId }}`

        Replaced by the ID of the input artifact.

    Defaults to `packer_{{ .BuildName }}_{{ .Provider }}.vhd`.

* `force` (boolean)

    Whether to overwrite a pre-existing VHD file at `output` if it exists. Specifying `--force` on the command line has the same effect. Defaults to `false`.

* `keep_input_artifact` (boolean)

    Whether to keep the input artifact (e.g., VirtualBox image) after processing. Defaults to `false`.

## Installation

1. [Install Packer](https://packer.io/docs/installation.html).

1. Install the [Go toolchain](https://golang.org/doc/install), then install the package:

    ```
    go get github.com/benwebber/packer-post-processor-vhd
    go install github.com/benwebber/packer-post-processor-vhd
    ```

2. Copy the binary to your [Packer plugins directory](https://www.packer.io/docs/extend/plugins.html).

    * Linux and Mac OS X:

        ```
        cp $GOPATH/bin/packer-post-processor-vhd ~/packer.d/plugins
        ```
    * Windows:

        ```
        Copy-Item %GOPATH%\bin\packer-post-processor-vhd %APPDATA%\packer.d\plugins
        ```

{'fraction_non_alphanumeric': 0.13322435635472007, 'fraction_numerical': 0.002043318348998774, 'mean_word_length': 3.286339754816112, 'pattern_counts': {'":': 6, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 12, 'lorem ipsum': 0, 'www.': 8, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3560919', 'n_tokens_mistral': 1616, 'n_tokens_neox': 1525, 'n_words': 449}