mirror of
https://github.com/vmware/vsphere-automation-sdk-python.git
synced 2024-11-23 01:49:59 -05:00
882 lines
106 KiB
HTML
882 lines
106 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>vmware.vapi.bindings.converter — 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="Module code" href="../../../index.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><a href="../../../../index.html">vSphere Automation SDK for Python 6.5.0 documentation</a> »</li>
|
|
<li><a href="../../../index.html" accesskey="U">Module code</a> »</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="document">
|
|
<div class="documentwrapper">
|
|
<div class="bodywrapper">
|
|
<div class="body">
|
|
|
|
<h1>Source code for vmware.vapi.bindings.converter</h1><div class="highlight"><pre>
|
|
<span class="sd">"""</span>
|
|
<span class="sd">Type converter to/from vAPI runtime data model to Python native data model</span>
|
|
<span class="sd">"""</span>
|
|
<span class="n">__author__</span> <span class="o">=</span> <span class="s">'VMware, Inc.'</span>
|
|
<span class="n">__copyright__</span> <span class="o">=</span> <span class="s">'Copyright (c) 2015-2016 VMware, Inc. All rights reserved.'</span>
|
|
|
|
<span class="kn">import</span> <span class="nn">logging</span>
|
|
<span class="kn">import</span> <span class="nn">six</span>
|
|
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.bindings.type</span> <span class="kn">import</span> <span class="p">(</span>
|
|
<span class="n">BindingTypeVisitor</span><span class="p">,</span> <span class="n">OptionalType</span><span class="p">,</span> <span class="n">MAP_KEY_FIELD</span><span class="p">,</span>
|
|
<span class="n">MAP_VALUE_FIELD</span><span class="p">)</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.bindings.enum</span> <span class="kn">import</span> <span class="n">Enum</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.bindings.error</span> <span class="kn">import</span> <span class="p">(</span><span class="n">VapiError</span><span class="p">,</span> <span class="n">UnresolvedError</span><span class="p">)</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.bindings.struct</span> <span class="kn">import</span> <span class="n">VapiStruct</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.bindings.datetime_helper</span> <span class="kn">import</span> <span class="n">DateTimeConverter</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.bindings.uri_helper</span> <span class="kn">import</span> <span class="n">URIValidator</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.data.serializers.python</span> <span class="kn">import</span> <span class="n">build_data_value</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.exception</span> <span class="kn">import</span> <span class="n">CoreException</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.lib.converter</span> <span class="kn">import</span> <span class="n">Converter</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.data.value</span> <span class="kn">import</span> <span class="n">DataValue</span><span class="p">,</span> <span class="n">StructValue</span>
|
|
<span class="kn">from</span> <span class="nn">vmware.vapi.l10n.runtime</span> <span class="kn">import</span> <span class="n">message_factory</span>
|
|
|
|
<span class="n">logger</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="n">__name__</span><span class="p">)</span>
|
|
|
|
|
|
<div class="viewcode-block" id="PythonToVapiVisitor"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor">[docs]</a><span class="k">class</span> <span class="nc">PythonToVapiVisitor</span><span class="p">(</span><span class="n">BindingTypeVisitor</span><span class="p">):</span> <span class="c"># pylint: disable=W0223</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visitor to convert from Python native value to vAPI DataValue</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Initialize PythonToVapiVisitor</span>
|
|
|
|
<span class="sd"> :type value: :class:`object`</span>
|
|
<span class="sd"> :param value: Native python value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">None</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_dispatch_map</span> <span class="o">=</span> <span class="p">{</span>
|
|
<span class="s">'VoidType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_void</span><span class="p">,</span>
|
|
<span class="s">'IntegerType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'DoubleType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'StringType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'SecretType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'BooleanType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'BlobType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'OptionalType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_optional</span><span class="p">,</span>
|
|
<span class="s">'ListType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_list</span><span class="p">,</span>
|
|
<span class="s">'SetType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_set</span><span class="p">,</span>
|
|
<span class="s">'MapType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_map</span><span class="p">,</span>
|
|
<span class="s">'StructType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_struct</span><span class="p">,</span>
|
|
<span class="s">'ErrorType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_error</span><span class="p">,</span>
|
|
<span class="s">'ReferenceType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_reference</span><span class="p">,</span>
|
|
<span class="s">'OpaqueType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_opaque</span><span class="p">,</span>
|
|
<span class="s">'DynamicStructType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_dynamic_struct</span><span class="p">,</span>
|
|
<span class="s">'AnyErrorType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_any_error</span><span class="p">,</span>
|
|
<span class="s">'DateTimeType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_date_time</span><span class="p">,</span>
|
|
<span class="s">'URIType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_uri</span><span class="p">,</span>
|
|
<span class="s">'EnumType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_enum</span><span class="p">,</span>
|
|
<span class="s">'IdType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="p">}</span>
|
|
<span class="n">BindingTypeVisitor</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
|
|
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit">[docs]</a> <span class="k">def</span> <span class="nf">visit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="n">class_name</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span>
|
|
<span class="n">method</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_dispatch_map</span><span class="p">[</span><span class="n">class_name</span><span class="p">]</span>
|
|
<span class="n">method</span><span class="p">(</span><span class="n">typ</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.get_out_value"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.get_out_value">[docs]</a> <span class="k">def</span> <span class="nf">get_out_value</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Returns the vAPI DataValue converted from the Python native value</span>
|
|
|
|
<span class="sd"> :rtype: :class:`vmware.vapi.data.value.DataValue`</span>
|
|
<span class="sd"> :return: vAPI DataValue</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_primitive"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_primitive">[docs]</a> <span class="k">def</span> <span class="nf">visit_primitive</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a primitive type python value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.BindingType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_void"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_void">[docs]</a> <span class="k">def</span> <span class="nf">visit_void</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a void value (i.e. None)</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.VoidType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.voiddef.expect.null'</span><span class="p">,</span>
|
|
<span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">()</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_opaque"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_opaque">[docs]</a> <span class="k">def</span> <span class="nf">visit_opaque</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit an opaque value. Don't do any conversion.</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.OpaqueType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">DataValue</span><span class="p">):</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.unexpected.python.type'</span><span class="p">,</span>
|
|
<span class="n">DataValue</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_list"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_list">[docs]</a> <span class="k">def</span> <span class="nf">visit_list</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a list value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.ListType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">in_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
<span class="n">out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">()</span>
|
|
<span class="n">elt_typ</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">element_type</span>
|
|
<span class="k">for</span> <span class="n">elt_value</span> <span class="ow">in</span> <span class="n">in_value</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">elt_value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">elt_typ</span><span class="p">)</span>
|
|
<span class="n">out_value</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">out_value</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_set"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_set">[docs]</a> <span class="k">def</span> <span class="nf">visit_set</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a python set</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.SetType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="nb">set</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="nb">frozenset</span><span class="p">):</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.invalid'</span><span class="p">,</span>
|
|
<span class="s">'set'</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">))</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit_list</span><span class="p">(</span><span class="n">typ</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_map"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_map">[docs]</a> <span class="k">def</span> <span class="nf">visit_map</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a python dict</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.MapType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">in_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
<span class="n">out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">()</span>
|
|
<span class="n">struct_def</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">element_type</span>
|
|
<span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">six</span><span class="o">.</span><span class="n">iteritems</span><span class="p">(</span><span class="n">in_value</span><span class="p">):</span>
|
|
<span class="n">struct_val</span> <span class="o">=</span> <span class="n">struct_def</span><span class="o">.</span><span class="n">new_value</span><span class="p">()</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">k</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">typ</span><span class="o">.</span><span class="n">key_type</span><span class="p">)</span>
|
|
<span class="n">struct_val</span><span class="o">.</span><span class="n">set_field</span><span class="p">(</span><span class="n">MAP_KEY_FIELD</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">v</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">typ</span><span class="o">.</span><span class="n">value_type</span><span class="p">)</span>
|
|
<span class="n">struct_val</span><span class="o">.</span><span class="n">set_field</span><span class="p">(</span><span class="n">MAP_VALUE_FIELD</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span><span class="p">)</span>
|
|
<span class="n">out_value</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">struct_val</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">out_value</span>
|
|
</div>
|
|
<span class="k">def</span> <span class="nf">_visit_vapi_struct</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit an instance of VapiStruct class</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.StructType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> :rtype: :class:`vmware.vapi.data.value.DataValue`</span>
|
|
<span class="sd"> :return: vAPI Data value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="c"># Check if it is the expected struct class</span>
|
|
<span class="n">expected_name</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">name</span>
|
|
<span class="n">actual_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">get_binding_type</span><span class="p">()</span><span class="o">.</span><span class="n">name</span>
|
|
<span class="c"># TODO: compare the types instead of names.</span>
|
|
<span class="k">if</span> <span class="n">expected_name</span> <span class="o">!=</span> <span class="n">actual_name</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.unexpected.struct.class'</span><span class="p">,</span>
|
|
<span class="n">expected_name</span><span class="p">,</span> <span class="n">actual_name</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="n">in_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
<span class="n">out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">()</span>
|
|
<span class="n">field_names</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">get_field_names</span><span class="p">()</span>
|
|
<span class="k">for</span> <span class="n">field</span> <span class="ow">in</span> <span class="n">field_names</span><span class="p">:</span>
|
|
<span class="k">try</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span><span class="o">.</span><span class="n">get_field</span><span class="p">(</span><span class="n">field</span><span class="p">)</span>
|
|
<span class="c"># If self._in_value is None and field type is not</span>
|
|
<span class="c"># optional, raise an error</span>
|
|
<span class="n">field_type</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">get_field</span><span class="p">(</span><span class="n">field</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="p">(</span><span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">field_type</span><span class="p">,</span> <span class="n">OptionalType</span><span class="p">)</span> <span class="ow">and</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">):</span>
|
|
<span class="k">raise</span> <span class="ne">AttributeError</span>
|
|
<span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.struct.missing.field'</span><span class="p">,</span>
|
|
<span class="n">field</span><span class="p">,</span> <span class="n">typ</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
|
|
<span class="k">try</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">typ</span><span class="o">.</span><span class="n">get_field</span><span class="p">(</span><span class="n">field</span><span class="p">))</span>
|
|
<span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.struct.invalid.field'</span><span class="p">,</span>
|
|
<span class="n">field</span><span class="p">,</span> <span class="n">typ</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">,</span> <span class="n">e</span><span class="p">)</span>
|
|
<span class="n">out_value</span><span class="o">.</span><span class="n">set_field</span><span class="p">(</span><span class="n">field</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">out_value</span>
|
|
|
|
<span class="k">def</span> <span class="nf">_visit_python_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit an instance of Python native dictionary</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.StructType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> :rtype: :class:`vmware.vapi.data.value.DataValue`</span>
|
|
<span class="sd"> :return: vAPI Data value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">in_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
<span class="n">out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">()</span>
|
|
<span class="n">field_names</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">get_field_names</span><span class="p">()</span>
|
|
<span class="k">for</span> <span class="n">field</span> <span class="ow">in</span> <span class="n">field_names</span><span class="p">:</span>
|
|
<span class="n">field_type</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">get_field</span><span class="p">(</span><span class="n">field</span><span class="p">)</span>
|
|
<span class="k">try</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span><span class="p">[</span><span class="n">field</span><span class="p">]</span>
|
|
<span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
|
|
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">field_type</span><span class="p">,</span> <span class="n">OptionalType</span><span class="p">):</span>
|
|
<span class="c"># If the field is optional, then tolerate</span>
|
|
<span class="c"># the absence of it in the dictionary</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="bp">None</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.dict.missing.key'</span><span class="p">,</span>
|
|
<span class="n">field</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">field_type</span><span class="p">)</span>
|
|
<span class="n">out_value</span><span class="o">.</span><span class="n">set_field</span><span class="p">(</span><span class="n">field</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">out_value</span>
|
|
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_struct"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_struct">[docs]</a> <span class="k">def</span> <span class="nf">visit_struct</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a struct value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.StructType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">VapiStruct</span><span class="p">):</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_visit_vapi_struct</span><span class="p">(</span><span class="n">typ</span><span class="p">)</span>
|
|
<span class="c"># Validating the constraints in the struct value</span>
|
|
<span class="c"># before sending it over the wire. The validation does</span>
|
|
<span class="c"># not happen during initialization of VapiStruct or</span>
|
|
<span class="c"># StructValue</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">validate_struct_value</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span><span class="p">)</span>
|
|
|
|
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_visit_python_dict</span><span class="p">(</span><span class="n">typ</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.unexpected.struct.type'</span><span class="p">,</span>
|
|
<span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_error"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_error">[docs]</a> <span class="k">def</span> <span class="nf">visit_error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit an error value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.ErrorType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">VapiError</span><span class="p">):</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_visit_vapi_struct</span><span class="p">(</span><span class="n">typ</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.unexpected.error.type'</span><span class="p">,</span>
|
|
<span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_dynamic_struct"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_dynamic_struct">[docs]</a> <span class="k">def</span> <span class="nf">visit_dynamic_struct</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit any struct value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.DynamicStructType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span> <span class="o">==</span> <span class="s">'VapiStruct'</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">get_struct_value</span><span class="p">()</span>
|
|
<span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span> <span class="o">==</span> <span class="s">'VapiError'</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">get_error_value</span><span class="p">()</span>
|
|
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">VapiStruct</span><span class="p">):</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_visit_vapi_struct</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">get_binding_type</span><span class="p">())</span>
|
|
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">StructValue</span><span class="p">):</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">build_data_value</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.unexpected.python.type'</span><span class="p">,</span>
|
|
<span class="n">StructValue</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_any_error"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_any_error">[docs]</a> <span class="k">def</span> <span class="nf">visit_any_error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit any error value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.AnyErrorType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">UnresolvedError</span><span class="p">):</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">get_error_value</span><span class="p">()</span>
|
|
<span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">VapiError</span><span class="p">):</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_visit_vapi_struct</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">get_binding_type</span><span class="p">())</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.unexpected.python.type'</span><span class="p">,</span>
|
|
<span class="n">VapiError</span><span class="o">.</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_optional"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_optional">[docs]</a> <span class="k">def</span> <span class="nf">visit_optional</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit an optional value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.OptionalType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">()</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">typ</span><span class="o">.</span><span class="n">element_type</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_date_time"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_date_time">[docs]</a> <span class="k">def</span> <span class="nf">visit_date_time</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a datetime value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.DateTimeType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">dt_str</span> <span class="o">=</span> <span class="n">DateTimeConverter</span><span class="o">.</span><span class="n">convert_from_datetime</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">(</span><span class="n">dt_str</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_uri"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_uri">[docs]</a> <span class="k">def</span> <span class="nf">visit_uri</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit an URI value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.UriType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">URIValidator</span><span class="o">.</span><span class="n">validate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_reference"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_reference">[docs]</a> <span class="k">def</span> <span class="nf">visit_reference</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a reference type</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.ReferenceType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">typ</span><span class="o">.</span><span class="n">resolved_type</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="PythonToVapiVisitor.visit_enum"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.PythonToVapiVisitor.visit_enum">[docs]</a> <span class="k">def</span> <span class="nf">visit_enum</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a enum type python value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.EnumType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="c"># If the binding type is EnumType, we will accept either</span>
|
|
<span class="c"># a plain string (or) a class variable of</span>
|
|
<span class="c"># :class:`vmware.vapi.bindings.enum.Enum` type.</span>
|
|
<span class="c"># String will be sent when the user invoked an API call</span>
|
|
<span class="c"># by sending a plain dictionary object (deserialized</span>
|
|
<span class="c"># from a human readable JSON).</span>
|
|
<span class="c"># Enum will be sent when the user use a language binding type</span>
|
|
<span class="c"># to invoke an operation.</span>
|
|
<span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">six</span><span class="o">.</span><span class="n">string_types</span><span class="p">):</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.unexpected.python.type'</span><span class="p">,</span>
|
|
<span class="n">typ</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span><span class="o">.</span><span class="n">__name__</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">,</span> <span class="n">Enum</span><span class="p">):</span>
|
|
<span class="c"># Check if it is the expected enum class</span>
|
|
<span class="n">expected_name</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">name</span>
|
|
<span class="n">actual_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">get_binding_type</span><span class="p">()</span><span class="o">.</span><span class="n">name</span>
|
|
<span class="c"># TODO: compare the types instead of names.</span>
|
|
<span class="k">if</span> <span class="n">expected_name</span> <span class="o">!=</span> <span class="n">actual_name</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.unexpected.enum.type'</span><span class="p">,</span>
|
|
<span class="n">expected_name</span><span class="p">,</span> <span class="n">actual_name</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="c"># Convert from vmware.vapi.bindings.Enum instance to string value</span>
|
|
<span class="n">enum_string_value</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">definition</span><span class="o">.</span><span class="n">new_value</span><span class="p">(</span><span class="n">enum_string_value</span><span class="p">)</span>
|
|
|
|
</div></div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor">[docs]</a><span class="k">class</span> <span class="nc">VapiToPythonVisitor</span><span class="p">(</span><span class="n">BindingTypeVisitor</span><span class="p">):</span> <span class="c"># pylint: disable=W0223</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visitor to convert from vAPI DataValue to Python native value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">resolver</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Initialize VapiToPythonVisitor</span>
|
|
|
|
<span class="sd"> :type value: :class:`vmware.vapi.data.value.DataValue`</span>
|
|
<span class="sd"> :param value: vAPI DataValue to be converted</span>
|
|
<span class="sd"> :type resolver: :class:`vmware.vapi.bindings.common.NameToTypeResolver` or</span>
|
|
<span class="sd"> ``None``</span>
|
|
<span class="sd"> :param resolver: Type resolver</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_resolver</span> <span class="o">=</span> <span class="n">resolver</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">None</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_dispatch_map</span> <span class="o">=</span> <span class="p">{</span>
|
|
<span class="s">'VoidType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_void</span><span class="p">,</span>
|
|
<span class="s">'IntegerType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'DoubleType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'StringType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_string</span><span class="p">,</span>
|
|
<span class="s">'SecretType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'BooleanType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'BlobType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="s">'OptionalType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_optional</span><span class="p">,</span>
|
|
<span class="s">'ListType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_list</span><span class="p">,</span>
|
|
<span class="s">'SetType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_set</span><span class="p">,</span>
|
|
<span class="s">'MapType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_map</span><span class="p">,</span>
|
|
<span class="s">'StructType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_struct</span><span class="p">,</span>
|
|
<span class="s">'ErrorType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_error</span><span class="p">,</span>
|
|
<span class="s">'ReferenceType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_reference</span><span class="p">,</span>
|
|
<span class="s">'OpaqueType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_opaque</span><span class="p">,</span>
|
|
<span class="s">'DynamicStructType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_dynamic_struct</span><span class="p">,</span>
|
|
<span class="s">'AnyErrorType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_any_error</span><span class="p">,</span>
|
|
<span class="s">'DateTimeType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_date_time</span><span class="p">,</span>
|
|
<span class="s">'URIType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_uri</span><span class="p">,</span>
|
|
<span class="s">'EnumType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_enum</span><span class="p">,</span>
|
|
<span class="s">'IdType'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">visit_primitive</span><span class="p">,</span>
|
|
<span class="p">}</span>
|
|
<span class="n">BindingTypeVisitor</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
|
|
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit">[docs]</a> <span class="k">def</span> <span class="nf">visit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="n">class_name</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">__class__</span><span class="o">.</span><span class="n">__name__</span>
|
|
<span class="n">method</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_dispatch_map</span><span class="p">[</span><span class="n">class_name</span><span class="p">]</span>
|
|
<span class="n">method</span><span class="p">(</span><span class="n">typ</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.get_out_value"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.get_out_value">[docs]</a> <span class="k">def</span> <span class="nf">get_out_value</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Returns the Python native value converted from the vAPI DataValue</span>
|
|
|
|
<span class="sd"> :rtype: :class:`object`</span>
|
|
<span class="sd"> :return: Native python value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_primitive"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_primitive">[docs]</a> <span class="k">def</span> <span class="nf">visit_primitive</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span> <span class="c"># pylint: disable=W0613</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit one of the primitive DataValues</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.BindingType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">value</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_void"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_void">[docs]</a> <span class="k">def</span> <span class="nf">visit_void</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Since there is no VoidValue, just return None</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.VoidType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">None</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_string"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_string">[docs]</a> <span class="k">def</span> <span class="nf">visit_string</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit StringValue</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.StringType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">try</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">value</span><span class="p">)</span>
|
|
<span class="k">except</span> <span class="ne">UnicodeError</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">value</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_opaque"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_opaque">[docs]</a> <span class="k">def</span> <span class="nf">visit_opaque</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Since there is no OpaqueValue, don't do any conversion</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.OpaqueType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
</div>
|
|
<span class="k">def</span> <span class="nf">_visit_list_element</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a ListValue element</span>
|
|
|
|
<span class="sd"> :type value: :class:`vmware.vapi.data.value.DataValue`</span>
|
|
<span class="sd"> :param value: element value</span>
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.ListType`</span>
|
|
<span class="sd"> :param typ: Binding type of the element</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">typ</span><span class="p">)</span>
|
|
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span>
|
|
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_list"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_list">[docs]</a> <span class="k">def</span> <span class="nf">visit_list</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a ListValue</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.ListType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">elt_typ</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">element_type</span>
|
|
<span class="n">in_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_visit_list_element</span><span class="p">(</span><span class="n">elt_value</span><span class="p">,</span> <span class="n">elt_typ</span><span class="p">)</span>
|
|
<span class="k">for</span> <span class="n">elt_value</span> <span class="ow">in</span> <span class="n">in_value</span><span class="p">]</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_set"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_set">[docs]</a> <span class="k">def</span> <span class="nf">visit_set</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a List Value. This ListValue must represent a set i.e. there must not be any duplicate elements</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.SetType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">elt_typ</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">element_type</span>
|
|
<span class="n">in_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
<span class="n">out_value</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
|
|
<span class="k">for</span> <span class="n">elt_value</span> <span class="ow">in</span> <span class="n">in_value</span><span class="p">:</span>
|
|
<span class="n">elt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_visit_list_element</span><span class="p">(</span><span class="n">elt_value</span><span class="p">,</span> <span class="n">elt_typ</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="n">elt</span> <span class="ow">in</span> <span class="n">out_value</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.set.duplicate.element'</span><span class="p">,</span>
|
|
<span class="n">elt</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="n">out_value</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">elt</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">out_value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_map"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_map">[docs]</a> <span class="k">def</span> <span class="nf">visit_map</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a List Value. This ListValue must represent a map. Each element</span>
|
|
<span class="sd"> of the ListValue is a StructValue with two fields, namely 'key' and 'value'.</span>
|
|
<span class="sd"> The 'key' field represents the key of the map and the 'value' field</span>
|
|
<span class="sd"> represents the value of the map. Also, since this represents a map, there</span>
|
|
<span class="sd"> should not be duplicate keys.</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.MapType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">in_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
<span class="n">key_typ</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">key_type</span>
|
|
<span class="n">value_typ</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">value_type</span>
|
|
<span class="n">out_value</span> <span class="o">=</span> <span class="p">{}</span>
|
|
<span class="k">for</span> <span class="n">elt_value</span> <span class="ow">in</span> <span class="n">in_value</span><span class="p">:</span>
|
|
<span class="n">key</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_visit_struct_field</span><span class="p">(</span><span class="n">elt_value</span><span class="o">.</span><span class="n">get_field</span><span class="p">(</span><span class="n">MAP_KEY_FIELD</span><span class="p">),</span>
|
|
<span class="n">key_typ</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">out_value</span><span class="p">:</span>
|
|
<span class="n">msg</span> <span class="o">=</span> <span class="n">message_factory</span><span class="o">.</span><span class="n">get_message</span><span class="p">(</span>
|
|
<span class="s">'vapi.bindings.typeconverter.map.duplicate.key'</span><span class="p">,</span>
|
|
<span class="n">key</span><span class="p">)</span>
|
|
<span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="k">raise</span> <span class="n">CoreException</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
|
|
<span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_visit_struct_field</span><span class="p">(</span><span class="n">elt_value</span><span class="o">.</span><span class="n">get_field</span><span class="p">(</span><span class="n">MAP_VALUE_FIELD</span><span class="p">),</span>
|
|
<span class="n">value_typ</span><span class="p">)</span>
|
|
<span class="n">out_value</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">out_value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span>
|
|
</div>
|
|
<span class="k">def</span> <span class="nf">_visit_struct_field</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a field of a StructValue</span>
|
|
|
|
<span class="sd"> :type value: :class:`vmware.vapi.data.value.DataValue`</span>
|
|
<span class="sd"> :param value: field value</span>
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.StructType`</span>
|
|
<span class="sd"> :param typ: Binding type of the struct field</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">typ</span><span class="p">)</span>
|
|
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span>
|
|
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_struct"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_struct">[docs]</a> <span class="k">def</span> <span class="nf">visit_struct</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit StructValue</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.StructType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">in_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span>
|
|
<span class="n">out_value</span> <span class="o">=</span> <span class="p">{}</span>
|
|
<span class="n">typ_field_names</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">get_field_names</span><span class="p">()</span>
|
|
<span class="n">value_field_names</span> <span class="o">=</span> <span class="n">in_value</span><span class="o">.</span><span class="n">get_field_names</span><span class="p">()</span>
|
|
|
|
<span class="k">for</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="n">typ_field_names</span><span class="p">:</span>
|
|
<span class="n">pep_name</span> <span class="o">=</span> <span class="n">Converter</span><span class="o">.</span><span class="n">canonical_to_pep</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
|
|
<span class="n">field_type</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">get_field</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
|
|
<span class="c"># When the request is converted from DataValue to Native value</span>
|
|
<span class="c"># on the server side:</span>
|
|
<span class="c"># - if the client - server version matches: we wont hit this case</span>
|
|
<span class="c"># - if new client talks to old server, runtime would have</span>
|
|
<span class="c"># raised InvalidArgument error if there are unexpected optional</span>
|
|
<span class="c"># fields</span>
|
|
<span class="c"># - if old client talks to new server, runtime adds the missing</span>
|
|
<span class="c"># optional fields, so we wont hit this case</span>
|
|
<span class="c">#</span>
|
|
<span class="c"># When the response is converted from DataValue to Native value</span>
|
|
<span class="c"># on the client side:</span>
|
|
<span class="c"># - if the client - server version matches: we wont hit this case</span>
|
|
<span class="c"># - if new client talks to old server, client bindings should</span>
|
|
<span class="c"># tolerate the absence of expected optional properties. So,</span>
|
|
<span class="c"># we have to set it to None!</span>
|
|
<span class="c"># - if old client talks to new server, we will visit all the known</span>
|
|
<span class="c"># fields here and the unexpected fields are added to the VapiStruct</span>
|
|
<span class="c"># object</span>
|
|
<span class="k">if</span> <span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="n">field_type</span><span class="p">,</span> <span class="n">OptionalType</span><span class="p">)</span> <span class="ow">and</span>
|
|
<span class="ow">not</span> <span class="n">in_value</span><span class="o">.</span><span class="n">has_field</span><span class="p">(</span><span class="n">field_name</span><span class="p">)):</span>
|
|
<span class="n">out_value</span><span class="p">[</span><span class="n">pep_name</span><span class="p">]</span> <span class="o">=</span> <span class="bp">None</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">out_value</span><span class="p">[</span><span class="n">pep_name</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_visit_struct_field</span><span class="p">(</span>
|
|
<span class="n">in_value</span><span class="o">.</span><span class="n">get_field</span><span class="p">(</span><span class="n">field_name</span><span class="p">),</span> <span class="n">field_type</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="n">in_value</span>
|
|
|
|
<span class="n">struct_class</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">binding_class</span>
|
|
<span class="k">if</span> <span class="n">struct_class</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span>
|
|
<span class="n">struct_class</span><span class="o">.</span><span class="n">validate_struct_value</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">struct_class</span><span class="p">(</span><span class="o">**</span><span class="n">out_value</span><span class="p">)</span>
|
|
|
|
<span class="c"># Fields present in struct value but not in struct binding type.</span>
|
|
<span class="n">unexpected_field_names</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">value_field_names</span><span class="p">)</span> <span class="o">-</span> <span class="nb">set</span><span class="p">(</span><span class="n">typ_field_names</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="n">unexpected_field_names</span><span class="p">:</span>
|
|
<span class="n">unexpected_fields</span> <span class="o">=</span> <span class="p">{}</span>
|
|
<span class="k">for</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="n">unexpected_field_names</span><span class="p">:</span>
|
|
<span class="n">unexpected_fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">in_value</span><span class="o">.</span><span class="n">get_field</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span><span class="o">.</span><span class="n">_set_unexpected_fields</span><span class="p">(</span><span class="n">unexpected_fields</span><span class="p">)</span> <span class="c"># pylint: disable=E1103,W0212</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">out_value</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_dynamic_struct"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_dynamic_struct">[docs]</a> <span class="k">def</span> <span class="nf">visit_dynamic_struct</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit StructValue to convert it into the base VapiStruct</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.DynamicStructType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">VapiStruct</span><span class="p">(</span><span class="n">struct_value</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_any_error"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_any_error">[docs]</a> <span class="k">def</span> <span class="nf">visit_any_error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit ErrorValue to convert it into the base VapiError</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.AnyErrorType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">typ</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_resolver</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_resolver</span><span class="o">.</span><span class="n">resolve</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
|
|
<span class="k">if</span> <span class="n">typ</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">UnresolvedError</span><span class="p">({},</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="n">typ</span><span class="o">.</span><span class="n">accept</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_error"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_error">[docs]</a> <span class="k">def</span> <span class="nf">visit_error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit ErrorValue</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.ErrorType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit_struct</span><span class="p">(</span><span class="n">typ</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_optional"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_optional">[docs]</a> <span class="k">def</span> <span class="nf">visit_optional</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit OptionalValue</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.OptionalType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">is_set</span><span class="p">():</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">value</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">typ</span><span class="o">.</span><span class="n">element_type</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="bp">None</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_date_time"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_date_time">[docs]</a> <span class="k">def</span> <span class="nf">visit_date_time</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a datetime value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.DateTimeType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">DateTimeConverter</span><span class="o">.</span><span class="n">convert_to_datetime</span><span class="p">(</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">value</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_uri"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_uri">[docs]</a> <span class="k">def</span> <span class="nf">visit_uri</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit an URI value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.UriType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">uri_string</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">value</span>
|
|
<span class="n">URIValidator</span><span class="o">.</span><span class="n">validate</span><span class="p">(</span><span class="n">uri_string</span><span class="p">)</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">uri_string</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_enum"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_enum">[docs]</a> <span class="k">def</span> <span class="nf">visit_enum</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit an Enum value</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.EnumType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">enum_string</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_value</span><span class="o">.</span><span class="n">value</span>
|
|
<span class="k">if</span> <span class="n">typ</span><span class="o">.</span><span class="n">binding_class</span><span class="p">:</span>
|
|
<span class="k">try</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">typ</span><span class="o">.</span><span class="n">binding_class</span><span class="p">,</span> <span class="n">enum_string</span><span class="p">)</span>
|
|
<span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">typ</span><span class="o">.</span><span class="n">binding_class</span><span class="p">(</span><span class="n">enum_string</span><span class="p">)</span>
|
|
<span class="k">else</span><span class="p">:</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">_out_value</span> <span class="o">=</span> <span class="n">Enum</span><span class="p">(</span><span class="n">enum_string</span><span class="p">)</span>
|
|
</div>
|
|
<div class="viewcode-block" id="VapiToPythonVisitor.visit_reference"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.VapiToPythonVisitor.visit_reference">[docs]</a> <span class="k">def</span> <span class="nf">visit_reference</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">typ</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Visit a reference type</span>
|
|
|
|
<span class="sd"> :type typ: :class:`vmware.vapi.bindings.type.ReferenceType`</span>
|
|
<span class="sd"> :param typ: Binding type of the value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="bp">self</span><span class="o">.</span><span class="n">visit</span><span class="p">(</span><span class="n">typ</span><span class="o">.</span><span class="n">resolved_type</span><span class="p">)</span>
|
|
|
|
</div></div>
|
|
<div class="viewcode-block" id="TypeConverter"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.TypeConverter">[docs]</a><span class="k">class</span> <span class="nc">TypeConverter</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Converter class that converts values from vAPI data model to Python native</span>
|
|
<span class="sd"> data model</span>
|
|
<span class="sd"> """</span>
|
|
|
|
<span class="nd">@staticmethod</span>
|
|
<div class="viewcode-block" id="TypeConverter.convert_to_python"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.TypeConverter.convert_to_python">[docs]</a> <span class="k">def</span> <span class="nf">convert_to_python</span><span class="p">(</span><span class="n">vapi_val</span><span class="p">,</span> <span class="n">binding_type</span><span class="p">,</span> <span class="n">resolver</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Converts vAPI DataValue to Python native value</span>
|
|
|
|
<span class="sd"> :type vapi_val: :class:`vmware.vapi.data.value.DataValue`</span>
|
|
<span class="sd"> :param vapi_val: vAPI DataValue to be converted</span>
|
|
<span class="sd"> :type binding_type: :class:`vmware.vapi.bindings.type.BindingType`</span>
|
|
<span class="sd"> :param binding_type: BindingType for the value</span>
|
|
<span class="sd"> :type resolver: :class:`vmware.vapi.bindings.common.NameToTypeResolver` or</span>
|
|
<span class="sd"> ``None``</span>
|
|
<span class="sd"> :param resolver: Type resolver</span>
|
|
<span class="sd"> :rtype: :class:`object`</span>
|
|
<span class="sd"> :return: Python native value</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">visitor</span> <span class="o">=</span> <span class="n">VapiToPythonVisitor</span><span class="p">(</span><span class="n">vapi_val</span><span class="p">,</span> <span class="n">resolver</span><span class="p">)</span>
|
|
<span class="n">binding_type</span><span class="o">.</span><span class="n">accept</span><span class="p">(</span><span class="n">visitor</span><span class="p">)</span>
|
|
<span class="k">return</span> <span class="n">visitor</span><span class="o">.</span><span class="n">get_out_value</span><span class="p">()</span>
|
|
</div>
|
|
<span class="nd">@staticmethod</span>
|
|
<div class="viewcode-block" id="TypeConverter.convert_to_vapi"><a class="viewcode-back" href="../../../../vmware.vapi.bindings.html#vmware.vapi.bindings.converter.TypeConverter.convert_to_vapi">[docs]</a> <span class="k">def</span> <span class="nf">convert_to_vapi</span><span class="p">(</span><span class="n">py_val</span><span class="p">,</span> <span class="n">binding_type</span><span class="p">):</span>
|
|
<span class="sd">"""</span>
|
|
<span class="sd"> Converts Python native value to vAPI DataValue</span>
|
|
|
|
<span class="sd"> :type py_val: :class:`object`</span>
|
|
<span class="sd"> :param py_val: Python native value to be converted</span>
|
|
<span class="sd"> :type binding_type: :class:`vmware.vapi.bindings.type.BindingType`</span>
|
|
<span class="sd"> :param binding_type: BindingType for the value</span>
|
|
<span class="sd"> :rtype: :class:`vmware.vapi.data.value.DataValue`</span>
|
|
<span class="sd"> :return: vAPI DataValue</span>
|
|
<span class="sd"> """</span>
|
|
<span class="n">visitor</span> <span class="o">=</span> <span class="n">PythonToVapiVisitor</span><span class="p">(</span><span class="n">py_val</span><span class="p">)</span>
|
|
<span class="n">binding_type</span><span class="o">.</span><span class="n">accept</span><span class="p">(</span><span class="n">visitor</span><span class="p">)</span>
|
|
<span class="k">return</span> <span class="n">visitor</span><span class="o">.</span><span class="n">get_out_value</span><span class="p">()</span></div></div>
|
|
</pre></div>
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sphinxsidebar">
|
|
<div class="sphinxsidebarwrapper">
|
|
<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><a href="../../../../index.html">vSphere Automation SDK for Python 6.5.0 documentation</a> »</li>
|
|
<li><a href="../../../index.html" >Module code</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> |