# rvtools2azmigrate
Convert an [RVTools](https://www.robware.net/rvtools/) export to an [Azure Migrate CSV inventory file](https://learn.microsoft.com/en-us/azure/migrate/tutorial-discover-import).
* Free software: MIT license
# Features
* Convert an RVTools export to an Azure Migrate CSV inventory file
* Anonymize the VM data by replacing the hostname with UUIDs
* Filter powered-off VMs
# Installation
## Using `PIP`
```bash
pip install rvtools2azmigrate
```
## From sources
The sources for `rvtools2azmigrate` can be downloaded from the [`Github repo`](https://github.com/lrivallain/rvtools2azmigrate).
You can either clone the public repository:
```bash
git clone git://github.com/lrivallain/rvtools2azmigrate
```
Or download the [`tarball`](https://github.com/lrivallain/rvtools2azmigrate/tarball/master):
```bash
curl -OJL https://github.com/lrivallain/rvtools2azmigrate/tarball/master
```
Once you have a copy of the source, you can install it with:
```bash
python setup.py install
```
or
```bash
pip install .
```
# Usage
```bash
rvtools2azmigrate --help
# Output
Usage: rvtools2azmigrate [OPTIONS] COMMAND[ARGS]...
Options:
--debug
--help Show this message and exit.
Commands:
convert Convert RVTools file to Azure Migrate format
```
## Convert RVTools file to Azure Migrate format
```bash
rvtools2azmigrate convert --help
# Output
Usage: rvtools2azmigrate convert [OPTIONS]
Convert RVTools file to Azure Migrate format
Options:
-i, --rvtools PATH RVTools input file [required]
-o, --output PATH Ouptut file [required]
--anonymized Anonymize the output file by replacing VM names with UUIDs
--filter-off-vms Filter the powered-off VMs
--filter-out TEXT Filter out VMs based on the provided patterns (contains + case-insensitive)
--help Show this message and exit.
```
### Examples
#### Anonymized
```bash
rvtools2azmigrate convert -i rvtools.xlsx -o azuremigrate.csv --anonymized
```
This will provide a CSV file to be imported in Azure Migrate manual discovery section. VMs names will be replaced by their UUID to anonymize the content of the exported file.
#### Filter off VMs
```bash
rvtools2azmigrate convert -i rvtools.xlsx -o azuremigrate.csv --filter-off-vms
```
This will provide a CSV file to be imported in Azure Migrate manual discovery section. Powered-Off VMs will not be exported to the CSV file.
#### Filter out VMs based on naming
It is possible to specify a list of patterns to filter out VMs based on their name.
```bash
rvtools2azmigrate convert -i rvtools.xlsx -o azuremigrate.csv \
--filter-out pattern1 \
--filter-out pattern2 \
--filter-out pattern3
```
This will provide a CSV file to be imported in Azure Migrate manual discovery section. VMs with one of the pattern in their name will be filtered out and not part of the exported file.
# History
## 0.2.0 (2024-05-21)
* Feat: Use python-slugify to generate VM names
* Feat: Filter out VMs based on name with `--filter-out pattern1 --filter-out pattern2`
## 0.1.3 (2023-10-11)
* Fix #2: Incorrect output if RV Tools input has a VM name with spaces in it
## 0.1.2 (2023-02-16)
* Fix import issue when used as installed module
## 0.1.1 (2023-02-03)
* Filter Powered-off VMs
* Automatic MiB/MB detection
* Intermediate `RvToolsVM` and `AzMigrateVM` objects
## 0.1.0 (2022-12-22)
* First release on GitHub.
Raw data
{
"_id": null,
"home_page": "https://github.com/lrivallain/rvtools2azmigrate",
"name": "rvtools2azmigrate",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "rvtools2azmigrate",
"author": "Ludovic Rivallain",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/11/32/cf4c872dfab32983a085eb40fcd80e827b41cbecdb2aad71936a20cbceaf/rvtools2azmigrate-0.2.0.tar.gz",
"platform": null,
"description": "# rvtools2azmigrate\n\nConvert an [RVTools](https://www.robware.net/rvtools/) export to an [Azure Migrate CSV inventory file](https://learn.microsoft.com/en-us/azure/migrate/tutorial-discover-import).\n\n* Free software: MIT license\n\n# Features\n\n* Convert an RVTools export to an Azure Migrate CSV inventory file\n* Anonymize the VM data by replacing the hostname with UUIDs\n* Filter powered-off VMs\n\n# Installation\n\n## Using `PIP`\n\n```bash\npip install rvtools2azmigrate\n```\n\n## From sources\n\nThe sources for `rvtools2azmigrate` can be downloaded from the [`Github repo`](https://github.com/lrivallain/rvtools2azmigrate).\n\nYou can either clone the public repository:\n\n```bash\ngit clone git://github.com/lrivallain/rvtools2azmigrate\n```\n\nOr download the [`tarball`](https://github.com/lrivallain/rvtools2azmigrate/tarball/master):\n\n```bash\ncurl -OJL https://github.com/lrivallain/rvtools2azmigrate/tarball/master\n```\n\nOnce you have a copy of the source, you can install it with:\n\n```bash\npython setup.py install\n```\n\nor\n\n```bash\npip install .\n```\n\n# Usage\n\n```bash\nrvtools2azmigrate --help\n# Output\nUsage: rvtools2azmigrate [OPTIONS] COMMAND[ARGS]...\n\nOptions:\n --debug\n --help Show this message and exit.\n\nCommands:\n convert Convert RVTools file to Azure Migrate format\n```\n\n## Convert RVTools file to Azure Migrate format\n\n```bash\nrvtools2azmigrate convert --help\n# Output\nUsage: rvtools2azmigrate convert [OPTIONS]\n\nConvert RVTools file to Azure Migrate format\n\nOptions:\n -i, --rvtools PATH RVTools input file [required]\n -o, --output PATH Ouptut file [required]\n --anonymized Anonymize the output file by replacing VM names with UUIDs\n --filter-off-vms Filter the powered-off VMs\n --filter-out TEXT Filter out VMs based on the provided patterns (contains + case-insensitive)\n --help Show this message and exit.\n```\n\n### Examples\n\n#### Anonymized\n\n```bash\nrvtools2azmigrate convert -i rvtools.xlsx -o azuremigrate.csv --anonymized\n```\n\nThis will provide a CSV file to be imported in Azure Migrate manual discovery section. VMs names will be replaced by their UUID to anonymize the content of the exported file.\n\n#### Filter off VMs\n\n```bash\nrvtools2azmigrate convert -i rvtools.xlsx -o azuremigrate.csv --filter-off-vms\n```\n\nThis will provide a CSV file to be imported in Azure Migrate manual discovery section. Powered-Off VMs will not be exported to the CSV file.\n\n\n#### Filter out VMs based on naming\n\nIt is possible to specify a list of patterns to filter out VMs based on their name.\n\n```bash\nrvtools2azmigrate convert -i rvtools.xlsx -o azuremigrate.csv \\\n --filter-out pattern1 \\\n --filter-out pattern2 \\\n --filter-out pattern3\n```\n\nThis will provide a CSV file to be imported in Azure Migrate manual discovery section. VMs with one of the pattern in their name will be filtered out and not part of the exported file.\n\n\n# History\n\n## 0.2.0 (2024-05-21)\n\n* Feat: Use python-slugify to generate VM names\n* Feat: Filter out VMs based on name with `--filter-out pattern1 --filter-out pattern2`\n\n## 0.1.3 (2023-10-11)\n\n* Fix #2: Incorrect output if RV Tools input has a VM name with spaces in it\n\n## 0.1.2 (2023-02-16)\n\n* Fix import issue when used as installed module\n\n## 0.1.1 (2023-02-03)\n\n* Filter Powered-off VMs\n* Automatic MiB/MB detection\n* Intermediate `RvToolsVM` and `AzMigrateVM` objects\n\n## 0.1.0 (2022-12-22)\n\n* First release on GitHub.\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "Convert an RVTools export to an Azure Migrate CSV inventory file",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/lrivallain/rvtools2azmigrate"
},
"split_keywords": [
"rvtools2azmigrate"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f02dd21fac32060e17f18b61113996a9a90ee3e5bbefa13b28067a494404723b",
"md5": "a90cfcdb43cc5ff4f256dd0005b98b29",
"sha256": "5bc4793a08eb677956e2f994444d1e315d76c922ece5093912acbb6a1d450469"
},
"downloads": -1,
"filename": "rvtools2azmigrate-0.2.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "a90cfcdb43cc5ff4f256dd0005b98b29",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 10016,
"upload_time": "2024-05-21T09:44:38",
"upload_time_iso_8601": "2024-05-21T09:44:38.103456Z",
"url": "https://files.pythonhosted.org/packages/f0/2d/d21fac32060e17f18b61113996a9a90ee3e5bbefa13b28067a494404723b/rvtools2azmigrate-0.2.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1132cf4c872dfab32983a085eb40fcd80e827b41cbecdb2aad71936a20cbceaf",
"md5": "34888a69df1b121c5aba968f2273b139",
"sha256": "64a64f813f7780f1a1cf811e0de2a6021e6e24078577bb633b24ec30309e7998"
},
"downloads": -1,
"filename": "rvtools2azmigrate-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "34888a69df1b121c5aba968f2273b139",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 9320,
"upload_time": "2024-05-21T09:44:39",
"upload_time_iso_8601": "2024-05-21T09:44:39.580360Z",
"url": "https://files.pythonhosted.org/packages/11/32/cf4c872dfab32983a085eb40fcd80e827b41cbecdb2aad71936a20cbceaf/rvtools2azmigrate-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-21 09:44:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lrivallain",
"github_project": "rvtools2azmigrate",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "rvtools2azmigrate"
}
JSON
