Merge pull request #47 from tkoukkari/tko_kw_full_comments

added support for command d(ocs)

DebugLibrary.py

@@ -141,12 +141,15 @@ def build(self, lib):
 
 
 @memoize
-def get_lib_keywords(library):
+def get_lib_keywords(library, long_format=False):
     """Get keywords of imported library"""
     lib = ImportedLibraryDocBuilder().build(library)
     keywords = []
     for keyword in lib.keywords:
-        doc = keyword.doc.split('\n')[0]
+        if long_format:
+            doc = keyword.doc
+        else:
+            doc = keyword.doc.split('\n')[0]
         keywords.append({'name': keyword.name,
                          'lib': library.name,
                          'doc': doc})
@@ -564,6 +567,20 @@ def complete_keywords(self, text, line, begin_idx, end_idx):
 
     complete_k = complete_keywords
 
+    def do_docs(self, kw_name):
+        """Get keyword documentation for individual keywords
+
+         d(ocs) [<keyword_name>]
+        """
+
+        for lib in get_libs():
+            for keyword in get_lib_keywords(lib, long_format=True):
+                if keyword['name'].lower() == kw_name.lower():
+                    print(keyword['doc'])
+                    return
+        print("could not find documentation for keyword {}".format(kw_name))
+
+    do_d = do_docs
 
 class DebugLibrary(object):
 

README.rst

@@ -47,7 +47,7 @@ Or you can run it standalone as a ``RobotFramework`` shell::
 
     Documented commands (type help <topic>):
     ========================================
-    EOF  exit  help  k  keywords  l  libs  pdb  s  selenium
+    EOF  d  docs  exit  help  k  keywords  l  libs  pdb  s  selenium
 
     > log  hello
     > get time