Gecko [ armaneco.co.uk ]

Name	Size	Permission	Date
common	[ DIR ]	drwxr-xr-x	2022-02-05 00:54
__init__.py	3.29 KB	-rw-r--r--	2013-03-01 03:21
__init__.pyc	2.64 KB	-rw-r--r--	2014-09-17 22:13
__init__.pyo	2.64 KB	-rw-r--r--	2014-09-17 22:13
_compat.py	1.82 KB	-rw-r--r--	2013-03-01 03:21
_compat.pyc	2.21 KB	-rw-r--r--	2014-09-17 22:13
_compat.pyo	2.21 KB	-rw-r--r--	2014-09-17 22:13
_flatten.py	1.03 KB	-rw-r--r--	2013-03-01 03:21
_flatten.pyc	698 B	-rw-r--r--	2014-09-17 22:13
_flatten.pyo	698 B	-rw-r--r--	2014-09-17 22:13
_zope_interface_coptimizations.so	31.73 KB	-rwxr-xr-x	2014-09-17 22:13
adapter.py	22.51 KB	-rw-r--r--	2013-03-01 03:21
adapter.pyc	18.89 KB	-rw-r--r--	2014-09-17 22:13
adapter.pyo	18.89 KB	-rw-r--r--	2014-09-17 22:13
advice.py	7.37 KB	-rw-r--r--	2013-03-01 03:21
advice.pyc	5.42 KB	-rw-r--r--	2014-09-17 22:13
advice.pyo	5.38 KB	-rw-r--r--	2014-09-17 22:13
declarations.py	27.17 KB	-rw-r--r--	2013-03-01 03:21
declarations.pyc	24.34 KB	-rw-r--r--	2014-09-17 22:13
declarations.pyo	24.34 KB	-rw-r--r--	2014-09-17 22:13
document.py	3.38 KB	-rw-r--r--	2013-03-01 03:21
document.pyc	2.72 KB	-rw-r--r--	2014-09-17 22:13
document.pyo	2.72 KB	-rw-r--r--	2014-09-17 22:13
exceptions.py	1.95 KB	-rw-r--r--	2013-03-01 03:21
exceptions.pyc	3.21 KB	-rw-r--r--	2014-09-17 22:13
exceptions.pyo	3.21 KB	-rw-r--r--	2014-09-17 22:13
interface.py	20.63 KB	-rw-r--r--	2013-03-01 03:21
interface.pyc	22.51 KB	-rw-r--r--	2014-09-17 22:13
interface.pyo	22.51 KB	-rw-r--r--	2014-09-17 22:13
interfaces.py	42.1 KB	-rw-r--r--	2013-03-01 03:21
interfaces.pyc	54.78 KB	-rw-r--r--	2014-09-17 22:13
interfaces.pyo	54.78 KB	-rw-r--r--	2014-09-17 22:13
registry.py	18.18 KB	-rw-r--r--	2013-03-01 03:21
registry.pyc	19.77 KB	-rw-r--r--	2014-09-17 22:13
registry.pyo	19.72 KB	-rw-r--r--	2014-09-17 22:13
ro.py	2.07 KB	-rw-r--r--	2013-03-01 03:21
ro.pyc	1.59 KB	-rw-r--r--	2014-09-17 22:13
ro.pyo	1.59 KB	-rw-r--r--	2014-09-17 22:13
verify.py	4.62 KB	-rw-r--r--	2013-03-01 03:21
verify.pyc	3.17 KB	-rw-r--r--	2014-09-17 22:13
verify.pyo	3.17 KB	-rw-r--r--	2014-09-17 22:13

Rename

##############################################################################
#
# Copyright (c) 2001, 2002 Zope Foundation and Contributors.
# All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE.
#
##############################################################################
""" Pretty-Print an Interface object as structured text (Yum)

This module provides a function, asStructuredText, for rendering an
interface as structured text.
"""
import zope.interface

def asStructuredText(I, munge=0):
    """ Output structured text format.  Note, this will whack any existing
    'structured' format of the text.  """

r = [I.getName()]
    outp = r.append
    level = 1

if I.getDoc():
        outp(_justify_and_indent(_trim_doc_string(I.getDoc()), level))

bases = [base
             for base in I.__bases__
             if base is not zope.interface.Interface
             ]
    if bases:
        outp(_justify_and_indent("This interface extends:", level, munge))
        level += 1
        for b in bases:
            item = "o %s" % b.getName()
            outp(_justify_and_indent(_trim_doc_string(item), level, munge))
        level -= 1

namesAndDescriptions = sorted(I.namesAndDescriptions())

outp(_justify_and_indent("Attributes:", level, munge))
    level += 1
    for name, desc in namesAndDescriptions:
        if not hasattr(desc, 'getSignatureString'):   # ugh...
            item = "%s -- %s" % (desc.getName(),
                                 desc.getDoc() or 'no documentation')
            outp(_justify_and_indent(_trim_doc_string(item), level, munge))
    level -= 1

outp(_justify_and_indent("Methods:", level, munge))
    level += 1
    for name, desc in namesAndDescriptions:
        if hasattr(desc, 'getSignatureString'):   # ugh...
            item = "%s%s -- %s" % (desc.getName(),
                                   desc.getSignatureString(),
                                   desc.getDoc() or 'no documentation')
            outp(_justify_and_indent(_trim_doc_string(item), level, munge))

return "\n\n".join(r) + "\n\n"

def _trim_doc_string(text):
    """ Trims a doc string to make it format
    correctly with structured text. """

lines = text.replace('\r\n', '\n').split('\n')
    nlines = [lines.pop(0)]
    if lines:
        min_indent = min([len(line) - len(line.lstrip())
                          for line in lines])
        for line in lines:
            nlines.append(line[min_indent:])

return '\n'.join(nlines)

def _justify_and_indent(text, level, munge=0, width=72):
    """ indent and justify text, rejustify (munge) if specified """

indent = " " * level

if munge:
        lines = []
        line = indent
        text = text.split()

for word in text:
            line = ' '.join([line, word])
            if len(line) > width:
                lines.append(line)
                line = indent
        else:
            lines.append(line)

return '\n'.join(lines)

else:
        return indent + \
            text.strip().replace("\r\n", "\n") .replace("\n", "\n" + indent)