From e3c79867db89febc5bf152c05410931c04bd06c4 Mon Sep 17 00:00:00 2001 From: CoprDistGit Date: Mon, 10 Apr 2023 11:05:35 +0000 Subject: automatic import of python-readchar --- .gitignore | 1 + python-readchar.spec | 481 +++++++++++++++++++++++++++++++++++++++++++++++++++ sources | 1 + 3 files changed, 483 insertions(+) create mode 100644 python-readchar.spec create mode 100644 sources diff --git a/.gitignore b/.gitignore index e69de29..9420c6b 100644 --- a/.gitignore +++ b/.gitignore @@ -0,0 +1 @@ +/readchar-4.0.5.tar.gz diff --git a/python-readchar.spec b/python-readchar.spec new file mode 100644 index 0000000..121cd31 --- /dev/null +++ b/python-readchar.spec @@ -0,0 +1,481 @@ +%global _empty_manifest_terminate_build 0 +Name: python-readchar +Version: 4.0.5 +Release: 1 +Summary: Library to easily read single chars and key strokes +License: MIT +URL: https://github.com/magmax/python-readchar +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/a1/57/439aaa28659e66265518232bf4291ae5568aa01cd9e0e0f6f8fe3b300e9e/readchar-4.0.5.tar.gz +BuildArch: noarch + +Requires: python3-setuptools + +%description +[![GitHub Repository](https://img.shields.io/badge/-GitHub-%230D0D0D?logo=github&labelColor=gray)](https://github.com/magmax/python-readchar) +[![Latest PyPi version](https://img.shields.io/pypi/v/readchar.svg)](https://pypi.python.org/pypi/readchar) +[![supported Python versions](https://img.shields.io/pypi/pyversions/readchar)](https://pypi.python.org/pypi/readchar) +[![Project licence](https://img.shields.io/pypi/l/readchar?color=blue)](LICENCE)
+[![Automated testing results](https://img.shields.io/github/actions/workflow/status/magmax/python-readchar/run-tests.yaml?branch=master)](https://github.com/magmax/python-readchar/actions/workflows/run-tests.yaml?query=branch%3Amaster) +[![Coveralls results](https://coveralls.io/repos/github/magmax/python-readchar/badge.svg?branch=master)](https://coveralls.io/github/magmax/python-readchar?branch=master) +[![Number of PyPi downloads](https://img.shields.io/pypi/dd/readchar.svg)](https://pypi.python.org/pypi/readchar) + +# python-readchar + +Library to easily read single chars and keystrokes. + +Born as a [python-inquirer](https://github.com/magmax/python-inquirer) requirement. + +## Installation + +simply install it via `pip`: + +```bash +pip install readchar +``` + +Or download the source code from [PyPi](https://pypi.python.org/pypi/readchar). + +## Usage + +Simply read a character or keystroke: + +```python +import readchar + +key = readchar.readkey() +``` + +React to different kinds of key-presses: + +```python +from readchar import readkey, key + +while True: + k = readkey() + if k == "a": + # do stuff + if k == key.DOWN: + # do stuff + if k == key.ENTER: + break +``` + +## Documentation + +There are just two methods: + +### `readchar.readchar() -> str` + +Reads one character from `stdin`, returning it as a string with length 1. Waits until a +character is available. + +As only ASCII characters are actually a single character, you usually want to use the +next function, that also handles longer keys. + +### `readchar.readkey() -> str` + +Reads the next keystroke from `stdin`, returning it as a string. Waits until a keystroke +is available. + +A keystroke can be: + +- single characters as returned by `readchar()`. These include: + - character for normal keys: a, Z, 9,... + - special characters like ENTER, BACKSPACE, TAB,... + - combinations with CTRL: CTRL+A,... +- keys that are made up of multiple characters: + - characters for cursors/arrows: 🡩, 🡪, 🡫, + 🡨 + - navigation keys: INSERT, HOME,... + - function keys: F1 to F12 + - combinations with ALT: ALT+A,... + - combinations with CTRL and ALT: + CTRL+ALT+SUPR,... + +> **Note** CTRL+C will not be returned by `readkey()`, but instead +> raise a `KeyboardInterupt`. If you what to handle it yourself, use `readchar()`. + +### `readchar.key` module + +This submodule contains a list of available keys to compare against. The constants are +defined depending on your operating system, so it should be fully portable. If a key is +listed here for your platform, `readkey()` can read it, and you can compare against it. + +### `readchar.config` class + +This static class contains configurations for `readchar`. It holds constants that are +used in other parts of the code as class attributes. You can override/change these to +modify its behaviour. Here is a description of the existing attributes: + +
+
INTERRUPT_KEYS
+
+ +List of keys that will result in `readkey()` raising a `KeyboardInterrupt`.
+*Default:* `[key.CTRL_C]` + +
+
+ +## OS Support + +This library actively supports these operating systems: + +- Linux +- Windows + +Some operating systems are enabled, but not actively tested or supported: + +- macOS +- FreeBSD / OpenBSD + +Theoretically every Unix based system should work, but they will not be actively tested. +It is also required that somebody provides initial test results before the OS is enabled +and added to the list. Feel free to open a PR for that. + +Thank you! + +## How to contribute + +You have an issue problem or found a bug? You have a great new idea or just want to fix +a typo? Great :+1:. We are happy to accept your issue or pull request, but first, please +read our +[contribution guidelines](https://github.com/magmax/python-readchar/blob/master/CONTRIBUTING.md). +They will also tell you how to write code for this repo and how to properly prepare an +issue or a pull request. + +______________________________________________________________________ + +*Copyright (c) 2014-2022 Miguel Ángel García* + + +%package -n python3-readchar +Summary: Library to easily read single chars and key strokes +Provides: python-readchar +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-readchar +[![GitHub Repository](https://img.shields.io/badge/-GitHub-%230D0D0D?logo=github&labelColor=gray)](https://github.com/magmax/python-readchar) +[![Latest PyPi version](https://img.shields.io/pypi/v/readchar.svg)](https://pypi.python.org/pypi/readchar) +[![supported Python versions](https://img.shields.io/pypi/pyversions/readchar)](https://pypi.python.org/pypi/readchar) +[![Project licence](https://img.shields.io/pypi/l/readchar?color=blue)](LICENCE)
+[![Automated testing results](https://img.shields.io/github/actions/workflow/status/magmax/python-readchar/run-tests.yaml?branch=master)](https://github.com/magmax/python-readchar/actions/workflows/run-tests.yaml?query=branch%3Amaster) +[![Coveralls results](https://coveralls.io/repos/github/magmax/python-readchar/badge.svg?branch=master)](https://coveralls.io/github/magmax/python-readchar?branch=master) +[![Number of PyPi downloads](https://img.shields.io/pypi/dd/readchar.svg)](https://pypi.python.org/pypi/readchar) + +# python-readchar + +Library to easily read single chars and keystrokes. + +Born as a [python-inquirer](https://github.com/magmax/python-inquirer) requirement. + +## Installation + +simply install it via `pip`: + +```bash +pip install readchar +``` + +Or download the source code from [PyPi](https://pypi.python.org/pypi/readchar). + +## Usage + +Simply read a character or keystroke: + +```python +import readchar + +key = readchar.readkey() +``` + +React to different kinds of key-presses: + +```python +from readchar import readkey, key + +while True: + k = readkey() + if k == "a": + # do stuff + if k == key.DOWN: + # do stuff + if k == key.ENTER: + break +``` + +## Documentation + +There are just two methods: + +### `readchar.readchar() -> str` + +Reads one character from `stdin`, returning it as a string with length 1. Waits until a +character is available. + +As only ASCII characters are actually a single character, you usually want to use the +next function, that also handles longer keys. + +### `readchar.readkey() -> str` + +Reads the next keystroke from `stdin`, returning it as a string. Waits until a keystroke +is available. + +A keystroke can be: + +- single characters as returned by `readchar()`. These include: + - character for normal keys: a, Z, 9,... + - special characters like ENTER, BACKSPACE, TAB,... + - combinations with CTRL: CTRL+A,... +- keys that are made up of multiple characters: + - characters for cursors/arrows: 🡩, 🡪, 🡫, + 🡨 + - navigation keys: INSERT, HOME,... + - function keys: F1 to F12 + - combinations with ALT: ALT+A,... + - combinations with CTRL and ALT: + CTRL+ALT+SUPR,... + +> **Note** CTRL+C will not be returned by `readkey()`, but instead +> raise a `KeyboardInterupt`. If you what to handle it yourself, use `readchar()`. + +### `readchar.key` module + +This submodule contains a list of available keys to compare against. The constants are +defined depending on your operating system, so it should be fully portable. If a key is +listed here for your platform, `readkey()` can read it, and you can compare against it. + +### `readchar.config` class + +This static class contains configurations for `readchar`. It holds constants that are +used in other parts of the code as class attributes. You can override/change these to +modify its behaviour. Here is a description of the existing attributes: + +
+
INTERRUPT_KEYS
+
+ +List of keys that will result in `readkey()` raising a `KeyboardInterrupt`.
+*Default:* `[key.CTRL_C]` + +
+
+ +## OS Support + +This library actively supports these operating systems: + +- Linux +- Windows + +Some operating systems are enabled, but not actively tested or supported: + +- macOS +- FreeBSD / OpenBSD + +Theoretically every Unix based system should work, but they will not be actively tested. +It is also required that somebody provides initial test results before the OS is enabled +and added to the list. Feel free to open a PR for that. + +Thank you! + +## How to contribute + +You have an issue problem or found a bug? You have a great new idea or just want to fix +a typo? Great :+1:. We are happy to accept your issue or pull request, but first, please +read our +[contribution guidelines](https://github.com/magmax/python-readchar/blob/master/CONTRIBUTING.md). +They will also tell you how to write code for this repo and how to properly prepare an +issue or a pull request. + +______________________________________________________________________ + +*Copyright (c) 2014-2022 Miguel Ángel García* + + +%package help +Summary: Development documents and examples for readchar +Provides: python3-readchar-doc +%description help +[![GitHub Repository](https://img.shields.io/badge/-GitHub-%230D0D0D?logo=github&labelColor=gray)](https://github.com/magmax/python-readchar) +[![Latest PyPi version](https://img.shields.io/pypi/v/readchar.svg)](https://pypi.python.org/pypi/readchar) +[![supported Python versions](https://img.shields.io/pypi/pyversions/readchar)](https://pypi.python.org/pypi/readchar) +[![Project licence](https://img.shields.io/pypi/l/readchar?color=blue)](LICENCE)
+[![Automated testing results](https://img.shields.io/github/actions/workflow/status/magmax/python-readchar/run-tests.yaml?branch=master)](https://github.com/magmax/python-readchar/actions/workflows/run-tests.yaml?query=branch%3Amaster) +[![Coveralls results](https://coveralls.io/repos/github/magmax/python-readchar/badge.svg?branch=master)](https://coveralls.io/github/magmax/python-readchar?branch=master) +[![Number of PyPi downloads](https://img.shields.io/pypi/dd/readchar.svg)](https://pypi.python.org/pypi/readchar) + +# python-readchar + +Library to easily read single chars and keystrokes. + +Born as a [python-inquirer](https://github.com/magmax/python-inquirer) requirement. + +## Installation + +simply install it via `pip`: + +```bash +pip install readchar +``` + +Or download the source code from [PyPi](https://pypi.python.org/pypi/readchar). + +## Usage + +Simply read a character or keystroke: + +```python +import readchar + +key = readchar.readkey() +``` + +React to different kinds of key-presses: + +```python +from readchar import readkey, key + +while True: + k = readkey() + if k == "a": + # do stuff + if k == key.DOWN: + # do stuff + if k == key.ENTER: + break +``` + +## Documentation + +There are just two methods: + +### `readchar.readchar() -> str` + +Reads one character from `stdin`, returning it as a string with length 1. Waits until a +character is available. + +As only ASCII characters are actually a single character, you usually want to use the +next function, that also handles longer keys. + +### `readchar.readkey() -> str` + +Reads the next keystroke from `stdin`, returning it as a string. Waits until a keystroke +is available. + +A keystroke can be: + +- single characters as returned by `readchar()`. These include: + - character for normal keys: a, Z, 9,... + - special characters like ENTER, BACKSPACE, TAB,... + - combinations with CTRL: CTRL+A,... +- keys that are made up of multiple characters: + - characters for cursors/arrows: 🡩, 🡪, 🡫, + 🡨 + - navigation keys: INSERT, HOME,... + - function keys: F1 to F12 + - combinations with ALT: ALT+A,... + - combinations with CTRL and ALT: + CTRL+ALT+SUPR,... + +> **Note** CTRL+C will not be returned by `readkey()`, but instead +> raise a `KeyboardInterupt`. If you what to handle it yourself, use `readchar()`. + +### `readchar.key` module + +This submodule contains a list of available keys to compare against. The constants are +defined depending on your operating system, so it should be fully portable. If a key is +listed here for your platform, `readkey()` can read it, and you can compare against it. + +### `readchar.config` class + +This static class contains configurations for `readchar`. It holds constants that are +used in other parts of the code as class attributes. You can override/change these to +modify its behaviour. Here is a description of the existing attributes: + +
+
INTERRUPT_KEYS
+
+ +List of keys that will result in `readkey()` raising a `KeyboardInterrupt`.
+*Default:* `[key.CTRL_C]` + +
+
+ +## OS Support + +This library actively supports these operating systems: + +- Linux +- Windows + +Some operating systems are enabled, but not actively tested or supported: + +- macOS +- FreeBSD / OpenBSD + +Theoretically every Unix based system should work, but they will not be actively tested. +It is also required that somebody provides initial test results before the OS is enabled +and added to the list. Feel free to open a PR for that. + +Thank you! + +## How to contribute + +You have an issue problem or found a bug? You have a great new idea or just want to fix +a typo? Great :+1:. We are happy to accept your issue or pull request, but first, please +read our +[contribution guidelines](https://github.com/magmax/python-readchar/blob/master/CONTRIBUTING.md). +They will also tell you how to write code for this repo and how to properly prepare an +issue or a pull request. + +______________________________________________________________________ + +*Copyright (c) 2014-2022 Miguel Ángel García* + + +%prep +%autosetup -n readchar-4.0.5 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-readchar -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Mon Apr 10 2023 Python_Bot - 4.0.5-1 +- Package Spec generated diff --git a/sources b/sources new file mode 100644 index 0000000..90b7f02 --- /dev/null +++ b/sources @@ -0,0 +1 @@ +973c1a67bdbb4cd5e206c5b50f4dbde4 readchar-4.0.5.tar.gz -- cgit v1.2.3