Package: genaa
genaa is a command line tool for generating ASCII Art:+-----+   +---+   +-----+     +-----+   +-----+
  |     |   |   |   |     |     |     |   |     |
+-+---+ | +-+   +-+ | +---+-+ +-+---+ | +-+---+ |
| |   | | |       | | |   | | | |   | | | |   | |
| |   | | | +-----+ | |   | | | |   | | | |   | |
| |   | | | |       | |   | | | |   | | | |   | |
+-+---+ | +-+-----+ | |   | | +-+---+ | +-+---+ |
  |     |   |     | | |   | |   |     |   |     |
  +---+ |   +-----+ +-+   +-+   +-----+   +-----+
      | |
  +---+-+
  |   |
  +---+InstallInstall genaa by using pip.pip install genaaNow genaa is supporting Python 2.7 and 3.3.Basic Usagegenaa has some sub-commands to render various ASCII Arts:boxblockgenaa boxis the most basic and simple feature.
It can render a block containing text input by user:$ genaa box --text Hello!
+--------+
| Hello! |
+--------+genaa blockis a command to render some free shape blocks.
It takes some ‘dots’ and translate it to ASCII Art blocks.
This example show you how to create a well-known TETRIS block from command line:$ genaa block --text '
> ***
>  * '

+-----+
|     |
+-+ +-+
  | |
  +-+As filterAbove examples are used as one of simple command line tools, using –text argument.
But, genaa usually behaves as a filter command, like this:$ echo -en 'Hello world!\nThis is genaa' | genaa box
+---------------+
| Hello world!  |
| This is genaa |
+---------------+Generally, it is recommended to use from some editors.
Most editors has a feature to pass the selected text to some shell command
and input returned value. On Emacs, you can use ‘shell-command-on-region’.genaa boxYou can specify these arguments togenaa box:-h, --help            show this help message and exit
-t TEXT, --text TEXT  Passing text by argument into box
-W WIDTH, --width WIDTH
-H HEIGHT, --height HEIGHT
-s {ccomment,ascii,hash,simple}, --style {ccomment,ascii,hash,simple}
-l, --list            Displaying examples for each styles–width and –heightBy default,genaa boxcommand render the box with automatically specified width/height.
But, you can specify these width and height of the box manually, like this:$ echo -en 'Hello world!\nThis is genaa' | genaa box --width=20 --height=3
+----------------------+
| Hello world!         |
| This is genaa        |
|                      |
+----------------------+–styleThis example is usinghashstyle which is used as comment block in Python:$ echo -en 'Hello world!\nThis is genaa' | genaa box --style=hash
#################
# Hello world!  #
# This is genaa #
#################–listThe list of styles are ongenaa box –listcommand:$ genaa box --list
ascii:
+-----------------------+
| Hello.                |
| How about this style? |
+-----------------------+

ccomment:
/************************
* Hello.                *
* How about this style? *
************************/

hash:
#########################–aligngenaa boxcommand put the text at the left side of the box.
It also supports putting the text on center and right:genaa box --align=center --text=Hello --width=20
+----------------------+
|        Hello         |
+----------------------+genaa blockYou can specify these arguments togenaa block:-h, --help            show this help message and exit
-t TEXT, --text TEXT  Passing text by argument into block
-s {ascii,simple}, --style {ascii,simple}
-l, --list            Displaying examples for each styles–styleThis example is usingsimplestyle.
You can see this clearly by some mono-space fonts:$ genaa block --style=simple
**
* *
 *
┌───┐
│   │
│ ┌─┼─┐
│ │ │ │
└─┼─┼─┘
  │ │
  └─┘–listThe list of styles are ongenaa block –listcommand:$ genaa block --list
ascii:
  +-+
  | |
  +-+-+   +-+ +-+       +-+   +-+       +-+
    | |   | | | |       | |   | |       | |
+---+ |   +-+-+ |   +-+ | |   +-+---+   +-+-+
|     |     |   |   | | | |     |   |     | |
+-----+     | +-+   +-+-+ |   +-+ +-+ +---+ |
            | |       |   |   |   |   |     |
            +-+       +---+   +---+   +-----+

simple:
  ┌─┐
  │ │
  └─┼─┐   ┌─┐ ┌─┐       ┌─┐   ┌─┐       ┌─┐
    │ │   │ │ │ │       │ │   │ │       │ │
┌───┘ │   └─┼─┘ │   ┌─┐ │ │   └─┼───┐   └─┼─┐Changes0.4 (2013-1-17)Multi-width characters support (like japanese)0.3 (2013-1-12)Python2 support (2.7 only)0.2 (2013-1-3)Addedgenaa blockcommand.
Added –list argument togenaa box.0.1 (2013-12-28)Initial release.
Supporting:Rendering boxes with textAuto specifying width and heightChanging style of boxesAlign specifying (right, center, left)