{"id":17257587,"url":"https://github.com/guysalt/python-inquirer3","last_synced_at":"2025-04-14T05:31:51.105Z","repository":{"id":176353052,"uuid":"656773800","full_name":"guysalt/python-inquirer3","owner":"guysalt","description":"This is a fork of magmax/python-inquirer. This one is hopefully more responsive (Issues/PRs/...).","archived":false,"fork":false,"pushed_at":"2024-09-30T21:02:49.000Z","size":1711,"stargazers_count":6,"open_issues_count":7,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T18:57:57.755Z","etag":null,"topics":["cli","inquirer","prompt","python","python3","ui"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guysalt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-21T15:55:14.000Z","updated_at":"2024-09-05T14:12:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"bd5ffa1c-11b4-45be-bffe-caaa93f1ba15","html_url":"https://github.com/guysalt/python-inquirer3","commit_stats":null,"previous_names":["guysalt/python-inquirer3"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guysalt%2Fpython-inquirer3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guysalt%2Fpython-inquirer3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guysalt%2Fpython-inquirer3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guysalt%2Fpython-inquirer3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guysalt","download_url":"https://codeload.github.com/guysalt/python-inquirer3/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248826638,"owners_count":21167727,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","inquirer","prompt","python","python3","ui"],"created_at":"2024-10-15T07:17:57.697Z","updated_at":"2025-04-14T05:31:50.817Z","avatar_url":"https://github.com/guysalt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n[![PyPI](https://img.shields.io/pypi/v/inquirer3?\u0026color=blue\u0026logo=pypi\u0026logoColor=%23FFFBEF)][pypi status]\n[![Downloads](https://static.pepy.tech/badge/inquirer3?color=green)][pypi downloads]\n[![Read the documentation at https://python-inquirer3.readthedocs.io/](https://img.shields.io/readthedocs/python-inquirer/latest.svg?label=docs)][read the docs]\n\n[![Tests](https://github.com/guysalt/python-inquirer3/workflows/Tests/badge.svg)][tests]\n[![Codecov](https://codecov.io/gh/guysalt/python-inquirer3/branch/main/graph/badge.svg)][codecov]\n[![Python Version](https://img.shields.io/pypi/pyversions/inquirer3.svg)][pypi status]\n[![License](https://img.shields.io/pypi/l/inquirer3.svg)][license]\n[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)][black]\n\n[pypi status]: https://pypi.org/project/inquirer3/\n[pypi downloads]: https://pepy.tech/project/inquirer3\n[read the docs]: https://python-inquirer3.readthedocs.io/\n[tests]: https://github.com/guysalt/python-inquirer3/actions?workflow=Tests\n[codecov]: https://app.codecov.io/gh/guysalt/python-inquirer3\n[black]: https://github.com/psf/black\n\n\u003c/div\u003e\n\n# python-inquirer3\n\nThis is a fork of [magmax/python-inquirer]. This one is hopefully more responsive (Issues/PRs/...).\n\nCollection of common interactive command line user interfaces, based on [magmax/python-inquirer].\n\n### Goal and Philosophy\n\n**inquirer3** should ease the process of asking end user **questions**, **parsing**, **validating** answers, managing **hierarchical prompts** and providing **error feedback**.\n\n## Platforms support\n\nPython-inquirer supports mainly UNIX-based platforms (eq. Mac OS, Linux, etc.). Windows has experimental support, please let us know if there are any problems!\n\n## Installation\n\nInstall the last released version using pip:\n\n```sh\npip install inquirer3\n```\n\nAlso, you can [download the python-inquirer code from GitHub] or [download the wheel from Pypi].\n\n## Documentation\n\n### Text\n\n```python\nimport re\n\nimport inquirer3\n\nquestions = [\n    inquirer3.Text('name', message=\"What's your name\"),\n    inquirer3.Text('surname', message=\"What's your surname\"),\n    inquirer3.Text('phone', message=\"What's your phone number\",\n                   validate=lambda _, x: re.match('\\+?\\d[\\d ]+\\d', x),\n                   )\n]\nanswers = inquirer3.prompt(questions)\n```\n\n### Editor\n\nLike a Text question, but used for larger answers. It opens external text editor which is used to collect the answer.\n\nThe environment variables `$VISUAL` and `$EDITOR`, can be used to specify which editor should be used. If not present inquirer fallbacks to `vim -\u003e emacs -\u003e nano` in this order based on availability in the system.\n\nExternal editor handling is done using great library [python-editor](https://github.com/fmoo/python-editor).\n\nExample:\n\n```python\nimport inquirer3\n\nquestions = [\n    inquirer3.Editor('long_text', message=\"Provide long text\")\n]\nanswers = inquirer3.prompt(questions)\n```\n\n### List\n\nShows a list of choices, and allows the selection of one of them.\n\nExample:\n\n```python\nimport inquirer3\n\nquestions = [\n    inquirer3.List('size',\n                   message=\"What size do you need?\",\n                   choices=['Jumbo', 'Large', 'Standard', 'Medium', 'Small', 'Micro'],\n                   ),\n]\nanswers = inquirer3.prompt(questions)\n```\n\nList questions can take one extra argument `carousel=False`. If set to true, the answers will rotate (back to first when pressing down on last choice, and down to last choice when pressing up on first choice)\n\n### Checkbox\n\nShows a list of choices, with multiple selection.\n\nExample:\n\n```python\nimport inquirer3\n\nquestions = [\n    inquirer3.Checkbox('interests',\n                       message=\"What are you interested in?\",\n                       choices=['Computers', 'Books', 'Science', 'Nature', 'Fantasy', 'History'],\n                       ),\n]\nanswers = inquirer3.prompt(questions)\n```\n\nCheckbox questions can take extra argument `carousel=False`. If set to true, the answers will rotate (back to first when pressing down on last choice, and down to last choice when pressing up on first choice)\n\nAnother argument that can be used is `locked=\u003cList\u003e`. The given choices in the locked argument cannot be removed. This is useful if you want to make clear that a specific option out of the choices must be chosen.\n\n### Path\n\nLike Text question, but with builtin validations for working with paths.\n\nExample:\n\n```python\nimport inquirer3\n\nquestions = [\n    inquirer3.Path('log_file',\n                   message=\"Where logs should be located?\",\n                   path_type=inquirer3.Path.DIRECTORY,\n                   ),\n]\nanswers = inquirer3.prompt(questions)\n```\n\n## Contributing\n\nContributions are very welcome.\nTo learn more, see the [Contributor Guide].\n\n## License\n\nCopyright (c) 2014-2023 Miguel Ángel García\n\nDistributed under the terms of the [MIT license][license].\n\n\u003c!-- github-only --\u003e\n\n[license]: https://github.com/guysalt/python-inquirer3/blob/main/LICENSE\n[contributor guide]: CONTRIBUTING.md\n[download the python-inquirer code from github]: https://github.com/guysalt/python-inquirer3\n[download the wheel from pypi]: https://pypi.org/project/inquirer3/#files\n[magmax/python-inquirer]: https://github.com/magmax/python-inquirer\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguysalt%2Fpython-inquirer3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguysalt%2Fpython-inquirer3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguysalt%2Fpython-inquirer3/lists"}