View Python docstrings through $EDITOR

pyds.py

#! /usr/bin/env python
# -*- coding: utf-8 -*-
# vim:fenc=utf-8
#
# Copyright © 2015 jaidev <jaidev@newton>
#
# Distributed under terms of the MIT license.

"""

"""


import sys
import tempfile


def main(funcpath):
    namespace = funcpath.split('.')
    base = namespace[-1]
    expression = "from {0} import {1}".format(".".join(namespace[:-1]), base)
    exec(expression)
    docstring = eval("{}.__doc__".format(base))
    with tempfile.NamedTemporaryFile(delete=False) as f:
        f.write(docstring)
    print f.name

if __name__ == '__main__':
    main(sys.argv[1])

run.sh

#! /bin/bash

# pyds
function pyds {
    DOCPATH=`python ~/src/pyds/pyds.py $1`
    $EDITOR $DOCPATH
    rm $DOCPATH
}