Skip to main content

Pynguin is a tool for automated unit test generation for Python

Project description

Pynguin

Pynguin (IPA: ˈpɪŋɡuiːn), the PYthoN General UnIt test geNerator, is a tool that allows developers to generate unit tests automatically.

Testing software is often considered to be a tedious task. Thus, automated generation techniques have been proposed and mature tools exist—for statically typed languages, such as Java. There is, however, no fully-automated tool available that produces unit tests for general-purpose programs in a dynamically typed language. Pynguin is, to the best of our knowledge, the first tool that fills this gap and allows the automated generation of unit tests for Python programs.

Internal Pipeline Status

pipeline status coverage report

License MIT Code style: black Ruff PyPI version Supported Python Versions Documentation Status DOI REUSE status Downloads SWH

Pynguin Logo

Attention

Please Note:

Pynguin executes the module under test! As a consequence, depending on what code is in that module, running Pynguin can cause serious harm to your computer, for example, wipe your entire hard disk! We recommend running Pynguin in an isolated environment; use, for example, a Docker container to minimize the risk of damaging your system.

Pynguin is only a research prototype! It is not tailored towards production use whatsoever. However, we would love to see Pynguin in a production-ready stage at some point; please report your experiences in using Pynguin to us.

Prerequisites

Before you begin, ensure you have met the following requirements:

  • You have installed Python 3.10 (we have not yet tested with Python 3.11, there might be some problems due to changed internals regarding the byte-code instrumentation).

    Attention: Pynguin now requires Python 3.10! Older versions are no longer supported!

  • You have a recent Linux/macOS/Windows machine.

Please consider reading the online documentation to start your Pynguin adventure.

Installing Pynguin

Pynguin can be easily installed using the pip tool by typing:

pip install pynguin

Make sure that your version of pip is that of a supported Python version, as any older version is not supported by Pynguin!

Using Pynguin

Before you continue, please read the quick start guide

Pynguin is a command-line application. Once you installed it to a virtual environment, you can invoke the tool by typing pynguin inside this virtual environment. Pynguin will then print a list of its command-line parameters.

A minimal full command line to invoke Pynguin could be the following, where we assume that a project foo is located in /tmp/foo, we want to store Pynguin's generated tests in /tmp/testgen, and we want to generate tests using a whole-suite approach for the module foo.bar (wrapped for better readability):

pynguin \
  --project-path /tmp/foo \
  --output-path /tmp/testgen \
  --module-name foo.bar

Please find a more detailed example in the quick start guide.

Contributing to Pynguin

For the development of Pynguin you will need the poetry dependency management and packaging tool. To start developing, follow these steps:

  1. Clone the repository

  2. Change to the pynguin folder: cd pynguin

  3. Create a virtual environment and install dependencies using poetry: poetry install

  4. Make your changes

  5. Run make check to verify that your changes pass all checks

    Please see the poetry documentation for more information on this tool.

Contributors

Pynguin is developed at the Chair of Software Engineering II of the University of Passau.

Maintainers: Stephan Lukasczyk, Lukas Krodinger

Contributors:

Development using PyCharm.

If you want to use the PyCharm IDE you have to set up a few things:

  1. Import pynguin into PyCharm.
  2. Let PyCharm configure configure a virtual environment using poetry.
  3. Set the default test runner to pytest
  4. Set the DocString format to Google

License

This project is licensed under the terms of the MIT License. Pynguin was using the GNU Lesser General Public License (LGPL) until version 0.29.0, its licence was changed with version 0.30.0.

Star History

Star History Chart

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

pynguin-0.41.0.tar.gz (477.4 kB view details)

Uploaded Source

Built Distribution

pynguin-0.41.0-py3-none-any.whl (395.3 kB view details)

Uploaded Python 3

File details

Details for the file pynguin-0.41.0.tar.gz.

File metadata

  • Download URL: pynguin-0.41.0.tar.gz
  • Upload date:
  • Size: 477.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pynguin-0.41.0.tar.gz
Algorithm Hash digest
SHA256 dd1222f9631d79fbe6c9360a92cdec60aa479501adc8a112c776e980142e2e4b
MD5 5b0449691c51d2f8b7ca665812805344
BLAKE2b-256 69667cb5044b2b3f4bcc5aef4e9f48b5f8bcbb5d16f586871a8c201c986af6fc

See more details on using hashes here.

Provenance

The following attestation bundles were made for pynguin-0.41.0.tar.gz:

Publisher: publish.yml on se2p/pynguin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pynguin-0.41.0-py3-none-any.whl.

File metadata

  • Download URL: pynguin-0.41.0-py3-none-any.whl
  • Upload date:
  • Size: 395.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pynguin-0.41.0-py3-none-any.whl
Algorithm Hash digest
SHA256 520c4fa733c94066a13a75a2417e77d25a47e536bd9dbed16a67f80a9c5acd1c
MD5 2c0dbf2f505bcc1574d3938ba333b928
BLAKE2b-256 91fae87b21bc9c51f31be5bb447cb980a6241459fca965d487430ae2360989c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for pynguin-0.41.0-py3-none-any.whl:

Publisher: publish.yml on se2p/pynguin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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