|
1 | 1 | /* |
2 | 2 | Package Box CLI Maker is a Highly Customized Terminal Box Creator written in Go. |
3 | 3 |
|
4 | | -It provides many styles and options to make Boxes. There are 8 inbuilt styles and Color support via RGB uint, RGB Array of [3]uint and string (given). |
| 4 | +It provides many styles and options to make Boxes. There are 8 inbuilt styles and has Color support via RGB uint, RGB Array of [3]uint and string (given). |
5 | 5 |
|
6 | 6 | Inbuilt Box Styles: |
7 | | -Single |
8 | | -Double |
9 | | -Bold |
10 | | -Single Double |
11 | | -Double Single |
12 | | -Round |
13 | | -Hidden |
| 7 | +Single, |
| 8 | +Double, |
| 9 | +Bold, |
| 10 | +Single Double, |
| 11 | +Double Single, |
| 12 | +Round, |
| 13 | +Hidden and |
14 | 14 | Classic |
15 | 15 |
|
16 | 16 | Inbuilt Colors: |
17 | | -Black |
18 | | -Blue |
19 | | -Red |
20 | | -Yellow |
21 | | -Green |
22 | | -Cyan |
23 | | -Magenta |
24 | | -HiBlack |
25 | | -HiBlue |
26 | | -HiRed |
27 | | -HiYellow |
28 | | -HiGreen |
29 | | -HiCyan |
| 17 | +Black, |
| 18 | +Blue, |
| 19 | +Red, |
| 20 | +Yellow, |
| 21 | +Green, |
| 22 | +Cyan, |
| 23 | +Magenta, |
| 24 | +HiBlack, |
| 25 | +HiBlue, |
| 26 | +HiRed, |
| 27 | +HiYellow, |
| 28 | +HiGreen, |
| 29 | +HiCyan and |
30 | 30 | HiMagenta |
31 | 31 |
|
32 | 32 | It also has Unicode and Emoji support which works across all terminals though there might be some terminals which do not support |
33 | | -Unicode and Emoji like Windows CMD and Powershell. Unlike other terminals makers Box CLI Mkaer supports tab and multi line string. |
| 33 | +Unicode and Emoji like Windows CMD and Powershell. Unlike other CLI Makers, Box CLI Maker supports tab and multi line string. |
| 34 | +
|
| 35 | +Note: As different terminals have different font by default so the right vertical alignment may not be aligned well. |
| 36 | +You will have to change your font accordingly to make it work. |
34 | 37 |
|
35 | 38 | Basic Example: |
36 | 39 |
|
37 | 40 | Box := box.New(box.Config{Px: 2, Py: 5, Type: "Single", Color: "Cyan"}) |
38 | 41 | Box.Print("Box CLI Maker", "Highly Customized Terminal Box Maker") |
39 | 42 |
|
40 | 43 | You can specify and change the options by changing the above Config struct. |
41 | | -If "Style" isn't provided in box.Config struct then by default it will be "Single". |
42 | | -
|
43 | | -You can customize and change the TitlePos to Inside, Top, Bottom and ContentAlign to Left, Right and Center. |
44 | | -By default TitlePos is Inside and ContentAlign is Left. |
45 | 44 |
|
46 | 45 | Box := box.New(box.Config{Px: 2, Py: 5, Type: "Single", TitlePos: "Top", ContentAlign: "Left"}) |
47 | 46 |
|
48 | | -If you want the string representation of the Box then you can just use String() method of the Box: |
| 47 | +You can also customize and change the TitlePos to Inside, Top, Bottom and ContentAlign to Left, Right and Center. |
| 48 | +By default TitlePos is Inside, ContentAlign is Left and Style is Single. |
49 | 49 |
|
50 | | -If you want the Box to be printed correctly irrespective of it will form the correct color or not on Windows then you will have to add Box.Output |
51 | | -as the passing stream to Fprintf(), Fprintln() and etc to the passing stream functions: |
| 50 | +You can also use the String() method for the string representation of the Box. |
52 | 51 |
|
53 | | -if runtime.GOOS == "windows" { |
54 | | - fmt.Fprintf(box.Output, box_str) |
55 | | -} |
| 52 | +If you want the Box to be printed correctly irrespective of if it will form the correct Color or not on Windows (as Windows Console only supports 16 Colors) then you will have to add Box.Output |
| 53 | +as the passing stream to stream based functions: |
56 | 54 |
|
57 | | -Box := box.New(box.Config{Px: 2, Py: 5, Type: "Single", Color: "Cyan"}) |
58 | | -b := Box.String("Box CLI Maker", "Highly Customized Terminal Box Maker") |
59 | | -... // use it afterwards |
| 55 | +fmt.Fprintf(box.Output, boxStr) |
60 | 56 |
|
61 | | -If you do not want the title and lines to be there then you can just leave i.e. put an empty in the both places.const |
| 57 | +Box := box.New(box.Config{Px: 2, Py: 5, Type: "Single", Color: "Cyan"}) |
| 58 | +boxStr := Box.String("Box CLI Maker", "Highly Customized Terminal Box Maker") |
62 | 59 |
|
63 | | -The following two will not be applicable for terminals which don't have 24 bit support i.e. True Color ANSI Code. |
64 | | -If used then the color effect will not be there. |
| 60 | +The Custom Color option will not be applicable for terminals which don't have 24 bit support i.e. True Color ANSI Code. |
| 61 | +If it is used then the Color effect will not be there. |
65 | 62 |
|
66 | | -RBG Uint Example: |
| 63 | +RGB Uint Example: |
67 | 64 |
|
68 | 65 | Box := box.New(box.Config{Px: 2, Py: 5, Type: "Single", Color: uint(0x34562f)}) |
69 | 66 | Box.Print("Box CLI Maker", "Highly Customized Terminal Box Maker") |
70 | 67 |
|
71 | 68 | Note: Uint must be in a range of [0x000000, 0xFFFFFF] else it will panic. |
72 | 69 |
|
73 | | -
|
74 | | -RBG [3]uint Example: |
| 70 | +RGB [3]uint Example: |
75 | 71 |
|
76 | 72 | Box := box.New(box.Config{Px: 2, Py: 5, Type: "Single", Color: [3]uint{23, 56, 78}}) |
77 | 73 | Box.Print("Box CLI Maker", "Highly Customized Terminal Box Maker") |
78 | 74 |
|
79 | 75 | Note: [3]uint array elements must be in a range of [0x0, 0xFF] else it will panic. |
80 | 76 |
|
81 | | -
|
82 | | -You can even make your custom Box Style by using box.Box struct: |
| 77 | +You can even make your custom Box Style by using struct box.Box: |
83 | 78 |
|
84 | 79 | config := box.Config{Px: 2, Py: 3, Type: "", TitlePos: "Inside"} |
85 | 80 | boxNew := box.Box{TopRight: "*", TopLeft: "*", BottomRight: "*", BottomLeft: "*", Horizontal: "-", Vertical: "|", Config: config} |
86 | | -... // use it afterwards |
87 | 81 | */ |
88 | | - |
89 | 82 | package box |
0 commit comments