<div dir="ltr"><div><span id="gmail-docs-internal-guid-23104ad7-c8be-2eac-de4c-eb7bc6447406"><h2 dir="ltr" style="line-height:1.38;margin-top:18pt;margin-bottom:6pt"><span style="font-size:16pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline;white-space:pre-wrap">MAAS Client Library — libmaas (0.4.1)</span></h2><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline;white-space:pre-wrap">The MAAS team is happy to announce the introduction of a new and improved MAAS Client Library (python-libmaas). The MAAS team has started working on  an asyncio-based client library to allow developers, integrators and administrators to better interact with MAAS.</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline;white-space:pre-wrap">While this is an initial client library release and does not support all MAAS endpoints (nor all operations), we would like our users to test and provide provide feedback. The currently supported releases include both MAAS 2.1 & 2.2.</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Also, If you wish to contribute to the development of the client library, please see below!</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;font-weight:700;vertical-align:baseline;white-space:pre-wrap">Available endpoints</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline;white-space:pre-wrap">The new client library, has the currently available endpoints:</span></p><br><ul style="margin-top:0pt;margin-bottom:0pt"><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Account</span></p></li><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Boot-resources, boot-sources (Manages MAAS images)</span></p></li><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Machines, devices, region-controllers & rack-controllers (Manages MAAS nodes)</span></p></li><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Events (Manages machine events)</span></p></li><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Configuration (MAAS Settings)</span></p></li><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Tags</span></p></li><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Version</span></p></li><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Zones</span></p></li></ul><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;font-weight:700;vertical-align:baseline;white-space:pre-wrap">Documentation</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline;white-space:pre-wrap">If you would like to know more about python-libmaas, please refer to the documentation available below:</span></p><br><ul style="margin-top:0pt;margin-bottom:0pt"><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">For installation and initial steps, please refer to: </span><a href="http://maas.github.io/python-libmaas/index.html" style="text-decoration:none"><span style="font-size:11pt;background-color:transparent;text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">http://maas.github.io/python-libmaas/index.html</span></a></p></li></ul><br><ul style="margin-top:0pt;margin-bottom:0pt"><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">For a few examples, please refer to:</span></p></li><ul style="margin-top:0pt;margin-bottom:0pt"><li dir="ltr" style="list-style-type:circle;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><a href="http://maas.github.io/python-libmaas/client/index.html" style="text-decoration:none"><span style="font-size:11pt;background-color:transparent;text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">http://maas.github.io/python-libmaas/client/index.html</span></a></p></li><li dir="ltr" style="list-style-type:circle;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><a href="http://maas.github.io/python-libmaas/client/nodes/index.html" style="text-decoration:none"><span style="font-size:11pt;background-color:transparent;text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">http://maas.github.io/python-libmaas/client/nodes/index.html</span></a></p></li></ul></ul><br><ul style="margin-top:0pt;margin-bottom:0pt"><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">For pypi information, please refer to: </span><a href="https://pypi.python.org/pypi/python-libmaas" style="text-decoration:none"><span style="font-size:11pt;background-color:transparent;text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">https://pypi.python.org/pypi/python-libmaas</span></a></p></li></ul><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;font-weight:700;vertical-align:baseline;white-space:pre-wrap">How to contribute?</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline;white-space:pre-wrap">If you would like to contribute you can find the source code in GitHub below:</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><a href="https://github.com/maas/python-libmaas" style="text-decoration:none"><span style="font-size:11pt;font-family:arial;background-color:transparent;text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">https://github.com/maas/python-libmaas</span></a></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline;white-space:pre-wrap">For more questions, please find us:</span></p><ul style="margin-top:0pt;margin-bottom:0pt"><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">#maas on freenode</span></p></li><li dir="ltr" style="list-style-type:disc;font-size:11pt;font-family:arial;color:rgb(0,0,0);background-color:transparent;vertical-align:baseline"><span style="font-size:11pt;background-color:transparent;vertical-align:baseline;white-space:pre-wrap">Maas-devel is always a good source for questions.</span></li></ul><div><font color="#000000" face="arial"><span style="font-size:14.6667px;white-space:pre-wrap"><br></span></font></div><div><font color="#000000" face="arial"><span style="font-size:14.6667px;white-space:pre-wrap"><b>Known Issues</b></span></font></div><div><font color="#000000" face="arial"><span style="font-size:14.6667px;white-space:pre-wrap">Login only works against a 'hostname' based endpoint. </span></font></div><div><font color="#000000" face="arial"><span style="font-size:14.6667px;white-space:pre-wrap"><a href="https://github.com/maas/python-libmaas/issues/80">https://github.com/maas/python-libmaas/issues/80</a><br></span></font></div><div><font color="#000000" face="arial"><span style="font-size:14.6667px;white-space:pre-wrap"><br></span></font></div></span></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr">Andres Rodriguez<div>Engineering Manager, MAAS</div><div>Canonical USA, Inc.</div></div></div></div></div></div></div>
</div>