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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

#! /usr/bin/python
""" A python primer. pydoc, doctest and classes.

Syntax:
 To generate man pages:
 > pydoc classtemplate

 To try all the tests in doctest (and execute the script):
 > python classtemplate.py -v
"""

#Class definition
class Table:
        """Class Table.

        Doctest: here we insert python command lines inputs and outputs.
        >>> print Table.database
        http://access.com/db
        """

        #Data attributes here
        database='http://access.com/db'

        #Method attributes here
        def __init__(self,id,text):
                """Initializes the id and textlabel data attributes.

                Doctest: Testing more data attributes defined at construction time
                >>> x = Table(1,'coucou')
                >>> print x.id
                1
                >>> print x.textlabel
                coucou
                """
                self.id=id
                self.textlabel=text

class Shape:
        """OO Example: base class for 2D shapes, defines area() and draw() methods
        """
        def area(self):
                raise Exception('Unimplemented for base class')
        def draw(self):
                # Doing this right depends on what graphics system you're using, what
                # API calls are required, how the coordinate system works, etc.
                raise Exception('Exercise in graphics programming left to the reader')

class Circle(Shape):
        """
        >>> c = Circle(0, 0, 2.0)
        >>> c.area()
        12.566370614359172
        """
        def __init__(self, x, y, radius):
                self.x, self.y, self.radius = x, y, radius
        def area(self):
                import math
                return math.pi * self.radius ** 2

class Rectangle(Shape):
        """
        >>> r = Rectangle(1, 4, 2, 9)
        >>> r.area()
        21
        """
        def __init__(self, left, right, top, bottom):
                self.left, self.right, self.top, self.bottom = \
                           left, right, top, bottom
        def area(self):
                width = self.right - self.left
                height = self.top - self.bottom
                # sign may depend on coordinate system, so use abs()
                return abs(width * height)

#doctest -- "Debugging sucks :( Testing rocks :)"
def _test():
        """Inline Doctest activated. Cool! :D
        This means that whenever the module is called in python
 
        > python thismodule.py -v
 
        the doctest function will try all the tests implemented in doctest.
        """
        import doctest
        doctest.testmod()

if __name__ == "__main__":
        _test()

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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

#! /usr/bin/python
""" A python primer. pydoc, doctest and classes.

Syntax:
 To generate man pages:
 > pydoc classtemplate

 To try all the tests in doctest (and execute the script):
 > python classtemplate.py -v
"""

#Class definition
class Table:
        """Class Table.

        Doctest: here we insert python command lines inputs and outputs.
        >>> print Table.database
        http://access.com/db
        """

        #Data attributes here
        database = 'http://access.com/db'

        #Method attributes here
        def __init__(self, id, text):
                """Initializes the id and textlabel data attributes.

                Doctest: Testing more data attributes defined at construction time
                >>> x = Table(1,'coucou')
                >>> print x.id
                1
                >>> print x.textlabel
                coucou
                >>> print x            # test __repr__ method
                This is table 1
                >>> print x + 'not'    # test __add__ method
                coucounot
                >>> print x[0:2]       # test __getitem__ method
                cou
                """
                self.id = id
                self.textlabel = text

        def __repr__(self):
                return "This is table %s", % self.id
        
        def __add__(self, i):
                # This actually doesn't make sense. However, it is an example
                return self.textlabel + i

        def __getitem__(self, i):
                return self.textlabel[i]


#doctest -- "Debugging sucks :( Testing rocks :)"
def _test():
        """Inline Doctest activated. Cool! :D
         This means that whenever the module is called in python
 
        > python thismodule.py -v
 
        the doctest function will try all the tests implemented in doctest.
        """
        import doctest
        doctest.testmod()

if __name__ == "__main__":
        _test()