**Deal** is a Python library for [design by contract][wiki] (DbC) programming.
Project description
Deal -- python library for design by contract (DbC) and checking values, exceptions, and side-effects. Read intro to get started.
Features
- Classic DbC: precondition, postcondition, invariant.
- Tracking exceptions and side-effects.
- Property-based testing.
- Static checker.
- Integration with pytest, flake8, and hypothesis.
- Type annotations support.
- External validators support.
- Contracts for importing modules.
- Can be enabled or disabled on production.
- Colorless: annotate only what you want. Hence, easy integration into an existing project.
- Colorful: syntax highlighting for every piece of code in every command.
- Memory leaks detection. Deal makes sure that a pure function doesn't leave unexpected objects in the memory.
- DRY: test discovery, error messages generation.
- Partial execution: linter executes contracts to statically check possible values.
Deal in 30 seconds
# the result is always non-negative
@deal.post(lambda result: result >= 0)
# the function has no side-effects
@deal.pure
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 lintorflake8to statically check errors. - Run
python3 -m deal testorpytestto generate and run tests. - Just use the function in the project and check errors in runtime.
Read more in the documentation.
Installation
python3 -m pip install --user deal
Contributing
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
README.md. - 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file deal-4.7.0.tar.gz.
File metadata
- Download URL: deal-4.7.0.tar.gz
- Upload date:
- Size: 667.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.25.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
380e8bfc25b75c2c539e07c685024a66736cd5ea19d51d40938dc69eb8179cd6
|
|
| MD5 |
bd1061896d0db20b3e39e4c679fba60b
|
|
| BLAKE2b-256 |
cb33784331a556aac76d9ab65fe7f97eff1a78bbf733bfde0bd5aa8423e62a89
|
File details
Details for the file deal-4.7.0-py3-none-any.whl.
File metadata
- Download URL: deal-4.7.0-py3-none-any.whl
- Upload date:
- Size: 131.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.25.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
403bb44cc3484a569d76c71d7f19cc72fc709274ae3b1b08bc2f200395c8841e
|
|
| MD5 |
03253cd2ee522301dbf90ec2068f5b7d
|
|
| BLAKE2b-256 |
147230b0a94385ab9dd42861c640a7845280edf75ba49f71cc4e89345209449e
|