# IO ANSI Plus
Functionality to render ANSI escape sequences.
Clone of module [IO.ANSI][IO.ANSI] but supporting named Xterm colors.
## Installation
Add `io_ansi_plus` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:io_ansi_plus, "~> 0.1"}
]
end
```
## Notes
In addition to the 16 standard ANSI colors<sup>[1](#footnote1)</sup> and
their background counterparts, this package also supports the 256 Xterm colors
(foreground and background).
Most of these 256 colors were given names like:
-  `:aqua`
-  `:chartreuse`
-  `:psychedelic_purple`
For the full list of color names, see the **Color Samples** section below.
You can use color number atoms for the few colors that are unnamed:
```elixir
alias IO.ANSI.Plus, as: ANSI
["Hello, ", :color163, "world!"] |> ANSI.format(true) |> IO.puts()
["Hello, ", :color163_background, "world!"] |> ANSI.format(true) |> IO.puts()
```
Any color can have multiple names, for example, `:moccasin` and `:navajo_white` for color code 223.
For details, see file `config/persist_colors.exs`.
<sup><a name="footnote1">1</a></sup> Actually 8 colors and their "bright" variants.
## Shortcuts
The package also provides shortcuts to drop the `format` calls in the following
expressions:
```elixir
alias IO.ANSI.Plus, as: ANSI
["Hello, ", :brown, "world!"] |> ANSI.format(true) |> IO.puts()
["Hello, ", :purple, "world!"] |> ANSI.format(true) |> IO.write()
[:aqua, "Garry, your move:", :reset, " "] |> ANSI.format(true) |> IO.gets()
```
The above expressions can be respectively shortened to:
```elixir
alias IO.ANSI.Plus, as: ANSI
["Hello, ", :brown, "world!"] |> ANSI.puts(true)
["Hello, ", :purple, "world!"] |> ANSI.write(true)
[:aqua, "Garry, your move:", :reset, " "] |> ANSI.gets(true)
```
## Examples
## 
## Color Chart
## 
## Color Samples
-  `:black` (0)
-  `:red` `:maroon` (1)
-  `:green` (2)
-  `:yellow` (3)
-  `:blue` `:navy` (4)
-  `:magenta` `:purple` `:fresh_eggplant` (5)
-  `:cyan` `:teal` (6)
-  `:white` (7)
-  `:light_black` (8)
-  `:light_red` (9)
-  `:light_green` `:lime` (10)
-  `:light_yellow` (11)
-  `:light_blue` (12)
-  `:light_magenta` (13)
-  `:light_cyan` (14)
-  `:light_white` (15)
-  `:color16` (16)
-  `:stratos` (17)
-  `:dark_blue` (18)
-  `:new_midnight_blue` (19)
-  `:medium_blue` (20)
-  `:color21` (21)
-  `:dark_green` `:camarone` (22)
-  `:blue_stone` `:dark_slate_gray` `:mosque` (23)
-  `:blue_lagoon` `:orient` (24)
-  `:cobalt` `:endeavour` (25)
-  `:navy_blue` `:science_blue` (26)
-  `:blue_ribbon` (27)
-  `:japanese_laurel` (28)
-  `:deep_sea` `:observatory` (29)
-  `:dark_cyan` (30)
-  `:cerulean` (31)
-  `:pacific_blue` (32)
-  `:dodger_blue` (33)
-  `:islamic_green` (34)
-  `:jade` (35)
-  `:persian_green` (36)
-  `:bondi_blue` `:light_sea_green` (37)
-  `:iris_blue` (38)
-  `:deep_sky_blue` (39)
-  `:color40` (40)
-  `:malachite` (41)
-  `:caribbean_green` (42)
-  `:color43` (43)
-  `:dark_turquoise` (44)
-  `:color45` (45)
-  `:color46` (46)
-  `:color47` (47)
-  `:spring_green` (48)
-  `:medium_spring_green` (49)
-  `:bright_turquoise` (50)
-  `:aqua` (51)
-  `:rosewood` (52)
-  `:tyrian_purple` (53)
-  `:indigo` (54)
-  `:color55` (55)
-  `:electric_indigo` (56)
-  `:blue_violet` (57)
-  `:verdun_green` (58)
-  `:dim_gray` (59)
-  `:kimberly` (60)
-  `:rich_blue` (61)
-  `:slate_blue` (62)
-  `:neon_blue` `:royal_blue` (63)
-  `:limeade` (64)
-  `:hippie_green` (65)
-  `:hoki` (66)
-  `:steel_blue` `:air_force_blue` (67)
-  `:picton_blue` (68)
-  `:cornflower_blue` `:light_slate_blue` (69)
-  `:color70` (70)
-  `:fern` (71)
-  `:cadet_blue` `:keppel` (72)
-  `:fountain_blue` (73)
-  `:shakespeare` (74)
-  `:maya_blue` (75)
-  `:bright_green` (76)
-  `:color77` (77)
-  `:pastel_green` (78)
-  `:color79` (79)
-  `:medium_turquoise` (80)
-  `:malibu` (81)
-  `:color82` (82)
-  `:screamin_green` (83)
-  `:color84` (84)
-  `:color85` (85)
-  `:color86` (86)
-  `:baby_blue` (87)
-  `:dark_red` (88)
-  `:eggplant` (89)
-  `:dark_magenta` (90)
-  `:color91` (91)
-  `:dark_violet` (92)
-  `:electric_violet` (93)
-  `:brown` (94)
-  `:light_wood` (95)
-  `:trendy_pink` (96)
-  `:blue_marguerite` (97)
-  `:color98` (98)
-  `:color99` (99)
-  `:olive` (100)
-  `:bandicoot` (101)
-  `:color102` (102)
-  `:ship_cove` `:light_slate_grey` (103)
-  `:medium_purple` `:portage` (104)
-  `:color105` (105)
-  `:citrus` (106)
- ![?][87af5f] `:chelsea_cucumber` (107)
-  `:dark_sea_green` (108)
-  `:ziggurat` (109)
-  `:seagull` (110)
-  `:color111` (111)
-  `:lawn_green` (112)
-  `:color113` (113)
-  `:gossip` (114)
-  `:bermuda` (115)
-  `:riptide` (116)
-  `:columbia_blue` (117)
-  `:chartreuse` (118)
-  `:color119` (119)
-  `:mint_green` (120)
-  `:pale_green` (121)
-  `:color122` (122)
-  `:electric_blue` (123)
-  `:free_speech_red` (124)
-  `:flirt` (125)
-  `:medium_violet_red` (126)
-  `:deep_magenta` (127)
-  `:color128` (128)
-  `:electric_purple` (129)
-  `:tenne` `:rose_of_sharon` (130)
-  `:coral_tree` (131)
-  `:tapestry` (132)
-  `:violet_blue` (133)
-  `:medium_orchid` (134)
-  `:color135` (135)
-  `:dark_goldenrod` (136)
-  `:teak` (137)
-  `:rosy_brown` `:thatch` (138)
-  `:london_hue` (139)
- ![?][af87d7] `:wisteria` (140)
-  `:color141` (141)
-  `:buddha_gold` (142)
- ![?][afaf5f] `:olive_green` `:dark_khaki` (143)
-  `:neutral_green` (144)
- ![?][afafaf] `:dark_gray` (145)
-  `:moon_raker` (146)
-  `:light_steel_blue` (147)
-  `:spring_bud` (148)
-  `:conifer` (149)
-  `:feijoa` (150)
-  `:chinook` (151)
-  `:scandal` (152)
-  `:anakiwa` (153)
-  `:green_yellow` (154)
-  `:color155` (155)
-  `:color156` (156)
-  `:color157` (157)
-  `:aero_blue` (158)
-  `:french_pass` (159)
-  `:guardsman_red` (160)
-  `:razzmatazz` (161)
-  `:hollywood_cerise` (162)
-  `:color163` (163)
-  `:purple_pizzazz` (164)
-  `:psychedelic_purple` (165)
-  `:tenn` (166)
-  `:indian_red` `:roman` (167)
-  `:pale_violet_red` (168)
-  `:hopbush` (169)
-  `:orchid` (170)
-  `:heliotrope` (171)
-  `:mango_tango` `:chocolate` (172)
-  `:copper` (173)
-  `:my_pink` (174)
-  `:kobi` (175)
-  `:plum` (176)
-  `:violet` (177)
-  `:goldenrod` `:golden_poppy` `:corn` (178)
-  `:equator` (179)
-  `:tan` `:calico` (180)
-  `:pink_flare` (181)
-  `:french_lilac` (182)
-  `:mauve` (183)
-  `:school_bus_yellow` (184)
-  `:tacha` (185)
-  `:deco` (186)
-  `:aths_special` (187)
-  `:light_grey` `:light_gray` (188)
-  `:lavender_blue` (189)
-  `:chartreuse_yellow` (190)
-  `:laser_lemon` (191)
-  `:canary` (192)
-  `:reef` (193)
-  `:honeydew` `:beige` (194)
-  `:oyster_bay` (195)
-  `:color196` (196)
-  `:rose` (197)
-  `:deep_pink` (198)
-  `:color199` (199)
- ![?][ff00d7] `:hot_magenta` (200)
-  `:fuchsia` (201)
- ![?][ff5f00] `:orange_red` `:safety_orange` (202)
- ![?][ff5f5f] `:bittersweet` (203)
- ![?][ff5f87] `:wild_watermelon` (204)
- ![?][ff5faf] `:hot_pink` (205)
- ![?][ff5fd7] `:neon_pink` (206)
-  `:pink_flamingo` (207)
-  `:dark_orange` (208)
- ![?][ff875f] `:coral` (209)
-  `:light_coral` `:mona_lisa` (210)
- ![?][ff87af] `:tickle_me_pink` (211)
-  `:color212` (212)
-  `:fuchsia_pink` (213)
-  `:orange` (214)
-  `:sandy_brown` `:rajah` (215)
-  `:hit_pink` `:macaroni_and_cheese` (216)
- ![?][ffafaf] `:melon` (217)
- ![?][ffafd7] `:cotton_candy` (218)
- ![?][ffafff] `:lavender_rose` (219)
- ![?][ffd700] `:gold` (220)
- ![?][ffd75f] `:dandelion` (221)
- ![?][ffd787] `:khaki` `:salomie` (222)
- ![?][ffd7af] `:moccasin` `:navajo_white` (223)
- ![?][ffd7d7] `:mysty_rose` (224)
- ![?][ffd7ff] `:lavender_blush` (225)
-  `:color226` (226)
- ![?][ffff5f] `:color227` (227)
- ![?][ffff87] `:dolly` (228)
- ![?][ffffaf] `:portafino` (229)
- ![?][ffffd7] `:cream` `:cumulus` (230)
-  `:color231` (231)
- ![?][080808] `:cod_gray` (232)
- ![?][121212] `:color233` (233)
- ![?][1c1c1c] `:nero` (234)
- ![?][262626] `:mine_shaft` (235)
-  `:night_rider` (236)
-  `:eclipse` (237)
-  `:charcoal` `:tundora` (238)
-  `:matterhorn` (239)
-  `:mortar` `:scorpion` (240)
-  `:dove_gray` (241)
-  `:color242` (242)
-  `:empress` (243)
-  `:grey` `:gray` (244)
-  `:suva_grey` (245)
-  `:dusty_gray` (246)
-  `:silver_chalice` (247)
-  `:color248` (248)
-  `:color249` (249)
-  `:silver` (250)
-  `:color251` (251)
-  `:alto` (252)
-  `:color253` (253)
-  `:mercury` `:gainsboro` (254)
-  `:white_smoke` `:gallery` (255)
[IO.ANSI]: https://hexdocs.pm/elixir/IO.ANSI.html
[87af5f]: /images/87af5f.png
[af87d7]: /images/af87d7.png
[afaf5f]: /images/afaf5f.png
[afafaf]: /images/afafaf.png
[ff00d7]: /images/ff00d7.png
[ff5f00]: /images/ff5f00.png
[ff5f5f]: /images/ff5f5f.png
[ff5f87]: /images/ff5f87.png
[ff5faf]: /images/ff5faf.png
[ff5fd7]: /images/ff5fd7.png
[ff875f]: /images/ff875f.png
[ff87af]: /images/ff87af.png
[ffafaf]: /images/ffafaf.png
[ffafd7]: /images/ffafd7.png
[ffafff]: /images/ffafff.png
[ffd700]: /images/ffd700.png
[ffd75f]: /images/ffd75f.png
[ffd787]: /images/ffd787.png
[ffd7af]: /images/ffd7af.png
[ffd7d7]: /images/ffd7d7.png
[ffd7ff]: /images/ffd7ff.png
[ffff5f]: /images/ffff5f.png
[ffff87]: /images/ffff87.png
[ffffaf]: /images/ffffaf.png
[ffffd7]: /images/ffffd7.png
[080808]: /images/080808.png
[121212]: /images/121212.png
[1c1c1c]: /images/1c1c1c.png
[262626]: /images/262626.png
