pyvcloud
is the Python SDK for VMware vCloud Director.
In general, pyvcloud
can be installed with the following command:
$ pip install --user pyvcloud
pyvcloud
can also be installed with virtualenv.
Contributions to pyvcloud
are welcome and it should include unit tests. See Contributing section below.
Check out the latest version and install:
git clone https://github.com/vmware/pyvcloud.git
cd pyvcloud
virtualenv .venv
source .venv/bin/activate
python setup.py develop
Sample test parameters are in file tests/config.yml. Create a copy to specify your own settings and use the VCD_TEST_CONFIG_FILE
env variable.
cd tests
cp config.yml private.config.yml
# customize credentials and other parameters
export VCD_TEST_CONFIG_FILE=private.config.yml
# run unit test
python -m unittest vcd_login vcd_catalog_setup
# run just a test method
python -m unittest vcd_catalog_setup.TestCatalogSetup.test_validate_ova
See tests for a list of current unit tests written for the new SDK implementation.
Please note that this project is under development and the interfaces might change over time.
pyvcloud
is used by vcd-cli, the Command Line Interface for VMware vCloud Director. It requires Python 3.
Previous versions and deprecated code can be found in this repository under tag 18.2.2.
The pyvcloud
project team welcomes contributions from the community. Before you start working with pyvcloud
, please read our Developer Certificate of Origin. All contributions to this repository must be signed as described on that page. Your signature certifies that you wrote the patch or have the right to pass it on as an open-source patch. For more detailed information, refer to CONTRIBUTING.md.