updated contents from Atlas repo

functions/attrgetter_demo.py

@@ -0,0 +1,25 @@
+
+metro_data = [
+    ('Tokyo', 'JP', 36.933, (35.689722, 139.691667)),
+    ('Delhi NCR', 'IN', 21.935, (28.613889, 77.208889)),
+    ('Mexico City', 'MX', 20.142, (19.433333, -99.133333)),
+    ('New York-Newark', 'US', 20.104, (40.808611, -74.020386)),
+    ('Sao Paulo', 'BR', 19.649, (-23.547778, -46.635833)),
+]
+
+from collections import namedtuple
+
+LatLong = namedtuple('LatLong', 'lat long')
+Metropolis = namedtuple('Metropolis', 'name cc pop coord')
+
+metro_areas = [Metropolis(name, cc, pop, LatLong(lat, long_))
+    for name, cc, pop, (lat, long_) in metro_data]
+
+metro_areas[0]
+metro_areas[0].coord.lat
+
+from operator import attrgetter
+name_lat = attrgetter('name', 'coord.lat')
+
+for city in sorted(metro_areas, key=attrgetter('coord.lat')):
+    print(name_lat(city))

functions/attrgetter_demo.rst

@@ -0,0 +1,31 @@
+>>> metro_data = [
+...     ('Tokyo', 'JP', 36.933, (35.689722, 139.691667)),
+...     ('Delhi NCR', 'IN', 21.935, (28.613889, 77.208889)),
+...     ('Mexico City', 'MX', 20.142, (19.433333, -99.133333)),
+...     ('New York-Newark', 'US', 20.104, (40.808611, -74.020386)),
+...     ('Sao Paulo', 'BR', 19.649, (-23.547778, -46.635833)),
+... ]
+# BEGIN ATTRGETTER_DEMO
+
+>>> from collections import namedtuple
+>>> LatLong = namedtuple('LatLong', 'lat long')  # <1>
+>>> Metropolis = namedtuple('Metropolis', 'name cc pop coord')  # <2>
+>>> metro_areas = [Metropolis(name, cc, pop, LatLong(lat, long_))  # <3>
+...     for name, cc, pop, (lat, long_) in metro_data]
+>>> metro_areas[0]
+Metropolis(name='Tokyo', cc='JP', pop=36.933, coord=LatLong(lat=35.689722, long=139.691667))
+>>> metro_areas[0].coord.lat  # <4>
+35.689722
+>>> from operator import attrgetter  
+>>> name_lat = attrgetter('name', 'coord.lat')  # <5>
+>>>
+>>> for city in sorted(metro_areas, key=attrgetter('coord.lat')):  # <6>
+...     print(name_lat(city))  # <7>
+...
+('Sao Paulo', -23.547778)
+('Mexico City', 19.433333)
+('Delhi NCR', 28.613889)
+('Tokyo', 35.689722)
+('New York-Newark', 40.808611)
+
+# END ATTRGETTER_DEMO

functions/bingo.py

@@ -0,0 +1,30 @@
+"""
+# BEGIN BINGO_DEMO
+
+>>> bingo = BingoCage(range(3))
+>>> bingo()
+2
+>>> 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 __call__(self):
+        if not self._items:  # <3>
+            raise IndexError('pop from empty BingoCage')
+        return self._items.pop()
+
+# END BINGO

functions/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

functions/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:
+    """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

functions/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

functions/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

functions/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

functions/hello.py

@@ -0,0 +1,5 @@
+import bobo
+
+@bobo.query('/')
+def hello(person):
+    return 'Hello %s!' % person

functions/strkeydict2.py

@@ -0,0 +1,76 @@
+"""StrKeyDict always converts non-string keys to `str`
+
+Tests for item retrieval using `d[key]` notation::
+
+    >>> d = StrKeyDict([('2', 'two'), ('4', 'four')])
+    >>> d['2']
+    'two'
+    >>> d[4]
+    'four'
+    >>> d[1]
+    Traceback (most recent call last):
+      ...
+    KeyError: '1'
+
+Tests for the `in` operator::
+
+    >>> 2 in d
+    True
+    >>> 1 in d
+    False
+
+Test for item assignment using non-string key::
+
+    >>> d[0] = 'zero'
+    >>> d['0']
+    'zero'
+
+Tests for update using a `dict` or a sequence of pairs::
+
+    >>> d.update({6:'six', '8':'eight'})
+    >>> sorted(d.keys())
+    ['0', '2', '4', '6', '8']
+    >>> d.update([(10, 'ten'), ('12', 'twelve')])
+    >>> sorted(d.keys())
+    ['0', '10', '12', '2', '4', '6', '8']
+    >>> d.update([1, 3, 5])
+    Traceback (most recent call last):
+      ...
+    TypeError: 'int' object is not iterable
+
+"""
+# BEGIN STRKEYDICT
+
+import collections
+import collections.abc
+
+
+class StrKeyDict(collections.UserDict):  # <1>
+
+    def __init__(self, args, normalize=str, **kwargs):
+        super().__init__(self, *args, **kwargs)
+        self.normalize = normalize
+
+    def __missing__(self, key):  # <2>
+        if self.normalize(key) == key:
+            raise KeyError(key)
+        return self[self.normalize(key)]
+
+    def __contains__(self, key):
+        return self.normalize(key) in self.data  # <3>
+
+    def __setitem__(self, key, item):
+        self.data[self.normalize(key)] = item   # <4>
+
+    def update(self, iterable=None, **kwds):
+        if iterable is not None:
+            if isinstance(iterable, collections.abc.Mapping):  # <5>
+                pairs = iterable.items()
+            else:
+                pairs = ((k, v) for k, v in iterable)  # <6>
+            for key, value in pairs:
+                self[key] = value  # <7>
+        if kwds:
+            self.update(kwds)  # <8>
+
+# END STRKEYDICT

functions/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