Version 1.6.1

This includes some minor bug fixes/documentation changes and will be a
point to sync between PyPI and GitHub.

Author: Patrick East

README.rst

@@ -33,6 +33,14 @@ Installation
  $ python setup.py install
 
 
+Tests
+=====
+From the root directory of the rest-client
+::
+
+ $ PYTHONPATH=$(pwd):$PYTHONPATH py.test test/*.py
+
+
 Files
 =====
 * purestorage/ -- Contains library code.

docs/_static/README

@@ -0,0 +1 @@
+# This file and parent directory solely exist to suppress documentation build warnings.

docs/changelog.rst

@@ -9,4 +9,5 @@ Version Date       Notes
 1.2.0   10/16/2014 Initial Version
 1.4.0   12/15/2014 Add support for REST 1.3 and 1.4
 1.6.0   05/17/2016 Add support for REST 1.5 and 1.6
+1.6.1   05/30/2016 Minor bug fixes and sync code between GitHub and PyPI
 ======= ========== =====

docs/quick_start.rst

@@ -105,9 +105,10 @@ added to the hgroup as part of creation or in a subsequent set call.
 
 .. code-block:: python
 
-        >>> array.create_host("host1", iqnlist=["iqn1", "iqn2"])
+        >>> array.create_host("host1", iqnlist=["iqn.2001-04.com.example:diskarrays-sn-a8675308",
+                                                "iqn.2001-04.com.example:diskarrays-sn-a8675309"])
         {
-         u'iqn': [u'iqn1', u'iqn2'],
+         u'iqn': [u'iqn.2001-04.com.example:diskarrays-sn-a8675308', u'iqn.2001-04.com.example:diskarrays-sn-a8675309'],
          u'wwn': [],
          u'name': u'host1'
         }
@@ -294,3 +295,29 @@ or explicitly eradicated.
         }
         >>> array.list_volumes(pending_only=True)
         []
+
+
+Enable Secure HTTPS Requests
+----------------------------
+
+By default the requests being made will not verify the SSL certificate of the
+target array. Requests made this way will log a InsecureRequestWarning.
+
+To enable verification use the verify_https flag:
+
+.. code-block:: python
+
+    >>> array = purestorage.FlashArray("localhost", "pureuser", "pureuser", verify_https=True)
+
+
+This does require that the target array has a trusted certificate and will
+be validated correctly by the system making the request.
+
+If using an 'untrusted' certificate (e.g. self-signed certificate) you can
+optionally pass in a path to the certificate file:
+
+.. code-block:: python
+
+    >>> array = purestorage.FlashArray("localhost", "pureuser", "pureuser", verify_https=True,
+                                       ssl_cert="/etc/ssl/certs/pure-self-signed.crt")
+

purestorage/purestorage.py

@@ -13,7 +13,7 @@
 from distutils.version import StrictVersion
 
 # The current version of this library.
-VERSION = "1.6.0"
+VERSION = "1.6.1"
 
 
 class FlashArray(object):
@@ -1069,7 +1069,7 @@ def get_subnet(self, subnet):
         return self._request("GET", "subnet/{0}".format(subnet))
 
     def list_subnets(self, **kwargs):
-        """Get a list of dictionaries describing each subnet.
+        """Get a list of dictionaries describing subnets.
 
         :param \*\*kwargs: See the REST API Guide on your array for the
                            documentation on the request:
@@ -1125,7 +1125,7 @@ def set_subnet(self, subnet, **kwargs):
         return self._request("PUT", "subnet/{0}".format(subnet), kwargs)
 
     def create_vlan_interface(self, interface, subnet, **kwargs):
-        """Create a vlan interface.
+        """Create a vlan interface
 
         :param interface: Name of interface to be created.
         :type interface: str

setup.py

@@ -2,7 +2,7 @@
 
 setup(
     name="purestorage",
-    version="1.6.0",
+    version="1.6.1",
     description="Pure Storage FlashArray REST Client",
     keywords=["pure", "storage", "flasharray", "rest", "client"],
     url="",

test/__init__.py

@@ -6,9 +6,9 @@
 import mock
 import requests
 
-from pure.rest.client.purestorage import FlashArray, PureError, PureHTTPError
+from purestorage import FlashArray, PureError, PureHTTPError
 
-CLIENT_PATH = "pure.rest.client.purestorage.purestorage"
+CLIENT_PATH = "purestorage.purestorage"
 ARRAY_OBJ = CLIENT_PATH + ".FlashArray"
 
 class TestBase(object):