feat(#31): Filter out the self parameter in Python methods

Author: kkoomen

autoload/doge/preprocessors/python.vim

@@ -16,5 +16,13 @@ function! doge#preprocessors#python#insert_position(lnum_insert_pos) abort
   return a:lnum_insert_pos
 endfunction
 
+
+" A callback function being called after the parameter tokens have been
+" extracted. This function will adjust the input if needed.
+function! doge#preprocessors#python#parameter_tokens(tokens) abort
+  " Filer out the 'self' variable in methods.
+  return filter(a:tokens, {_, token -> token['name'] !=# 'self'})
+endfunction
+
 let &cpoptions = s:save_cpo
 unlet s:save_cpo

test/filetypes/python/class-methods.vader

@@ -11,14 +11,13 @@ Do (trigger doge):
   :3\<CR>
   \<C-d>
 
-Expect python (generated comment with :param tags):
+Expect python (generated comment with no :param tags):
   class MyClass(object):
 
       def __init__(self: MyClass):
           """
           [TODO:description]
 
-          :param self MyClass: [TODO:description]
           """
           pass
 # ==============================================================================
@@ -41,7 +40,6 @@ Expect python (generated comment with :param tags):
           """
           [TODO:description]
 
-          :param self MyClass: [TODO:description]
           :param p1 Sequence[T]: [TODO:description]
           :rtype Generator[int, float, str]: [TODO:description]
           """
@@ -67,7 +65,6 @@ Expect python (generated comment with :param tags):
           """
           [TODO:description]
 
-          :param self [TODO:type]: [TODO:description]
           :param args str: [TODO:description]
           :param kwargs str: [TODO:description]
           :rtype str: [TODO:description]