#!/usr/bin/env python
# -*- coding: utf-8 -*-

#
# Written in place of AboutBlocks in the Ruby Koans
#
# Note: Both blocks and generators use a yield keyword, but they behave
# a lot differently
#

from runner.koan import *


class AboutGenerators(Koan):

    def test_generating_values_on_the_fly(self):
        result = list()
        bacon_generator = (n + ' bacon' for \
                n in ['crunchy', 'veggie', 'danish'])
        for bacon in bacon_generator:
            result.append(bacon)
        self.assertEqual(['crunchy bacon', 'veggie bacon', 'danish bacon'], result)

    def test_generators_are_different_to_list_comprehensions(self):
        num_list = [x * 2 for x in range(1, 3)]
        num_generator = (x * 2 for x in range(1, 3))

        self.assertEqual(2, num_list[0])

        # A generator has to be iterated through.
        self.assertEqual(2, list(num_generator)[0])

        # Both list comprehensions and generators can be iterated
        # though. However, a generator function is only called on the
        # first iteration. The values are generated on the fly instead
        # of stored.
        #
        # Generators are more memory friendly, but less versatile

    def test_generator_expressions_are_a_one_shot_deal(self):
        dynamite = ('Boom!' for n in range(3))

        attempt1 = list(dynamite)
        attempt2 = list(dynamite)

        self.assertEqual(['Boom!', 'Boom!', 'Boom!'], list(attempt1))
        self.assertEqual([], list(attempt2))

    # ------------------------------------------------------------------

    def simple_generator_method(self):
        yield 'peanut'
        yield 'butter'
        yield 'and'
        yield 'jelly'

    def test_generator_method_will_yield_values_during_iteration(self):
        result = list()
        for item in self.simple_generator_method():
            result.append(item)
        self.assertEqual(['peanut', 'butter', 'and', 'jelly'], result)

    def test_coroutines_can_take_arguments(self):
        result = self.simple_generator_method()
        self.assertEqual('peanut', next(result))
        self.assertEqual('butter', next(result))
        result.close()

    # ------------------------------------------------------------------

    def square_me(self, seq):
        for x in seq:
            yield x * x

    def test_generator_method_with_parameter(self):
        result = self.square_me(range(2, 5))
        self.assertEqual([4, 9, 16], list(result))

    # ------------------------------------------------------------------

    def sum_it(self, seq):
        value = 0
        for num in seq:
            # The local state of 'value' will be retained between iterations
            value += num
            yield value

    def test_generator_keeps_track_of_local_variables(self):
        result = self.sum_it(range(2, 5))
        self.assertEqual([2, 5, 9], list(result))

    # ------------------------------------------------------------------

    def generator_with_coroutine(self):
        result = yield
        yield result

    def test_generators_can_take_coroutines(self):
        generator = self.generator_with_coroutine()

        # THINK ABOUT IT:
        # Why is this line necessary?
        #
        # Hint: Read the "Specification: Sending Values into Generators"
        #       section of http://www.python.org/dev/peps/pep-0342/
        next(generator)

        self.assertEqual(3, generator.send(1 + 2))

    def test_before_sending_a_value_to_a_generator_next_must_be_called(self):
        generator = self.generator_with_coroutine()

        try:
            generator.send(1 + 2)
        except TypeError as ex:
            self.assertMatch("can't send non-None value to a just-started generator", ex[0])

    # ------------------------------------------------------------------

    def yield_tester(self):
        value = yield
        if value:
            yield value
        else:
            yield 'no value'

    def test_generators_can_see_if_they_have_been_called_with_a_value(self):
        generator = self.yield_tester()
        next(generator)
        self.assertEqual('with value', generator.send('with value'))

        generator2 = self.yield_tester()
        next(generator2)
        self.assertEqual('no value', next(generator2))

    def test_send_none_is_equivalent_to_next(self):
        generator = self.yield_tester()

        next(generator)
        # 'next(generator)' is exactly equivalent to 'generator.send(None)'
        self.assertEqual('no value', generator.send(None))
