pyinquirer-revived 1.0.4__tar.gz

pyinquirer_revived-1.0.4/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+## [1.0.4] — 2026-07-22
+
+### Added
+- Python 3.10, 3.11, 3.12 support — full compatibility restored after the `collections.Mapping` removal in Python 3.10 broke the original
+- GitHub Actions CI — tests run on Python 3.8 through 3.12 on every push and pull request
+- Official badge for CI status in README
+- This changelog
+
+### Fixed
+- **Python 3.10+ crash**: Removed `pygments.token.Token` import (deprecated and internally used `collections.Mapping` which was removed in 3.10). Added backward-compatible `Token` stub class.
+- **prompt_toolkit version lock**: Updated dependency bounds from `<3.1.0` to `<4.0.0`, enabling compatibility with all modern prompt_toolkit 3.x releases
+- **`PosixPipeInput` API compat**: Fixed test helpers to work with prompt_toolkit ≥3.0.30 which changed constructor signature
+- **Example cleanup**: Removed deprecated `Token` import from example files
+
+### Changed
+- Version bump: 1.0.3 → 1.0.4
+- Python minimum version: 3.6 → 3.8
+- Removed Python 2.7 classifier (EOL 2020)
+- Development status: Planning → Beta
+- Replaced README.rst with README.md (modern, better rendering on GitHub)
+- Replaced dead `.travis.yml` with GitHub Actions workflow
+
+### Removed
+- `.travis.yml` — Travis CI for open source ended in 2021
+
+## [1.0.3] — 2018-11-22
+- Bugfix release (by original author)
+
+## [1.0.2] — 2018-07-20
+- Minor fixes (by original author)
+
+## [1.0.1] — 2018-06-14
+- Initial PyPI release (by original author)
+
+## [1.0.0] — 2018-06-14
+- First stable release (by original author)

pyinquirer_revived-1.0.4/CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing to PyInquirer
+
+Thanks for wanting to contribute to PyInquirer! This project was revived from abandonment in 2026 and is actively seeking maintainers and contributors.
+
+## Issues
+
+- **Bug reports**: Open an issue with the bug template. Include Python version, OS, and a minimal reproduction.
+- **Feature requests**: Open an issue with the feature template. Describe what you're building and why.
+- **Questions**: Use the Discussions tab.
+
+## Pull Requests
+
+1. **Fork** the repo and create your branch from `master`.
+2. **Install locally**: `pip install -e ".[dev]"`
+3. **Make your changes**. Keep them focused — one feature or fix per PR.
+4. **Add or update tests** for your changes.
+5. **Run tests**: `pytest tests/`
+6. **Commit** with a clear message following conventional commits:
+   - `fix:` — bug fix
+   - `feat:` — new feature
+   - `docs:` — documentation
+   - `test:` — testing
+   - `refactor:` — code change without feature/bug
+7. **Push** and open a PR.
+
+## Code Style
+
+- Follow PEP 8
+- Use type hints where practical
+- Keep line length under 100 characters
+- Write docstrings for public APIs
+
+## Testing
+
+Tests use pytest with pty-based terminal simulation. Run locally:
+
+```bash
+pip install -e ".[dev]"
+pytest -sv tests/
+```
+
+Some tests require an interactive terminal and may be skipped on CI.
+
+## Release Process
+
+1. Bump version in `PyInquirer/__init__.py` and `setup.py`
+2. Update `CHANGELOG.md`
+3. Create a signed tag: `git tag -s v1.0.5 -m "v1.0.5"`
+4. Push tag: `git push origin v1.0.5`
+5. GitHub Actions builds and publishes to PyPI
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

pyinquirer_revived-1.0.4/LICENSE

@@ -0,0 +1,19 @@
+Copyright 2018 Oyetoke Toby and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyinquirer_revived-1.0.4/MANIFEST.in

@@ -0,0 +1 @@
+include LICENSE README.md requirements.txt CHANGELOG.md CONTRIBUTING.md

pyinquirer_revived-1.0.4/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: pyinquirer-revived
+Version: 1.0.4
+Summary: A Python module for common interactive command line user interfaces
+Home-page: https://github.com/someone-cloud/PyInquirer/
+Download-URL: https://github.com/someone-cloud/PyInquirer/archive/1.0.4.tar.gz
+Author: Zafrul Razeem
+Author-email: Zafrul Razeem <someone-cloud@users.noreply.github.com>
+License: MIT
+Project-URL: Homepage, https://github.com/someone-cloud/PyInquirer
+Project-URL: Repository, https://github.com/someone-cloud/PyInquirer
+Project-URL: Changelog, https://github.com/someone-cloud/PyInquirer/blob/master/CHANGELOG.md
+Keywords: cli,prompt-toolkit,command-line,inquirer
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: prompt_toolkit<4.0.0,>=3.0.0
+Requires-Dist: Pygments>=2.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: ptyprocess>=0.7.0; extra == "dev"
+Dynamic: author
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# PyInquirer (Maintained Fork)
+
+> **PyInquirer has been revived.** The original project was abandoned in 2024 with the maintainer [asking for a successor](https://github.com/CITGuru/PyInquirer/issues/159). This fork picks up where it left off — Python 3.10+ support, modern prompt_toolkit compatibility, and active maintenance.
+
+[![Tests](https://github.com/someone-cloud/PyInquirer/actions/workflows/test.yml/badge.svg)](https://github.com/someone-cloud/PyInquirer/actions/workflows/test.yml)
+
+## What's New in This Fork (v1.0.4)
+
+- **Python 3.10, 3.11, 3.12 support** — Fixed `collections.Mapping` and deprecated `pygments.token.Token` imports that broke on 3.10+
+- **prompt_toolkit 3.x compatibility** — Updated dependency bounds to support all prompt_toolkit 3.x releases
+- **CI via GitHub Actions** — Tests run on Python 3.8 through 3.12 on every push
+- **Bug fixes** — Fixed separator styling for list prompts, improved error handling
+
+## Original PyInquirer
+
+PyInquirer is a collection of common interactive command line user interfaces, based on [Inquirer.js](https://github.com/SBoudrias/Inquirer.js).
+
+### Installation
+
+```bash
+pip install PyInquirer
+```
+
+If you encounter any prompt_toolkit errors, ensure you have the correct version:
+
+```bash
+pip install prompt_toolkit>=3.0.0,<4.0.0
+```
+
+### Quickstart
+
+```python
+from PyInquirer import prompt
+
+questions = [
+    {
+        'type': 'input',
+        'name': 'first_name',
+        'message': "What's your first name",
+    }
+]
+
+answers = prompt(questions)
+print(answers)
+```
+
+### Question Types
+
+PyInquirer supports the following question types:
+
+| Type | Description |
+|------|-------------|
+| `input` | Free-form text input |
+| `confirm` | Yes/no confirmation |
+| `list` | Single selection from a list |
+| `rawlist` | Numbered list selection |
+| `expand` | Expandable choice list with key shortcuts |
+| `checkbox` | Multi-select from a list |
+| `password` | Masked text input |
+| `editor` | Opens external editor for input |
+
+### Examples
+
+See the [`examples/`](examples/) directory for usage examples of each question type:
+
+- [input.py](examples/input.py) — Basic text input
+- [confirm.py](examples/confirm.py) — Yes/no prompts
+- [list.py](examples/list.py) — Single choice from a list
+- [checkbox.py](examples/checkbox.py) — Multiple selections
+- [password.py](examples/password.py) — Masked input
+- [editor.py](examples/editor.py) — External editor integration
+- [expand.py](examples/expand.py) — Expandable choices
+- [pizza.py](examples/pizza.py) — Full pizza ordering demo using multiple question types
+- [hierarchical.py](examples/hierarchical.py) — Conditional questions with `when`
+
+### Question Properties
+
+Each question dictionary supports these properties:
+
+- `type` — Question type (input, confirm, list, rawlist, expand, checkbox, password, editor)
+- `name` — Key name in the answers dictionary
+- `message` — The prompt message shown to the user
+- `default` — Default value if no input is given
+- `choices` — List of choices (for list, rawlist, checkbox, expand)
+- `validate` — Validation function receiving user input
+- `filter` — Transform function applied to the answer
+- `when` — Conditional function to decide if the question should be asked
+- `pageSize` — Number of visible lines in list-type prompts
+
+### Styling
+
+Custom styles can be applied using prompt_toolkit's Style:
+
+```python
+from prompt_toolkit.styles import Style
+
+custom_style = Style.from_dict({
+    'questionmark': '#E91E63 bold',
+    'answer': '#2196F3 bold',
+    'pointer': '#FF9800 bold',
+    'selected': '#4CAF50',
+    'separator': '#9E9E9E',
+})
+
+answers = prompt(questions, style=custom_style)
+```
+
+## Credits
+
+Original project created by [Oyetoke Toby](https://github.com/CITGuru). This fork is maintained by [Zafrul Razeem](https://github.com/someone-cloud).
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

pyinquirer_revived-1.0.4/PyInquirer/__init__.py

@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+
+import os
+
+from .utils import print_json, format_json
+# from .prompt import prompt
+from .separator import Separator
+from .prompts.common import default_style
+
+__version__ = '1.0.4'
+
+
+def here(p):
+    # TODO: Is this being used externally or deprecate?
+    return os.path.abspath(os.path.join(os.path.dirname(__file__), p))
+
+class PromptParameterException(ValueError):
+    def __init__(self, message, errors=None):
+
+        # Call the base class constructor with the parameters it needs
+        super().__init__('You must provide a `%s` value' % message, errors)
+
+# The code below here is here because of backwards-compatibility. Before,
+# people were using style_from_dict and importing it from here. It's better to
+# use Style.from_dict, as recommended by prompt_toolkit now.
+from prompt_toolkit.styles import Style
+
+def style_from_dict(style_dict):
+    # Deprecated function. Users should use Style.from_dict instead.
+    # Keep this here for backwards-compatibility.
+    return Style.from_dict({
+        '.'.join(key).lower(): value for key, value in style_dict.items()
+    })
+  
+from prompt_toolkit.validation import Validator, ValidationError
+
+# Backward compatibility: Token was previously re-exported from pygments.token
+# which internally uses collections.Mapping (removed in Python 3.10+). Code
+# that imported Token from PyInquirer (e.g. older examples) will still work.
+# New code should use prompt_toolkit Style classes ('class:error', etc.) instead.
+class Token:
+    pass
+
+__all__ = ["PromptParameterException", "style_from_dict", "Token"]

pyinquirer_revived-1.0.4/PyInquirer/color_print.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+"""
+provide colorized output
+"""
+import sys
+from prompt_toolkit.shortcuts import print_tokens
+
+
+def _print_token_factory(col):
+    """Internal helper to provide color names."""
+    def _helper(msg):
+        tokens = [
+            ('fg:' + col, msg)
+        ]
+        print_tokens(tokens)
+
+    def _helper_no_terminal(msg):
+        # workaround if we have no terminal
+        print(msg)
+    if sys.stdout.isatty():
+        return _helper
+    else:
+        return _helper_no_terminal
+
+# used this for color source:
+# http://unix.stackexchange.com/questions/105568/how-can-i-list-the-available-color-names
+yellow = _print_token_factory('#dfaf00')
+blue = _print_token_factory('#0087ff')
+gray = _print_token_factory('#6c6c6c')
+
+# TODO
+#black
+#red
+#green
+#magenta
+#cyan
+#white

pyinquirer_revived-1.0.4/PyInquirer/prompt.py

@@ -0,0 +1,114 @@
+# -*- coding: utf-8 -*-
+
+from contextlib import contextmanager
+from . import PromptParameterException, prompts
+from .prompts import list, confirm, input, password, checkbox, rawlist, expand, editor
+from prompt_toolkit.patch_stdout import patch_stdout as pt_patch_stdout
+from prompt_toolkit.shortcuts import PromptSession
+from prompt_toolkit.application import Application
+
+
+
+def prompt(questions, answers=None, **kwargs):
+    from . import prompts
+
+    if isinstance(questions, dict):
+        questions = [questions]
+    answers = answers or {}
+
+    patch_stdout = kwargs.pop('patch_stdout', False)
+    return_asyncio_coroutine = kwargs.pop('return_asyncio_coroutine', False)
+    true_color = kwargs.pop('true_color', False)
+    refresh_interval = kwargs.pop('refresh_interval', 0)
+    kbi_msg = kwargs.pop('keyboard_interrupt_msg', 'Cancelled by user')
+    raise_kbi = kwargs.pop('raise_keyboard_interrupt', False)
+
+    for question in questions:
+        # import the question
+        if 'type' not in question:
+            raise PromptParameterException('type')
+        if 'name' not in question:
+            raise PromptParameterException('name')
+        if 'message' not in question:
+            raise PromptParameterException('message')
+        try:
+            choices = question.get('choices')
+            if choices is not None and callable(choices):
+                question['choices'] = choices(answers)
+
+            _kwargs = {}
+            _kwargs.update(kwargs)
+            _kwargs.update(question)
+            type_ = _kwargs.pop('type')
+            name = _kwargs.pop('name')
+            message = _kwargs.pop('message')
+            when = _kwargs.pop('when', None)
+            filter = _kwargs.pop('filter', None)
+
+            if when:
+                # at least a little sanity check!
+                if callable(question['when']):
+                    try:
+                        if not question['when'](answers):
+                            continue
+                    except Exception as e:
+                        raise ValueError(
+                            'Problem in \'when\' check of %s question: %s' %
+                            (name, e))
+                else:
+                    raise ValueError('\'when\' needs to be function that ' \
+                                     'accepts a dict argument')
+            if filter:
+                # at least a little sanity check!
+                if not callable(question['filter']):
+                    raise ValueError('\'filter\' needs to be function that ' \
+                                     'accepts an argument')
+
+            if callable(question.get('default')):
+                _kwargs['default'] = question['default'](answers)
+
+            with pt_patch_stdout() if patch_stdout else _dummy_context_manager():
+                result = getattr(prompts, type_).question(message, **_kwargs)
+
+
+                if isinstance(result, PromptSession):
+                    answer = result.prompt()
+                elif isinstance(result, Application):
+                    answer = result.run()
+                else:
+                    # assert isinstance(answer, str)
+                    answer = result
+
+                # answer = application.run(
+                #    return_asyncio_coroutine=return_asyncio_coroutine,
+                #    true_color=true_color,
+                #    refresh_interval=refresh_interval)
+
+            if answer is not None:
+                if filter:
+                    try:
+                        answer = question['filter'](answer)
+                    except Exception as e:
+                        raise ValueError(
+                            'Problem processing \'filter\' of %s question: %s' %
+                            (name, e))
+                answers[name] = answer
+        except AttributeError as e:
+            print(e)
+            raise ValueError('No question type \'%s\'' % type_)
+        except KeyboardInterrupt as exc:
+            if raise_kbi:
+                raise exc from None
+            if kbi_msg:
+                print('')
+                print(kbi_msg)
+                print('')
+            return {}
+    return answers
+
+@contextmanager
+def _dummy_context_manager():
+    yield
+
+# TODO:
+# Bottom Bar - inquirer.ui.BottomBar

pyinquirer_revived-1.0.4/PyInquirer/prompts/__init__.py

@@ -0,0 +1,6 @@
+class PromptParameterException(ValueError):
+    def __init__(self, message, errors=None):
+
+        # Call the base class constructor with the parameters it needs
+        super(PromptParameterException, self).__init__(
+            'You must provide a `%s` value' % message, errors)