Skip to main content

pytest ngs fixtures

Project description



This is a pytest plugin that provides functionality for next generation sequencing pytest fixtures. There are some predefined fixtures, but the main functionality depends on configuring fixtures via the pytest.mark helper function.

See the pytest-ngsfixtures documentation for more information and usage.

  • Free software: GNU General Public License v3


  • a small test ngs data set

  • predefined sample layouts

  • wrappers for quickly setting up workflow tests


$ conda install -c percyfal pytest-ngsfixtures
$ pip install pytest-ngsfixtures


You can easily setup a test requiring the predefined samples and ref fixtures:

def test_data(samples, ref):
 shell("bwa index {}".format(ref.join("scaffolds.fa")))
 shell("bwa mem {} {} {} | samtools view -b > {}".format(
 assert samples.join("s1.bam").exists()

The samples and ref fixtures can also be configured to use local files:

import pytest

@pytest.mark.samples(layout={'s1_1.fastq.gz': "/path/to/read1.fastq.gz",
                             's1_2.fastq.gz': "/path/to/read2.fastq.gz"})
@pytest.mark.ref(data={'ref.fa': "/path/to/reference.fa"})
def test_data(samples, ref):
    # Do something with data

In addition, there are wrapper functions and fixtures for workflow managers, including Snakemake.

import pytest
from pytest_ngsfixtures.wm.snakemake import snakefile, run as snakemake_run

# By default, the snakefile fixture assumes there is a Snakefile in
# the test file directory
def test_workflow(samples, snakefile):
    snakemake_run(snakefile, options=["-d", str(samples)])
    assert samples.join("results.txt").exists()

See the pytest-ngsfixtures documentation for more examples.


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


0.8.1 (2019-09-06)

Hotfix: fix failing conda builds

0.8.0 (2019-09-05)


  • Add support for python 3.7

  • Pin pytest >= 5.0

  • PEP-8 formatting

  • Check for correct snakemake repo tag

0.7.6 (2018-05-25)


  • Add path option to override tmpdir_factory invocation

  • Pass ignore_errors to copy/link function

0.7.5 (2018-05-25)


  • Add Fixture class to setup fixtures (#63)

0.7.4 (2018-05-24)


  • Make pytest.mark.fixture have precedence over pytest.mark.parametrize when updating functions

0.7.3 (2018-05-24)


  • Add testdir parameter and allow configuration of all fixture options via parametrization (#62)

0.7.2 (2018-05-24)


  • Fix layout for multi-run samples (#61)

0.7.1 (2018-05-23)


  • Update busybox images for tests (#59)

  • Fix failing test (#58)

0.7.0 (2018-05-23)

Breaking changes

This is a major update in which the API has changed considerably. Notably, most of the code for generating fixtures has been removed and refactored completely. Most importantly, the factory functions have been replaced by a small number of fixtures that can be configured via the pytest.mark helper.

In addition, most data files have been removed in an attempt to make the package as small as possible. As the location of test data has been decoupled from package functionality, it makes more sense to distribute package data separately.

See the API documentation for more information.


  • Remove application data (#30)

  • Simplify config.runfmt_alias function (#56)

  • Only package tiny sequence data (#55)

  • Simplify sample layout configuration (#57)

0.6.4 (2018-01-31)

  • Add docker-py as a dependency (#52)

0.6.3 (2018-01-02)

  • Remove obsolete working directory argument - requires snakemake >= 4.4.0

  • Install correct docker API (#50)

  • Allow modifying path in shell wrapper (#51)

0.6.2 (2017-12-19)

Add shell wrappers and wrappers for easily setting up workflow tests.

Add tutorial.


  • Update pypi badge

  • Remove tox.ini

  • Defer setting alias to FixtureFile (#42)

  • ReadFixtureFile.SM now returns id (#39)

  • Options ngs_layout and ngs_runfmt are now lists (#41)

  • Update project layout configuration (#40)

  • Add function to return runfmt and alias as tuple (#43)

  • Read 1 and 2 have same id when alias required (#45)

  • Census is not increased for read 2 (#44)

  • Add option to only setup sampleinfo (#47)

  • Add tutorial (#46)

  • Add working snakemake tests (#8)

0.6.1 (2017-11-22)

Added some fixes that turned out to be necessary for optional performance.

  • Add fixture that parametrizes over input parameters (#37)

  • Fix bug that returned wrong number of snakemake targets in application output generation (#36)

  • Add travis builds (#35)

  • Fix reference layout error for python 3.5 (#34)

  • Update option defaults (#32)

  • Expose fewer predefined fixtures via plugin (#31)

  • Unify parameter names (#33)

0.6.0 (2017-11-21)

This is a major revision of the code. Several new abstraction classes have been introduced to ease interaction with local test files, along with new factory functions. For backwards compatibility, most factory functions should work as previously. Documentation has been much improved.

  • Clarify fixture function naming convention (#29)

  • Expose bulk of factory inner functions (#24)

  • Create separate module for os-related functions (#27)

  • Use separate conda build statements to build for different python versions (#23)

0.5.2 (2017-11-16)

  • Add pool fixtures (#22)

  • Add safe_copy function (#21)

0.5.1 (2017-10-25)

  • Change name to pytest-ngsfixtures (#20)

  • Add bcftools versions 1.4, 1.4.1, 1.5, 1.6

  • Add bowtie

0.5.0 (2017-09-25)

  • Add star application

  • Add vsearch application

  • Add rseqc application

  • Add snakemake dependency

  • Update docs

  • Separate qualimap pe and se output (#12)

  • Add mapdamage2 (#11)

  • Fix mapdamage2 missing output (#18)

  • Use realpath to determine download url (#17)

  • Rename to

  • Update versions for samtools

0.4.0 (2017-03-28)

  • Add picard output data

  • Add functions for dealing with application fixtures

  • Move docs to gh-pages

  • Add for templating new applications

  • Application outputs now implemented as dictionaries for multiple-output applications

0.3.1 (2017-03-03)

Defer download to script, minor bug fixes

  • Add application_fixtures to config module

  • Fix sample_alias bug (#4)

  • Add script for manual download of data (#5)

0.3.0 (2017-03-02)

Add application data, pool data, and functions for downloading data

  • Add application data for cutadapt, fastqc, qualimap and samtools

  • Add pooled sequencing data

  • Add functionality for downloading large data sets

  • Improve make targets for easier releases

  • Minor bug fixes

0.2.0 (2017-02-24)

Add new reference files, test files, and factory functions.

  • Use snakemake instead of make to generate data files

  • Add separate test file for factory functions

  • Add scaffold file with randomly inserted N’s

  • Improve safe_symlink

  • Add threads options for running tests

  • Add Snakefile and rules for generating application files

  • Add fileset, filetype factory functions

0.1.0 (2017-01-24)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest-ngsfixtures-0.8.1.tar.gz (1.6 MB view hashes)

Uploaded source

Built Distribution

pytest_ngsfixtures-0.8.1-py2.py3-none-any.whl (1.6 MB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page