Add code samples

Author: Hwesta

Diff for: LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Keep Python Weird, Holly Becker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

Diff for: README.md

@@ -18,6 +18,7 @@ This tutorial was developed for [PyLadies Vancouver](http://www.pyladies.com/loc
 
 Instructions for following the tutorial are in the [docs](docs) folder.
 Code to modify and play with is in the [code](code) folder.
+Tests can be run with `python -m unittest` or `python -m unittest code.test_cattery` from this directory.
 
 
 ## Prerequisites
@@ -87,6 +88,8 @@ We're also showing two workflows.
  * Windows user
  * 8 years creating & resolving merge conflicts
 
+Some code from [catinabox Python testing tutorial](https://github.com/keeppythonweird/catinabox).
+
 ## License
 
-The content of this project is licensed [CC-BY-SA](https://creativecommons.org/licenses/by-sa/4.0/).
+The content of this project is licensed [CC-BY-SA](https://creativecommons.org/licenses/by-sa/4.0/), and the example source code is licensed under the MIT license.

Diff for: code/__init__.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python
+"""Cat collection classes."""
+from __future__ import absolute_import, unicode_literals, print_function
+
+# Exceptions
+
+class CatNotFound(Exception):
+    """The requested cat was not found in the cattery."""
+
+    def __init__(self, name):
+        super(CatNotFound, self).__init__(
+            "Cat with name {!r} not found in cattery.".format(name)
+        )
+        self.name = name
+
+
+# Classes
+
+class Cattery(object):
+    """A collection of cats."""
+
+    def __init__(self):
+        self._cats = []
+
+    @property
+    def num_cats(self):
+        return len(self._cats)
+
+    @property
+    def cats(self):
+        return self._cats
+
+    def add_cats(self, names):
+        """Add cats with the specified names to the cattery.
+
+        :param names: A list of the names of cats to add to the cattery.
+        """
+        self._cats.extend(names)
+
+    def remove_cat(self, name):
+        """Remove the specified cat from the cattery.
+
+        The first cat found in the cattery with the specified name will be
+        removed.
+
+        :param name: The name of the cat to remove.
+        """
+        cats = [cat for cat in self._cats if cat == name]
+        if len(cats) == 0:
+            raise CatNotFound(name)
+        self._cats.remove(cats[0])

Diff for: code/cattery.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python
+"""Test cattery.py file."""
+
+import unittest
+
+from . import cattery
+
+
+class TestCattery(unittest.TestCase):
+    """Test Cattery class."""
+
+    def setUp(self):
+        self.cattery = cattery.Cattery()
+
+    # add_cats
+
+    def test__add_cats__succeeds(self):
+        """It should successfully add cats."""
+        self.cattery.add_cats(["Fluffy", "Snookums"])
+        assert self.cattery.cats == ["Fluffy", "Snookums"]
+        assert self.cattery.num_cats == 2
+
+    # remove_cat
+
+    def test__remove_cat__succeeds(self):
+        """It should remove a cat."""
+        self.cattery.add_cats(["Fluffy", "Junior"])
+        self.cattery.remove_cat("Fluffy")
+        assert self.cattery.cats == ["Junior"]
+        assert self.cattery.num_cats == 1
+
+    def test__remove_cat__no_cats__fails(self):
+        """It should fail to remove non-existent cats."""
+        with self.assertRaises(cattery.CatNotFound):
+            self.cattery.remove_cat("Fluffles")
+
+    def test__remove_cat__cat_not_in_cattery__fails(self):
+        """It should fail to remove cats not in the cattery."""
+        self.cattery.add_cats(["Fluffy"])
+        with self.assertRaises(cattery.CatNotFound):
+            self.cattery.remove_cat("Snookums")
+
+if __name__ == '__main__':
+    unittest.main()