mirror of
https://github.com/vmware/vsphere-automation-sdk-python.git
synced 2024-11-25 10:50:00 -05:00
1132 lines
79 KiB
HTML
1132 lines
79 KiB
HTML
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
|
|
<title>lib Package — vSphere Automation SDK for Python 6.5.0 documentation</title>
|
|
|
|
<link rel="stylesheet" href="_static/vapitheme.css" type="text/css" />
|
|
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
|
|
|
|
<script type="text/javascript">
|
|
var DOCUMENTATION_OPTIONS = {
|
|
URL_ROOT: '',
|
|
VERSION: '6.5.0',
|
|
COLLAPSE_INDEX: false,
|
|
FILE_SUFFIX: '.html',
|
|
HAS_SOURCE: true
|
|
};
|
|
</script>
|
|
<script type="text/javascript" src="_static/jquery.js"></script>
|
|
<script type="text/javascript" src="_static/underscore.js"></script>
|
|
<script type="text/javascript" src="_static/doctools.js"></script>
|
|
<link rel="top" title="vSphere Automation SDK for Python 6.5.0 documentation" href="index.html" />
|
|
<link rel="up" title="vapi Package" href="vmware.vapi.html" />
|
|
<link rel="next" title="protocol Package" href="vmware.vapi.protocol.html" />
|
|
<link rel="prev" title="l10n Package" href="vmware.vapi.l10n.html" />
|
|
</head>
|
|
<body>
|
|
<div class="related">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="genindex.html" title="General Index"
|
|
accesskey="I">index</a></li>
|
|
<li class="right" >
|
|
<a href="py-modindex.html" title="Python Module Index"
|
|
>modules</a> |</li>
|
|
<li class="right" >
|
|
<a href="vmware.vapi.protocol.html" title="protocol Package"
|
|
accesskey="N">next</a> |</li>
|
|
<li class="right" >
|
|
<a href="vmware.vapi.l10n.html" title="l10n Package"
|
|
accesskey="P">previous</a> |</li>
|
|
<li><a href="index.html">vSphere Automation SDK for Python 6.5.0 documentation</a> »</li>
|
|
<li><a href="vmware.html" >vmware Package</a> »</li>
|
|
<li><a href="vmware.vapi.html" accesskey="U">vapi Package</a> »</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="document">
|
|
<div class="documentwrapper">
|
|
<div class="bodywrapper">
|
|
<div class="body">
|
|
|
|
<div class="section" id="lib-package">
|
|
<h1>lib Package<a class="headerlink" href="#lib-package" title="Permalink to this headline">¶</a></h1>
|
|
<div class="section" id="id1">
|
|
<h2><tt class="xref py py-mod docutils literal"><span class="pre">lib</span></tt> Package<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
|
|
<span class="target" id="module-vmware.vapi.lib"></span></div>
|
|
<div class="section" id="module-vmware.vapi.lib.addr_url_parser">
|
|
<span id="addr-url-parser-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">addr_url_parser</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.addr_url_parser" title="Permalink to this headline">¶</a></h2>
|
|
<p>vAPI configuration addr url parser</p>
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.addr_url_parser.get_url_scheme">
|
|
<tt class="descclassname">vmware.vapi.lib.addr_url_parser.</tt><tt class="descname">get_url_scheme</tt><big>(</big><em>url</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/addr_url_parser.html#get_url_scheme"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.addr_url_parser.get_url_scheme" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Get the scheme from the url (as described in <a class="reference external" href="http://www.rabbitmq.com/uri-spec.html">http://www.rabbitmq.com/uri-spec.html</a>)</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>url</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The addr url to parse</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">url scheme</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.addr_url_parser.parse_addr_url">
|
|
<tt class="descclassname">vmware.vapi.lib.addr_url_parser.</tt><tt class="descname">parse_addr_url</tt><big>(</big><em>url</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/addr_url_parser.html#parse_addr_url"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.addr_url_parser.parse_addr_url" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Parse addr url (as described in <a class="reference external" href="http://www.rabbitmq.com/uri-spec.html">http://www.rabbitmq.com/uri-spec.html</a>)
|
|
Note: This fn make no attempt to unescape the url, just like the urlparse</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>url</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The addr url to parse</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">tuple</span></tt> of (scheme, host, port, user, password, path, query_dict) where scheme: url scheme
|
|
host: hostname
|
|
port: query_dict is a dictionary of (name, [values])</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Parsed addr url</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.connect">
|
|
<span id="connect-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">connect</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.connect" title="Permalink to this headline">¶</a></h2>
|
|
<p>vAPI Connection factory</p>
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.connect.check_file_exists">
|
|
<tt class="descclassname">vmware.vapi.lib.connect.</tt><tt class="descname">check_file_exists</tt><big>(</big><em>filename</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/connect.html#check_file_exists"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.connect.check_file_exists" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Check if name is a file and exists</p>
|
|
<p>:type <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>
|
|
:param file name</p>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.connect.get_connector">
|
|
<tt class="descclassname">vmware.vapi.lib.connect.</tt><tt class="descname">get_connector</tt><big>(</big><em>rpc_provider_name</em>, <em>msg_protocol</em>, <em>ssl_context=None</em>, <em>**kwargs</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/connect.html#get_connector"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.connect.get_connector" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Create a connection to the vAPI Provider using the specified arguments</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>rpc_provider_name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The RPC provider to be used for the connection.
|
|
Valid values are ‘http’, ‘https’ and ‘requests’</li>
|
|
<li><strong>msg_protocol</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The message protocol to be used for the connection.
|
|
Valid values are ‘json’.</li>
|
|
<li><strong>ssl_context</strong> (<tt class="xref py py-class docutils literal"><span class="pre">OpenSSL.SSL.Context</span></tt>) – SSL context to use for SSL connections</li>
|
|
<li><strong>kwargs</strong> – Additional arguments for the RPC provider</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="vmware.vapi.protocol.client.html#vmware.vapi.protocol.client.connector.Connector" title="vmware.vapi.protocol.client.connector.Connector"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.protocol.client.connector.Connector</span></tt></a></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">Connection to the vAPI provider</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.connect.get_requests_connector">
|
|
<tt class="descclassname">vmware.vapi.lib.connect.</tt><tt class="descname">get_requests_connector</tt><big>(</big><em>session</em>, <em>msg_protocol='json'</em>, <em>url=None</em>, <em>timeout=None</em>, <em>pool_size=8</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/connect.html#get_requests_connector"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.connect.get_requests_connector" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Create a connection that uses ‘requests’ library for http(s) connections to
|
|
a vAPI Provider.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>session</strong> (<tt class="xref py py-class docutils literal"><span class="pre">requests.Session</span></tt>) – Session object</li>
|
|
<li><strong>msg_protocol</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Message protocol to be used for the connection. Valid
|
|
values are ‘json’.</li>
|
|
<li><strong>url</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – HTTP(S) URL to be used</li>
|
|
<li><strong>timeout</strong> (<tt class="xref py py-class docutils literal"><span class="pre">int</span></tt>) – Request timeout</li>
|
|
<li><strong>pool_size</strong> (<tt class="xref py py-class docutils literal"><span class="pre">int</span></tt>) – Connection pool size to be used</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="vmware.vapi.protocol.client.html#vmware.vapi.protocol.client.connector.Connector" title="vmware.vapi.protocol.client.connector.Connector"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.protocol.client.connector.Connector</span></tt></a></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">Connection to the vAPI provider</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.connect.get_requests_hok_connector">
|
|
<tt class="descclassname">vmware.vapi.lib.connect.</tt><tt class="descname">get_requests_hok_connector</tt><big>(</big><em>session</em>, <em>msg_protocol='json'</em>, <em>url=None</em>, <em>timeout=None</em>, <em>pool_size=8</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/connect.html#get_requests_hok_connector"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.connect.get_requests_hok_connector" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Create a connection that uses SAML Hok based authentication using ‘requests’
|
|
library to connect to a vAPI Provider.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>session</strong> (<tt class="xref py py-class docutils literal"><span class="pre">requests.Session</span></tt>) – Session object</li>
|
|
<li><strong>msg_protocol</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Message protocol to be used for the connection. Valid
|
|
values are ‘json’.</li>
|
|
<li><strong>url</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – HTTP(S) URL to be used</li>
|
|
<li><strong>timeout</strong> (<tt class="xref py py-class docutils literal"><span class="pre">int</span></tt>) – Request timeout</li>
|
|
<li><strong>pool_size</strong> (<tt class="xref py py-class docutils literal"><span class="pre">int</span></tt>) – Connection pool size to be used</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="vmware.vapi.protocol.client.html#vmware.vapi.protocol.client.connector.Connector" title="vmware.vapi.protocol.client.connector.Connector"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.protocol.client.connector.Connector</span></tt></a></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">Connection to the vAPI provider</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.connect.get_saml_hok_connector">
|
|
<tt class="descclassname">vmware.vapi.lib.connect.</tt><tt class="descname">get_saml_hok_connector</tt><big>(</big><em>rpc_provider_name</em>, <em>msg_protocol='json'</em>, <em>ssl_context=None</em>, <em>**kwargs</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/connect.html#get_saml_hok_connector"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.connect.get_saml_hok_connector" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Create a connection that uses SAML Hok based authentication
|
|
to connect to a vAPI Provider</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>rpc_provider_name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The RPC provider to be used for the connection.
|
|
Valid values are ‘http’, ‘https’ or ‘requests’</li>
|
|
<li><strong>msg_protocol</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The message protocol to be used for the connection.
|
|
Valid values are ‘json’.</li>
|
|
<li><strong>ssl_context</strong> (<tt class="xref py py-class docutils literal"><span class="pre">OpenSSL.SSL.Context</span></tt>) – SSL context to use for SSL connections</li>
|
|
<li><strong>kwargs</strong> (<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt> and <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt>) – Additional arguments for the RPC provider</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="vmware.vapi.protocol.client.html#vmware.vapi.protocol.client.connector.Connector" title="vmware.vapi.protocol.client.connector.Connector"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.protocol.client.connector.Connector</span></tt></a></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">Connection to the vAPI provider</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.constants">
|
|
<span id="constants-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">constants</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.constants" title="Permalink to this headline">¶</a></h2>
|
|
<p>String Constants used in vAPI runtime</p>
|
|
<dl class="class">
|
|
<dt id="vmware.vapi.lib.constants.Introspection">
|
|
<em class="property">class </em><tt class="descclassname">vmware.vapi.lib.constants.</tt><tt class="descname">Introspection</tt><a class="reference internal" href="_modules/vmware/vapi/lib/constants.html#Introspection"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.constants.Introspection" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p>
|
|
<p>String constants used in introsection service</p>
|
|
<dl class="attribute">
|
|
<dt id="vmware.vapi.lib.constants.Introspection.DATA_DEFINITION">
|
|
<tt class="descname">DATA_DEFINITION</tt><em class="property"> = 'com.vmware.vapi.std.introspection.operation.data_definition'</em><a class="headerlink" href="#vmware.vapi.lib.constants.Introspection.DATA_DEFINITION" title="Permalink to this definition">¶</a></dt>
|
|
<dd></dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="vmware.vapi.lib.constants.Introspection.OPERATION_SVC">
|
|
<tt class="descname">OPERATION_SVC</tt><em class="property"> = 'com.vmware.vapi.std.introspection.operation'</em><a class="headerlink" href="#vmware.vapi.lib.constants.Introspection.OPERATION_SVC" title="Permalink to this definition">¶</a></dt>
|
|
<dd></dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="vmware.vapi.lib.constants.Introspection.PACKAGE">
|
|
<tt class="descname">PACKAGE</tt><em class="property"> = 'com.vmware.vapi.std.introspection'</em><a class="headerlink" href="#vmware.vapi.lib.constants.Introspection.PACKAGE" title="Permalink to this definition">¶</a></dt>
|
|
<dd></dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="vmware.vapi.lib.constants.Introspection.PROVIDER_SVC">
|
|
<tt class="descname">PROVIDER_SVC</tt><em class="property"> = 'com.vmware.vapi.std.introspection.provider'</em><a class="headerlink" href="#vmware.vapi.lib.constants.Introspection.PROVIDER_SVC" title="Permalink to this definition">¶</a></dt>
|
|
<dd></dd></dl>
|
|
|
|
<dl class="attribute">
|
|
<dt id="vmware.vapi.lib.constants.Introspection.SERVICE_SVC">
|
|
<tt class="descname">SERVICE_SVC</tt><em class="property"> = 'com.vmware.vapi.std.introspection.service'</em><a class="headerlink" href="#vmware.vapi.lib.constants.Introspection.SERVICE_SVC" title="Permalink to this definition">¶</a></dt>
|
|
<dd></dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.context">
|
|
<span id="context-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">context</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.context" title="Permalink to this headline">¶</a></h2>
|
|
<p>Factory methods for creating application context</p>
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.context.create_default_application_context">
|
|
<tt class="descclassname">vmware.vapi.lib.context.</tt><tt class="descname">create_default_application_context</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/context.html#create_default_application_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.context.create_default_application_context" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Create a default application context. The
|
|
created context will only have opId.</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="vmware.vapi.html#vmware.vapi.core.ApplicationContext" title="vmware.vapi.core.ApplicationContext"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.core.ApplicationContext</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">Newly created application context</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.converter">
|
|
<span id="converter-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">converter</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.converter" title="Permalink to this headline">¶</a></h2>
|
|
<p>Convenience methods for converting variable names</p>
|
|
<dl class="class">
|
|
<dt id="vmware.vapi.lib.converter.Converter">
|
|
<em class="property">class </em><tt class="descclassname">vmware.vapi.lib.converter.</tt><tt class="descname">Converter</tt><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p>
|
|
<p>Convenience methods for converting variable names</p>
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.converter.Converter.canonical_to_pep">
|
|
<em class="property">static </em><tt class="descname">canonical_to_pep</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter.canonical_to_pep"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter.canonical_to_pep" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Converts the argument from vAPI canonical format to PEP8 compliant
|
|
parameter or attribute name</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The string to be converted</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The converted string</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.converter.Converter.capitalize">
|
|
<em class="property">static </em><tt class="descname">capitalize</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter.capitalize"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter.capitalize" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Capitalize the first letter of the name</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – name to be converted</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">name with first letter capitalized</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.converter.Converter.capwords_to_underscore">
|
|
<em class="property">static </em><tt class="descname">capwords_to_underscore</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter.capwords_to_underscore"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter.capwords_to_underscore" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Convert from CapWords to lower_case_with_underscore format</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – name in CapWords format</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">name in lower_case_with_underscore format</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.converter.Converter.mixedcase_to_underscore">
|
|
<em class="property">static </em><tt class="descname">mixedcase_to_underscore</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter.mixedcase_to_underscore"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter.mixedcase_to_underscore" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Convert from mixedCase to lower_case_with_underscore format</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – name in mixedCase format</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">name in lower_case_with_underscore format</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.converter.Converter.pepify">
|
|
<em class="property">static </em><tt class="descname">pepify</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter.pepify"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter.pepify" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Converts the argument into a name that conforms to PEP8 standard.
|
|
i.e. lower_case_with_underscore</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The string to be converted</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The converted string</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.converter.Converter.uncapitalize">
|
|
<em class="property">static </em><tt class="descname">uncapitalize</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter.uncapitalize"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter.uncapitalize" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Uncapitalize the first letter of the name</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – name to be converted</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">name with first letter uncapitalized</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.converter.Converter.underscore_to_capwords">
|
|
<em class="property">static </em><tt class="descname">underscore_to_capwords</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter.underscore_to_capwords"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter.underscore_to_capwords" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Convert from lower_case_with_underscore to CapWords format</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – name in lower_case_with_underscore</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">name in CapWords</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.converter.Converter.underscore_to_mixedcase">
|
|
<em class="property">static </em><tt class="descname">underscore_to_mixedcase</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter.underscore_to_mixedcase"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter.underscore_to_mixedcase" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Convert from lower_case_with_underscore to mixedCase format</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – name in lower_case_with_underscore</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">name in mixedCase</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.converter.Converter.unreserve_name">
|
|
<em class="property">static </em><tt class="descname">unreserve_name</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/converter.html#Converter.unreserve_name"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.converter.Converter.unreserve_name" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Converts the argument if it clashes with a python keyword. If the string
|
|
matches a keyword, adds a trailing underscore, else it returns the same
|
|
string</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>name</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The string to be converted</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">The converted string</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.fingerprint">
|
|
<span id="fingerprint-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">fingerprint</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.fingerprint" title="Permalink to this headline">¶</a></h2>
|
|
<p>Fingerprint related functions</p>
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.fingerprint.generate_fingerprint">
|
|
<tt class="descclassname">vmware.vapi.lib.fingerprint.</tt><tt class="descname">generate_fingerprint</tt><big>(</big><em>data</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/fingerprint.html#generate_fingerprint"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.fingerprint.generate_fingerprint" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Generate fingerprint for the given data</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">fingerprint of the given data</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.jsonlib">
|
|
<span id="jsonlib-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">jsonlib</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.jsonlib" title="Permalink to this headline">¶</a></h2>
|
|
<p>JSON encoder for double values</p>
|
|
<dl class="class">
|
|
<dt id="vmware.vapi.lib.jsonlib.DecimalEncoder">
|
|
<em class="property">class </em><tt class="descclassname">vmware.vapi.lib.jsonlib.</tt><tt class="descname">DecimalEncoder</tt><big>(</big><em>skipkeys=False</em>, <em>ensure_ascii=True</em>, <em>check_circular=True</em>, <em>allow_nan=True</em>, <em>sort_keys=False</em>, <em>indent=None</em>, <em>separators=None</em>, <em>encoding='utf-8'</em>, <em>default=None</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/jsonlib.html#DecimalEncoder"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.jsonlib.DecimalEncoder" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">json.encoder.JSONEncoder</span></tt></p>
|
|
<p>Class that adds capability of encoding decimal
|
|
in JSON</p>
|
|
<p>Constructor for JSONEncoder, with sensible defaults.</p>
|
|
<p>If skipkeys is False, then it is a TypeError to attempt
|
|
encoding of keys that are not str, int, long, float or None. If
|
|
skipkeys is True, such items are simply skipped.</p>
|
|
<p>If ensure_ascii is True, the output is guaranteed to be str
|
|
objects with all incoming unicode characters escaped. If
|
|
ensure_ascii is false, the output will be unicode object.</p>
|
|
<p>If check_circular is True, then lists, dicts, and custom encoded
|
|
objects will be checked for circular references during encoding to
|
|
prevent an infinite recursion (which would cause an OverflowError).
|
|
Otherwise, no such check takes place.</p>
|
|
<p>If allow_nan is True, then NaN, Infinity, and -Infinity will be
|
|
encoded as such. This behavior is not JSON specification compliant,
|
|
but is consistent with most JavaScript based encoders and decoders.
|
|
Otherwise, it will be a ValueError to encode such floats.</p>
|
|
<p>If sort_keys is True, then the output of dictionaries will be
|
|
sorted by key; this is useful for regression tests to ensure
|
|
that JSON serializations can be compared on a day-to-day basis.</p>
|
|
<p>If indent is a non-negative integer, then JSON array
|
|
elements and object members will be pretty-printed with that
|
|
indent level. An indent level of 0 will only insert newlines.
|
|
None is the most compact representation.</p>
|
|
<p>If specified, separators should be a (item_separator, key_separator)
|
|
tuple. The default is (‘, ‘, ‘: ‘). To get the most compact JSON
|
|
representation you should specify (‘,’, ‘:’) to eliminate whitespace.</p>
|
|
<p>If specified, default is a function that gets called for objects
|
|
that can’t otherwise be serialized. It should return a JSON encodable
|
|
version of the object or raise a <tt class="docutils literal"><span class="pre">TypeError</span></tt>.</p>
|
|
<p>If encoding is not None, then all input strings will be
|
|
transformed into unicode using that encoding prior to JSON-encoding.
|
|
The default is UTF-8.</p>
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.jsonlib.DecimalEncoder.default">
|
|
<tt class="descname">default</tt><big>(</big><em>o</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/jsonlib.html#DecimalEncoder.default"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.jsonlib.DecimalEncoder.default" title="Permalink to this definition">¶</a></dt>
|
|
<dd></dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.jsonlib.canonicalize_double">
|
|
<tt class="descclassname">vmware.vapi.lib.jsonlib.</tt><tt class="descname">canonicalize_double</tt><big>(</big><em>o</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/jsonlib.html#canonicalize_double"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.jsonlib.canonicalize_double" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Canonicalize double based on XML schema double canonical format</p>
|
|
<p>The exponent must be indicated by “E”. Leading zeroes and the
|
|
preceding optional “+” sign are prohibited in the exponent. If the
|
|
exponent is zero, it must be indicated by “E0”. For the mantissa, the
|
|
preceding optional “+” sign is prohibited and the decimal point is
|
|
required. Leading and trailing zeroes are prohibited subject to the
|
|
following: number representations must be normalized such that there
|
|
is a single digit which is non-zero to the left of the decimal point
|
|
and at least a single digit to the right of the decimal point unless
|
|
the value being represented is zero. The canonical representation
|
|
for zero is 0.0E0
|
|
<a class="reference external" href="http://www.w3.org/TR/xmlschema-2/#double">http://www.w3.org/TR/xmlschema-2/#double</a></p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>o</strong> (<tt class="xref py py-class docutils literal"><span class="pre">decimal.Decimal</span></tt>) – Decimal object to be canonicalized</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Canonical string representation of the decimal</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.load">
|
|
<span id="load-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">load</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.load" title="Permalink to this headline">¶</a></h2>
|
|
<p>Convenience methods for dynamic loading</p>
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.load.dynamic_import">
|
|
<tt class="descclassname">vmware.vapi.lib.load.</tt><tt class="descname">dynamic_import</tt><big>(</big><em>constructor</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/load.html#dynamic_import"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.load.dynamic_import" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Dynamically import a module and get the specified module attribute</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>constructor</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Fully qualified module attribute</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Python object</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.load.import_multiple_classes">
|
|
<tt class="descclassname">vmware.vapi.lib.load.</tt><tt class="descname">import_multiple_classes</tt><big>(</big><em>section</em>, <em>property_key</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/load.html#import_multiple_classes"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.load.import_multiple_classes" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Import multiple class names provided in the config file</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>section</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Name of the section in the config file</li>
|
|
<li><strong>property_key</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Name of the property in the config file</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">List of class references</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="log-module">
|
|
<h2><tt class="xref py py-mod docutils literal"><span class="pre">log</span></tt> Module<a class="headerlink" href="#log-module" title="Permalink to this headline">¶</a></h2>
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.profiler">
|
|
<span id="profiler-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">profiler</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.profiler" title="Permalink to this headline">¶</a></h2>
|
|
<p>Convenience methods for loading the profiler</p>
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.profiler.mock_profile">
|
|
<tt class="descclassname">vmware.vapi.lib.profiler.</tt><tt class="descname">mock_profile</tt><big>(</big><em>func</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/profiler.html#mock_profile"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.profiler.mock_profile" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Mock decorator that is used when the PROFILER is not set</p>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.profiler.profile">
|
|
<tt class="descclassname">vmware.vapi.lib.profiler.</tt><tt class="descname">profile</tt><big>(</big><em>func</em><big>)</big><a class="headerlink" href="#vmware.vapi.lib.profiler.profile" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Mock decorator that is used when the PROFILER is not set</p>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.ssl">
|
|
<span id="ssl-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">ssl</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.ssl" title="Permalink to this headline">¶</a></h2>
|
|
<p>SSL Context factories</p>
|
|
<dl class="class">
|
|
<dt id="vmware.vapi.lib.ssl.ClientContextFactory">
|
|
<em class="property">class </em><tt class="descclassname">vmware.vapi.lib.ssl.</tt><tt class="descname">ClientContextFactory</tt><a class="reference internal" href="_modules/vmware/vapi/lib/ssl.html#ClientContextFactory"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.ssl.ClientContextFactory" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p>
|
|
<p>Context factory base class. This class should be used to set the
|
|
SSL options</p>
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.ssl.ClientContextFactory.get_context">
|
|
<tt class="descname">get_context</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/ssl.html#ClientContextFactory.get_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.ssl.ClientContextFactory.get_context" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the SSL context</p>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="vmware.vapi.lib.ssl.DefaultClientContextFactory">
|
|
<em class="property">class </em><tt class="descclassname">vmware.vapi.lib.ssl.</tt><tt class="descname">DefaultClientContextFactory</tt><big>(</big><em>certificate=None</em>, <em>private_key=None</em>, <em>ca_certs=None</em>, <em>ca_certs_dir=None</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/ssl.html#DefaultClientContextFactory"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.ssl.DefaultClientContextFactory" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#vmware.vapi.lib.ssl.ClientContextFactory" title="vmware.vapi.lib.ssl.ClientContextFactory"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.lib.ssl.ClientContextFactory</span></tt></a></p>
|
|
<p>Default SSL context class. This chooses some default options for SSL context.
|
|
Clients can retrieve the context.</p>
|
|
<p>To modify the context and set some options directly. Create a class like below
|
|
and set the options. Pass this to the get_connector function</p>
|
|
<dl class="docutils">
|
|
<dt>class CustomClientContextFactory(DefaultClientContextFactory):</dt>
|
|
<dd><dl class="first last docutils">
|
|
<dt>def get_context(self):</dt>
|
|
<dd>ctx = DefaultClientContextFactory.get_context(self)
|
|
# modify ctx
|
|
return ctx</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
<p>Initialize DefaultClientContextFactory</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>certificate</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – File path of the certificate</li>
|
|
<li><strong>private_key</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – File path of the private key</li>
|
|
<li><strong>ca_certs</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – File path of ca certificates</li>
|
|
<li><strong>ca_certs_dir</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Directory prepared using the c_rehash tool
|
|
included with OpenSSL</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.ssl.DefaultClientContextFactory.get_context">
|
|
<tt class="descname">get_context</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/ssl.html#DefaultClientContextFactory.get_context"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.ssl.DefaultClientContextFactory.get_context" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Returns the SSL context</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">OpenSSL.SSL.Context</span></tt></td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">SSL context</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="vmware.vapi.lib.ssl.UnverifiedClientContextFactory">
|
|
<em class="property">class </em><tt class="descclassname">vmware.vapi.lib.ssl.</tt><tt class="descname">UnverifiedClientContextFactory</tt><a class="reference internal" href="_modules/vmware/vapi/lib/ssl.html#UnverifiedClientContextFactory"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.ssl.UnverifiedClientContextFactory" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <a class="reference internal" href="#vmware.vapi.lib.ssl.DefaultClientContextFactory" title="vmware.vapi.lib.ssl.DefaultClientContextFactory"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.lib.ssl.DefaultClientContextFactory</span></tt></a></p>
|
|
<p>Unverified SSL context class. This class retrieves an unverified SSL Context
|
|
with other options from the DefaultClientContext</p>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.std">
|
|
<span id="std-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">std</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.std" title="Permalink to this headline">¶</a></h2>
|
|
<p>Helper functions for manipulating vAPI runtime objects corresponding to
|
|
the standard types (e.g. LocalizableMessage) and errors</p>
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.std.make_error_value_from_error_value_and_msgs">
|
|
<tt class="descclassname">vmware.vapi.lib.std.</tt><tt class="descname">make_error_value_from_error_value_and_msgs</tt><big>(</big><em>error_def</em>, <em>cause</em>, <em>*msg_list</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/std.html#make_error_value_from_error_value_and_msgs"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.std.make_error_value_from_error_value_and_msgs" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Create an error result for a “standard” error from a cause ErrorValue
|
|
and an list of messages.</p>
|
|
<p>The list of message will be prepended to the messages from the cause
|
|
(if any).</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>error_def</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.data.type.ErrorDefinition</span></tt>) – ErrorDefintion for the error</li>
|
|
<li><strong>cause</strong> (<a class="reference internal" href="vmware.vapi.data.html#vmware.vapi.data.value.ErrorValue" title="vmware.vapi.data.value.ErrorValue"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.data.value.ErrorValue</span></tt></a>) – Lower level ErrorValue that “caused” the error</li>
|
|
<li><strong>msg_list</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="vmware.vapi.html#vmware.vapi.message.Message" title="vmware.vapi.message.Message"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.message.Message</span></tt></a>) – list of localizable messages</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="vmware.vapi.data.html#vmware.vapi.data.value.ErrorValue" title="vmware.vapi.data.value.ErrorValue"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.data.value.ErrorValue</span></tt></a></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">ErrorValue containing a single message</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.std.make_error_value_from_msg_id">
|
|
<tt class="descclassname">vmware.vapi.lib.std.</tt><tt class="descname">make_error_value_from_msg_id</tt><big>(</big><em>error_def</em>, <em>msg_id</em>, <em>*args</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/std.html#make_error_value_from_msg_id"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.std.make_error_value_from_msg_id" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Create an error result for a “standard” error</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>error_def</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.data.type.ErrorDefinition</span></tt>) – ErrorDefintion for the error</li>
|
|
<li><strong>msg_id</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Message identifier</li>
|
|
<li><strong>args</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – Argument list for constructing a Message</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="vmware.vapi.data.html#vmware.vapi.data.value.ErrorValue" title="vmware.vapi.data.value.ErrorValue"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.data.value.ErrorValue</span></tt></a></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">ErrorValue containing a single message</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.std.make_error_value_from_msgs">
|
|
<tt class="descclassname">vmware.vapi.lib.std.</tt><tt class="descname">make_error_value_from_msgs</tt><big>(</big><em>error_def</em>, <em>*msg_list</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/std.html#make_error_value_from_msgs"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.std.make_error_value_from_msgs" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Create an error result for a “standard” error</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>error_def</strong> (<tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.data.type.ErrorDefinition</span></tt>) – ErrorDefintion for the error</li>
|
|
<li><strong>msg_list</strong> (<tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of <a class="reference internal" href="vmware.vapi.html#vmware.vapi.message.Message" title="vmware.vapi.message.Message"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.message.Message</span></tt></a>) – list of localizable messages</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="vmware.vapi.data.html#vmware.vapi.data.value.ErrorValue" title="vmware.vapi.data.value.ErrorValue"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.data.value.ErrorValue</span></tt></a></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">ErrorValue containing a single message</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.std.make_std_error_def">
|
|
<tt class="descclassname">vmware.vapi.lib.std.</tt><tt class="descname">make_std_error_def</tt><big>(</big><em>name</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/std.html#make_std_error_def"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.std.make_std_error_def" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Internal function to create a “standard” ErrorDefinition for use only by
|
|
the vAPI runtime.
|
|
:type name: <tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>
|
|
:param args: Fully qualified name of the standard error type
|
|
:rtype: <a class="reference internal" href="vmware.vapi.data.html#vmware.vapi.data.definition.ErrorDefinition" title="vmware.vapi.data.definition.ErrorDefinition"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.data.definition.ErrorDefinition</span></tt></a>
|
|
:return: ErrorDefinition containing a single message field</p>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.thread_pool">
|
|
<span id="thread-pool-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">thread_pool</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.thread_pool" title="Permalink to this headline">¶</a></h2>
|
|
<p>This module is YATP (Yet another thread pool)</p>
|
|
<dl class="class">
|
|
<dt id="vmware.vapi.lib.thread_pool.ThreadPool">
|
|
<em class="property">class </em><tt class="descclassname">vmware.vapi.lib.thread_pool.</tt><tt class="descname">ThreadPool</tt><big>(</big><em>min_workers=1</em>, <em>max_workers=8</em>, <em>idle_timeout=300</em>, <em>logger=None</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/thread_pool.html#ThreadPool"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.thread_pool.ThreadPool" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p>
|
|
<p>Thread pool</p>
|
|
<p>Thread pool constructor</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name" colspan="2">Params min_workers:</th></tr>
|
|
<tr class="field-odd field"><td> </td><td class="field-body">Min number of worker threads</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name" colspan="2">Params max_workers:</th></tr>
|
|
<tr class="field-even field"><td> </td><td class="field-body">Max number of worker threads</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name" colspan="2">Params idle_timeout:</th></tr>
|
|
<tr class="field-odd field"><td> </td><td class="field-body">Worker threads idle timeout</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Params logger:</th><td class="field-body">logger to use. Default to stdout</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="staticmethod">
|
|
<dt id="vmware.vapi.lib.thread_pool.ThreadPool.normalize_works">
|
|
<em class="property">static </em><tt class="descname">normalize_works</tt><big>(</big><em>works</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/thread_pool.html#ThreadPool.normalize_works"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.thread_pool.ThreadPool.normalize_works" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Generator to return work in normalize form: (fn, args, kwargs)</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>works</strong> (<em>iteratable of fn / (fn, args) / (fn, args, kwargs)</em>) – An iteratable of possible functor form</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">tuple</span></tt> of (fn, args, kwargs)</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">A normalize tuple of (functor, args, kwargs)</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.thread_pool.ThreadPool.queue_work">
|
|
<tt class="descname">queue_work</tt><big>(</big><em>fn</em>, <em>*args</em>, <em>**kwargs</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/thread_pool.html#ThreadPool.queue_work"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.thread_pool.ThreadPool.queue_work" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Queue work</p>
|
|
<p>Returns a work_item when work is queued to work queue
|
|
The work will start when a ready worker is available to process the work
|
|
User could call {work_item}.join() to wait for the work item to finish</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>fn</strong> (<em>function</em>) – Work item functor</li>
|
|
<li><strong>args</strong> (<tt class="xref py py-class docutils literal"><span class="pre">tuple</span></tt>) – Work item functor positional parameters</li>
|
|
<li><strong>kwargs</strong> (<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>) – Work item functor key-value parameters</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><a class="reference internal" href="#vmware.vapi.lib.thread_pool.WorkItem" title="vmware.vapi.lib.thread_pool.WorkItem"><tt class="xref py py-class docutils literal"><span class="pre">WorkItem</span></tt></a></p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">work item when work is queued to work queue</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.thread_pool.ThreadPool.queue_work_and_wait">
|
|
<tt class="descname">queue_work_and_wait</tt><big>(</big><em>fn</em>, <em>*args</em>, <em>**kwargs</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/thread_pool.html#ThreadPool.queue_work_and_wait"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.thread_pool.ThreadPool.queue_work_and_wait" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Queue a work and wait until the work is completed / error out</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
|
|
<li><strong>fn</strong> (<em>function</em>) – Work item functor</li>
|
|
<li><strong>args</strong> (<tt class="xref py py-class docutils literal"><span class="pre">tuple</span></tt>) – Work item functor positional parameters</li>
|
|
<li><strong>kwargs</strong> (<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>) – Work item functor key-value parameters</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first"><tt class="xref py py-class docutils literal"><span class="pre">tuple</span></tt> of (<tt class="xref py py-class docutils literal"><span class="pre">bool</span></tt>, <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt>) or (<tt class="xref py py-class docutils literal"><span class="pre">bool</span></tt>, <tt class="xref py py-class docutils literal"><span class="pre">Exception</span></tt>)</p>
|
|
</td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">(True, return val) / (False, exception) when work is done</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.thread_pool.ThreadPool.queue_works_and_wait">
|
|
<tt class="descname">queue_works_and_wait</tt><big>(</big><em>works</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/thread_pool.html#ThreadPool.queue_works_and_wait"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.thread_pool.ThreadPool.queue_works_and_wait" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Queue a brunch of works and wait until all works are completed / error
|
|
out</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>works</strong> (<em>iteratable of fn / (fn, args) / (fn, args, kwargs)</em>) – An iteratable of possible functor form</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">list</span></tt> of {tuple} of <tt class="xref py py-class docutils literal"><span class="pre">bool</span></tt>,:class:<cite>object</cite> or <tt class="xref py py-class docutils literal"><span class="pre">bool</span></tt>,:class:<cite>Exception</cite></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">A list of (True, return val) / (False, exception) when all works done</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.thread_pool.ThreadPool.shutdown">
|
|
<tt class="descname">shutdown</tt><big>(</big><em>no_wait=False</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/thread_pool.html#ThreadPool.shutdown"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.thread_pool.ThreadPool.shutdown" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Shuthdown this thread pool</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>no_wait</strong> (<tt class="xref py py-class docutils literal"><span class="pre">bool</span></tt>) – Set to True to return immediately without waiting for all workers to quit</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
<dl class="class">
|
|
<dt id="vmware.vapi.lib.thread_pool.WorkItem">
|
|
<em class="property">class </em><tt class="descclassname">vmware.vapi.lib.thread_pool.</tt><tt class="descname">WorkItem</tt><big>(</big><em>fn</em>, <em>*args</em>, <em>**kwargs</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/thread_pool.html#WorkItem"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.thread_pool.WorkItem" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p>
|
|
<p>Work item</p>
|
|
<p>Work item constructor</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
|
|
<li><strong>fn</strong> (<em>function</em>) – Work item functor</li>
|
|
<li><strong>args</strong> (<tt class="xref py py-class docutils literal"><span class="pre">tuple</span></tt>) – Work item functor positional parameters</li>
|
|
<li><strong>kwargs</strong> (<tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt>) – Work item functor key-value parameters</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.thread_pool.WorkItem.done">
|
|
<tt class="descname">done</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/thread_pool.html#WorkItem.done"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.thread_pool.WorkItem.done" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Signal work item is done</p>
|
|
</dd></dl>
|
|
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.thread_pool.WorkItem.join">
|
|
<tt class="descname">join</tt><big>(</big><em>timeout=inf</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/thread_pool.html#WorkItem.join"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.thread_pool.WorkItem.join" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Wait for work item is done</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>timeout</strong> (<tt class="xref py py-class docutils literal"><span class="pre">float</span></tt>) – Timeout in seconds</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">Work item functor’s return value</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.visitor">
|
|
<span id="visitor-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">visitor</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.visitor" title="Permalink to this headline">¶</a></h2>
|
|
<p>Visitor helper class</p>
|
|
<dl class="class">
|
|
<dt id="vmware.vapi.lib.visitor.VapiVisitor">
|
|
<em class="property">class </em><tt class="descclassname">vmware.vapi.lib.visitor.</tt><tt class="descname">VapiVisitor</tt><big>(</big><em>suffix=None</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/visitor.html#VapiVisitor"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.visitor.VapiVisitor" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p>
|
|
<p>Convenience class for visitors used in vAPI Python runtime</p>
|
|
<p>Initialize VapiVisitor</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>suffix</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – The suffix string that should be removed from
|
|
class name during the dispatch</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<dl class="method">
|
|
<dt id="vmware.vapi.lib.visitor.VapiVisitor.visit">
|
|
<tt class="descname">visit</tt><big>(</big><em>value</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/visitor.html#VapiVisitor.visit"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.visitor.VapiVisitor.visit" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Dispatch the call to the appropriate method based
|
|
on the type of the input argument</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>value</strong> (<tt class="xref py py-class docutils literal"><span class="pre">object</span></tt>) – The object to be used for dispatch</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="module-vmware.vapi.lib.workers_pool">
|
|
<span id="workers-pool-module"></span><h2><tt class="xref py py-mod docutils literal"><span class="pre">workers_pool</span></tt> Module<a class="headerlink" href="#module-vmware.vapi.lib.workers_pool" title="Permalink to this headline">¶</a></h2>
|
|
<p>Workers thread pool</p>
|
|
<dl class="function">
|
|
<dt id="vmware.vapi.lib.workers_pool.get_workers_pool">
|
|
<tt class="descclassname">vmware.vapi.lib.workers_pool.</tt><tt class="descname">get_workers_pool</tt><big>(</big><em>pool_tag</em><big>)</big><a class="reference internal" href="_modules/vmware/vapi/lib/workers_pool.html#get_workers_pool"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#vmware.vapi.lib.workers_pool.get_workers_pool" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>get workers pool</p>
|
|
<table class="docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>pool_tag</strong> (<tt class="xref py py-class docutils literal"><span class="pre">str</span></tt>) – workers pool tag</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference internal" href="#vmware.vapi.lib.thread_pool.ThreadPool" title="vmware.vapi.lib.thread_pool.ThreadPool"><tt class="xref py py-class docutils literal"><span class="pre">vmware.vapi.lib.thread_pool.ThreadPool</span></tt></a></td>
|
|
</tr>
|
|
<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">workers pool</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="subpackages">
|
|
<h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to this headline">¶</a></h2>
|
|
<div class="toctree-wrapper compound">
|
|
<ul class="simple">
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sphinxsidebar">
|
|
<div class="sphinxsidebarwrapper">
|
|
<h3><a href="index.html">Table Of Contents</a></h3>
|
|
<ul>
|
|
<li><a class="reference internal" href="#">lib Package</a><ul>
|
|
<li><a class="reference internal" href="#id1"><tt class="docutils literal"><span class="pre">lib</span></tt> Package</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.addr_url_parser"><tt class="docutils literal"><span class="pre">addr_url_parser</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.connect"><tt class="docutils literal"><span class="pre">connect</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.constants"><tt class="docutils literal"><span class="pre">constants</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.context"><tt class="docutils literal"><span class="pre">context</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.converter"><tt class="docutils literal"><span class="pre">converter</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.fingerprint"><tt class="docutils literal"><span class="pre">fingerprint</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.jsonlib"><tt class="docutils literal"><span class="pre">jsonlib</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.load"><tt class="docutils literal"><span class="pre">load</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#log-module"><tt class="docutils literal"><span class="pre">log</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.profiler"><tt class="docutils literal"><span class="pre">profiler</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.ssl"><tt class="docutils literal"><span class="pre">ssl</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.std"><tt class="docutils literal"><span class="pre">std</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.thread_pool"><tt class="docutils literal"><span class="pre">thread_pool</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.visitor"><tt class="docutils literal"><span class="pre">visitor</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#module-vmware.vapi.lib.workers_pool"><tt class="docutils literal"><span class="pre">workers_pool</span></tt> Module</a></li>
|
|
<li><a class="reference internal" href="#subpackages">Subpackages</a><ul>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<h4>Previous topic</h4>
|
|
<p class="topless"><a href="vmware.vapi.l10n.html"
|
|
title="previous chapter">l10n Package</a></p>
|
|
<h4>Next topic</h4>
|
|
<p class="topless"><a href="vmware.vapi.protocol.html"
|
|
title="next chapter">protocol Package</a></p>
|
|
<h3>This Page</h3>
|
|
<ul class="this-page-menu">
|
|
<li><a href="_sources/vmware.vapi.lib.txt"
|
|
rel="nofollow">Show Source</a></li>
|
|
</ul>
|
|
<div id="searchbox" style="display: none">
|
|
<h3>Quick search</h3>
|
|
<form class="search" action="search.html" method="get">
|
|
<input type="text" name="q" />
|
|
<input type="submit" value="Go" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
<p class="searchtip" style="font-size: 90%">
|
|
Enter search terms or a module, class or function name.
|
|
</p>
|
|
</div>
|
|
<script type="text/javascript">$('#searchbox').show(0);</script>
|
|
</div>
|
|
</div>
|
|
<div class="clearer"></div>
|
|
</div>
|
|
<div class="related">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="genindex.html" title="General Index"
|
|
>index</a></li>
|
|
<li class="right" >
|
|
<a href="py-modindex.html" title="Python Module Index"
|
|
>modules</a> |</li>
|
|
<li class="right" >
|
|
<a href="vmware.vapi.protocol.html" title="protocol Package"
|
|
>next</a> |</li>
|
|
<li class="right" >
|
|
<a href="vmware.vapi.l10n.html" title="l10n Package"
|
|
>previous</a> |</li>
|
|
<li><a href="index.html">vSphere Automation SDK for Python 6.5.0 documentation</a> »</li>
|
|
<li><a href="vmware.html" >vmware Package</a> »</li>
|
|
<li><a href="vmware.vapi.html" >vapi Package</a> »</li>
|
|
</ul>
|
|
</div>
|
|
<div class="footer">
|
|
© Copyright 2014, VMware, Inc..
|
|
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
|
|
</div>
|
|
</body>
|
|
</html> |