{ "info": { "author": "Gram", "author_email": "master_fess@mail.ru", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Plugins", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python", "Topic :: Software Development", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Software Development :: Quality Assurance" ], "description": "\n\n.. image:: https://raw.githubusercontent.com/orsinium/deal/master/logo.png\n :target: https://raw.githubusercontent.com/orsinium/deal/master/logo.png\n :alt: Deal\n\n======================================================================================================================================================================\n\n\n.. image:: https://travis-ci.org/orsinium/deal.svg?branch=master\n :target: https://travis-ci.org/orsinium/deal\n :alt: Build Status\n \n.. image:: https://coveralls.io/repos/github/orsinium/deal/badge.svg\n :target: https://coveralls.io/github/orsinium/deal\n :alt: Coverage Status\n \n.. image:: https://img.shields.io/pypi/v/deal.svg\n :target: https://pypi.python.org/pypi/deal\n :alt: PyPI version\n \n.. image:: https://img.shields.io/pypi/status/deal.svg\n :target: https://pypi.python.org/pypi/deal\n :alt: Development Status\n \n.. image:: https://img.shields.io/github/languages/code-size/orsinium/deal.svg\n :target: https://github.com/orsinium/deal\n :alt: Code size\n\n\n**Deal** -- python library for `design by contract `_ (DbC) programming.\n\nThat'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.\n\nFeatures\n--------\n\n\n* Functional declaration.\n* Custom exceptions.\n* Raising exceptions from contract.\n* Django Forms styled validators.\n* Attribute setting invariant validation.\n* Dynamically assigned attributes and methods invariant validation.\n* Decorators to control available resources: forbid input/output, network operations, raising exceptions\n\nAvailable decorators\n--------------------\n\nCLassic DbC:\n\n\n* ``@deal.pre`` -- validate function arguments (pre-condition)\n* ``@deal.post`` -- validate function return value (post-condition)\n* ``@deal.inv`` -- validate object internal state (invariant)\n\nTake more control:\n\n\n* ``@deal.offline`` -- forbid network requests\n* ``@deal.raises`` -- allow only list of exceptions\n* ``@deal.safe`` -- forbid exceptions\n* ``@deal.silent`` -- forbid output into stderr/stdout.\n\nInstallation\n------------\n\n.. code-block:: bash\n\n pip3 install --user deal\n\nQuick Start\n-----------\n\n.. code-block:: python\n\n import re\n\n import attr\n import deal\n\n REX_LOGIN = re.compile(r'^[a-zA-Z][a-zA-Z0-9]+$')\n\n class PostAlreadyLiked(Exception):\n pass\n\n @deal.inv(lambda post: post.visits >= 0)\n class Post:\n visits: int = attr.ib(default=0)\n likes: set = attr.ib(factory=set)\n\n @deal.pre(lambda user: REX_LOGIN.match(user), message='invalid username format')\n @deal.raises(PostAlreadyLiked)\n @deal.chain(deal.offline, deal.silent)\n def like(self, user: str) -> None:\n if user in self.likes:\n raise PostAlreadyLiked\n self.likes.add(user)\n\n @deal.post(lambda result: 'visits' in result)\n @deal.post(lambda result: 'likes' in result)\n @deal.post(lambda result: result['likes'] > 0)\n @deal.pure\n def get_state(self):\n return dict(visits=self.visits, likes=len(self.likes))\n\nNow, Deal controls conditions and states of the object at runtime:\n\n\n#. ``@deal.inv`` controls that visits count in post always non-negative.\n#. ``@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.\n#. ``@deal.raises`` says that only possible exception that can be raised is ``PostAlreadyLiked``.\n#. ``@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.\n#. ``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.\n\nIf code violates some condition, sub-exception of ``deal.ContractError`` will be raised:\n\n.. code-block:: python\n\n p = Post()\n p.visits = -1\n # InvContractError:\n\nDive deeper on `deal.readthedocs.io `_.\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "", "keywords": "deal,contracts,pre,post,invariant,decorators,validation,pythonic,functional", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "deal", "package_url": "https://pypi.org/project/deal/", "platform": "", "project_url": "https://pypi.org/project/deal/", "project_urls": { "Repository": "https://github.com/orsinium/deal" }, "release_url": "https://pypi.org/project/deal/3.1.0/", "requires_dist": [ "coverage; extra == \"dev\" or extra == \"tests\"", "hypothesis", "m2r; extra == \"dev\" or extra == \"docs\"", "marshmallow; extra == \"dev\" or extra == \"tests\"", "pytest; extra == \"dev\" or extra == \"tests\"", "recommonmark; extra == \"dev\" or extra == \"docs\"", "sphinx; extra == \"dev\" or extra == \"docs\"", "sphinx-rtd-theme; extra == \"dev\" or extra == \"docs\"", "typeguard", "urllib3; extra == \"dev\" or extra == \"docs\" or extra == \"tests\"", "vaa>=0.1.4; extra == \"dev\" or extra == \"tests\"" ], "requires_python": ">=3.5", "summary": "Programming by contract", "version": "3.1.0" }, "last_serial": 5929550, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "f75afc85f080fdc7d25c60f01db498d1", "sha256": "d9140d775980fbf2c4753569e4fa3825d8b144d61ff83bb6cb6f79c9142ea8ba" }, "downloads": -1, "filename": "deal-1.0.0.tar.gz", "has_sig": false, "md5_digest": "f75afc85f080fdc7d25c60f01db498d1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6528, "upload_time": "2018-01-27T08:05:04", "url": "https://files.pythonhosted.org/packages/d2/9c/b70e4c4d23cdb76067bc0dab6f56c4088bab52c92e967a1f142e925ad10e/deal-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "62d858af0f47a4fb81b3de23be54fef1", "sha256": "716d01a30e45484b5b6e0e470c640afbe4aa6d97480d9646d84757aa9c2087da" }, "downloads": -1, "filename": "deal-1.1.0.tar.gz", "has_sig": false, "md5_digest": "62d858af0f47a4fb81b3de23be54fef1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9166, "upload_time": "2018-02-04T05:14:19", "url": "https://files.pythonhosted.org/packages/44/b9/56c2ae13b55a7f5358aa3cf8fbdd12f4895ecb02ce7eb05bdd0f74529a85/deal-1.1.0.tar.gz" } ], "1.2.0": [ { "comment_text": "", "digests": { "md5": "69bf3dc93bcd8538f3b6f3e4bb9ed12b", "sha256": "0c31ff1aac7482c69b48a201c51a5e8fbe22e10869528b78722c44c181f39bec" }, "downloads": -1, "filename": "deal-1.2.0.tar.gz", "has_sig": false, "md5_digest": "69bf3dc93bcd8538f3b6f3e4bb9ed12b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8402, "upload_time": "2018-03-22T09:44:17", "url": "https://files.pythonhosted.org/packages/3c/d8/bafe4208e7ee21ff261df8225aa6c388a1b77c324796a453a2ceeb02e0ea/deal-1.2.0.tar.gz" } ], "2.0.0": [ { "comment_text": "", "digests": { "md5": "4976266987b0dbbb6686053233dcc251", "sha256": "2c01863427764fc82ebc348be01f29d9bd5489add2e3c808ca23354ed5b06a0b" }, "downloads": -1, "filename": "deal-2.0.0.tar.gz", "has_sig": false, "md5_digest": "4976266987b0dbbb6686053233dcc251", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12667, "upload_time": "2018-03-25T05:39:44", "url": "https://files.pythonhosted.org/packages/cd/d9/38ae08084240dba4cf0bba3a6e3d3e541199bfda70473f2deebd3929861e/deal-2.0.0.tar.gz" } ], "2.1.0": [ { "comment_text": "", "digests": { "md5": "94ea524f3046092ffa535bd86d01b1e4", "sha256": "a5277272df02756ad44d61ebaf7c9c98a9c13341945ad57485c4e0c9359d1cc4" }, "downloads": -1, "filename": "deal-2.1.0.tar.gz", "has_sig": false, "md5_digest": "94ea524f3046092ffa535bd86d01b1e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10733, "upload_time": "2018-06-10T17:59:58", "url": "https://files.pythonhosted.org/packages/47/ad/83bb43b27ee2714a91e82b9fbf6463f34d562b1f45f6d3c47adbf4feb631/deal-2.1.0.tar.gz" } ], "2.2.0": [ { "comment_text": "", "digests": { "md5": "92cf58b4497ccbf5eb616df7b758d38d", "sha256": "1534c5dae16746a0dfff9ea84d1edebafa8c3a7710198dc3fea6dd3fecae08cf" }, "downloads": -1, "filename": "deal-2.2.0.tar.gz", "has_sig": false, "md5_digest": "92cf58b4497ccbf5eb616df7b758d38d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10957, "upload_time": "2018-09-07T08:52:14", "url": "https://files.pythonhosted.org/packages/86/21/bab7cb82af92e7be9f2e1f2cb02210f9369a37d38832df978a997b323363/deal-2.2.0.tar.gz" } ], "2.2.1": [ { "comment_text": "", "digests": { "md5": "8cac32530a0d71af78f293dc5298c985", "sha256": "7ccdb2024c1b24f3e8c362d082b0a771f559f70562ac5f97c22711fadcd3d02c" }, "downloads": -1, "filename": "deal-2.2.1.tar.gz", "has_sig": false, "md5_digest": "8cac32530a0d71af78f293dc5298c985", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11168, "upload_time": "2018-09-07T08:57:55", "url": "https://files.pythonhosted.org/packages/1d/3d/7d32d8dc2e490a0ef56d6e68373a7836ab0d7ef0a037a9484a786968ac7c/deal-2.2.1.tar.gz" } ], "2.3.0": [ { "comment_text": "", "digests": { "md5": "fc35169542aea49aac507e23ab68103f", "sha256": "e5c232b12100e9d87dd27318d8466b76d6004d9f5bf4a28b2271a69bb2284e1d" }, "downloads": -1, "filename": "deal-2.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "fc35169542aea49aac507e23ab68103f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 9723, "upload_time": "2019-07-05T16:12:36", "url": "https://files.pythonhosted.org/packages/11/a6/e785d52ab0ba2216a0eaa225d0afb65cf27fedc5fdef4f727e437258ffa4/deal-2.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "86b90d9ddd953af47299ad6d75791278", "sha256": "8ca9c8bcd7a5b93283d0750095849898b5ce5917cd967bb0e1d75f5caf542109" }, "downloads": -1, "filename": "deal-2.3.0.tar.gz", "has_sig": false, "md5_digest": "86b90d9ddd953af47299ad6d75791278", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 8748, "upload_time": "2019-07-05T16:12:37", "url": "https://files.pythonhosted.org/packages/18/06/da65205cf265a16224d4597f35fa2b515e8e646c49efc1885796a57a5231/deal-2.3.0.tar.gz" } ], "2.4.0": [ { "comment_text": "", "digests": { "md5": "3ed260d179d93aaf8445141dd8509c0a", "sha256": "f0ffee7b5fd9c5c11032425b3de5a348715355651b3009ffa460beadce517535" }, "downloads": -1, "filename": "deal-2.4.0-py3-none-any.whl", "has_sig": false, "md5_digest": "3ed260d179d93aaf8445141dd8509c0a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 7998, "upload_time": "2019-07-06T08:13:43", "url": "https://files.pythonhosted.org/packages/d7/76/41d0978b115fab9c45e20aebf5582566e2d2d1473ce664503df4a95a1aa0/deal-2.4.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "95ddd16d48ea5ec3d8fd69a42af4b4fb", "sha256": "e1f454b97083b4b7fd0f2ef982885ec45840edf91bb15a4d4abb5df755480280" }, "downloads": -1, "filename": "deal-2.4.0.tar.gz", "has_sig": false, "md5_digest": "95ddd16d48ea5ec3d8fd69a42af4b4fb", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 6968, "upload_time": "2019-07-06T08:13:45", "url": "https://files.pythonhosted.org/packages/bc/1d/ccf7d2d89ca682c4ef4a77c97dc3053af232b8aa5ff9b2283add71921bb2/deal-2.4.0.tar.gz" } ], "3.0.0": [ { "comment_text": "", "digests": { "md5": "ff582469eb2265ba7f73d62bc0052e33", "sha256": "a7071818fde1984c5a56da2879ea3c0971f06c46dd4b9a366308499c82d7b67f" }, "downloads": -1, "filename": "deal-3.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "ff582469eb2265ba7f73d62bc0052e33", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 8248, "upload_time": "2019-10-02T13:44:08", "url": "https://files.pythonhosted.org/packages/9f/91/a0595e9529c5f8df230066847972a9a5cccad8fc70dfdf84168adc1c286b/deal-3.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "70f8cf36ee069e2c2037e3440fb1fbfc", "sha256": "41d0f86297534485dbabf7956630e7ea73dba0dc5b2e9220dced0a248eb66c7a" }, "downloads": -1, "filename": "deal-3.0.0.tar.gz", "has_sig": false, "md5_digest": "70f8cf36ee069e2c2037e3440fb1fbfc", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 7311, "upload_time": "2019-10-02T13:44:11", "url": "https://files.pythonhosted.org/packages/f4/9b/e0690a6997b953f874691f72c25965a02e0129604bec6cf755c27a4ef1c8/deal-3.0.0.tar.gz" } ], "3.1.0": [ { "comment_text": "", "digests": { "md5": "f9a99f342e02b36e3147f2ce68c5d03d", "sha256": "15b9809071bea6f055fea27dbf0be942d7cf1f57dec8991f8047767adf9e2abe" }, "downloads": -1, "filename": "deal-3.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "f9a99f342e02b36e3147f2ce68c5d03d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 9787, "upload_time": "2019-10-04T17:57:28", "url": "https://files.pythonhosted.org/packages/1d/7f/db4b8bde9f524e1825046518f24752ea90242cbef24bc85f06daefc063fd/deal-3.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "036244bd959710fa6cead6e1ba372bd5", "sha256": "2b782a63c287fbb67e4c4e8c5116e2bbd1ce1f9a765c83c632d14c34e2a3e1a8" }, "downloads": -1, "filename": "deal-3.1.0.tar.gz", "has_sig": false, "md5_digest": "036244bd959710fa6cead6e1ba372bd5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 8779, "upload_time": "2019-10-04T17:57:30", "url": "https://files.pythonhosted.org/packages/40/e7/be72ed30fee361c27e793adadb39a4d2616878c95dd59b1b627c193d99de/deal-3.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f9a99f342e02b36e3147f2ce68c5d03d", "sha256": "15b9809071bea6f055fea27dbf0be942d7cf1f57dec8991f8047767adf9e2abe" }, "downloads": -1, "filename": "deal-3.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "f9a99f342e02b36e3147f2ce68c5d03d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 9787, "upload_time": "2019-10-04T17:57:28", "url": "https://files.pythonhosted.org/packages/1d/7f/db4b8bde9f524e1825046518f24752ea90242cbef24bc85f06daefc063fd/deal-3.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "036244bd959710fa6cead6e1ba372bd5", "sha256": "2b782a63c287fbb67e4c4e8c5116e2bbd1ce1f9a765c83c632d14c34e2a3e1a8" }, "downloads": -1, "filename": "deal-3.1.0.tar.gz", "has_sig": false, "md5_digest": "036244bd959710fa6cead6e1ba372bd5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 8779, "upload_time": "2019-10-04T17:57:30", "url": "https://files.pythonhosted.org/packages/40/e7/be72ed30fee361c27e793adadb39a4d2616878c95dd59b1b627c193d99de/deal-3.1.0.tar.gz" } ] }