https://pyvboxmanage.readthedocs.io/en/latest/docs/ Recent content in Docs on PyVBoxManage Hugo -- gohugo.io en-us https://pyvboxmanage.readthedocs.io/en/latest/docs/configuration-file/ Mon, 01 Jan 0001 00:00:00 +0000 https://pyvboxmanage.readthedocs.io/en/latest/docs/configuration-file/ PyVBoxManage # The pyvboxmanage configuration file is forgiving and flexible with several alternative configuration attribute names possible. Variables can be set by declaring vars Configurations can import other configuration files by declaring imports The input args and opts for each VBoxManage command follows the Virtual Box documentation https://www.virtualbox.org/manual/ch08.html All VBoxManage commands are supported and possible. vars # vars: <var1_name>: <value> <var2_name>: '<value>' <var3_name>: "<value>" ... <varN_name>: "<value>" imports # imports: - <pyvboxmanage-config-filename-1. https://pyvboxmanage.readthedocs.io/en/latest/docs/configuration-examples/ Mon, 01 Jan 0001 00:00:00 +0000 https://pyvboxmanage.readthedocs.io/en/latest/docs/configuration-examples/ PyVBoxManage # Example01 # vars: # Define some variables used in the "pyvboxmanage" sections from the imported configuration files. target_vmname: "Ubuntu-20.04-master" target_macaddress_prefix: "0800281901" imports: - 'Ubuntu-20.04-base-configuration.yml' - 'Ubuntu-20.04-cicd-configuration.yml' Example02 # vars: # Define some variables used in the "pyvboxmanage" section below. source_vmname: "Ubuntu-20.04-master" target_vmname: "Ubuntu-20.04-pipeline" target_basefolder: "/opt/virtual-machines" target_groups: "/cicd" target_bridgeadapter: "enp0s25" pyvboxmanage: # Command opts and args follow https://www.virtualbox.org/manual/ch08.html docs # Use stdout from showvminfo to confirm the string "running" is not present, # else stop running. https://pyvboxmanage.readthedocs.io/en/latest/docs/project/ Mon, 01 Jan 0001 00:00:00 +0000 https://pyvboxmanage.readthedocs.io/en/latest/docs/project/ PyVBoxManage # Project # Github - github.com/ndejong/pyvboxmanage PyPI - pypi.python.org/pypi/pyvboxmanage TravisCI - travis-ci.org/github/ndejong/pyvboxmanage ReadTheDocs - pyvboxmanage.readthedocs.io Features / Bugs # Please submit all feature-requests and bug-reports via Github issues - https://github.com/ndejong/pyvboxmanage/issues Contact # Nicholas de Jong https://nicholasdejong.com Other projects same author # Arpwitch - A modern arpwatch replacement with JSON formatted outputs and easy options to exec commands (eg. https://pyvboxmanage.readthedocs.io/en/latest/docs/changelog/ Mon, 01 Jan 0001 00:00:00 +0000 https://pyvboxmanage.readthedocs.io/en/latest/docs/changelog/ 0.4.2 (2021-06-05) # general fix: Fixes variable handling when int value is provided 0.4.1 (2021-06-05) # general fix: Fixes minumum click version 0.4.0 (2021-01-06) # general feature: Added ability to override variables via command line input arguments 0.3.1 (2020-12-31) # general fix: Improves config merge by using .extend() on list types 0. https://pyvboxmanage.readthedocs.io/en/latest/docs/development/ Mon, 01 Jan 0001 00:00:00 +0000 https://pyvboxmanage.readthedocs.io/en/latest/docs/development/ PyVBoxManage # Development # The following development tools are used to help create and manage this project. shut # shut is a Python package management and release tool - documentation link # Update package files $ shut pkg update # Test the package $ shut pkg test # Create a staged changelog entry for a fix/feature $ shut changelog --add fix --stage --message "Fixes bug" $ shut changelog --add feature --stage --message "Initial version" # Release bumps at patch/minor/major levels with --dry runs $ shut pkg bump --patch --tag --push --dry $ shut pkg bump --minor --tag --push --dry $ shut pkg bump --major --tag --push --dry # Build a package $ shut pkg build -vvv setuptools:wheel $ shut pkg build -vvv setuptools:* # Publish a package $ shut pkg publish --test warehouse:pypi $ shut pkg publish warehouse:pypi pydoc-markdown # pydoc-markdown is a documentation generation tool that works well with Python modules - documentation link https://pyvboxmanage.readthedocs.io/en/latest/docs/license/ Mon, 01 Jan 0001 00:00:00 +0000 https://pyvboxmanage.readthedocs.io/en/latest/docs/license/ Copyright 2021 Nicholas de Jong Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.