introduce unittest by marqh · Pull Request #11 · carpentries-incubator/python-testing

marqh · 2017-02-01T09:04:21Z

Hi @katyhuff @gvwilson

this is a replacement for
swcarpentry#2

targeting this repository; as requested

katyhuff · 2017-02-01T14:49:42Z

Thanks @marqh ! I'll have time to look this over on friday. Talk to you then.

katyhuff · 2017-02-16T14:27:58Z

Sorry, @marqh . This fell off of my radar. I will look this weekend at this. For real this time.

katyhuff

I'm really sorry @marqh that this took a long time. Generally, I just think an explanation at the beginning to explain why and when someone might want to know unittest in addition to pytest, would be appropriate. Also, a couple of line length and brit->american spelling suggestions follow. Thanks for the contribution!

katyhuff · 2017-04-04T01:50:36Z

06-edges.html

@@ -1,159 +0,0 @@
-<!DOCTYPE html>


Why was this file deleted?

katyhuff · 2017-04-04T01:50:56Z

10-fixtures.html

@@ -1,114 +0,0 @@
-<!DOCTYPE html>


Why was this deleted?

katyhuff · 2017-04-04T01:51:41Z

06-unittest.md

+> -   
+> -   
+
+The Python standard library provides a module for writing and running tests, called `unittest`, which is documented for [Python3.6](https://docs.python.org/3.6/library/unittest.html?highlight=unittest#module-unittest) and [Python2.7](https://docs.python.org/2/library/unittest.html?highlight=unittest#module-unittest).


line too long. Please keep lines, even text, under 80 chars.

katyhuff · 2017-04-04T01:52:18Z

06-unittest.md

+
+The Python standard library provides a module for writing and running tests, called `unittest`, which is documented for [Python3.6](https://docs.python.org/3.6/library/unittest.html?highlight=unittest#module-unittest) and [Python2.7](https://docs.python.org/2/library/unittest.html?highlight=unittest#module-unittest).
+
+This module is useful for writing all styles of test, including unit tests and functional tests.


Since we already cover pytest, perhaps this would be a good place to justify the need to learn both (or when it is or is not necessary to learn both). My general feeling is that pytest is much more friendly to beginners.

katyhuff · 2017-04-04T01:53:55Z

06-unittest.md

+
+## Functional Tests
+
+Functional testing is a way of checking software to ensure that it has all the required functionality that's specified within its functional requirements.  This will test many methods and may interact with dependencies like file access.


line length.

katyhuff · 2017-04-04T01:55:15Z

06-unittest.md

+
+## Unittest TestCases
+
+unittest is part of the Python core library; it defines a class, unittest.TestCase which provides lots of useful machinery for writing tests.  We define classes which inherit from unittest.TestCase, bringing in their useful behaviour for us to apply to our tests.


line length

katyhuff · 2017-04-04T01:55:21Z

06-unittest.md

+
+unittest is part of the Python core library; it defines a class, unittest.TestCase which provides lots of useful machinery for writing tests.  We define classes which inherit from unittest.TestCase, bringing in their useful behaviour for us to apply to our tests.
+
+The reuse of objects in this way is a really useful programming approach.  Don't worry if it is new to you.  For testing with unittest, you can just think of it as a framework to fit your test cases into.


line length

katyhuff · 2017-04-04T01:55:53Z

06-unittest.md

+
+The reuse of objects in this way is a really useful programming approach.  Don't worry if it is new to you.  For testing with unittest, you can just think of it as a framework to fit your test cases into.
+
+We can rewrite the tests from the previous page, using the Unittest approach.


line length. Otherwise, great transition.

katyhuff · 2017-04-04T01:56:10Z

06-unittest.md

+
+~~~
+
+Unittest reports failures and errors on test cases, which we can see if we run Python2, as one of our tests only passes in Python3:


line length

katyhuff · 2017-04-04T01:56:47Z

10-fixtures.md

+
+## Unittest
+
+The `unittest` module also provides this functionality for us with the `setUp` and `tearDown` methods that allow you to define instructions that will be executed before and after each test method (note the capitalisation of these names, which is important).


perhaps you can use the notion of "fixtures" here, so that the student recognize the vocabulary that they just learned in the previous lesson?

line length.

katyhuff · 2017-05-04T20:37:43Z

Hi @marqh , have you been able to look at these change requests?

introduce unittest

4a62dda

marqh mentioned this pull request Feb 1, 2017

introduce unittest swcarpentry/python-testing#2

Closed

katyhuff requested changes Apr 4, 2017

View reviewed changes


		The Python standard library provides a module for writing and running tests, called `unittest`, which is documented for [Python3.6](https://docs.python.org/3.6/library/unittest.html?highlight=unittest#module-unittest) and [Python2.7](https://docs.python.org/2/library/unittest.html?highlight=unittest#module-unittest).

		This module is useful for writing all styles of test, including unit tests and functional tests.


		## Functional Tests

		Functional testing is a way of checking software to ensure that it has all the required functionality that's specified within its functional requirements. This will test many methods and may interact with dependencies like file access.


		## Unittest TestCases

		unittest is part of the Python core library; it defines a class, unittest.TestCase which provides lots of useful machinery for writing tests. We define classes which inherit from unittest.TestCase, bringing in their useful behaviour for us to apply to our tests.


		unittest is part of the Python core library; it defines a class, unittest.TestCase which provides lots of useful machinery for writing tests. We define classes which inherit from unittest.TestCase, bringing in their useful behaviour for us to apply to our tests.

		The reuse of objects in this way is a really useful programming approach. Don't worry if it is new to you. For testing with unittest, you can just think of it as a framework to fit your test cases into.


		The reuse of objects in this way is a really useful programming approach. Don't worry if it is new to you. For testing with unittest, you can just think of it as a framework to fit your test cases into.

		We can rewrite the tests from the previous page, using the Unittest approach.


		~~~

		Unittest reports failures and errors on test cases, which we can see if we run Python2, as one of our tests only passes in Python3:


		## Unittest

		The `unittest` module also provides this functionality for us with the `setUp` and `tearDown` methods that allow you to define instructions that will be executed before and after each test method (note the capitalisation of these names, which is important).

Uh oh!

Conversation

marqh commented Feb 1, 2017

Uh oh!

katyhuff commented Feb 1, 2017

Uh oh!

katyhuff commented Feb 16, 2017

Uh oh!

katyhuff left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

katyhuff commented May 4, 2017

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants