Skip to main content

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.

Gallery

Main Menu Question Screen
End Screen Data Screen

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

mentalmath-0.1.7.tar.gz (17.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mentalmath-0.1.7-py3-none-any.whl (29.6 kB view details)

Uploaded Python 3

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

Hashes for mentalmath-0.1.7.tar.gz
Algorithm Hash digest
SHA256 7ccea15d71eee2eeed2957b0b15efff89465f6bbc5d08878fc0ddc2cddf8c6bc
MD5 2bc151f07ea536f600d29c853f06fd7a
BLAKE2b-256 7eeca147dce85604e112fb4bff31ee55b195dac9b208ceb5203e586e0c2651c5

See more details on using hashes here.

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

Hashes for mentalmath-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 1a67302a83658aa19275de035de6129749355757ba15a086a39cd4c3a11cbe1c
MD5 dd16c558bb57a67671dd2a893551d51c
BLAKE2b-256 5aa781c1d739568b115ae64f27cda6e1a96c08e7e2667c781d5a7b9f2c0d7245

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page