a cli mental math toy, made with python
"manturón" is spanish for "binturong!" 🐻🐱

requirements

python 3.14
typer 0.27.0
python-stopwatch 1.1.11

to install python, use brew install python@3.14, or however you get your cli tools
typer and pythton-stopwatch can be installed with pip

installation

start a python virtual environment

python -m venv venv

install requirements into python venv

source venv/bin/activate
pip install -r requirements.txt

run program

python main.py --help

playground 🛝

roadmaps 🤢👎🏿 playgrounds 😁👍🏿,

done so far

✅ correct / total after finishing a set of problems
✅ ability to set a range of numbers using an optional argument
✅ stopwatch --option
✅ primes only
✅ addition mode
✅ average time

still exploring

set and store a user-defined num_of_problems
user-defined config file
find out how to put it on homebrew
colors
high-scores database
time-trial mode
previous test history
tens only (might have to remove multiples_of to enable)
zen mode (go until you type "stop")
disappearing numbers mode
hints ("it's near ___!" or "it ends with ___!")
gamification (score-attack that increases with problems solved; constantly depleting time remaining; obtain more time from doing problems or something)
master mode (end test if you get one wrong)