pytest-dev/cookiecutter-pytest-plugin pytest-dev/cookiecutter-pytest-plugin

  • Stars
    star
    292
  • Rank 142,152 (Top 3 %)
  • Language
    Python
  • License
    MIT License
  • Created over 9 years ago
  • Updated 8 months ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
pytest-dev/cookiecutter-pytest-plugin
github

pytest-dev

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A Cookiecutter template for pytest plugins πŸ’»

cookiecutter-pytest-plugin

Documentation Status

Minimal Cookiecutter template for authoring pytest plugins that help you to write better programs.

This template requires Cookiecutter 1.4.0 "Shortbread" or higher

Getting Started

Install Cookiecutter and generate a new pytest plugin project:

$ pip install cookiecutter
$ cookiecutter https://github.com/pytest-dev/cookiecutter-pytest-plugin

Cookiecutter prompts you for information regarding your plugin:

full_name [Raphael Pierzina]: Andreas Pelme
email [[email protected]]: [email protected]
github_username [hackebrot]: pelme
plugin_name [foobar]: awesome
module_name [awesome]: awesome
short_description [A simple plugin to use with pytest]:
version [0.1.0]:
pytest_version [2.9.1]:
Select docs_tool:
1 - mkdocs
2 - sphinx
3 - none
Choose from 1, 2, 3 [1]: 1
Select license:
1 - MIT
2 - BSD-3
3 - GNU GPL v3.0
Choose from 1, 2, 3 [1]: 2
INFO:post_gen_project:Moving files for mkdocs.

There you go - you just created a minimal pytest plugin:

pytest-awesome/
β”œβ”€β”€ LICENSE
β”œβ”€β”€ README.rst
β”œβ”€β”€ docs
β”‚Β Β  └── index.md
β”œβ”€β”€ mkdocs.yml
β”œβ”€β”€ pytest_awesome.py
β”œβ”€β”€ setup.py
β”œβ”€β”€ tests
β”‚Β Β  β”œβ”€β”€ conftest.py
β”‚Β Β  └── test_awesome.py
└── tox.ini

Features

  • Installable PyPI package featuring a setup.py.
  • Test suite running tox and pytest that makes sure your plugin is working as expected
  • Working example code for a fixture, a cli option, as well as a pytest.ini option
  • Comprehensive README.rst file that contains useful information about your plugin
  • Continuous integration configuration for AppVeyor
  • Optional documentation with either Sphinx or MkDocs
  • Choose from several licenses, such as MIT, BSD-3, Apache v2.0, GNU GPL v3.0, or MPL v2.0

Requirements to Submit a Plugin

If you plan on submitting your plugin to the pytest-dev organization you need to meet the following requirements:

  • PyPI presence with a setup.py that contains a license, pytest- prefixed, version number, authors, short and long description.
  • a tox.ini for running tests using tox.
  • a README describing how to use the plugin and on which platforms it runs.
  • a LICENSE file or equivalent containing the licensing information, with matching info in setup.py.
  • an issue tracker unless you rather want to use the core pytest issue tracker.

Please see the official guidelines at Submit a Plugin.

Resources

Please consult the pytest docs for more information on hooks at pytest hook reference.

Contribute

We welcome you to contribute to this project. Please visit the documentation to get started!

Issues

If you encounter any problems, please file an issue along with a detailed description.

Code of Conduct

Everyone interacting in the Cookiecutter pytest Plugin project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the PyPA Code of Conduct.

License

Distributed under the terms of the MIT license, Cookiecutter pytest Plugin is free and open source software.

OSI certified

More Repositories

1

pytest

The pytest framework makes it easy to write small tests, yet scales to support complex functional testing
Python
11,750
star
2

pytest-testinfra

Testinfra test your infrastructures
Python
2,359
star
3

pytest-mock

Thin-wrapper around the mock package for easier use with pytest
Python
1,804
star
4

pytest-cov

Coverage plugin for pytest.
Python
1,722
star
5

pytest-xdist

pytest plugin for distributed testing and loop-on-failures testing modes.
Python
1,421
star
6

pytest-asyncio

Asyncio support for pytest
Python
1,378
star
7

pytest-django

A Django plugin for pytest.
Python
1,350
star
8

pytest-bdd

BDD library for the py.test runner
Python
1,281
star
9

pluggy

A minimalist production ready plugin system
Python
1,235
star
10

pytest-html

Plugin for generating HTML reports for pytest results
Python
689
star
11

pyfakefs

Provides a fake file system that mocks the Python file system modules.
Python
635
star
12

pytest-randomly

🎲 Pytest plugin to randomly order tests and control random.seed
Python
600
star
13

pytest-flask

A set of pytest fixtures to test Flask applications
Python
483
star
14

pytest-qt

pytest plugin for Qt (PyQt5/PyQt6 and PySide2/PySide6) application testing
Python
401
star
15

pytest-rerunfailures

a pytest plugin that re-runs failed tests up to -n times to eliminate flakey failures
Python
373
star
16

pytest-factoryboy

factory_boy integration the pytest runner
Python
358
star
17

pytest-selenium

Plugin for running Selenium with pytest
Python
331
star
18

pytest-splinter

pytest splinter and selenium integration for anyone interested in browser interaction in tests
Python
253
star
19

pytest-describe

Describe-style plugin for the pytest framework
Python
208
star
20

pytest-timeout

Python
206
star
21

pytest-subtests

unittest subTest() support and subtests fixture
Python
199
star
22

pytest-repeat

pytest plugin for repeating test execution
Python
168
star
23

pytest-order

pytest plugin that allows to customize the test execution order
Python
158
star
24

pytest-instafail

py.test plugin to show failures instantly
Python
135
star
25

unittest2pytest

helps rewriting Python `unittest` test-cases into `pytest` test-cases
Python
128
star
26

pytest-env

pytest plugin to set environment variables in pytest.ini or pyproject.toml file
Python
128
star
27

pytest-github-actions-annotate-failures

Pytest plugin to annotate failed tests with a workflow command for GitHub Actions
Python
127
star
28

pytest-cpp

Use pytest's runner to discover and execute C++ tests
C++
117
star
29

pytest-xprocess

pytest external process plugin
Python
97
star
30

pytest-reportlog

Replacement for the --resultlog option, focused in simplicity and extensibility
Python
89
star
31

execnet

distributed Python deployment and communication
Python
78
star
32

pytest-variables

Plugin for providing variables to pytest tests/fixtures
Python
74
star
33

pytest-play

pytest plugin that let you automate actions and assertions with test metrics reporting executing plain YAML files
Python
68
star
34

py

Python development support library (note: maintenance only)
Python
67
star
35

pytest-print

pytest-print adds the printer fixture you can use to print messages to the user (directly to the pytest runner, not stdout)
Python
67
star
36

pytest-messenger

Pytest-messenger report plugin for all popular messengers like: Slack, DingTalk, Telegram
Python
67
star
37

pytest-random-order

pytest plugin to randomise the order of tests with some control over the randomness
Python
65
star
38

pytest-forked

extracted --boxed from pytest-xdist to ensure backward compat
Python
62
star
39

pytest-mimesis

Mimesis integration with the pytest test runner. This plugin provider useful fixtures based on providers from Mimesis.
Python
62
star
40

pytest-services

Collection of fixtures and utility functions to run service processes for your tests
Python
57
star
41

pytest-runner

Python
56
star
42

pytest-metadata

Plugin for accessing test session metadata
Python
56
star
43

apipkg

Python
55
star
44

iniconfig

Python
50
star
45

pytest-twisted

test twisted code with pytest
Python
46
star
46

pytest-freezer

Pytest plugin providing a fixture interface for spulec/freezegun
Python
45
star
47

pytest-incremental

py-test plugin: an incremental test runner
Python
42
star
48

pytest-stress

A Pytest plugin that allows you to loop tests for a user defined amount of time.
Python
41
star
49

nose2pytest

Scripts to convert Python Nose tests to PyTest
Python
38
star
50

pytest-base-url

pytest plugin for URL based tests
Python
38
star
51

pytest-faker

faker integration the pytest test runner
Python
38
star
52

pytest-fixture-tools

Pytest fixture tools
Python
36
star
53

pytest-cloud

Distributed tests planner plugin for pytest testing framework.
Python
35
star
54

plugincompat

Test execution and compatibility checks for pytest plugins
CSS
34
star
55

pytest-faulthandler

py.test plugin that activates the fault handler module during testing
Python
27
star
56

pytest-localserver

py.test plugin to test server connections locally. This repository was migrated from Bitbucket.
Python
23
star
57

pygments-pytest

A pygments lexer for pytest output
Python
23
star
58

pytest-echo

pytest plugin to dump environment variables, package version and generic attributes.
Python
22
star
59

pytest-inline

pytest-inline is a pytest plugin for writing inline tests.
Python
16
star
60

pytest-nunit

An Nunit output plugin for Pytest
Python
10
star
61

pytest-plus

pytest-plus adds new features to pytest
Python
10
star
62

design

Graphic design for Pytest project
9
star
63

pytest-iam

A fully functional OAUTH2 / OpenID Connect (OIDC) server to be used in your testsuite
Python
7
star
64

sprint

pytest development sprint 2024
7
star
65

pytest-bpdb

pytest plugin for dropping to bpdb on test failures
Python
6
star
66

blog.pytest.org

Repository for the official pytest blog
Python
4
star
67

pytest-tcpclient

pytest mocking of TCP clients
Python
3
star
68

regendoc

Python
2
star
69

meta

Used for generic pytest organization issues, stuff that can impact multiple projects.
2
star
70

pytest-libfaketime

Prepare pytest for python-libfaketime - https://github.com/simon-weber/python-libfaketime
Python
2
star
71

pytest-talks

public pytest talks and workshops - meant to help user groups spin up talks and workshops
HTML
1
star