معرفی شرکت ها
arithmetic-dice-roller-0.2.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A handy dice roller with extended notation and arithmetic expressions management.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | OS Independent |
| نام فایل | arithmetic-dice-roller-0.2.3 |
| نام | arithmetic-dice-roller |
| نسخه کتابخانه | 0.2.3 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Massimo Pavoni |
| ایمیل نویسنده | maspavoni@gmail.com |
| آدرس صفحه اصلی | https://github.com/massimopavoni/arithmetic-dice-roller |
| آدرس اینترنتی | https://pypi.org/project/arithmetic-dice-roller/ |
| مجوز | - |
# arithmetic-dice-roller
[](https://github.com/massimopavoni/arithmetic-dice-roller/releases)
[](https://pypi.org/project/arithmetic-dice-roller/)
[](https://github.com/massimopavoni/arithmetic-dice-roller/blob/main/LICENSE)
[](https://www.python.org/downloads/release/python-3100/)
[](https://discord.gg/ZA76nJ3RsU)
[](https://ko-fi.com/T6T8BD7A1)
A handy dice roller with extended notation and arithmetic expressions' management.
The package aims to provide an easy-to-use implementation of a dice roller application with multiple operators' options and automatic results calculation.
### Dependencies
- [SymPy](https://www.sympy.org) ([LICENSE](https://github.com/sympy/sympy/blob/master/LICENSE))
### Syntax
Chosen syntax is inspired to the one from the [CritDice mobile app](https://www.critdice.com/) (you can check the [advanced notation](https://www.critdice.com/roll-advanced-dice) for similarities with this package).
The output object once the expression has been evaluated ("rolled") contains:
- the original expression
- the expression without repeated sub-expressions
- the expressions with evaluated dice rolls
- the list of dice rolls (for beautifying purposes)
- the final evaluated result
- the optional label for the whole expression
If the package is being used as a part of another project, you can just import the `Roller` class and use the `roll` function.
A simple console script (`arithmetic-dice-roller`) is also provided, which requires an input with an expression and an optional label for it, separated by a space.
Every expression must not present any spaces, and can contain any number of dice rolls (big numbers and complex calculations may affect execution time), given the following format is respected:
`[dice amount]d[die type][operator]` where **dice number** can be omitted for default 1, **d** is case-insensitive and **dice type** can be any integer, `f` (for fudge die, case-insensitive) or `%` (for percentage, equal to typing in `d100`).
**Operator** can be of three different types, with only the third omitting some results (because or rerolls):
- keeping or dropping a number of dice (`[K|k|X|x][amount]`, any of the four combinations of keep/drop highest/lowest followed by how many needs to be kept or dropped)
- counting successes and failures (`[<=|>=][success threshold]f[<=|>=][failure threshold]`, any of the two comparison operators and a threshold for success/failure, with **f** being case-insensitive and the failure part being optional)
- rerolling until the condition is satisfied (critics or comparison) or once (`[!|R|r][|<=|>=][threshold]`, any of the three operators for rerolling and any of the three comparison operators, putting none means equality)
Repeating sub-expressions is also supported: these are expanded before any other parsing operations, and can be used to repeat rolls (and not multiply the result) writing the same sub-expression multiple times.
The format is `[repetitions]x([sub-expression])`, and the sub-expression (and all the expression in general) must have matching brackets.
The final arithmetic expression without dice notation is evaluated using [SymPy](https://www.sympy.org/en/index.html), so any kind of arithmetic operation is allowed inside expressions, to provide a nice tool for complex rolls.
<br>
_Feel free to suggest and submit modifications to this guide, as any kind of help is always very much appreciated and welcomed._
نیازمندی
| مقدار | نام |
|---|---|
| >=1.11 | sympy |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.10 | Python |
نحوه نصب
نصب پکیج whl arithmetic-dice-roller-0.2.3:
pip install arithmetic-dice-roller-0.2.3.whl
نصب پکیج tar.gz arithmetic-dice-roller-0.2.3:
pip install arithmetic-dice-roller-0.2.3.tar.gz