A module for getting validated user input via the console
Project description
* [[https://github.com/Sleft/cliask][cliask]]
A Python module for getting validated user input via the console which is meant to ease the process of building command line interfaces. Provides the function =ask= which will ask for input until a valid response is given. Also provides the function =agree= which will ask for input until the answer is yes or no. Both functions are similar to and inspired by the functions with the same name in the Ruby library [[http://highline.rubyforge.org/][HighLine]]. The following code gives a peek of how the functions can be used:
#+BEGIN_EXAMPLE
import cliask
animal = cliask.ask('Cow or cat? ',
validator=('cow', 'cat'),
invalid_response='You must say cow or cat')
yn = cliask.agree('Yes or no? ')
print(animal)
print(yn)
#+END_EXAMPLE
** Installation
To use cliask you need Python 3. The following describes two ways of installing. The first method requires that =git= is installed and the second does not. Either way the module has to be [[http://docs.python.org/3/tutorial/modules.html][imported]] for it to be used.
*** pip
Make sure you have =pip= installed then do the following:
#+BEGIN_EXAMPLE
sudo pip install cliask
#+END_EXAMPLE
*** Git
=cd= to the directory you want to install in and do
#+BEGIN_EXAMPLE
git clone https://github.com/Sleft/cliask.git .
#+END_EXAMPLE
to clone the git repository into that directory. You can use the same command if you want to update your installation.
*** Archive
[[https://github.com/Sleft/cliask/archive/master.zip][Download]] an archive and extract to the directory you want to install in.
** Usage
See the documentation in [[https://github.com/Sleft/cliask/blob/master/cliask.py][cliask.py]], especially the documention for =cliask.ask= and the example of usage in =cliask._test=. Run cliask.py, =python cliask.py=, to try the example of usage.
** Credits
The code in the module was first posted as [[http://stackoverflow.com/a/14977144][an answer]] to [[http://stackoverflow.com/q/14962930][a question]].
** License
See [[https://github.com/Sleft/yasnippet-latex-mode/blob/master/LICENSE.org][LICENSE.org]].
A Python module for getting validated user input via the console which is meant to ease the process of building command line interfaces. Provides the function =ask= which will ask for input until a valid response is given. Also provides the function =agree= which will ask for input until the answer is yes or no. Both functions are similar to and inspired by the functions with the same name in the Ruby library [[http://highline.rubyforge.org/][HighLine]]. The following code gives a peek of how the functions can be used:
#+BEGIN_EXAMPLE
import cliask
animal = cliask.ask('Cow or cat? ',
validator=('cow', 'cat'),
invalid_response='You must say cow or cat')
yn = cliask.agree('Yes or no? ')
print(animal)
print(yn)
#+END_EXAMPLE
** Installation
To use cliask you need Python 3. The following describes two ways of installing. The first method requires that =git= is installed and the second does not. Either way the module has to be [[http://docs.python.org/3/tutorial/modules.html][imported]] for it to be used.
*** pip
Make sure you have =pip= installed then do the following:
#+BEGIN_EXAMPLE
sudo pip install cliask
#+END_EXAMPLE
*** Git
=cd= to the directory you want to install in and do
#+BEGIN_EXAMPLE
git clone https://github.com/Sleft/cliask.git .
#+END_EXAMPLE
to clone the git repository into that directory. You can use the same command if you want to update your installation.
*** Archive
[[https://github.com/Sleft/cliask/archive/master.zip][Download]] an archive and extract to the directory you want to install in.
** Usage
See the documentation in [[https://github.com/Sleft/cliask/blob/master/cliask.py][cliask.py]], especially the documention for =cliask.ask= and the example of usage in =cliask._test=. Run cliask.py, =python cliask.py=, to try the example of usage.
** Credits
The code in the module was first posted as [[http://stackoverflow.com/a/14977144][an answer]] to [[http://stackoverflow.com/q/14962930][a question]].
** License
See [[https://github.com/Sleft/yasnippet-latex-mode/blob/master/LICENSE.org][LICENSE.org]].
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cliask-0.0.4.tar.gz
(3.3 kB
view hashes)