This file is indexed.

/usr/share/pyshared/pyth/format.py is in python-pyth 0.5.6-3.

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