create disconnect() method for BaseAPI

This new method can help ppl tearing things down without using the
"with" statement. Similarly to the motivation behind implmenting the
"with" statement, this can be useful for connections that were made
through a tunnel (for example ssh).

This method makes it possible for example to have a BaseAPI object
wrapped up in another class, and tear down connections only when that
wrapping class is all done with calls to the object.

Author: lelutin

Diff for: pypuppetdb/api.py

@@ -194,18 +194,22 @@ def __init__(self, host='localhost', port=8080, ssl_verify=True,
         else:
             self.protocol = 'http'
 
+    def disconnect(self):
+        """Close all connections that this class opened up."""
+        # If we don't explicitly close connections, we might cause other
+        # functions or libraries to hang on the open connections. This happens
+        # for example with using paramiko to tunnel PuppetDB connections
+        # through ssh.
+        self._session.close()
+
     def __enter__(self):
         """Set up environment for 'with' statement."""
         # Once this class has been instantiated, there's nothing more required
         return self
 
     def __exit__(self, type, value, trace):
         """Tear down connections."""
-        # If we don't explicitly close connections, we might cause other
-        # functions or libraries to hang on the open connections. This happens
-        # for example with using paramiko to tunnel PuppetDB connections
-        # through ssh.
-        self._session.close()
+        self.disconnect()
 
     @property
     def version(self):