Programming by contract
Project description
Deal – python library for design by contract (DbC) programming.
That’s nice assert statements in decorators style to validate function input, output, available operations and object state. Goal is make testing much easier and detect errors in your code that occasionally was missed in tests.
Features
Generators and async coroutines support.
Specify allowed exceptions for function
Invariant for all actions with class instances.
Decorators to control available resources: forbid output, network operations, raising exceptions.
You can disable contracts on production.
Available decorators
CLassic DbC:
``@deal.pre` <https://deal.readthedocs.io/decorators/pre.html>`_ – validate function arguments (pre-condition)
``@deal.post` <https://deal.readthedocs.io/decorators/post.html>`_ – validate function return value (post-condition)
``@deal.ensure` <https://deal.readthedocs.io/decorators/ensure.html>`_ – post-condition that accepts not only result, but also function arguments.
``@deal.inv` <https://deal.readthedocs.io/decorators/inv.html>`_ – validate object internal state (invariant).
Take more control:
``@deal.module_load` <https://deal.readthedocs.io/decorators/module_load.html>`_ – check contracts at module initialization.
``@deal.offline` <https://deal.readthedocs.io/decorators/offline.html>`_ – forbid network requests
``@deal.raises` <https://deal.readthedocs.io/decorators/raises.html>`_ – allow only list of exceptions
``@deal.reason` <https://deal.readthedocs.io/decorators/reason.html>`_ – check function arguments that caused a given exception.
``@deal.silent` <https://deal.readthedocs.io/decorators/silent.html>`_ – forbid output into stderr/stdout.
Helpers:
``@deal.chain` <https://deal.readthedocs.io/decorators/chain.html>`_ – chain a few contracts in one.
``@deal.pure` <https://deal.readthedocs.io/decorators/pure.html>`_ – alias for safe, silent, and offline.
``@deal.safe` <https://deal.readthedocs.io/decorators/safe.html>`_ – forbid exceptions.
Installation
python3 -m pip install --user dealQuick Start
import re
import attr
import deal
REX_LOGIN = re.compile(r'^[a-zA-Z][a-zA-Z0-9]+$')
class PostAlreadyLiked(Exception):
pass
@deal.inv(lambda post: post.visits >= 0)
class Post:
visits: int = attr.ib(default=0)
likes: set = attr.ib(factory=set)
@deal.pre(lambda user: REX_LOGIN.match(user), message='invalid username format')
@deal.raises(PostAlreadyLiked)
@deal.chain(deal.offline, deal.silent)
def like(self, user: str) -> None:
if user in self.likes:
raise PostAlreadyLiked
self.likes.add(user)
@deal.post(lambda result: 'visits' in result)
@deal.post(lambda result: 'likes' in result)
@deal.post(lambda result: result['likes'] > 0)
@deal.pure
def get_state(self):
return dict(visits=self.visits, likes=len(self.likes))Now, Deal controls conditions and states of the object at runtime:
@deal.inv controls that visits count in post always non-negative.
@deal.pre checks user name format. We assume that it should be validated somewhere before by some nice forms with user-friendly error messages. So, if we have invalid login passed here, it’s definitely developer’s mistake.
@deal.raises says that only possible exception that can be raised is PostAlreadyLiked.
@deal.chain(deal.offline, deal.silent) controls that function has no network requests and has no output in stderr or stdout. So, if we are making unexpected network requests somewhere inside, deal let us know about it.
deal.post checks result format for get_state. So, all external code can be sure that fields likes and visits always represented in the result and likes always positive.
If code violates some condition, sub-exception of deal.ContractError will be raised:
p = Post()
p.visits = -1
# InvContractError:Dive deeper on deal.readthedocs.io.
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
File details
Details for the file deal-3.6.0.tar.gz.
File metadata
- Download URL: deal-3.6.0.tar.gz
- Upload date:
- Size: 18.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.20.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d877350ac62cb3960c80011ab20fb37a44868109a702d11b7714d2cac354cadc |
|
| MD5 | 9f655def0707239eabcf4e7420e2348e |
|
| BLAKE2b-256 | 7140f041034b19d03eba1103eb629b8ea7a65337565f5566835c807f09696863 |
File details
Details for the file deal-3.6.0-py3-none-any.whl.
File metadata
- Download URL: deal-3.6.0-py3-none-any.whl
- Upload date:
- Size: 26.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.20.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4903124a361710b214d2aaaca82a3b2a5168c70f38ba73b28e432b647b2e2354 |
|
| MD5 | c72a89ee06143d84236670abca9fab3b |
|
| BLAKE2b-256 | 5f81e5cc5a7cc3c549cdab1d2d007806cfd09cb7c531d6bfc1c2f3d7134673c2 |
