{ "info": { "author": "Bernardo Mart\u00ednez Garrido", "author_email": "programming@bernardomg.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Games/Entertainment :: Role-Playing" ], "description": "==============================\nDice Notation Tools for Python\n==============================\n\nThis notation is widely used on tabletop games, such as wargames or RPGs, and\nwas created on the late 70s for Dungeons & Dragons, as a way to allow generating\nrandom values in specific distributions.\n\nWith the pass of years it has evolved, and while it never underwent a formal\nstandarization process a core set of rules is kept among all the variations,\nmostly representing dice in a format such as '1d6', and the use of algebra\noperations like addition and subtraction.\n\nThis project aims to give support to the dice notation, allowing parsing and\noperating with it on any Python application.\n\n.. image:: https://badge.fury.io/py/dice-notation.svg\n :target: https://pypi.python.org/pypi/dice-notation\n :alt: Dice Notation Tools for Python Pypi package page\n\n.. image:: https://img.shields.io/badge/docs-release-blue.svg\n :target: http://docs.bernardomg.com/dice-notation-python\n :alt: Dice Notation Tools for Python latest documentation\n.. image:: https://img.shields.io/badge/docs-develop-blue.svg\n :target: http://docs.bernardomg.com/development/dice-notation-python\n :alt: Dice Notation Tools for Python development documentation\n\nFeatures\n--------\n\n- Ply-based parser to generate objects for dice notation\n- Easy-to-use objects to handle the notation, just call the 'roll' method\n- Classes to support plain dice\n\nDocumentation\n-------------\n\nDocumentation sources are included with the project, and used to generate the\ndocumentation sites:\n\n- The `latest docs`_ are always generated for the latest release, kept in the 'master' branch\n- The `development docs`_ are generated from the latest code in the 'develop' branch\n\nYou can also create the documentation from the source files, kept in the 'docs'\nfolder, with the help of `Sphinx`_. For this use the makefile, or the make.bat\nfile, contained on that folder.\n\nPrerequisites\n~~~~~~~~~~~~~\n\nThe project has been tested in the following versions of the interpreter:\n\n- Python 3.4\n- Python 3.5\n- Python 3.6\n\nAll other dependencies are indicated on the requirements.txt file.\n\nThese can be installed with:\n\n``$ pip install --upgrade -r requirements.txt``\n\nInstalling\n~~~~~~~~~~\n\nThe project is offered as a `Pypi package`_, and using pip is the preferred way\nto install it. For this use the following command;\n\n``$ pip install dice-notation``\n\nIf needed, manual installation is possible:\n\n``$ python setup.py install``\n\nUsage\n-----\n\nThe application has been coded in Python, and does not require any particular\nframework.\n\nTo use it just import the parser::\n\n from dice_notation.parser import DiceParser\n\nAnd then use it to parse a dice notation expression::\n\n parser = DiceParser()\n dice = parser.parse('1d6+2')\n\nThe result can be accessed just by calling the 'roll' method as many times as\nneeded, which will generate a new random value each time it is called::\n\n print(dice.roll())\n print(dice.roll())\n\nTesting\n-------\n\nThe tests included with the project can be run with:\n\n``$ python setup.py test``\n\nThis will delegate the execution to tox.\n\nIt is possible to run just one of the test profiles, in this case the py36 profile:\n\n``$ python setup.py test -p \"py36\"``\n\nCollaborate\n-----------\n\nAny kind of help with the project will be well received, and there are two main ways to give such help:\n\n- Reporting errors and asking for extensions through the issues management\n- or forking the repository and extending the project\n\nIssues management\n~~~~~~~~~~~~~~~~~\n\nIssues are managed at the GitHub `project issues tracker`_, where any Github\nuser may report bugs or ask for new features.\n\nGetting the code\n~~~~~~~~~~~~~~~~\n\nIf you wish to fork or modify the code, visit the `GitHub project page`_, where\nthe latest versions are always kept. Check the 'master' branch for the latest\nrelease, and the 'develop' for the current, and stable, development version.\n\nLicense\n-------\n\nThe project has been released under the `MIT License`_.\n\n.. _GitHub project page: https://github.com/Bernardo-MG/dice-notation-python\n.. _latest docs: http://docs.bernardomg.com/dice-notation-python\n.. _development docs: http://docs.bernardomg.com/development/dice-notation-python\n.. _Pypi package: https://pypi.python.org/pypi/dice-notation\n.. _MIT License: http://www.opensource.org/licenses/mit-license.php\n.. _project issues tracker: https://github.com/Bernardo-MG/dice-notation-python/issues\n.. _Sphinx: http://sphinx-doc.org/", "description_content_type": null, "docs_url": null, "download_url": "https://pypi.python.org/pypi/dice-notation", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Bernardo-MG/dice-notation-python", "keywords": "dice,dice notation,rpg,parser", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "dice-notation", "package_url": "https://pypi.org/project/dice-notation/", "platform": "any", "project_url": "https://pypi.org/project/dice-notation/", "project_urls": { "Download": "https://pypi.python.org/pypi/dice-notation", "Homepage": "https://github.com/Bernardo-MG/dice-notation-python" }, "release_url": "https://pypi.org/project/dice-notation/1.0.6/", "requires_dist": null, "requires_python": "", "summary": "Dice notation tools", "version": "1.0.6" }, "last_serial": 3478506, "releases": { "0.1.0": [], "1.0.0": [ { "comment_text": "", "digests": { "md5": "a435507bb238282b69763d3006e84987", "sha256": "dc179dedeec111110656a8cd540d068e160a55068e5dd0f3af4909c23282fb6a" }, "downloads": -1, "filename": "dice-notation-1.0.0.tar.gz", "has_sig": false, "md5_digest": "a435507bb238282b69763d3006e84987", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 47487, "upload_time": "2016-10-23T13:55:29", "url": "https://files.pythonhosted.org/packages/6e/ec/c811e20e791bbbcebe4a793b0a6dfbb7807de65534db323b7e0334e5cc36/dice-notation-1.0.0.tar.gz" } ], "1.0.3": [ { "comment_text": "", "digests": { "md5": "6f4c5a880af7bc495096991070811327", "sha256": "60e8f91948c2ad417a890f4bff14cf4338f51fb391b6bc6da5bda5f1556e3ef2" }, "downloads": -1, "filename": "dice-notation-1.0.3.tar.gz", "has_sig": false, "md5_digest": "6f4c5a880af7bc495096991070811327", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 46814, "upload_time": "2018-01-02T20:44:03", "url": "https://files.pythonhosted.org/packages/b0/70/7b8f15d774101bcf0d80158a8e30cbb9be9959b95488fb2828a75796dd2d/dice-notation-1.0.3.tar.gz" } ], "1.0.4": [ { "comment_text": "", "digests": { "md5": "a8025649659f0fe7eb7d7d891d42a5f6", "sha256": "366c31ee13cbf5a49ce71fdeafcec2589aa340a44d982fc81990782eb2dbaabe" }, "downloads": -1, "filename": "dice-notation-1.0.4.tar.gz", "has_sig": false, "md5_digest": "a8025649659f0fe7eb7d7d891d42a5f6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45259, "upload_time": "2018-01-09T19:56:24", "url": "https://files.pythonhosted.org/packages/6d/3d/3f84bae0ada7e3b5ed7ca6ea989631824eb310283f9fa22f6f4772ad708a/dice-notation-1.0.4.tar.gz" } ], "1.0.5": [ { "comment_text": "", "digests": { "md5": "c096db0017f7c925fdddd42ed1aa803b", "sha256": "b4e15877985675d5334de4f4354effeb888c683557bb9305bbef6cb446405810" }, "downloads": -1, "filename": "dice-notation-1.0.5.tar.gz", "has_sig": false, "md5_digest": "c096db0017f7c925fdddd42ed1aa803b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45297, "upload_time": "2018-01-09T19:58:25", "url": "https://files.pythonhosted.org/packages/5d/4f/e788d4524ec254ba713bfab44b2e046474304adc3fdb3839f4a64d690651/dice-notation-1.0.5.tar.gz" } ], "1.0.6": [ { "comment_text": "", "digests": { "md5": "b9a1f066c9eb8c2cc43fec6b79269d44", "sha256": "6643e69ff560eb7311ba5a88b81f9e81886b3a84e5b04da02e140b11eb78290c" }, "downloads": -1, "filename": "dice_notation-1.0.6-py3.6.egg", "has_sig": false, "md5_digest": "b9a1f066c9eb8c2cc43fec6b79269d44", "packagetype": "bdist_egg", "python_version": "3.6", "requires_python": null, "size": 43874, "upload_time": "2018-01-10T18:50:35", "url": "https://files.pythonhosted.org/packages/c1/3a/c2cb6eef0f607976074fa045dda482190a0b5e1183b446f5438e500ae16f/dice_notation-1.0.6-py3.6.egg" }, { "comment_text": "", "digests": { "md5": "13d28e6ce6b352a6cc65657abc31e999", "sha256": "5cc683f9d0c2c86d0d85a213e565a5bbe257cf90f39cbb77c45074d958ebfe8e" }, "downloads": -1, "filename": "dice_notation-1.0.6-py3-none-any.whl", "has_sig": false, "md5_digest": "13d28e6ce6b352a6cc65657abc31e999", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22039, "upload_time": "2018-01-10T18:50:33", "url": "https://files.pythonhosted.org/packages/14/21/e20106678d8172234b093c5bed2d64a81936690f3417d34cb7d1127795c7/dice_notation-1.0.6-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "137109b98f90e708764c0ba6e7d48f40", "sha256": "394f5d1b5cc6d8636bc91507b769e8c2e16e3d7f5a0705b3b0e1bfe0f966feb4" }, "downloads": -1, "filename": "dice-notation-1.0.6.tar.gz", "has_sig": false, "md5_digest": "137109b98f90e708764c0ba6e7d48f40", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45747, "upload_time": "2018-01-09T21:08:26", "url": "https://files.pythonhosted.org/packages/b5/22/c7e55c2087913fe2819a489afed798c2d828fa602b48fb05f7ff896d8609/dice-notation-1.0.6.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "b9a1f066c9eb8c2cc43fec6b79269d44", "sha256": "6643e69ff560eb7311ba5a88b81f9e81886b3a84e5b04da02e140b11eb78290c" }, "downloads": -1, "filename": "dice_notation-1.0.6-py3.6.egg", "has_sig": false, "md5_digest": "b9a1f066c9eb8c2cc43fec6b79269d44", "packagetype": "bdist_egg", "python_version": "3.6", "requires_python": null, "size": 43874, "upload_time": "2018-01-10T18:50:35", "url": "https://files.pythonhosted.org/packages/c1/3a/c2cb6eef0f607976074fa045dda482190a0b5e1183b446f5438e500ae16f/dice_notation-1.0.6-py3.6.egg" }, { "comment_text": "", "digests": { "md5": "13d28e6ce6b352a6cc65657abc31e999", "sha256": "5cc683f9d0c2c86d0d85a213e565a5bbe257cf90f39cbb77c45074d958ebfe8e" }, "downloads": -1, "filename": "dice_notation-1.0.6-py3-none-any.whl", "has_sig": false, "md5_digest": "13d28e6ce6b352a6cc65657abc31e999", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22039, "upload_time": "2018-01-10T18:50:33", "url": "https://files.pythonhosted.org/packages/14/21/e20106678d8172234b093c5bed2d64a81936690f3417d34cb7d1127795c7/dice_notation-1.0.6-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "137109b98f90e708764c0ba6e7d48f40", "sha256": "394f5d1b5cc6d8636bc91507b769e8c2e16e3d7f5a0705b3b0e1bfe0f966feb4" }, "downloads": -1, "filename": "dice-notation-1.0.6.tar.gz", "has_sig": false, "md5_digest": "137109b98f90e708764c0ba6e7d48f40", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45747, "upload_time": "2018-01-09T21:08:26", "url": "https://files.pythonhosted.org/packages/b5/22/c7e55c2087913fe2819a489afed798c2d828fa602b48fb05f7ff896d8609/dice-notation-1.0.6.tar.gz" } ] }