/pyvcloud

Python SDK for VMware vCloud Director
  1. Python 99.5%
  2. Shell 0.5%
Python Shell
Switch branches/tags
Nothing to show
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs Exception Handling doc (#243) May 16, 2018
examples VCDA-594: Add scripts to enable Jenkins multi-branch builds on commits ( May 9, 2018
pyvcloud [VDP-1661, VCDA-619] Added register, list, and unregister NSX-T Manag… Jun 8, 2018
system_tests [VDP-1661, VCDA-619] Added register, list, and unregister NSX-T Manag… Jun 8, 2018
tests [VCDA-606] Add NSX-T manager name optional parameter to create PVDC (#… May 8, 2018
.Jenkinsfile VCDA-594: Add scripts to enable Jenkins multi-branch builds on commits ( May 9, 2018
.gitignore VCDA-594: Add scripts to enable Jenkins multi-branch builds on commits ( May 9, 2018
.gitlab-ci.yml power-on/off Sep 20, 2017
.travis.yml travis fix (#215) Mar 8, 2018
AUTHORS Updated license files (#203) Mar 8, 2018
CODE_OF_CONDUCT.md Add code of conduct and PR/issue templates (#156) Jan 3, 2018
CONTRIBUTING.md Improve CONTRIBUTING.md to make it more informative (#153) Dec 27, 2017
ChangeLog Changelog Mar 9, 2018
Dockerfile publish Oct 11, 2017
Dockerfile.dev publish Oct 11, 2017
ISSUE_REQUEST.md Add code of conduct and PR/issue templates (#156) Jan 3, 2018
LICENSE.txt Updated license files (#203) Mar 8, 2018
MANIFEST.in Updated license files (#203) Mar 8, 2018
NOTICE.txt Updated license files (#203) Mar 8, 2018
PULL_REQUEST_TEMPLATE.md Add code of conduct and PR/issue templates (#156) Jan 3, 2018
README.md VCDA-180: Add detailed installation instructions for pyvcloud (#189) Jan 24, 2018
cleanup.sh VCDA-213 cleanup pyvcloud repository Dec 21, 2017
format-code.sh VCDA-409: validate PEP8 compliance (#183) Jan 23, 2018
open_source_license_pyvCloud19.2.0GA.txt Updated license files (#203) Mar 8, 2018
publish.sh VCDA-213 cleanup pyvcloud repository Dec 21, 2017
requirements.txt Updated requirements with version info (#194) Jan 26, 2018
setup.cfg travis fix (#215) Mar 8, 2018
setup.py VCDA-454: Updated copyrights for release (#204) Feb 13, 2018
test-requirements.txt VCDA-474: consider name and namespace in api extension (#201) Feb 7, 2018
tox.ini VCDA-409: validate PEP8 compliance (#183) Jan 23, 2018

README.md

pyvcloud

License Stable Version Build Status

pyvcloud is the Python SDK for VMware vCloud Director.

Installation

In general, pyvcloud can be installed with the following command:

$ pip install --user pyvcloud

Depending on your operating system and distribution you may need additional packages to install successfully. See install.md for full details.

Testing

Contributions to pyvcloud are welcome and it should include unit tests. See the contributing guide for details.

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.

Notes

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.

Contributing

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.

License

Apache-2.0