A mental math training app.
Project description
mmath
A mental math training TUI application. Built with Python using the textual library.
Features
- Covers many of the standard mental math challenges, including arithmetic, exponents, fractions, complex numbers, unit conversions, and day of the week questions.
- Supports quizzes with an arbitrary maximum number limit and number of questions.
- Options to set a limit on the time per question and make the question vanish after a specified period.
- Detailed data screen with options to question type, question time, or number of mistakes
Guides
There are many resources available that detail methods to calculate quickly and accurately.
- World Mental Calculation
- Secrets of Mental Math, by Arthur Benjamin and Michael Shermer
Gallery
Usage
Run mmath from the command line to start the application. Press h to view the help screen which details the options.
Installation
1. With uv
mmath can be run with uv with the command
uvx mentalmath
It can be installed with
uv tool install mentalmath
and then run with mmath from the command line.
To build from source with uv, run
git clone https://github.com/kianbroderick/mmath.git
cd mmath
uv pip install -e .
to clone the repository and install the program to a virtual environment.
2. Using pip
Install mmath to your global or virtual environment with
pip install mentalmath
Run the application with mmath.
mmath can be built from source with the following commands:
git clone https://github.com/kianbroderick/mmath.git
cd mmath
Install textual in either the global or virtual evironment with
pip install textual
Run the application with
pip install -e .
mmath
Future improvements
- add a screen to type in memorized digits of pi or e
- more operations
- add score tracking and statistics over multiple sessions
License
mmath is licensed under the terms of the MIT License.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mentalmath-0.1.7.tar.gz.
File metadata
- Download URL: mentalmath-0.1.7.tar.gz
- Upload date:
- Size: 17.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7ccea15d71eee2eeed2957b0b15efff89465f6bbc5d08878fc0ddc2cddf8c6bc
|
|
| MD5 |
2bc151f07ea536f600d29c853f06fd7a
|
|
| BLAKE2b-256 |
7eeca147dce85604e112fb4bff31ee55b195dac9b208ceb5203e586e0c2651c5
|
File details
Details for the file mentalmath-0.1.7-py3-none-any.whl.
File metadata
- Download URL: mentalmath-0.1.7-py3-none-any.whl
- Upload date:
- Size: 29.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1a67302a83658aa19275de035de6129749355757ba15a086a39cd4c3a11cbe1c
|
|
| MD5 |
dd16c558bb57a67671dd2a893551d51c
|
|
| BLAKE2b-256 |
5aa781c1d739568b115ae64f27cda6e1a96c08e7e2667c781d5a7b9f2c0d7245
|