<divclass="children"><h1>Upgrading pythonwhois</h1><divclass="text"><ahref="index.html"><<backtoindex</a></div><divclass="text">Depending on the version, upgrading to a new version of pythonwhois may entail a need for code changes. These are the usual guidelines:</div><dl><dt>Major version (x.0.0)</dt><dd>Major changes have been made to the API. This will almost certainly require a code change.<divclass="children"></div></dd></dl><dl><dt>Minor version (0.x.0)</dt><dd>Some changes have been made to the API, but these are backwards-compatible. There are probably new features that you're not yet utilizing, but current code will remain functional.<divclass="children"></div></dd></dl><dl><dt>Patch version (0.0.x)</dt><dd>Minor changes have been made that do not affect the API. Patch releases are usually changes in the parsing or normalization, or support for new WHOIS servers.<divclass="children"></div></dd></dl><divclass="text">More specific instructions are below.</div><h2>Upgrading from 1.x to 2.x</h2><divclass="text">The <spanclass="fixed">pythonwhois.whois</span> method has been removed, and is replaced by the <spanclass="fixed">pythonwhois.get_whois</span> method, <em>which has a significantly different API.</em> The following important changes have to be taken into account:</div><ul><li><strong>Empty keys are no longer filled with nulls; they are now simply absent. You cannot assume anymore that any keys will be present in the response, whatsoever.</strong></li><li> The <spanclass="fixed">name_servers</span> key has been renamed to <spanclass="fixed">nameservers</span>.</li><li> A new <spanclass="fixed">contacts</span>key has been added. Refer to the <ahref="usage.html">usage instructions</a> for more information.</li></ul></div>
