inquirer

A collection of common interactive command line user interfaces, based on Inquirer.js (https://github.com/SBoudrias/Inquirer.js/)

https://github.com/magmax/python-inquirer

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    1 of 38 committers (2.6%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.8%) to scientific vocabulary

Keywords from Contributors

distribution interactive embedded wsgi werkzeug pallets uml-diagram serializer diagram packaging
Last synced: 10 months ago · JSON representation

Repository

A collection of common interactive command line user interfaces, based on Inquirer.js (https://github.com/SBoudrias/Inquirer.js/)

Basic Info
  • Host: GitHub
  • Owner: magmax
  • License: mit
  • Language: Python
  • Default Branch: main
  • Size: 1.67 MB
Statistics
  • Stars: 1,099
  • Watchers: 8
  • Forks: 101
  • Open Issues: 39
  • Releases: 33
Created about 12 years ago · Last pushed 11 months ago
Metadata Files
Readme Contributing License Code of conduct Codeowners

README.md

PyPI Status Python Version License Black
Read the documentation at https://python-inquirer.readthedocs.io/ Tests Codecov pre-commit

python-inquirer

Collection of common interactive command line user interfaces, based on Inquirer.js.

Goal and Philosophy

Born as a Inquirer.js clone, it shares part of the goals and philosophy.

So, Inquirer should ease the process of asking end user questions, parsing, validating answers, managing hierarchical prompts and providing error feedback.

You can download the python-inquirer code from GitHub or download the wheel from Pypi.

Platforms support

Python-inquirer supports mainly UNIX-based platforms (eq. Mac OS, Linux, etc.). Windows has experimental support, please let us know if there are any problems!

Installation

sh pip install inquirer

Documentation

Documentation has been moved to python-inquirer.readthedocs.io.

But here you have a couple of usage examples:

Text

```python import re

import inquirer questions = [ inquirer.Text('name', message="What's your name"), inquirer.Text('surname', message="What's your surname"), inquirer.Text('phone', message="What's your phone number", validate=lambda _, x: re.match('+?\d[\d ]+\d', x), ) ] answers = inquirer.prompt(questions) ```

Editor

Like a Text question, but used for larger answers. It opens external text editor which is used to collect the answer.

The environment variables $VISUAL and $EDITOR, can be used to specify which editor should be used. If not present inquirer fallbacks to vim -> emacs -> nano in this order based on availability in the system.

External editor handling is done using great library python-editor.

Example:

python import inquirer questions = [ inquirer.Editor('long_text', message="Provide long text") ] answers = inquirer.prompt(questions)

List

Shows a list of choices, and allows the selection of one of them.

Example:

python import inquirer questions = [ inquirer.List('size', message="What size do you need?", choices=['Jumbo', 'Large', 'Standard', 'Medium', 'Small', 'Micro'], ), ] answers = inquirer.prompt(questions)

List 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)

Checkbox

Shows a list of choices, with multiple selection.

Example:

python import inquirer questions = [ inquirer.Checkbox('interests', message="What are you interested in?", choices=['Computers', 'Books', 'Science', 'Nature', 'Fantasy', 'History'], ), ] answers = inquirer.prompt(questions)

Checkbox 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)

Another argument that can be used is locked=<List>. 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.

Path

Like Text question, but with builtin validations for working with paths.

Example:

python import inquirer questions = [ inquirer.Path('log_file', message="Where logs should be located?", path_type=inquirer.Path.DIRECTORY, ), ] answers = inquirer.prompt(questions)

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Copyright (c) 2014-2023 Miguel Ángel García (@magmax_en), based on Inquirer.js, by Simon Boudrias (@vaxilart)

Distributed under the terms of the MIT license.

Owner

  • Name: Miguel Ángel García
  • Login: magmax
  • Kind: user
  • Location: Ciudad Real

GitHub Events

Total
  • Create event: 30
  • Release event: 1
  • Issues event: 6
  • Watch event: 86
  • Delete event: 37
  • Issue comment event: 39
  • Push event: 49
  • Pull request review event: 9
  • Pull request review comment event: 12
  • Pull request event: 79
  • Fork event: 5
Last Year
  • Create event: 30
  • Release event: 1
  • Issues event: 6
  • Watch event: 86
  • Delete event: 37
  • Issue comment event: 39
  • Push event: 49
  • Pull request review event: 9
  • Pull request review comment event: 12
  • Pull request event: 79
  • Fork event: 5

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 729
  • Total Committers: 38
  • Avg Commits per committer: 19.184
  • Development Distribution Score (DDS): 0.658
Past Year
  • Commits: 72
  • Committers: 4
  • Avg Commits per committer: 18.0
  • Development Distribution Score (DDS): 0.292
Top Committers
Name Email Commits
Miguel Angel Garcia m****a@g****m 249
dependabot[bot] 4****] 207
Jan Wille m****l@j****e 86
staticdev s****t@p****m 52
AuHau u****a@g****m 44
William Venner 1****r 19
vittorio.camisa@gmail.com v****a@g****m 8
NivEz n****r@g****m 7
matiboy m****c@g****m 6
Matt Warren m****n@g****m 5
Zhymabek Roman 6****n 5
Steven Loria s****1@g****m 3
Rizky Arlin r****5@g****m 3
Lele Gaifax l****e@m****t 3
Vittorio Camisa “****o@i****” 3
Ariel Steiner a****s@a****m 2
Aaron Fischer a****n@s****m 2
Palash Karmore p****e@g****m 2
Patrick Browne p****e@g****m 2
Xiang Zheng z****l@g****m 2
The Alchemist k****0@g****m 2
Yahya Badran y****n@g****m 1
Tomer Zait r****3@g****m 1
Jose Manuel Rubio j****o@a****m 1
Patrick Browne p****e@a****m 1
Victor Machado v****o@h****m 1
Shintaro Takechi p****9@g****m 1
Sandro-Alessio Gierens s****o@g****e 1
Robert Stein S****t 1
Priyanshu Tripathi p****u@g****v 1
and 8 more...

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 59
  • Total pull requests: 363
  • Average time to close issues: 4 months
  • Average time to close pull requests: 24 days
  • Total issue authors: 54
  • Total pull request authors: 21
  • Average comments per issue: 2.92
  • Average comments per pull request: 0.64
  • Merged pull requests: 208
  • Bot issues: 0
  • Bot pull requests: 286
Past Year
  • Issues: 4
  • Pull requests: 80
  • Average time to close issues: about 2 months
  • Average time to close pull requests: about 2 months
  • Issue authors: 4
  • Pull request authors: 6
  • Average comments per issue: 1.5
  • Average comments per pull request: 0.48
  • Merged pull requests: 40
  • Bot issues: 0
  • Bot pull requests: 65
Top Authors
Issue Authors
  • Cube707 (4)
  • kutysam (2)
  • guysalt (2)
  • aaronhendry (2)
  • gaardhus (1)
  • elpekenin (1)
  • manorit2001 (1)
  • aphshir (1)
  • snps-grafael (1)
  • JackBailey (1)
  • whinee (1)
  • sergey-samoylov (1)
  • markfink (1)
  • adityasule (1)
  • Zereges (1)
Pull Request Authors
  • dependabot[bot] (378)
  • Cube707 (66)
  • staticdev (7)
  • fullfox (4)
  • badranX (4)
  • magmax (3)
  • guysalt (3)
  • YoussefEssalhi (2)
  • victormachadoperez (2)
  • ocaballeror (2)
  • rizkyarlin (2)
  • GetPsyched (2)
  • polirritmico (2)
  • The-Alchemist (2)
  • ofeknissan (1)
Top Labels
Issue Labels
python (16) bug (9) enhancement (8) duplicate (7) upstream_issue (6) documentation (4) question (4) help wanted (4) blocked (3) wontfix (3) needs more info (2) skip-changelog (1) dependencies (1) build (1) testing (1) good first issue (1) ci (1) breaking (1) invalid (1)
Pull Request Labels
dependencies (381) python (375) skip-changelog (19) github_actions (17) enhancement (6) ci (5) bug (4) documentation (3) refactoring (2) style (2) breaking (2) blocked (1)

Packages

  • Total packages: 22
  • Total downloads:
    • pypi 4,406,238 last-month
  • Total docker downloads: 1,477,681
  • Total dependent packages: 283
    (may contain duplicates)
  • Total dependent repositories: 842
    (may contain duplicates)
  • Total versions: 112
  • Total maintainers: 6
pypi.org: inquirer

Collection of common interactive command line user interfaces, based on Inquirer.js

  • Versions: 53
  • Dependent Packages: 278
  • Dependent Repositories: 840
  • Downloads: 4,406,238 Last month
  • Docker Downloads: 1,477,681
Rankings
Dependent packages count: 0.1%
Downloads: 0.3%
Dependent repos count: 0.4%
Docker downloads count: 0.8%
Average: 1.3%
Stargazers count: 2.1%
Forks count: 4.3%
Maintainers (3)
Last synced: 10 months ago
alpine-v3.18: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 5.3%
Stargazers count: 8.8%
Forks count: 12.2%
Maintainers (1)
Last synced: 11 months ago
alpine-v3.18: py3-inquirer-pyc

Precompiled Python bytecode for py3-inquirer

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 5.3%
Stargazers count: 8.8%
Forks count: 12.2%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.13: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 1
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Stargazers count: 5.7%
Average: 5.8%
Forks count: 8.0%
Dependent packages count: 9.4%
Maintainers (1)
Last synced: 10 months ago
proxy.golang.org: github.com/magmax/python-inquirer
  • Versions: 21
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 7.0%
Average: 8.2%
Dependent repos count: 9.3%
Last synced: 10 months ago
alpine-v3.14: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Stargazers count: 5.9%
Forks count: 8.2%
Average: 8.9%
Dependent packages count: 21.7%
Maintainers (1)
Last synced: 10 months ago
alpine-edge: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 9
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Average: 9.5%
Stargazers count: 10.5%
Forks count: 12.8%
Dependent packages count: 14.6%
Maintainers (1)
Last synced: 10 months ago
alpine-edge: py3-inquirer-pyc

Precompiled Python bytecode for py3-inquirer

  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Average: 9.5%
Stargazers count: 10.6%
Forks count: 13.2%
Dependent packages count: 14.3%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.15: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Stargazers count: 6.4%
Forks count: 8.8%
Average: 10.2%
Dependent packages count: 25.6%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.16: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Stargazers count: 6.9%
Forks count: 9.3%
Average: 10.9%
Dependent packages count: 27.3%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.17: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Stargazers count: 8.6%
Forks count: 11.2%
Average: 11.8%
Dependent packages count: 27.3%
Maintainers (1)
Last synced: 10 months ago
conda-forge.org: inquirer
  • Versions: 5
  • Dependent Packages: 2
  • Dependent Repositories: 2
Rankings
Stargazers count: 14.2%
Average: 18.3%
Forks count: 19.5%
Dependent packages count: 19.6%
Dependent repos count: 20.1%
Last synced: 10 months ago
spack.io: py-inquirer

Collection of common interactive command line user interfaces, based on Inquirer.js.

  • Versions: 1
  • Dependent Packages: 1
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Average: 28.6%
Dependent packages count: 57.3%
Maintainers (1)
Last synced: 10 months ago
anaconda.org: inquirer

Collection of common interactive command line user interfaces, based on Inquirer.js.

  • Versions: 1
  • Dependent Packages: 1
  • Dependent Repositories: 0
Rankings
Dependent packages count: 51.0%
Average: 55.4%
Dependent repos count: 59.9%
Last synced: 10 months ago
alpine-v3.20: py3-inquirer-pyc

Precompiled Python bytecode for py3-inquirer

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.22: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.21: py3-inquirer-pyc

Precompiled Python bytecode for py3-inquirer

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.20: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 11 months ago
alpine-v3.19: py3-inquirer-pyc

Precompiled Python bytecode for py3-inquirer

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.21: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.22: py3-inquirer-pyc

Precompiled Python bytecode for py3-inquirer

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago
alpine-v3.19: py3-inquirer

collection of common interactive command line user interfaces

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Dependent packages count: 0.0%
Average: 100%
Maintainers (1)
Last synced: 10 months ago

Dependencies

.github/workflows/documentation.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
.github/workflows/labeler.yml actions
  • actions/checkout v3 composite
  • crazy-max/ghaction-github-labeler v4 composite
.github/workflows/release.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • pypa/gh-action-pypi-publish release/v1 composite
  • release-drafter/release-drafter v5 composite
  • salsify/action-detect-and-tag-new-version v2 composite
.github/workflows/tests.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/download-artifact v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
  • codecov/codecov-action v3 composite
docs/requirements.txt pypi
  • furo ==2022.12.7
  • myst_parser ==0.18.1
  • sphinx ==6.1.2
poetry.lock pypi
  • alabaster 0.7.12 develop
  • babel 2.11.0 develop
  • bandit 1.7.4 develop
  • beautifulsoup4 4.11.1 develop
  • certifi 2022.12.7 develop
  • cfgv 3.3.1 develop
  • charset-normalizer 2.0.12 develop
  • click 8.1.3 develop
  • colorama 0.4.6 develop
  • distlib 0.3.6 develop
  • docutils 0.19 develop
  • dparse 0.6.2 develop
  • filelock 3.8.2 develop
  • flake8 5.0.4 develop
  • flake8-docstrings 1.6.0 develop
  • furo 2022.12.7 develop
  • gitdb 4.0.10 develop
  • gitpython 3.1.30 develop
  • identify 2.5.10 develop
  • idna 3.4 develop
  • imagesize 1.4.1 develop
  • importlib-metadata 5.1.0 develop
  • isort 5.11.4 develop
  • jinja2 3.1.2 develop
  • livereload 2.6.3 develop
  • markupsafe 2.1.1 develop
  • mccabe 0.7.0 develop
  • nodeenv 1.7.0 develop
  • packaging 21.3 develop
  • pbr 5.11.0 develop
  • pexpect 4.8.0 develop
  • platformdirs 2.6.0 develop
  • pre-commit 2.21.0 develop
  • pre-commit-hooks 4.4.0 develop
  • ptyprocess 0.7.0 develop
  • pycodestyle 2.9.1 develop
  • pydocstyle 6.1.1 develop
  • pyflakes 2.5.0 develop
  • pygments 2.13.0 develop
  • pyparsing 3.0.9 develop
  • pytz 2022.6 develop
  • pyupgrade 3.3.1 develop
  • pyyaml 6.0 develop
  • requests 2.27.1 develop
  • ruamel-yaml 0.17.21 develop
  • ruamel-yaml-clib 0.2.7 develop
  • safety 2.3.5 develop
  • smmap 5.0.0 develop
  • snowballstemmer 2.2.0 develop
  • soupsieve 2.3.2.post1 develop
  • sphinx 5.3.0 develop
  • sphinx-autobuild 2021.3.14 develop
  • sphinx-basic-ng 1.0.0b1 develop
  • sphinxcontrib-applehelp 1.0.2 develop
  • sphinxcontrib-devhelp 1.0.2 develop
  • sphinxcontrib-htmlhelp 2.0.0 develop
  • sphinxcontrib-jsmath 1.0.1 develop
  • sphinxcontrib-qthelp 1.0.3 develop
  • sphinxcontrib-serializinghtml 1.1.5 develop
  • stevedore 4.1.1 develop
  • tokenize-rt 5.0.0 develop
  • toml 0.10.2 develop
  • tomli 2.0.1 develop
  • tornado 6.2 develop
  • urllib3 1.26.13 develop
  • virtualenv 20.17.1 develop
  • zipp 3.11.0 develop
  • ansicon 1.89.0
  • blessed 1.19.1
  • jinxed 1.2.0
  • python-editor 1.0.4
  • readchar 4.0.3
  • setuptools 65.6.3
  • six 1.16.0
  • wcwidth 0.2.5
pyproject.toml pypi
  • bandit >=1.7.4 develop
  • flake8 >=4.0.1,<6.0.0 develop
  • flake8-docstrings >=1.6.0 develop
  • furo >=2022.9.29 develop
  • isort >=5.10.1 develop
  • pexpect >=4.8.0 develop
  • pre-commit >=2.17.0 develop
  • pre-commit-hooks >=4.3.0 develop
  • pyupgrade >=2.31.1 develop
  • safety >=2.3.1 develop
  • sphinx >=5.3.0 develop
  • sphinx-autobuild >=2021.3.14 develop
  • blessed >=1.19.0
  • python >=3.8
  • python-editor >=1.0.4
  • readchar >=3.0.6