{
"info": {
"author": "Kevin Stone",
"author_email": "kevinastone@gmail.com",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 2 - Pre-Alpha",
"Intended Audience :: Developers",
"License :: OSI Approved :: ISC License (ISCL)",
"Natural Language :: English",
"Programming Language :: Python :: 2",
"Programming Language :: Python :: 2.6",
"Programming Language :: Python :: 2.7",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.3",
"Programming Language :: Python :: 3.4"
],
"description": "===============================\nGenerator\n===============================\n\n.. image:: https://img.shields.io/travis/kevinastone/generator.svg\n :target: https://travis-ci.org/kevinastone/generator\n\n.. image:: https://img.shields.io/pypi/v/generator.svg\n :target: https://pypi.python.org/pypi/generator\n\n\nGenerator is a helper for generating test methods for nose while still using unittest.\n\n* Free software: ISC license\n* Documentation: https://generator.readthedocs.org.\n\n\nInstallation\n------------\n\n::\n\n pip install test-generator\n\n\nIntroduction\n------------\n\nHave you ever written tests that loop through a list of inputs to validate the functionality?\n\nSomething like?\n\n.. code-block:: python\n\n from mything import thingy\n\n class MyTestCase(unittest.TestCase):\n def test_thingy(self):\n for input in [\n 'a',\n 'b',\n 'cccc',\n 'ddd'\n 'eeeeee',\n 'f',\n 'g'\n ]:\n self.assertTrue(thingy(input))\n\n\nBut running in a loop limits all the functionality in ``TestCase`` like per-\ntest setUp or tearDown. It also fails on the first input and you can't run a\nsingle test input, you have to run them all? (Doesn't work well when each\ntest is more complicated than this toy case).\n\nInstead, what if you wrote your test like:\n\n.. code-block:: python\n\n from generator import generator, generate\n from mything import thingy\n\n @generator\n class MyTestCase(unittest.TestCase):\n\n @generate('a', 'b', 'cccc', 'ddd', 'eeeeee', 'f', 'g')\n def test_thingy(self, input):\n self.assertTrue(thingy(input))\n\n\nAnd when you run your tests, you see:\n\n.. code-block:: shell\n\n ----------------------------------------------------------------------\n Ran 7 tests in 0.001s\n\n OK\n\nGenerator gives you simple decorators to mulitply your test methods based on\nan argument list. It's great for checking a range of inputs, a list of error\nconditions or expected status codes.\n\n\nExamples\n--------\n\nAPI Client Error Handling\n^^^^^^^^^^^^^^^^^^^^^^^^^\n\nLet's make sure our API client properly handles error conditions and raises a\ngeneric APIError under the conditions. We'll use mock to patch out the actual\nAPI call to return our response.\n\n.. code-block:: python\n\n import mock\n from generator import generator, generate\n from example import client, APIError\n\n @generator\n class TestAPIErrorHandling(unittest.TestCase):\n\n @generate(400, 401, 403, 404, 500, 502, 503)\n def test_error(self, status_code):\n with mock.patch(client, '_request') as _request_stub:\n _request_stub.return_value.status_code = status_code\n\n self.assertRaises(APIError):\n client.get('/path/')\n\n\nTest Fixtures\n^^^^^^^^^^^^^\n\nLet's make sure our API client properly handles error conditions and raises a\ngeneric APIError under the conditions. We'll use mock to patch out the actual\nAPI call to return our response.\n\n.. code-block:: python\n\n from generator import generator, generate\n from example.sanitize import strip_tags\n\n @generator\n class TestStripTags(unittest.TestCase):\n\n @generate(\n ('