More work on params, docstrings

[osm/N2VC.git] / juju / juju.py

diff --git a/juju/juju.py b/juju/juju.py
index b1dcabd..b2c6152 100644 (file)
--- a/juju/juju.py
+++ b/juju/juju.py
@@ -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,15 +62,19 @@ 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