Copyright and other protections apply. Please see the accompanying LICENSE file for rights and restrictions governing use of this software. All rights not expressly waived or licensed are reserved. If that file is missing or appears to be modified from its original, then please contact the author before viewing or using this software in any capacity.

dyceum (née anydyce) – Application experiments for dyce

Dyceum’s AnyDice language interpreter and interactive playground in action

dyceum is a testing ground for various interactive interfaces to dyce (the dice mechanic modeling library). dyceum was deliberately renamed from anydyce based on community feedback. Currently, it includes:

1. 💥 New! 💥 A fully functioning, (mostly¹) compatible, pure-Python AnyDice language interpreter and interactive playground. Quite a bit of detail is provided on how it was built, how it differs from the original, and all the pitfalls and nuances discovered along the way.
   • Try it! 👉 👈
2. A JupyterLite graphing widget using Matplotlib and Jupyter Widgets for visualizing histograms and pools:
   • Try it! 👉 👈

!!! danger "JupyterLite may not save your work!"

JupyterLite attempts to make use of your browser’s local storage for saving notebook changes.
Browser environments vary, including how long local storage is persisted.
Further, Binder loses all state once its instances shut down after a period of inactivity.
Be careful to download any notebooks you wish to keep.

If you find anything lacking in any way, please don’t hesitate to bring it to my attention.

Running locally

dyceum is also available as a PyPI package and as source. To try it on your own hardware, use the quickstart-local.sh script to create a local virtual environment and bootstrap a local copy.

% git clone https://github.com/posita/dyceum.git dyceum && ./dyceum/quickstart-local.sh
...
INFO    -  Documentation built in 4.84 seconds
INFO    -  [20:39:05] Serving on http://127.0.0.1:8000/

Once loaded, try the following:

• Introduction Jupyter Lite notebook - http://127.0.0.1:8000/jupyter/lab/?path=dyceum_intro.ipynb
• AnyDice-compatible playground - http://127.0.0.1:8000/playground/

Requirements

dyceum requires a relatively modern version of Python:

• CPython (3.11+)
• PyPy (CPython 3.11+ compatible)

It has the following runtime dependencies:

• dyce for dice mechanic modeling
• Lark for the AnyDice interpreter
• Matplotlib (optional) for visualizing histograms and pools
• Jupyter Widgets (optional) for interactivity in Jupyter

dyceum is proudly 100% Bear-ified™! 👌🏾🐻

License

dyceum is licensed under the MIT License. See the included LICENSE file for details. Source code is available on GitHub.