Skip to main content

VERSION

DOWNLOADS

TESTS

COVERAGE

Latest PyPI version

Number of PyPI downloads

Travis results

Coveralls results_

Library to easily read single chars and key strokes.

Goal and Philosophy

Born as a python-inquirer requirement.

The idea is to have a portable way to read single characters and key-strokes.

Documentation

Installation

pip install readchar

The readchar library is compatible with python 2.6, 2.7, 3.2 and 3.3.

Usage

Usage example:

import readchar

c = readchar.readchar()
key = readchar.readkey()

API

There are just two methods:

readchar()

Reads the next char from stdin, returning it as a string with length 1.

readkey()

Reads the next key-stroke from stdin, returning it as an string.

A key-stroke can have:

  • 1 character for normal keys: ‘a’, ‘z’, ‘9’…

  • 2 characters for combinations with ALT: ALT+A, …

  • 3 characters for cursors: ->, <-, …

  • 4 characters for combinations with CTRL and ALT: CTRL+ALT+SUPR, …

There is a list of previously captured chars with their names in readchar.key, in order to be used in comparations and so on. This list is not enough tested and it can have mistakes, so use it carefully. Please, report them if found.

SO Support

Sadly, this library has only being probed in GNU/Linux. Please, if you can try it in another SO and find a bug, put an issue or send the pull-request.

Thank you!

License

Copyright (c) 2014 Miguel Ángel García (@magmax9).

Based on previous work on gist getch()-like unbuffered character reading from stdin on both Windows and Unix (Python recipe), started by Danny Yoo.

Licensed under the MIT license.

Metadata

Release files for readchar 0.2-test2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for readchar 0.2-test2
File Size Uploaded Provenance Actions
readchar-0.2-test2.tar.gz 4.4 kB Without provenance Details for readchar-0.2-test2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for readchar 0.2-test2
File Interpreter ABI Platform Actions
readchar-0.2-test2.linux-i686.tar.gz Details for readchar-0.2-test2.linux-i686.tar.gz

Total release size: 10.8 kB

Release files / readchar-0.2-test2.tar.gz

Download URL readchar-0.2-test2.tar.gz
Size 4.4 kB
Tags Source
SHA-256 checksum
How to use checksums
02854486881bded8d2b2a0a06ace70e10d835be673de0ba16382641a403c08f5
BLAKE2b-256 checksum
How to use checksums
3ebe82e77aefbfe556bb5048edf5d099bb08e2feeb0e04a8824cb1133fc064b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / readchar-0.2-test2.linux-i686.tar.gz

Download URL readchar-0.2-test2.linux-i686.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
be21e11f972d4ff1cdedd00b8321f2bf6c70e4ed129cbdb6d6a0578cd861af86
BLAKE2b-256 checksum
How to use checksums
bdf7a8e507600e7c2862de3f3fabdf1ed59089da597ec3b4f0b9b8b6aaa632d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for readchar 0.2-test2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

0.0.1

This release

0.2-test2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page