{"id":1435,"date":"2014-09-17T03:00:03","date_gmt":"2014-09-17T07:00:03","guid":{"rendered":"http:\/\/qxf2.com\/blog\/?p=1435"},"modified":"2017-06-14T01:58:49","modified_gmt":"2017-06-14T05:58:49","slug":"jenkins-python","status":"publish","type":"post","link":"https:\/\/qxf2.com\/blog\/jenkins-python\/","title":{"rendered":"Python unit test integration with Jenkins"},"content":{"rendered":"

Problem:<\/strong> Jenkins is still somewhat of a black box to testers. <\/p>\n

This post is for the hands on tester looking to integrate their Python unit tests with Jenkins.<\/p>\n

\n

Why this post?<\/h3>\n

Jenkins<\/a> is an extremely popular continuous integration<\/a> tool. Jenkins is often setup and maintained by the development team or I.T. team in many companies. Testers know about Jenkins but rarely get a chance to explore Jenkins. At Qxf2<\/a>, we believe in learning and exploring the tools we work with everyday. In a previous post, we showed you how to get started with Jenkins<\/a>. In this post, we will show you how to install and configure plugins and run some Python unit tests.<\/p>\n

\n

Overview<\/h3>\n

This post will walk you through the following steps:
\n1. Download and install Jenkins
\n2. Install and configure the required Jenkins plugins
\n3. Install Python mock and Python nose
\n4. Add Python unit test cases
\n5. Set up the project in Jenkins
\n6. Start the build
\n7. Verify the result<\/p>\n

We are going to be using a fairly popular Python plugin call ShiningPanda<\/a>. <\/p>\n

NOTE:<\/em> If you are new to Python unit tests, please refer to our previous blog on Python unit checks<\/a> where we downloaded the Python Chess <\/a> application and wrote a Python unit test for it.<\/p>\n

\n

A step by step guide<\/h3>\n

STEP 1: Download and install Jenkins<\/a><\/strong>
\nJenkins provides installers for different operating systems. In companies, it is more common to see Jenkins hosted on a *nix system. Our best guess is that most testers use Windows. Our goal is to help you, the tester, learn about Jenkins. So we are choosing to use Windows in this example. You can download the Windows native package as a zip file. Extract the file and install Jenkins. Since we are installing Jenkins using the Windows installer, we don’t need to do anything else as the Windows installer automatically runs Jenkins as a Windows service.<\/p>\n

You can verify Jenkins is running as a service by launching the Services app from the Windows Start Menu and looking for a running service called “Jenkins” among the list of all windows services running on the machine.<\/p>\n

\"Windows<\/a><\/p>\n

By default, Jenkins runs at http:\/\/localhost:8080\/. You can change it by editing jenkins.xml, which is located in your installation directory.<\/p>\n

\"Jenkins\"<\/a><\/p>\n

STEP 2: Install and configure required Jenkins Plugins to run Python Unit Test<\/strong>
\nThere are various Python Plugins available to build python files in Jenkins. We will use ShiningPanda<\/a> Plugin which provides Python support to Jenkins with some useful builders.<\/p>\n

To install the plugin click on the Manage Jenkins<\/em> link on the left-hand side of the page. On the next page click on Manage Plugins<\/em> link. Finally on Plugin Manager page click on the Available tab and search for ShiningPanda<\/em>. Check the checkbox for the plugin and install it.Jenkins will install the selected plugins and then take a moment to restart<\/p>\n

\"Jenkins<\/a><\/p>\n

To configure Python installations, navigate to Manage Jenkins > Configure System. Search for the Python. Select Python Installations and configure it. The Name<\/em> is the name of the Python installation and Home or executable<\/em> is the path to the root folder of the Python installation<\/p>\n

\"Configure<\/a><\/p>\n

STEP 3: Install Python mock and Python nose<\/strong>
\nWe will use the Python mock module in our test case to mock some classes. The mock<\/a> module has one of my favorite features \u2013 patch decorators<\/a>, that make it easy to mock classes. We are doing this on Python 2.7. For Python 3.x you could skip this step. To install mock, open a command prompt and run:<\/p>\n

pip install -U mock<\/pre>\n
Python nose<\/a> extends unittest to make testing easier. By default, nose will run tests in files or directories under the current working directory whose names include “test” or “Test”. To install nose, open a command prompt and run:<\/p>\n
pip install nose<\/pre>\n
STEP 4: Add Python unit test cases<\/strong>
\nIn real life, you run a suite of tests. To make this example realistic, we are going to be writing three test cases. If you are already comfortable with Python nose, you can choose to run exactly one test. <\/p>\n
Test 1:<\/u> Please refer to our previous blog on python unit check<\/a>  where we have written a python unit test for a python chess app<\/a>. The test case to check whether the GetListOfValidMoves<\/em> method is getting called with the arguments that we expect it to be called with. <\/p>\n
Test 2:<\/u> Check if the mocked method was called at least once with some arguments<\/p>\n
\r\n\"\"\"\r\nExample written for Qxf2 Services' blog post on Python Unit Checking\r\nCheck if IsCheckmate method in ChessRules class calls GetListOfValidMoves  \r\nAssert that it called at least once with some expected argument\r\n\"\"\"\r\nimport unittest, mock\r\nimport ChessRules \r\nfrom ChessBoard import ChessBoard\r\n\r\nclass CheckIsCheckmate(unittest.TestCase):\r\n    \"Class to unit check the IsCheckmate method of ChessRules.py module\"\r\n    # creating a mock for GetListOfValidMoves\r\n    @mock.patch('ChessRules.ChessRules.GetListOfValidMoves')        \r\n    def test_called_with_args(self, mockGetListOfValidMoves):\r\n        \"Unit test for ChessRules method: IsCheckmate\"\r\n\r\n        # Creating objects of Chessboard and ChessRules class and calling IsCheckmate function with each piece for initial position and \"black\" color\r\n        cb = ChessBoard(0) #Create a chess board object with the initial position\r\n        chess_rules_obj = ChessRules.ChessRules()\r\n        chess_rules_obj.IsCheckmate(cb.GetState(),\"black\")\r\n        \r\n        # Create expected_arg_calls list which is supposed to be called with GetListOfValidMoves for initial position\r\n        # IsCheckmate calls GetListOfValidMoves with arguments: board, color (who is to play?) and co-ordinates of a square with a piece on it\r\n        expected_arg_calls = []\r\n        for row in range(0,2):\r\n            for col in range(0,8):\r\n                expected_arg_calls.append(mock.call(cb.GetState(), 'black', (row, col)))\r\n                \r\n        \r\n        # assert that method was called at least once with some argument        \r\n        mockGetListOfValidMoves.assert_any_call(cb.GetState(),\"black\",(1,6))\r\n\r\n        \r\nif __name__==\"__main__\":\r\n    unittest.main()\r\n<\/pre>\n
Test 3:<\/u> Check if the mocked method was called exactly 16 times<\/p>\n
\r\n\"\"\"\r\nExample written for Qxf2 Services' blog post on Python Unit Checking\r\nCheck if IsCheckmate method in ChessRules class calls GetListOfValidMoves  \r\nAssert that the mocked method is called 16 times\r\n\"\"\"\r\nimport unittest, mock\r\nimport ChessRules \r\nfrom ChessBoard import ChessBoard\r\n\r\nclass CheckIsCheckmate(unittest.TestCase):\r\n    \"Class to unit check the IsCheckmate method of ChessRules.py module\"\r\n    # creating a mock for GetListOfValidMoves\r\n    @mock.patch('ChessRules.ChessRules.GetListOfValidMoves')        \r\n    def test_call_count(self, mockGetListOfValidMoves):\r\n        \"Unit test for ChessRules method: IsCheckmate\"\r\n                        \r\n        # Creating objects of Chessboard and ChessRules class and calling IsCheckmate function with each piece for initial position and \"black\" color\r\n        cb = ChessBoard(0) #Create a chess board object with the initial position\r\n        chess_rules_obj = ChessRules.ChessRules()\r\n        chess_rules_obj.IsCheckmate(cb.GetState(),\"black\")\r\n        \r\n        # Create expected_arg_calls list which is supposed to be called with GetListOfValidMoves for initial position\r\n        # IsCheckmate calls GetListOfValidMoves with arguments: board, color (who is to play?) and co-ordinates of a square with a piece on it\r\n        expected_arg_calls = []\r\n        for row in range(0,2):\r\n            for col in range(0,8):\r\n                expected_arg_calls.append(mock.call(cb.GetState(), 'black', (row, col)))\r\n                \r\n        \r\n        # check the number of times your mocked method was called\r\n        self.assertEqual(mockGetListOfValidMoves.call_count,16)\r\n        \r\n            \r\nif __name__==\"__main__\":\r\n    unittest.main()\r\n<\/pre>\n
STEP 5: Set up the project in Jenkins<\/strong> <\/p>\n