How to get PyCharm to auto-complete code in methods?

Question

When I'm using a 3rd party l ibrary such as boto, PyCharm seems to be able to auto-complete quite nicely

However, as soon as I define a function of my own, auto-complete breaks down inside that function. I understand why, since I can't give the function any type information about its arguments, so it can't guess how to auto-complete. Is there a way around this issue?

Edit

I tried using the docstring (for Python 2), but still no auto-complete

def delete_oldest_backups(conn, backups_to_keep, backup_description):
    """
    delete_oldest_backups(EC2Connection, int, string)
    """

(Also tried boto.ec2.connection.EC2Connection instead of just EC2Connection)

Answer 1

You can use type hints: http://www.jetbrains.com/pycharm/webhelp/type-hinting-in-pycharm.html

 def some_method(self, conn):
   """
   @type conn: EC2Connection
   """
   conn.<autocomplete>

Answer 2

You can specify the type information about the parameters of the function using Python 3 parameter and return value annotations. If you're using Python 2, you can also specify information in the function's docstring. PyCharm understands the format used by docstrings of binary modules in the standard library, for example:

"""
foo(int, string) -> list

Returns the list of something
"""