Added Placement parser.
[osm/N2VC.git] / juju / juju.py
index b1dcabd..fe3ce92 100644 (file)
@@ -1,13 +1,26 @@
 class Juju(object):
-    def add_cloud(self):
+    def add_cloud(self, name, definition, replace=False):
         """Add a user-defined cloud to Juju from among known cloud types.
 
+        :param str name: Name of cloud
+        :param dict definition: Cloud definition
+
+        Example cloud definition, as yaml::
+
+            type: openstack
+            auth-types: [ userpass ]
+            regions:
+              london:
+                endpoint: https://london.mycloud.com:35574/v3.0/
+
         """
         pass
 
-    def agree(self):
+    def agree(self, *terms):
         """Agree to the terms of a charm.
 
+        :param str \*terms: Terms to agree to
+
         """
         pass
 
@@ -49,20 +62,27 @@ class Juju(object):
         """
         pass
 
-    def get_plans(self, charm_name):
+    def get_plans(self, charm_url):
         """Return list of plans available for the specified charm.
 
+        :param str charm_url: Charm url
+
         """
         pass
 
     def register(self, registration_string):
         """Register a user to a controller.
 
+        :param str registration_string: The registration string
+
         """
         pass
 
-    def set_budget(self, name, amount):
-        """Set a budget limit.
+    def set_budget(self, name, limit):
+        """Set a monthly budget limit.
+
+        :param str name: Name of budget
+        :param int limit: Monthly limit
 
         """
         pass
@@ -70,12 +90,17 @@ class Juju(object):
     def get_cloud(self, name):
         """Get a cloud by name.
 
+        :param str name: Name of cloud
+
         """
         pass
 
-    def get_controller(self):
+    def get_controller(self, name, include_passwords=False):
         """Get a controller by name.
 
+        :param str name: Name of controller
+        :param bool include_passwords: Include passwords for accounts
+
         (maybe move this to Cloud?)
         """
         pass