Skip to main content

python-trr is a terminal app written in Python for typing practice.

Project description

python-trr

Python-trr is an terminal app for typing practice. It is written in Python with one of its standard libraries - Curses, which means no additional packages are required to run this app as long as you have python3 installed in your environment. Python-trr is inspired by ( or a remake of ) emacs-trr on GNU Emacs.

What does it do?

sample video of python-trr

The current version of python-trr ( as in Dec 2021 ) supports the following features:

  • Has a stable graphics interface in a standard 80 x 24 terminal window
  • Highlights correct / incorrect inputs
  • Shows time, error rate, kpm ( keystrokes per minute ) in real-time
  • Stores results and histories in local files
  • Presents recent game results in scatter plot style
  • Provides a settings menu ( accessible with the TAB key ) for user settings

Usage

First, install python-trr with pip.

pip install pythontrr

Then, from the terminal, simply run

python3 -m pythontrr

and start typing!

Configuration

Via settings menu

Press TAB during the game to pause and enter settings mode. There are currently 5 settings and several options for users to choose from. Here are some keys you will find useful:

Up / Down arrow key

Navigate through different settings

Left / Right arrow key

Navigate through different options

TAB

Save changes and let the game resume

ESC

Save your changes beforehand, otherwise your current game status and changes to settings will be lost.

Press ESC to exit the game. After restarting the game, you will find the new settings applied.


Via connfiguration file ( not recommended )

In config.py you can tweak the configuration as you like. Here are some tips:

READ_RESULT_FROM_HISTORY, READ_HISTORY

If set to True, then the program will look for the stored history in your local files. If there is not one, it will be created. If set to False, it erases all existing histories stored in the file and overwrites them.

HISTORY_ENTRIES

Specifies how many entries will be shown in the History block. The maximum is 3.

WORD_COUNT

Specifies how many words ( or in fact keystrokes ) will be shown in the Text block. The maximum is 350.

References

Sample texts are scraped from Project Gutenberg's Website.

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

pythontrr-1.0.1.tar.gz (229.9 kB view details)

Uploaded Source

Built Distribution

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

pythontrr-1.0.1-py3-none-any.whl (244.4 kB view details)

Uploaded Python 3

File details

Details for the file pythontrr-1.0.1.tar.gz.

File metadata

  • Download URL: pythontrr-1.0.1.tar.gz
  • Upload date:
  • Size: 229.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.1

File hashes

Hashes for pythontrr-1.0.1.tar.gz
Algorithm Hash digest
SHA256 01f6a9c45a4a07078a3b0e4434f7f08c370986e3210028b7c4d897931dbe0fdd
MD5 5a893eff5933a1efb1eb2a0e2ce37340
BLAKE2b-256 dee614fd9c5014a7f7c63d9c0363e7d9c8a44e63faf80108a98c37de983f3b87

See more details on using hashes here.

File details

Details for the file pythontrr-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: pythontrr-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 244.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.1

File hashes

Hashes for pythontrr-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 030fb05b4555fad0affc875823f1d228706dad2d6165cc48b9b7a80c81ad8d24
MD5 3e47632cabb29df9a38881507ed5edc7
BLAKE2b-256 fb977adb13dbdedb350a7274b13e2439b77fb9a0587ff871b20d936ea2b98fa5

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