Incluido doctest e código para Trem com padrão GOF

Author: renzon

trens/README.md

@@ -0,0 +1,13 @@
+#Esse arquvivo documeta o comportamento de um Trem
+
+```python
+    >>> from trens.trem_gof import Trem
+    >>> t = Trem(4)
+    >>> for vagao in t:
+    ...     print(vagao)
+    vagao #1
+    vagao #2
+    vagao #3
+    vagao #4
+
+```

trens/__init__.py

@@ -0,0 +1,2 @@
+# -*- coding: utf-8 -*-
+from __future__ import absolute_import, unicode_literals

trens/trem_gof.py

@@ -0,0 +1,19 @@
+class Trem:
+    def __init__(self, num_vagoes):
+        self.num_vagoes = num_vagoes
+
+    def __iter__(self):
+        return IteradorTrem(self.num_vagoes)
+
+
+class IteradorTrem:
+    def __init__(self, num_vagoes):
+        self.atual = 0
+        self.ultimo_vagao = num_vagoes - 1
+
+    def __next__(self):
+        if self.atual <= self.ultimo_vagao:
+            self.atual += 1
+            return 'vagao #%s' % (self.atual)
+        else:
+            raise StopIteration()