/usr/share/pyshared/pyth/format.py is in python-pyth 0.5.6-2build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | """
Stuff for format implementations to subclass / use.
"""
class PythReader(object):
"""
Base class for all Pyth readers.
Readers must implement these methods.
"""
@classmethod
def read(self, source):
"""
source: An object to read the document from.
Usually (but not necessarily) a file object.
Returns: A pyth.document.Document object.
"""
pass
class PythWriter(object):
"""
Base class for all Pyth writers.
Writers must implement these methods.
"""
@classmethod
def write(self, document, target=None):
"""
document: An instance of pyth.document.Document
target: An object to write the document to.
Usually (but not necessarily) a file object.
If target is None, return something sensible
(like a StringIO object)
Returns: The target object
"""
pass
|