How to Use pytest Skip Test And XFail in Selenium

Paulo Oliveira

Posted On: April 29, 2024

view count89203 Views

Read time20 Min Read

While performing automated testing with pytest, you may need to skip test execution due to the ongoing refactoring of functionalities, which may lead to instability or alignment with current project requirements. In such scenarios, leveraging pytest skip test functionality becomes crucial.

pytest skip test functionality lets users focus on relevant tests during debugging and prioritize important tests within time constraints. Additionally, pytest skip test functionality helps manage broken or flaky tests, enabling progress on other tests while issues are resolved.

In this blog, you will learn how to use pytest skip test functionality, skip a single test, test according to a specific condition through the command line and using a configuration file, and mark tests as xfail.

Why Use Selenium Python for Test Automation?

Python is an open-source programming language with easy-to-understand code that is compatible across different platforms. It’s constantly improving with updates and has a fantastic community behind it. Right now, Python 3.12.3 is the latest version out there.

According to the Stack Overflow Developer Survey 2023, Python has gained prominence over the years and has become the third most popular language.

Stack Overflow Developer Survey 2023

Python is a go-to choice for automating tests because of its huge community and tons of helpful libraries and frameworks. If you’re curious about its fundamentals, check out this article on Python basics.

When it comes to automation testing, Selenium is a widely used open-source framework that supports multiple programming languages, including Python. Selenium’s extensive capabilities, coupled with Python’s simplicity and flexibility, empower developers to create robust, maintainable, and scalable automation scripts.

What is the pytest Framework?

pytest is a testing framework for Python used for writing simple unit tests as well as complex functional tests. It provides a simple way to write tests using Python’s standard assert statements, making it easy to get started. It also offers a range of features, such as fixture support, parameterized testing, and plugins for extending its functionality.

Subscribe to the LambdaTest YouTube Channel. Get the latest updates on various Python automation tutorials covering Selenium Python, Selenium pytest, and more.

Here are some advantages of using pytest framework:

  • Easy to use: pytest has a simple and intuitive syntax, making it easy for new users to get started with test automation. Its natural language style and descriptive error messages make it easy to understand the results of a test run.
  • Highly flexible: It allows users to write tests using a wide variety of testing styles and approaches. It supports unit testing, functional testing, integration testing, and more. Additionally, pytest has a large ecosystem of plugins and extensions that can be used to customize and enhance its behavior.
  • Write effective test cases: pytest supports a number of features that can help users write effective test cases and execute them more efficiently. For example, it supports automatic test discovery, which allows users to specify the location of tests and have pytest automatically locate and run them. It also supports parallel test execution, which can significantly reduce the time it takes to run a large test suite.
  • pytest parameterization: pytest allows you to easily parameterize test functions, making it simple to run the same test with multiple inputs. This can save a lot of time and code when writing tests.
  • Detailed reporting: pytest generates detailed test reports, including the number of tests run, the number of tests passed, and the number of tests failed.
  • Plugins support: It has a large ecosystem of plugins that can be used to extend its functionality. Plugins are available for things like test discovery, test execution, test reporting, and more.
  • Assertion introspection: pytest provides detailed information about test failures, including the local variables in the test function and the values of the function arguments. This makes it easier to understand and fix test failures.
  • pytest fixtures: pytest allows you to define fixtures, which are reusable pieces of code that can be used to set up and tear down test dependencies. pytest fixtures can be used to share resources across multiple test functions, making it easy to write modular and maintainable test code.
  • Well-documented: pytest has comprehensive documentation that makes it easy for folks to learn how to use pytest and get the most out of its features.
  • Large and active community: It has a large and active community of users, developers, and testers who contribute to its development and support. This means that users can often find help and advice from other users when they encounter issues or have questions about pytest.

In the next section of this blog on pytest skip test functionality, we will set up the pytest project to set the foundation for using the pytest skip test functionality.

Setting Up the pytest Project

In this blog, all the configurations and codes will be used to demonstrate how to use pytest skip test functionality. For demonstration purposes, we will use VS Code. However, you are free to use your preferable IDE.

  1. Download and install Python according to your operating system.
  2. Install Selenium WebDriver using the below command.
  3. Install pytest using the below command.
  4. To set up pytest as the test runner in Visual Studio Code, follow these steps:
    1. Start by creating a folder for your project. For instance, you can name it “ARTICLE-SKIP-PYTEST-PYTHON-TESTS”.
    2. Open VS Code and navigate to the project folder you just created.
    3. Create another folder named “tests”. This is where you’ll store your test files.
    4. Create a new file named “_init_py”. This file tells Python that the folder is a package, allowing you to import modules from it.
    5. Once you’ve completed these steps, you’re ready to start writing your tests using pytest in VS Code.

      Here is the project structure is shown below:

      project structure

    6. Open the command palette (menu View > Command Palette), and type “Configure Tests”.
    7. command palette

    8. Select pytest as the test framework.
    9. Now select the “tests” folder that contains the test files.

The demonstration will be done on cloud-based testing platforms like LambdaTest. It is an AI-powered test orchestration and execution platform that helps developers and testers perform Python automation testing at scale on a remote test lab of 3000+ real environments.

To perform pytest testing on the LambdaTest platform, you need to use the capabilities to configure the environment where the test will run.

In this blog on pytest skip test functionality, we are going to run the tests with the following configurations:

  • Automation testing tool: Selenium 4
  • Browser: Chrome
  • Browser version: “latest”
  • Resolution: 1024 x 768
  • Operating system: Windows 11

You can generate the capabilities from the LambdaTest Automation Capabilities Generator.

Then, you can get the LambdaTest Username and Access Key from your Profile > Account Settings > Password & Security.

Now you have everything configured, let’s look at how to use pytest skip test functionality.

Demonstration: Using pytest Skip Test Functionality

The primary purpose of this blog is to show you all the ways to use pytest skip test functionality.

Skipping tests are helpful for various reasons:

  • Isolating known issues: You can skip tests that are currently broken or expected to fail to avoid impacting your overall test results and focus on tests that should be passing.
  • Conditional test execution: Tests can be skipped based on specific conditions, such as environmental factors or functionalities under development.
  • Targeted test runs: When running a subset of tests, skipping allows you to focus on a specific area of the codebase without executing the entire test suite.

Following are the ways to use pytest skip test functionality:

  • Skipping a single test.
  • Skipping a test according to a specific condition.
  • Skipping through the command line.
  • Skipping using a configuration file.
  • Skipping a test that is expected to fail.

It’s worth noting that skipping tests should be used strategically. If you have a lot of skipped tests, it could indicate that there’s something wrong with your test strategy or that you are not maintaining your tests properly.

Quick Test: Opening a Web Page on Chrome

Before we go ahead and demonstrate the pytest skip test functionality, let’s run a quick test to ensure that all configurations are working correctly.

The test will just open the Simple Form Demo page from LambdaTest eCommerce Playground and check that the page title is Selenium Grid Online | Run Selenium Test On Cloud. All of our tests will have the same steps, so the content will be used for all the tests.

Implementation:

Github

Code Walkthrough:

First, you must import the library that is needed for Selenium WebDriver to interact with the browser.

Then, create a browser() function. To create a browser() function in pytest that instantiates a browser, you can use the @pytest.fixture decorator. A fixture is a function run before each test to set up a known state. This fixture will run before each test and create a new instance of the Chrome browser to be run in LambdaTest.

Inside the browser() function, we have:

  • The username and accessToken of your LambdaTest account.
  • The LambdaTest gridUrl.
  • The LambdaTest automation capabilities.
  • The test URL that will be used to run tests on the LambdaTest cloud grid.
  • The instantiation of the browser driver.
  • The maximize_window() method to maximize the screen when the browser opens (not mandatory, but helps the visualization during the execution).
  • The yield statement is used to return the browser object to the test function.
  • The code after the yield statement will be run after the test is finished. In our case, the quit function is called in the browser object to close it at the end of each test.

Now, create a test_01() function to understand that this is a test case. As a parameter of this function, pass the browser object.

The test will perform the following actions:

  1. Open the Simple Form Demo page. For this, use the browser instance to access the desired web page, using the get() function and informing the website URL that it should be opened.
  2. Check that the browser title is correctly shown. For this, use the assert statement to compare the browser title with the expected title string Selenium Grid Online | Run Selenium Test On Cloud.

To run the tests, you should:

  1. Go to the TESTING tab in your VS Code
  2. Click ▶ to play the tests in the test suite. At this moment, you only have one test, but this process will be the same for the next test cases.
  3.  test cases

Skipping a Single Test

pytest skip test functionality provides a number of ways to skip tests, including the ability to skip a single test. To skip a single test using pytest, we can use the @pytest.mark.skip decorator. In the test below, test_02 will be skipped when running the tests.

Here is an example of how to use @pytest.mark.skip decorator to skip a test. The below snippet should follow the code demonstrated in the test_01, omitting the need for the test_01 in this context.

Implementation:

Code Walkthrough:

Using the @pytest.mark.skip decorator, test_02 will be skipped when running the tests.

Create a test_02() function using the browser object as a parameter. Inside it, open the desired page, then assert that the correct page title is shown.

Now, run the tests. As expected, the test_02 was skipped, and just the test_01 was executed.

run the tests

Skipping a Test Based on a Specific Condition

pytest skip test functionality can skip a single test according to a specific condition. The @pytest.mark.skipif decorator allows you to specify conditions under which a test should be skipped. This can be useful if you have tests that should only be run under certain conditions or if you have tests that are currently failing and you want to temporarily skip them until they can be fixed.

In the below test, the test_03 will be skipped when running in a Linux environment, and the test_04 will be skipped when running in a Windows environment.

Here is an example of how to use @pytest.mark.skipif decorator to skip a test. This code should be preceded by the code shown in test_01, except test_01, which does not need to be used here.

Implementation:

Code Walkthrough:

Import the sys library to check the operating system that is being used to run the tests.

Use the @pytest.mark.skipif decorator. This specifies the test condition in which the test will be skipped when executed. In the test_03, specify that if the operating system is Linux, this test should be skipped.

To create this condition, use sys.platform.startswith(“linux”). Then, specify a reason to skip this test. In this code example, it is “Not available on Linux”.

Create a test_03() function using the browser object as a parameter. Inside it, open the desired page, then assert that the correct page title is shown.

In test_04, specify that if the operating system is Windows, this test should be skipped. To create this condition, use sys.platform.startswith(“win”). Then, specify a reason to skip this test. In this code example, it is “Not available on Windows”.

Create a test_04() function using the browser object as a parameter. Inside it, open the desired page, then assert that the correct page title is shown.

Run the tests now and see the below result:

result

As expected, given that we are running tests on a Windows environment, the test_03 is executed, and the test_04 was skipped.

Skipping a Test Through the Command Line

pytest skip test functionality allows you to skip a single or a group of tests through the command line. One of the most useful features of pytest is the ability to specify which test cases to run using the -k flag.

The -k flag stands for keyword and specifies a keyword expression that will be used to filter the test cases that pytest runs. For example, if you have a test file with multiple test functions, you can use the -k flag only to run the test functions that contain a certain keyword in their name.

Here is an example of how you can use the -k flag to filter test cases in pytest. This code should be preceded with the code shown in the test_01, with the exception of test_01 which does not need to be used here.

Implementation:

Code Walkthrough:

Create a test_05() function using the browser object as a parameter. Inside it, open the desired page, then assert that the correct page title is shown.

Use the below command to run the tests using the command line:

In the above code, we used the pytest command using the -k flag and informing the keyword you don’t want to run between quotes. You should inform the keyword not, followed by a space for the keyword you wish to, which should be part of the function name of the test you want to skip. In our example, we will skip the tests with 05 in the function name.

After running the above command, see the below result:

test result

As expected, the test_05 is not executed. In the command line, it is shown as 1 deselected.

Note: This ability is handy where you have multiple test cases related to login functionality, each with a distinct name indicating its purpose (e.g., test_login_success, test_login_wrong_pwd, test_login_wrong_username).

You can skip the successful test cases just running the below command in the command line:

It will selectively execute tests whose names do not contain the word “success”. This allows you to easily skip tests associated with a specific functionality or scenario without affecting other tests.

Skipping a Test Using a Configuration File

One useful feature of pytest skip test functionality is the ability to configure it using a configuration file called pytest.ini. This configuration file can be used to set various options that control the behavior of pytest.

One such option is the addopts, which allows you to specify command line options that should be passed to pytest when it is run. This can be useful for setting options that are not available as part of the pytest configuration file or passing in options you want to use frequently.

You can just do as shown below:

Implementation:

Code Walkthrough:

To create a pytest.ini file that uses the addopts option, create a new file in the root directory of your project and name it pytest.ini.

Then, add the following:

  • [pytest]: This needs to be understood by pytest that this is the configuration file and should be followed.
  • addopts = -k “not 06”: This specifies the command line options that you want to pass to pytest by adding them after the = sign. In this example, run all tests that do not match a particular pattern and should not contain the 06 in the test name.

Create a new test_06() function using the browser object as a parameter. Inside it, open the desired page, then assert that the correct page title is shown.

Run the tests now and see the below result:

correct page title

We have two important points to mention about this test execution:

  • test_05 was executed in this case because now we are running it directly in VS Code. As shown in the previous session, when executing through the command line with the -k option, it will be skipped.
  • test_06 is not being shown in the list of tests because pytest checks the configuration file, then it is noticed that it should not consider tests with “06” in the name, so it is skipped and not shown in the list.

Skipping a Test Expected to Fail

One of the interesting features of pytest skip test functionality is the ability to mark tests as xfail, which stands for expected to fail. It is marked using the @pytest.mark.xfail decorator. When a test is marked as xfail, pytest will run the test as usual, but it will expect the test to fail. If the test passes, the pytest framework will treat it as a failure; if it fails, the pytest framework will treat it as a success. This feature can be useful in several scenarios.

One use case for xfail is when you have a test that is known to fail, but you want to keep it in the test suite anyway. For example, if you are working on a new feature that has yet to be fully implemented, you can mark the test as xfail so that it will not fail the build, but you can still see its progress.

Another use case is when working with an external dependency not under your control, such as a third-party API known to have bugs. You can mark the test as xfail so that it will not fail the build, but you can still see if the bug has been fixed.

Here is an example of how to use @pytest.mark.xfail decorator. This code should be preceded with the code shown in the test_01, with the exception of test_01, which does not need to be used here.

Implementation:

Code Walkthrough:

Use the @pytest.mark.xfail decorator to say that this test is expected to fail.

Create a new test_07() function using the browser object as a parameter. Inside it, open the desired page, then assert that a wrong page title is shown.

Run the tests now, see the below result:

wrong page title

As expected, test_07 is considered as passed, even though it failed.

That brings us to the end of this blog on using pytest skip test functionality.

But why stop here? If you’re eager to deepen your expertise in test automation, explore the LambdaTest Selenium Python 101 certification. This certification will help validate your skills to excel in automation testing using Selenium Python.

Info Note

Run your pytest tests with Selenium on the cloud. Try LambdaTest Today!

Conclusion

In this blog on pytest skip test functionality, we learned how to skip a test in Python pytest.

We discussed the rationale behind using Python and Selenium for test automation. We explained the functionality of the pytest framework and its role in executing Python test cases effectively.

Additionally, we covered the setup procedures necessary to configure all essential environments, including running automation tests on an online Selenium Grid using the LambdaTest platform.

Lastly, we outlined four methods for using pytest skip test functionality: individually, based on conditions, via the command line, through a configuration file, and using xfail. All of these were demonstrated using test scenarios.

Frequently Asked Questions (FAQs)

What is skip in pytest?

In pytest, skip allows you to temporarily suspend a test’s execution. It’s useful for tests that aren’t ready or rely on unavailable resources.

How do I skip a file in pytest?

While pytest doesn’t directly skip files, you can use the @pytest.mark.skip decorator at the module level. Add it to your test file to mark all tests within as skipped.

How do I skip all tests in pytest?

There’s no single command to skip all tests, but you can leverage command-line options. For specific test cases or directories, use pytest –skip-test.

Author Profile Author Profile Author Profile

Author’s Profile

Paulo Oliveira

Paulo is a Quality Assurance Engineer with more than 15 years of experience in Software Testing. He loves to automate tests for all kind of applications (both backend and frontend) in order to improve the team’s workflow, product quality, and customer satisfaction. Even though his main roles were hands-on testing applications, he also worked as QA Lead, planning and coordinating activities, as well as coaching and contributing to team member’s development. Sharing knowledge and mentoring people to achieve their goals make his eyes shine.

Blogs: 15



linkedintwitter

Test Your Web Or Mobile Apps On 3000+ Browsers

Signup for free