Very nice project, I've been pondering abut something like this for a while, and existing Python console support projects seem to have died a quiet death.

A small feature request: Most terminals these days support 256 color (gnome, konsole, even old xterm/mrxvt). It'd be awesome if you could use these colors in Clint (for example, by setting colors as RGB and choosing the closest color). We're now in 2011 and 8-color text is old-fashioned :)

I might get around to implementing this myself and submitting a patch. I have code for this in one of my other projects. (As for lists of R/G/B values, and/or color names, IPython could be an inspiration as it has a module for it)

If args is installed (via setup.py install for example):

>>> from clint import args
>>> args
<module 'args' from '/Users/lothiraldan/.virtualenvs/clint/lib/python2.7/site-packages/args.pyc'>

If args is not installed:

>>> from clint import args
>>> args
<module 'clint.packages.args' from 'clint/packages/args/__init__.pyc'>

Hope it help. PS: Waiting for a new release.

Is the PyPi package (clint2 0.3.2 or clint 0.3.1) up to date? Neither package supports the expected_size arg in textui.progress.bar, though it appears to be in the current version of the code.

If I open up IPython and import clint (or a submodule), completion stops working; e.g. if I press the 'up' button, it prints '^[[A' ; 'tab' inserts an actual tab.

clint 0.3.2 can't be installed on python 3.3 because of this print statement.

Downloading/unpacking clint
  Running setup.py egg_info for package clint
    Traceback (most recent call last):
      File "<string>", line 16, in <module>
      File "/home/simon/lib/virtualenvs/clint/build/clint/setup.py", line 12, in <module>
        import clint
      File "./clint/__init__.py", line 22, in <module>
        from . import textui
      File "./clint/textui/__init__.py", line 17, in <module>
        from . import prompt
      File "./clint/textui/prompt.py", line 33
        print prompt
                   ^
    SyntaxError: invalid syntax
    Complete output from command python setup.py egg_info:
    Traceback (most recent call last):

  File "<string>", line 16, in <module>

  File "/home/simon/lib/virtualenvs/clint/build/clint/setup.py", line 12, in <module>

    import clint

  File "./clint/__init__.py", line 22, in <module>

    from . import textui

  File "./clint/textui/__init__.py", line 17, in <module>

    from . import prompt

  File "./clint/textui/prompt.py", line 33

    print prompt

               ^

SyntaxError: invalid syntax

>>> print "{}".format(colored.red("hello")).rjust(12)
hello
>>> print "{}".format(colored.red("hello")).rjust(20)
     hello
>>> print "{}".format("hello").rjust(20)
               hello

The fix for issue 22 introduced a new problem. The data files are now installed in the top folder of the environment.

To reproduce do:

$ virtualenv-2.6 --distribute venv
New python executable in venv/bin/python2.6
...
$ cd venv/
$ bin/pip install clint
Downloading/unpacking clint
  Running setup.py egg_info for package clint
Installing collected packages: clint
  Running setup.py install for clint
    warning: install_data: setup script did not provide a directory for 'README.rst' -- installing right in '/opt/tmp/venv'
    warning: install_data: setup script did not provide a directory for 'HISTORY.rst' -- installing right in '/opt/tmp/venv'
Successfully installed clint
Cleaning up...
$ ls
HISTORY.rst README.rst  bin     include     lib

distutils even warns about this. In my case my own readme/history files are overwritten by this.

I think to solve the issue you had, you just want to use a MANIFEST.in which will tell distutils to include the files in the sdist. There's no need to actually install them on the target system. If you want to install them as well, I'd use setuptools/distribute include_package_data option (http://packages.python.org/distribute/setuptools.html#including-data-files).

After running into the broken colour on Windows problem which is apparently fixed in code but not in the current release (#75) I thought I'd download what is current from github (https://github.com/kennethreitz/clint/archive/develop.zip), but that seems to be broken completely:

B:\code\clint>python setup.py
Traceback (most recent call last):
  File "setup.py", line 12, in <module>
    import clint
  File "B:\code\clint\clint\__init__.py", line 21, in <module>
    from arguments import *
ImportError: No module named arguments

And it appears I'm not the only one, https://readthedocs.org/projects/clint/ says the builds have been failing for the last 7 weeks with a similar error:

Exception occurred:
  File "/var/build/user_builds/clint/checkouts/latest/clint/__init__.py", line 21, in <module>
    from arguments import *
ImportError: No module named arguments

issue #145 Hello , I'm not sure about what author exactly wanted this function do However , I try to fixed the boolean return value in textui.prompt.yn()function I agree issue #145 concerned about the output is more close to users' thoughts Testing code as issue #145

from clint.textui import prompt

for d in range(3):
    print(prompt.yn("Yes?"))

for y in range(3):
    print(prompt.yn("Yes? default=y", default="y"))

for n in range(3):
    print(prompt.yn("Yes? default=n", default="n"))

• Before , output changed when no as default section

Yes? default=n [y/N] y
False
Yes? default=n [y/N] n
True
Yes? default=n [y/N]
False

• After

Yes? default=n [y/N] y
True
Yes? default=n [y/N] n
False
Yes? default=n [y/N] 
False

• The yn function's return value is now defined as

yes  ->  return True

no   ->  return False

NULL string -> return True if default is 'y' else False

clint.arguments was your inspiration for args module it seems... So just updating clint to reference it and reduce code duplication.

Also i think i may want the flags capabilities in legit.

I personnaly need some news features of clint in one of my project and wait for a new release of clint in order to release it. Is it planned for soon?

https://github.com/kennethreitz-archive/clint/blob/9d3693d644b8587d985972b6075d970096f6439e/clint/textui/prompt.py#L69

This line uses 'is not' to compare variable with string literal. This should be '=' and in python 3.8 and later raises following warning.

SyntaxWarning: "is not" with a literal. Did you mean "!="?

Running this code gives the following warning:

/opt/homebrew/Cellar/gitless/0.8.8_7/libexec/lib/python3.9/site-packages/clint/textui/prompt.py:68: SyntaxWarning: "is not" with a literal. Did you mean "!="?
  if prompt[-1] is not ' ':

Due to the python 3.8 update, the compiler now raises a SyntaxWarning if it founds an identity check(is, is not) with a certain literal. This pr addresses that.

I really want learn to use clint! But, I don't seem to be able to find any reliable documentation. I think the world's CLI should have the world's best documentation¯_(ツ)_/¯

But, jokes aside, I would be really grateful for some official documentation or at least some pointers on where to begin.

EDIT: If possible can any of the viewers, help me?

Thanks in advance!!

changed string formatting to .format() which is way faster. added optional unit to add to your progress bar. e.g 10/100 MB. added a show_percent option for those that want their progress bar to show percentage as well as progress/expected size. added a progress bar with percent template.