import os import sys import inspect root = os.path.realpath( os.path.dirname( os.path.realpath(__file__) ) + '{0}..{0}..{0}web'.format(os.sep) ) if sys.path[0] != root: sys.path.insert(0, root) from pgadmin.utils import PgAdminModule target = open('code_snippets.rst', 'w') target.truncate() target.write("*************\n") target.write("Code Snippets\n") target.write("*************\n\n") target.write(""" This document contains code for some of the important classes, listed as below:\n\n""") for m in [ 'PgAdminModule', 'NodeView', 'BaseDriver', 'BaseConnection' ]: target.write("* {0}_\n".format(m)) def print_code(outstream, name, module, info=None): l = len(name) outstream.write("\n\n.. _{0}:\n\n{0}\n".format(name)) idx = 0 while idx < l: idx += 1 outstream.write("*") if info: outstream.write("\n\n{0}".format(info)) outstream.write("\n\n.. code-block:: python\n\n") for line in inspect.getsourcelines(module)[0]: if line.strip(): outstream.write(" {0}".format(line)) else: outstream.write("{0}".format(line)) print_code( target, "PgAdminModule", PgAdminModule, """ PgAdminModule is inherted from Flask.Blueprint module. This module defines a set of methods, properties and attributes, that every module should implement. """) from pgadmin.browser.utils import NodeView print_code( target, "NodeView", NodeView, """ NodeView class helps exposing basic REST APIs for different operations used by pgAdmin Browser. The basic idea has been taken from the `Flask's MethodView `_ class. Because - we need a lot more operations (not, just CRUD), we can not use it directly.""") from pgadmin.utils.driver.abstract import BaseDriver, BaseConnection print_code(target, "BaseDriver", BaseDriver) print_code(target, "BaseConnection", BaseConnection)