Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

**Deal** is a Python library for [design by contract][wiki] (DbC) programming.

Project description


Build Status PyPI version Development Status

Deal -- python library for design by contract (DbC) and checking values, exceptions, and side-effects. Read intro to get started.


Deal in 30 seconds

# the result is always non-negative result: result >= 0)
# the function has no side-effects
def count(items: List[str], item: str) -> int:
    return items.count(item)

# generate test function
test_count = deal.cases(count)

Now we can:

  • Run python3 -m deal lint or flake8 to statically check errors.
  • Run python3 -m deal test or pytest to generate and run tests.
  • Just use the function in the project and check errors in runtime.

Read more in the documentation.


python3 -m pip install --user deal


Contributions are welcome! A few ideas what you can contribute:

  • Add new checks for the linter.
  • Improve documentation.
  • Add more tests.
  • Improve performance.
  • Found a bug? Fix it!
  • Made an article about deal? Great! Let's add it into the
  • Don't have time to code? No worries! Just tell your friends and subscribers about the project. More users -> more contributors -> more cool features.

Thank you :heart:

Project details

Download files

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

Files for deal, version 4.6.0
Filename, size File type Python version Upload date Hashes
Filename, size deal-4.6.0-py3-none-any.whl (130.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size deal-4.6.0.tar.gz (89.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page