pyvmomi
------------
.. image:: https://img.shields.io/pypi/dm/pyvmomi.svg
:target: https://pypi.python.org/pypi/pyvmomi/
:alt: Downloads
pyVmomi is the Python SDK for the VMware vSphere API that allows you to manage
ESX, ESXi, and vCenter.
.. contents:: Table of Contents
:depth: 1
:local:
:backlinks: none
Getting Started
================
To get started, see the
`getting started guide <http://vmware.github.io/pyvmomi-community-samples/#getting-started>`_.
You'll need `Python <https://www.python.org/downloads/>`_,
`pip <https://pip.pypa.io/en/latest/installation/>`_, and the
`samples project <http://vmware.github.io/pyvmomi-community-samples/>`_.
Installing
==========
The master is code that is in development, official releases are tagged and
posted to `pypi <https://pypi.python.org/pypi/pyvmomi/>`_
* The official release is available using pip, just run
``pip install --upgrade pyvmomi``.
* To install the version in `github <https://github.com/vmware/pyvmomi>`_ use
``python setup.py develop`` for development install or
``python setup.py install``.
* To install `github's version <https://github.com/vmware/pyvmomi>`_ with sso support, just run
``pip install -e ".[sso]"`` inside project's home folder.
Testing
=======
Unit tests can be invoked by using the `tox <https://testrun.org/tox/>`_ command. You may have to
configure multiple python interpreters so that you can test in all the
environments listed in ``tox.ini`` or you will have to run ``tox`` with the
``-e`` flag to run only in your version of python. For example, if you only
have Python 2.7 then ``tox -e py27`` will limit your test run to Python 2.7.
Contributing
============
* Research `open issues <https://github.com/vmware/pyvmomi/issues?q=is%3Aopen+is%3Aissue>`_
* Follow the `contribution standards <https://github.com/vmware/pyvmomi/wiki/Contributions>`_
Documentation
=============
For general language neutral documentation of vSphere Management API see:
* `vSphere Web Services API Doc <https://code.vmware.com/apis/1720/vsphere>`_
Python Support
==============
* pyVmomi supports Python 3.4+
Versioning
====================
pyVmomi: **X.Y.Z.U.P**
vCenter-related:
**X.Y** - (Major release), **Z** - (Update release), **U** - (Patch)
pyVmomi-related:
**P** - (pyVmomi patches)
Compatibility Policy
====================
pyVmomi maintains minimum backward compatibility with the previous
*four* releases of *vSphere* and it's own previous four releases.
Compatibility with much older versions may continue to work but will
not be actively supported.
For example, version v6.0.0 is most compatible with vSphere 6.0, 5.5, 5.1 and
5.0. Initial releases compatible with a version of vSphere will bare a naked
version number of v6.0.0 indicating that version of pyVmomi was released
simultaneously with the *GA* version of vSphere with the same version number.
Support
====================
For official support, users with Premium SDK Support, Standard SDK Support and Premier/Success360 customers can reach out to `VMware Global Support <https://kb.vmware.com/s/article/87265?lang=en_US>`_ for any issues.
For community support, please open a `Github issue <https://github.com/vmware/pyvmomi/issues>`_ or start a `Discussion <https://github.com/vmware/pyvmomi/discussions>`_
Related Projects
================
* VMware vSphere Automation SDK for Python: https://github.com/vmware/vsphere-automation-sdk-python
* Samples Project: https://github.com/vmware/pyvmomi-community-samples
Have fun!
Raw data
{
"_id": null,
"home_page": "https://github.com/vmware/pyvmomi",
"name": "pyvmomi",
"maintainer": "",
"docs_url": null,
"requires_python": ">=2.7.9, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
"maintainer_email": "",
"keywords": "pyvmomi,vsphere,vmware,esx",
"author": "VMware, Inc.",
"author_email": "jhu@vmware.com",
"download_url": "https://files.pythonhosted.org/packages/ae/a4/70716f2fb132b105bc6cb4d4399491364582ab5690c87f19d6a9e4096037/pyvmomi-8.0.2.0.1.tar.gz",
"platform": "Windows",
"description": "pyvmomi\r\n------------\r\n.. image:: https://img.shields.io/pypi/dm/pyvmomi.svg\r\n :target: https://pypi.python.org/pypi/pyvmomi/\r\n :alt: Downloads\r\n\r\npyVmomi is the Python SDK for the VMware vSphere API that allows you to manage \r\nESX, ESXi, and vCenter.\r\n\r\n.. contents:: Table of Contents\r\n :depth: 1\r\n :local:\r\n :backlinks: none\r\n\r\nGetting Started\r\n================\r\nTo get started, see the\r\n`getting started guide <http://vmware.github.io/pyvmomi-community-samples/#getting-started>`_.\r\nYou'll need `Python <https://www.python.org/downloads/>`_,\r\n`pip <https://pip.pypa.io/en/latest/installation/>`_, and the\r\n`samples project <http://vmware.github.io/pyvmomi-community-samples/>`_.\r\n\r\nInstalling\r\n==========\r\nThe master is code that is in development, official releases are tagged and\r\nposted to `pypi <https://pypi.python.org/pypi/pyvmomi/>`_\r\n\r\n* The official release is available using pip, just run\r\n ``pip install --upgrade pyvmomi``.\r\n* To install the version in `github <https://github.com/vmware/pyvmomi>`_ use\r\n ``python setup.py develop`` for development install or\r\n ``python setup.py install``.\r\n* To install `github's version <https://github.com/vmware/pyvmomi>`_ with sso support, just run\r\n ``pip install -e \".[sso]\"`` inside project's home folder.\r\n\r\nTesting\r\n=======\r\nUnit tests can be invoked by using the `tox <https://testrun.org/tox/>`_ command. You may have to\r\nconfigure multiple python interpreters so that you can test in all the\r\nenvironments listed in ``tox.ini`` or you will have to run ``tox`` with the\r\n``-e`` flag to run only in your version of python. For example, if you only\r\nhave Python 2.7 then ``tox -e py27`` will limit your test run to Python 2.7.\r\n\r\nContributing\r\n============\r\n* Research `open issues <https://github.com/vmware/pyvmomi/issues?q=is%3Aopen+is%3Aissue>`_\r\n* Follow the `contribution standards <https://github.com/vmware/pyvmomi/wiki/Contributions>`_\r\n\r\nDocumentation\r\n=============\r\nFor general language neutral documentation of vSphere Management API see:\r\n\r\n* `vSphere Web Services API Doc <https://code.vmware.com/apis/1720/vsphere>`_\r\n\r\nPython Support\r\n==============\r\n* pyVmomi supports Python 3.4+\r\n\r\nVersioning\r\n====================\r\npyVmomi: **X.Y.Z.U.P**\r\n\r\nvCenter-related:\r\n**X.Y** - (Major release), **Z** - (Update release), **U** - (Patch)\r\n\r\npyVmomi-related:\r\n**P** - (pyVmomi patches)\r\n\r\nCompatibility Policy\r\n====================\r\npyVmomi maintains minimum backward compatibility with the previous\r\n*four* releases of *vSphere* and it's own previous four releases.\r\nCompatibility with much older versions may continue to work but will\r\nnot be actively supported.\r\n\r\nFor example, version v6.0.0 is most compatible with vSphere 6.0, 5.5, 5.1 and\r\n5.0. Initial releases compatible with a version of vSphere will bare a naked\r\nversion number of v6.0.0 indicating that version of pyVmomi was released\r\nsimultaneously with the *GA* version of vSphere with the same version number.\r\n\r\nSupport\r\n====================\r\nFor official support, users with Premium SDK Support, Standard SDK Support and Premier/Success360 customers can reach out to `VMware Global Support <https://kb.vmware.com/s/article/87265?lang=en_US>`_ for any issues.\r\nFor community support, please open a `Github issue <https://github.com/vmware/pyvmomi/issues>`_ or start a `Discussion <https://github.com/vmware/pyvmomi/discussions>`_\r\n\r\nRelated Projects\r\n================\r\n* VMware vSphere Automation SDK for Python: https://github.com/vmware/vsphere-automation-sdk-python\r\n* Samples Project: https://github.com/vmware/pyvmomi-community-samples\r\n\r\nHave fun!\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "License :: OSI Approved :: Apache Software License",
"summary": "VMware vSphere Python SDK",
"version": "8.0.2.0.1",
"project_urls": {
"Homepage": "https://github.com/vmware/pyvmomi"
},
"split_keywords": [
"pyvmomi",
"vsphere",
"vmware",
"esx"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "aea470716f2fb132b105bc6cb4d4399491364582ab5690c87f19d6a9e4096037",
"md5": "c1bf94f8cf52223dc114ce6463f46eb2",
"sha256": "791c4d93252e3c0896fecae8d785f8342b123672e7cae9c5548a639b9bf668ad"
},
"downloads": -1,
"filename": "pyvmomi-8.0.2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "c1bf94f8cf52223dc114ce6463f46eb2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2.7.9, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
"size": 852170,
"upload_time": "2023-11-17T10:15:41",
"upload_time_iso_8601": "2023-11-17T10:15:41.308908Z",
"url": "https://files.pythonhosted.org/packages/ae/a4/70716f2fb132b105bc6cb4d4399491364582ab5690c87f19d6a9e4096037/pyvmomi-8.0.2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-17 10:15:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vmware",
"github_project": "pyvmomi",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"tox": true,
"lcname": "pyvmomi"
}
JSON
