added chapter map to README

06-1class-func/README.rst

@@ -0,0 +1,4 @@
+Sample code for Chapter 5 - "First-class functions"
+
+From the book "Fluent Python" by Luciano Ramalho (O'Reilly, 2015)
+http://shop.oreilly.com/product/0636920032519.do

06-1class-func/bingocall.py

@@ -0,0 +1,35 @@
+"""
+# BEGIN BINGO_DEMO
+
+>>> bingo = BingoCage(range(3))
+>>> bingo.pick()
+1
+>>> bingo()
+0
+>>> callable(bingo)
+True
+
+# END BINGO_DEMO
+
+"""
+
+# BEGIN BINGO
+
+import random
+
+class BingoCage:
+
+    def __init__(self, items):
+        self._items = list(items)  # <1>
+        random.shuffle(self._items)  # <2>
+
+    def pick(self):  # <3>
+        try:
+            return self._items.pop()
+        except IndexError:
+            raise LookupError('pick from empty BingoCage')  # <4>
+
+    def __call__(self):  # <5>
+        return self.pick()
+
+# END BINGO

06-1class-func/clip.py

@@ -0,0 +1,38 @@
+"""
+    >>> clip('banana ', 6)
+    'banana'
+    >>> clip('banana ', 7)
+    'banana'
+    >>> clip('banana ', 5)
+    'banana'
+    >>> clip('banana split', 6)
+    'banana'
+    >>> clip('banana split', 7)
+    'banana'
+    >>> clip('banana split', 10)
+    'banana'
+    >>> clip('banana split', 11)
+    'banana'
+    >>> clip('banana split', 12)
+    'banana split'
+"""
+
+# BEGIN CLIP
+
+def clip(text, max_len=80):
+    """Return text clipped at the last space before or after max_len
+    """
+    end = None
+    if len(text) > max_len:
+        space_before = text.rfind(' ', 0, max_len)
+        if space_before >= 0:
+            end = space_before
+        else:
+            space_after = text.rfind(' ', max_len)
+            if space_after >= 0:
+                end = space_after
+    if end is None:  # no spaces were found
+        end = len(text)
+    return text[:end].rstrip()
+
+# END CLIP

06-1class-func/clip_annot.py

@@ -0,0 +1,38 @@
+"""
+    >>> clip('banana ', 6)
+    'banana'
+    >>> clip('banana ', 7)
+    'banana'
+    >>> clip('banana ', 5)
+    'banana'
+    >>> clip('banana split', 6)
+    'banana'
+    >>> clip('banana split', 7)
+    'banana'
+    >>> clip('banana split', 10)
+    'banana'
+    >>> clip('banana split', 11)
+    'banana'
+    >>> clip('banana split', 12)
+    'banana split'
+"""
+
+# BEGIN CLIP_ANNOT
+
+def clip(text:str, max_len:'int > 0'=80) -> str:  # <1>
+    """Return text clipped at the last space before or after max_len
+    """
+    end = None
+    if len(text) > max_len:
+        space_before = text.rfind(' ', 0, max_len)
+        if space_before >= 0:
+            end = space_before
+        else:
+            space_after = text.rfind(' ', max_len)
+            if space_after >= 0:
+                end = space_after
+    if end is None:  # no spaces were found
+        end = len(text)
+    return text[:end].rstrip()
+
+# END CLIP_ANNOT

06-1class-func/clip_annot_signature.rst

@@ -0,0 +1,10 @@
+>>> from clip_annot import clip
+>>> from inspect import signature
+>>> sig = signature(clip)
+>>> sig.return_annotation
+<class 'str'>
+>>> for param in sig.parameters.values():
+...     note = repr(param.annotation).ljust(13)
+...     print(note, ':', param.name, '=', param.default)
+<class 'str'> : text = <class 'inspect._empty'>
+'int > 0'     : max_len = 80

06-1class-func/clip_introspection.rst

@@ -0,0 +1,9 @@
+>>> from clip import clip
+>>> clip.__defaults__
+(80,)
+>>> clip.__code__  # doctest: +ELLIPSIS
+<code object clip at 0x...>
+>>> clip.__code__.co_varnames
+('text', 'max_len', 'end', 'space_before', 'space_after')
+>>> clip.__code__.co_argcount
+2

06-1class-func/clip_signature.rst

@@ -0,0 +1,12 @@
+>>> from clip import clip
+>>> from inspect import signature
+>>> sig = signature(clip)
+>>> sig  # doctest: +ELLIPSIS
+<inspect.Signature object at 0x...>
+>>> str(sig)
+'(text, max_len=80)'
+>>> for name, param in sig.parameters.items():
+...     print(param.kind, ':', name, '=', param.default)
+...
+POSITIONAL_OR_KEYWORD : text = <class 'inspect._empty'>
+POSITIONAL_OR_KEYWORD : max_len = 80

06-1class-func/tagger.py

@@ -0,0 +1,44 @@
+
+
+"""
+# BEGIN TAG_DEMO
+>>> tag('br')  # <1>
+'<br />'
+>>> tag('p', 'hello')  # <2>
+'<p>hello</p>'
+>>> print(tag('p', 'hello', 'world'))
+<p>hello</p>
+<p>world</p>
+>>> tag('p', 'hello', id=33)  # <3>
+'<p id="33">hello</p>'
+>>> print(tag('p', 'hello', 'world', cls='sidebar'))  # <4>
+<p class="sidebar">hello</p>
+<p class="sidebar">world</p>
+>>> tag(content='testing', name="img")  # <5>
+'<img content="testing" />'
+>>> my_tag = {'name': 'img', 'title': 'Sunset Boulevard',
+...           'src': 'sunset.jpg', 'cls': 'framed'}
+>>> tag(**my_tag)  # <6>
+'<img class="framed" src="sunset.jpg" title="Sunset Boulevard" />'
+
+# END TAG_DEMO
+"""
+
+
+# BEGIN TAG_FUNC
+def tag(name, *content, cls=None, **attrs):
+    """Generate one or more HTML tags"""
+    if cls is not None:
+        attrs['class'] = cls
+    if attrs:
+        attr_str = ''.join(' %s="%s"' % (attr, value)
+                           for attr, value
+                           in sorted(attrs.items()))
+    else:
+        attr_str = ''
+    if content:
+        return '\n'.join('<%s%s>%s</%s>' %
+                         (name, attr_str, c, name) for c in content)
+    else:
+        return '<%s%s />' % (name, attr_str)
+# END TAG_FUNC