<div class="section" id="python-openzwave">
<h1>python-openzwave</h1>
<p>This is the new generation of python-openzwave.</p>
<p>python-openzwave is a python wrapper for the openzwave library.
It&#8217;s also contains an api (object representation of Zwave network) and ozwsh (a shell like manager using the api).</p>
<p>You can install python-openzwave in 3 ways :</p>
<blockquote>
<div><ul class="simple">
<li>From repository : you need to install mercurial, subversion and the common builds tools. Look at INSTALL_REPO to do such installation</li>
<li>From an archive : you don&#8217;t need to install mercurial, subversion. Only the common builds tools are needed. Look at INSTALL_ARCH to do such installation</li>
<li>From scratch : if you can&#8217;t build python-openzwave automatically or you are using windows or MacOS X. Look at INSTALL_MAN to do such installation</li>
</ul>
</div></blockquote>
<div class="section" id="migrating-from-python-openzwave-0-2-x-to-0-3-0">
<h2>Migrating from python-openzwave 0.2.X to 0.3.0</h2>
<p>This version (0.3.0) is under development, do not use it in a production environnement.</p>
<p>I need to update source tree of python-openzwave and modules&#8217;s names because of a bug in setuptools : <a class="reference external" href="https://bitbucket.org/pypa/setuptools/issue/230/develop-mode-does-not-respect-src">https://bitbucket.org/pypa/setuptools/issue/230/develop-mode-does-not-respect-src</a> .
Sorry for that.</p>
<p>So, before building python-openzwave, you must uninstall the old version :</p>
<div class="highlight-bash"><div class="highlight"><pre>sudo make uninstall
</pre></div>
</div>
<p>After that, reinstall python-openzwave using your prefered method.</p>
<p>About cython : I&#8217;ve made many tests using the cython installed via pip : (0.20, 0.21 and 0.22).
Compilation is ok but a segfault appears when launching the tests. Please remove it.</p>
<div class="highlight-bash"><div class="highlight"><pre>sudo pip uninstall Cython
</pre></div>
</div>
<p>And reinstall the one provided with your distribution</p>
<div class="highlight-bash"><div class="highlight"><pre>sudo make deps
</pre></div>
</div>
<p>If you have problems, please submit an issue with :</p>
<blockquote>
<div><ul class="simple">
<li>cython -V</li>
<li>the content of the directory /usr/local/lib/python2.7/dist-packages/ (for python2.7)</li>
<li>the content of /usr/local/lib/python2.7/dist-packages/easy-install.pth (for python 2.7)</li>
</ul>
</div></blockquote>
</div>
<div class="section" id="testing-python-openzwave">
<h2>Testing python-openzwave</h2>
<p>After installing python-openzwave, you can run tests :</p>
<div class="highlight-bash"><div class="highlight"><pre>sudo make tests
</pre></div>
</div>
</div>
<div class="section" id="documentation">
<h2>Documentation</h2>
<p>You can browse the documentation here : <a class="reference external" href="http://bibi21000.gallet.info/python-openzwave.html">http://bibi21000.gallet.info/python-openzwave.html</a>.</p>
</div>
<div class="section" id="to-do">
<h2>To do</h2>
<ul class="simple">
<li>Improve tests : add virtual nodes and controllers to pass test on travis</li>
<li>...</li>
</ul>
</div>
</div>