# Sonne
**Sonne** is a Python module that provides a lot of possibilities to make your terminal look beautiful.
# Setup
```python
pip install sonne
```
```python
python -m sonne
```
# Documentation
## Text
**Sonne** has a ``Text`` class that you can use wherever strings are accepted and customize it with parameters.
Example usage:
```python
import sonne
x = sonne.Text("Hello, World!", fg="blue", bg="white", style="italic").styled()
print(x)
```
This will print colored and styled ``Hello, World!`` in the terminal.
Also you can use like this:
```python
import sonne
x = sonne.Text("Hello,", "World!", fg="blue", bg="white", style="italic").styled()
print(x)
```
This will also print colored and styled ``Hello, World!`` in the terminal.
[Click to see a list of colors and styles.](#styles)
## Progress
**Sonne** has a ``Progress`` class where you can create customizable progress bars.
Example usage:
```python
import sonne
total = 50
progressbar = sonne.Progress(total=total, desc="Download", length=40)
for i in range(total):
progressbar.update(i)
time.sleep(0.1)
```
Output:
## Tree
**Sonne** has a ``Tree`` function which can generate a customizable tree view.
Example usage:
```python
import sonne
x = ["A", ["B", ["C"], ["D"]]]
sonne.Tree(x, depth=0, islast=True)
```
Output:
```
┗━━ A
┃━━ B
┗━━ C
┗━━ D
```
## JSON
**Sonne** will automatically highlight expressions in JSON texts, such as integers, floats,booleans, arrays, strings etc. With ``JSON`` function.
Example usage:
```python
import sonne
code = """
{
"value": "string",
"value2": 1,
"value3": null,
"array": [2, 3, 5, 7]
}
"""
print(JSON(code))
```
This will print highlighted ``code`` in the terminal.
## Other Functions
``clear()``: Clears the terminal screen.
``typewrite(*text: str, duration)``: Prints strings with typewriter effect.
## Styles
A list of ``Text`` styles in **Sonne**.
| Name | Number |
|-------|---------|
| normal | 0 |
| bold | 1 |
| italic | 3 |
| underlined | 4 |
| reversed | 7 |
| hidden | 8 |
| strike | 9 |
## Colors
A list of the 8-bit ``Text`` colors in **Sonne**.
| Name | Number |
|-------|---------|
| black | 0 |
| red | 1 |
| green | 2 |
| yellow | 3 |
| blue | 4 |
| magenta | 5 |
| cyan | 6 |
| white | 7 |
| brightblack | 8 |
| brightred | 9 |
| brightgreen | 10 |
| brightyellow | 11 |
| brightblue | 12 |
| brightmagenta | 13 |
| brightcyan | 14 |
| brightwhite | 15 |
| grey0 | 16 |
| gray0 | 16 |
| navyblue | 17 |
| darkblue | 18 |
| blue3 | 20 |
| blue1 | 21 |
| darkgreen | 22 |
| deepskyblue4 | 25 |
| dodgerblue3 | 26 |
| dodgerblue2 | 27 |
| green4 | 28 |
| springgreen4 | 29 |
| turquoise4 | 30 |
| deepskyblue3 | 32 |
| dodgerblue1 | 33 |
| green3 | 40 |
| springgreen3 | 41 |
| darkcyan | 36 |
| lightseagreen | 37 |
| deepskyblue2 | 38 |
| deepskyblue1 | 39 |
| springgreen2 | 47 |
| cyan3 | 43 |
| darkturquoise | 44 |
| turquoise2 | 45 |
| green1 | 46 |
| springgreen1 | 48 |
| mediumspringgreen | 49 |
| cyan2 | 50 |
| cyan1 | 51 |
| darkred | 88 |
| deeppink4 | 125 |
| purple4 | 55 |
| purple3 | 56 |
| blueviolet | 57 |
| orange4 | 94 |
| grey37 | 59 |
| gray37 | 59 |
| mediumpurple4 | 60 |
| slateblue3 | 62 |
| royalblue1 | 63 |
| chartreuse4 | 64 |
| darkseagreen4 | 71 |
| paleturquoise4 | 66 |
| steelblue | 67 |
| steelblue3 | 68 |
| cornflowerblue | 69 |
| chartreuse3 | 76 |
| cadetblue | 73 |
| skyblue3 | 74 |
| steelblue1 | 81 |
| palegreen3 | 114 |
| seagreen3 | 78 |
| aquamarine3 | 79 |
| mediumturquoise | 80 |
| chartreuse2 | 112 |
| seagreen2 | 83 |
| seagreen1 | 85 |
| aquamarine1 | 122 |
| darkslategray2 | 87 |
| darkmagenta | 91 |
| darkviolet | 128 |
| purple | 129 |
| lightpink4 | 95 |
| plum4 | 96 |
| mediumpurple3 | 98 |
| slateblue1 | 99 |
| yellow4 | 106 |
| wheat4 | 101 |
| grey53 | 102 |
| gray53 | 102 |
| lightslategrey | 103 |
| lightslategray | 103 |
| mediumpurple | 104 |
| lightslateblue | 105 |
| darkolivegreen3 | 149 |
| darkseagreen | 108 |
| lightskyblue3 | 110 |
| skyblue2 | 111 |
| darkseagreen3 | 150 |
| darkslategray3 | 116 |
| skyblue1 | 117 |
| chartreuse1 | 118 |
| lightgreen | 120 |
| palegreen1 | 156 |
| darkslategray1 | 123 |
| red3 | 160 |
| mediumvioletred | 126 |
| magenta3 | 164 |
| darkorange3 | 166 |
| indianred | 167 |
| hotpink3 | 168 |
| mediumorchid3 | 133 |
| mediumorchid | 134 |
| mediumpurple2 | 140 |
| darkgoldenrod | 136 |
| lightsalmon3 | 173 |
| rosybrown | 138 |
| grey63 | 139 |
| gray63 | 139 |
| mediumpurple1 | 141 |
| gold3 | 178 |
| darkkhaki | 143 |
| navajowhite3 | 144 |
| grey69 | 145 |
| gray69 | 145 |
| lightsteelblue3 | 146 |
| lightsteelblue | 147 |
| yellow3 | 184 |
| darkseagreen2 | 157 |
| lightcyan3 | 152 |
| lightskyblue1 | 153 |
| greenyellow | 154 |
| darkolivegreen2 | 155 |
| darkseagreen1 | 193 |
| paleturquoise1 | 159 |
| deeppink3 | 162 |
| magenta2 | 200 |
| hotpink2 | 169 |
| orchid | 170 |
| mediumorchid1 | 207 |
| orange3 | 172 |
| lightpink3 | 174 |
| pink3 | 175 |
| plum3 | 176 |
| violet | 177 |
| lightgoldenrod3 | 179 |
| tan | 180 |
| mistyrose3 | 181 |
| thistle3 | 182 |
| plum2 | 183 |
| khaki3 | 185 |
| lightgoldenrod2 | 222 |
| lightyellow3 | 187 |
| grey84 | 188 |
| gray84 | 188 |
| lightsteelblue1 | 189 |
| yellow2 | 190 |
| darkolivegreen1 | 192 |
| honeydew2 | 194 |
| lightcyan1 | 195 |
| red1 | 196 |
| deeppink2 | 197 |
| deeppink1 | 199 |
| magenta1 | 201 |
| orangered1 | 202 |
| indianred1 | 204 |
| hotpink | 206 |
| darkorange | 208 |
| salmon1 | 209 |
| lightcoral | 210 |
| palevioletred1 | 211 |
| orchid2 | 212 |
| orchid1 | 213 |
| orange1 | 214 |
| sandybrown | 215 |
| lightsalmon1 | 216 |
| lightpink1 | 217 |
| pink1 | 218 |
| plum1 | 219 |
| gold1 | 220 |
| navajowhite1 | 223 |
| mistyrose1 | 224 |
| thistle1 | 225 |
| yellow1 | 226 |
| lightgoldenrod1 | 227 |
| khaki1 | 228 |
| wheat1 | 229 |
| cornsilk1 | 230 |
| grey100 | 231 |
| gray100 | 231 |
| grey3 | 232 |
| gray3 | 232 |
| grey7 | 233 |
| gray7 | 233 |
| grey11 | 234 |
| gray11 | 234 |
| grey15 | 235 |
| gray15 | 235 |
| grey19 | 236 |
| gray19 | 236 |
| grey23 | 237 |
| gray23 | 237 |
| grey27 | 238 |
| gray27 | 238 |
| grey30 | 239 |
| gray30 | 239 |
| grey35 | 240 |
| gray35 | 240 |
| grey39 | 241 |
| gray39 | 241 |
| grey42 | 242 |
| gray42 | 242 |
| grey46 | 243 |
| gray46 | 243 |
| grey50 | 244 |
| gray50 | 244 |
| grey54 | 245 |
| gray54 | 245 |
| grey58 | 246 |
| gray58 | 246 |
| grey62 | 247 |
| gray62 | 247 |
| grey66 | 248 |
| gray66 | 248 |
| grey70 | 249 |
| gray70 | 249 |
| grey74 | 250 |
| gray74 | 250 |
| grey78 | 251 |
| gray78 | 251 |
| grey82 | 252 |
| gray82 | 252 |
| grey85 | 253 |
| gray85 | 253 |
| grey89 | 254 |
| gray89 | 254 |
| grey93 | 255 |
| gray93 | 255 |
Raw data
{
"_id": null,
"home_page": "https://github.com/sonnelib/sonne",
"name": "sonne",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "Terminal,Style,Color,Terminal Styling",
"author": "Ekin Aksu",
"author_email": "sonnelib@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/24/dd/86e3ff1dc9ab50a5d240899c4c16285e7ebb0171013c8bac4f8d9505b25c/sonne-0.1.4.tar.gz",
"platform": null,
"description": "\r\n\r\n# Sonne\r\n\r\n**Sonne** is a Python module that provides a lot of possibilities to make your terminal look beautiful.\r\n\r\n\r\n\r\n# Setup\r\n\r\n```python\r\npip install sonne\r\n```\r\n```python\r\npython -m sonne\r\n```\r\n\r\n# Documentation\r\n\r\n## Text\r\n\r\n**Sonne** has a ``Text`` class that you can use wherever strings are accepted and customize it with parameters.\r\n\r\nExample usage:\r\n```python\r\nimport sonne\r\n\r\nx = sonne.Text(\"Hello, World!\", fg=\"blue\", bg=\"white\", style=\"italic\").styled()\r\nprint(x)\r\n```\r\nThis will print colored and styled ``Hello, World!`` in the terminal.\r\n\r\nAlso you can use like this:\r\n```python\r\nimport sonne\r\n\r\nx = sonne.Text(\"Hello,\", \"World!\", fg=\"blue\", bg=\"white\", style=\"italic\").styled()\r\nprint(x)\r\n```\r\nThis will also print colored and styled ``Hello, World!`` in the terminal.\r\n\r\n[Click to see a list of colors and styles.](#styles)\r\n\r\n## Progress\r\n\r\n**Sonne** has a ``Progress`` class where you can create customizable progress bars.\r\n\r\nExample usage:\r\n```python\r\nimport sonne\r\n\r\ntotal = 50\r\nprogressbar = sonne.Progress(total=total, desc=\"Download\", length=40)\r\n\r\nfor i in range(total):\r\n progressbar.update(i)\r\n time.sleep(0.1)\r\n```\r\nOutput:\r\n\r\n\r\n\r\n## Tree\r\n\r\n**Sonne** has a ``Tree`` function which can generate a customizable tree view.\r\n\r\nExample usage:\r\n```python\r\nimport sonne\r\n\r\nx = [\"A\", [\"B\", [\"C\"], [\"D\"]]]\r\n\r\nsonne.Tree(x, depth=0, islast=True)\r\n```\r\nOutput:\r\n\r\n```\r\n\u2517\u2501\u2501 A\r\n \u2503\u2501\u2501 B\r\n \u2517\u2501\u2501 C\r\n \u2517\u2501\u2501 D\r\n```\r\n\r\n## JSON\r\n\r\n**Sonne** will automatically highlight expressions in JSON texts, such as integers, floats,booleans, arrays, strings etc. With ``JSON`` function.\r\n\r\nExample usage:\r\n```python\r\nimport sonne\r\n\r\ncode = \"\"\"\r\n{\r\n \"value\": \"string\",\r\n \"value2\": 1,\r\n \"value3\": null,\r\n \"array\": [2, 3, 5, 7]\r\n}\r\n\"\"\"\r\nprint(JSON(code))\r\n```\r\n\r\nThis will print highlighted ``code`` in the terminal.\r\n\r\n## Other Functions\r\n``clear()``: Clears the terminal screen.\r\n\r\n``typewrite(*text: str, duration)``: Prints strings with typewriter effect.\r\n\r\n## Styles\r\n\r\nA list of ``Text`` styles in **Sonne**.\r\n\r\n| Name | Number |\r\n|-------|---------|\r\n| normal | 0 |\r\n| bold | 1 |\r\n| italic | 3 |\r\n| underlined | 4 |\r\n| reversed | 7 |\r\n| hidden | 8 |\r\n| strike | 9 |\r\n\r\n## Colors\r\n\r\nA list of the 8-bit ``Text`` colors in **Sonne**.\r\n\r\n| Name | Number |\r\n|-------|---------|\r\n| black | 0 |\r\n| red | 1 |\r\n| green | 2 |\r\n| yellow | 3 |\r\n| blue | 4 |\r\n| magenta | 5 |\r\n| cyan | 6 |\r\n| white | 7 |\r\n| brightblack | 8 |\r\n| brightred | 9 |\r\n| brightgreen | 10 |\r\n| brightyellow | 11 |\r\n| brightblue | 12 |\r\n| brightmagenta | 13 |\r\n| brightcyan | 14 |\r\n| brightwhite | 15 |\r\n| grey0 | 16 |\r\n| gray0 | 16 |\r\n| navyblue | 17 |\r\n| darkblue | 18 |\r\n| blue3 | 20 |\r\n| blue1 | 21 |\r\n| darkgreen | 22 |\r\n| deepskyblue4 | 25 |\r\n| dodgerblue3 | 26 |\r\n| dodgerblue2 | 27 |\r\n| green4 | 28 |\r\n| springgreen4 | 29 |\r\n| turquoise4 | 30 |\r\n| deepskyblue3 | 32 |\r\n| dodgerblue1 | 33 |\r\n| green3 | 40 |\r\n| springgreen3 | 41 |\r\n| darkcyan | 36 |\r\n| lightseagreen | 37 |\r\n| deepskyblue2 | 38 |\r\n| deepskyblue1 | 39 |\r\n| springgreen2 | 47 |\r\n| cyan3 | 43 |\r\n| darkturquoise | 44 |\r\n| turquoise2 | 45 |\r\n| green1 | 46 |\r\n| springgreen1 | 48 |\r\n| mediumspringgreen | 49 |\r\n| cyan2 | 50 |\r\n| cyan1 | 51 |\r\n| darkred | 88 |\r\n| deeppink4 | 125 |\r\n| purple4 | 55 |\r\n| purple3 | 56 |\r\n| blueviolet | 57 |\r\n| orange4 | 94 |\r\n| grey37 | 59 |\r\n| gray37 | 59 |\r\n| mediumpurple4 | 60 |\r\n| slateblue3 | 62 |\r\n| royalblue1 | 63 |\r\n| chartreuse4 | 64 |\r\n| darkseagreen4 | 71 |\r\n| paleturquoise4 | 66 |\r\n| steelblue | 67 |\r\n| steelblue3 | 68 |\r\n| cornflowerblue | 69 |\r\n| chartreuse3 | 76 |\r\n| cadetblue | 73 |\r\n| skyblue3 | 74 |\r\n| steelblue1 | 81 |\r\n| palegreen3 | 114 |\r\n| seagreen3 | 78 |\r\n| aquamarine3 | 79 |\r\n| mediumturquoise | 80 |\r\n| chartreuse2 | 112 |\r\n| seagreen2 | 83 |\r\n| seagreen1 | 85 |\r\n| aquamarine1 | 122 |\r\n| darkslategray2 | 87 |\r\n| darkmagenta | 91 |\r\n| darkviolet | 128 |\r\n| purple | 129 |\r\n| lightpink4 | 95 |\r\n| plum4 | 96 |\r\n| mediumpurple3 | 98 |\r\n| slateblue1 | 99 |\r\n| yellow4 | 106 |\r\n| wheat4 | 101 |\r\n| grey53 | 102 |\r\n| gray53 | 102 |\r\n| lightslategrey | 103 |\r\n| lightslategray | 103 |\r\n| mediumpurple | 104 |\r\n| lightslateblue | 105 |\r\n| darkolivegreen3 | 149 |\r\n| darkseagreen | 108 |\r\n| lightskyblue3 | 110 |\r\n| skyblue2 | 111 |\r\n| darkseagreen3 | 150 |\r\n| darkslategray3 | 116 |\r\n| skyblue1 | 117 |\r\n| chartreuse1 | 118 |\r\n| lightgreen | 120 |\r\n| palegreen1 | 156 |\r\n| darkslategray1 | 123 |\r\n| red3 | 160 |\r\n| mediumvioletred | 126 |\r\n| magenta3 | 164 |\r\n| darkorange3 | 166 |\r\n| indianred | 167 |\r\n| hotpink3 | 168 |\r\n| mediumorchid3 | 133 |\r\n| mediumorchid | 134 |\r\n| mediumpurple2 | 140 |\r\n| darkgoldenrod | 136 |\r\n| lightsalmon3 | 173 |\r\n| rosybrown | 138 |\r\n| grey63 | 139 |\r\n| gray63 | 139 |\r\n| mediumpurple1 | 141 |\r\n| gold3 | 178 |\r\n| darkkhaki | 143 |\r\n| navajowhite3 | 144 |\r\n| grey69 | 145 |\r\n| gray69 | 145 |\r\n| lightsteelblue3 | 146 |\r\n| lightsteelblue | 147 |\r\n| yellow3 | 184 |\r\n| darkseagreen2 | 157 |\r\n| lightcyan3 | 152 |\r\n| lightskyblue1 | 153 |\r\n| greenyellow | 154 |\r\n| darkolivegreen2 | 155 |\r\n| darkseagreen1 | 193 |\r\n| paleturquoise1 | 159 |\r\n| deeppink3 | 162 |\r\n| magenta2 | 200 |\r\n| hotpink2 | 169 |\r\n| orchid | 170 |\r\n| mediumorchid1 | 207 |\r\n| orange3 | 172 |\r\n| lightpink3 | 174 |\r\n| pink3 | 175 |\r\n| plum3 | 176 |\r\n| violet | 177 |\r\n| lightgoldenrod3 | 179 |\r\n| tan | 180 |\r\n| mistyrose3 | 181 |\r\n| thistle3 | 182 |\r\n| plum2 | 183 |\r\n| khaki3 | 185 |\r\n| lightgoldenrod2 | 222 |\r\n| lightyellow3 | 187 |\r\n| grey84 | 188 |\r\n| gray84 | 188 |\r\n| lightsteelblue1 | 189 |\r\n| yellow2 | 190 |\r\n| darkolivegreen1 | 192 |\r\n| honeydew2 | 194 |\r\n| lightcyan1 | 195 |\r\n| red1 | 196 |\r\n| deeppink2 | 197 |\r\n| deeppink1 | 199 |\r\n| magenta1 | 201 |\r\n| orangered1 | 202 |\r\n| indianred1 | 204 |\r\n| hotpink | 206 |\r\n| darkorange | 208 |\r\n| salmon1 | 209 |\r\n| lightcoral | 210 |\r\n| palevioletred1 | 211 |\r\n| orchid2 | 212 |\r\n| orchid1 | 213 |\r\n| orange1 | 214 |\r\n| sandybrown | 215 |\r\n| lightsalmon1 | 216 |\r\n| lightpink1 | 217 |\r\n| pink1 | 218 |\r\n| plum1 | 219 |\r\n| gold1 | 220 |\r\n| navajowhite1 | 223 |\r\n| mistyrose1 | 224 |\r\n| thistle1 | 225 |\r\n| yellow1 | 226 |\r\n| lightgoldenrod1 | 227 |\r\n| khaki1 | 228 |\r\n| wheat1 | 229 |\r\n| cornsilk1 | 230 |\r\n| grey100 | 231 |\r\n| gray100 | 231 |\r\n| grey3 | 232 |\r\n| gray3 | 232 |\r\n| grey7 | 233 |\r\n| gray7 | 233 |\r\n| grey11 | 234 |\r\n| gray11 | 234 |\r\n| grey15 | 235 |\r\n| gray15 | 235 |\r\n| grey19 | 236 |\r\n| gray19 | 236 |\r\n| grey23 | 237 |\r\n| gray23 | 237 |\r\n| grey27 | 238 |\r\n| gray27 | 238 |\r\n| grey30 | 239 |\r\n| gray30 | 239 |\r\n| grey35 | 240 |\r\n| gray35 | 240 |\r\n| grey39 | 241 |\r\n| gray39 | 241 |\r\n| grey42 | 242 |\r\n| gray42 | 242 |\r\n| grey46 | 243 |\r\n| gray46 | 243 |\r\n| grey50 | 244 |\r\n| gray50 | 244 |\r\n| grey54 | 245 |\r\n| gray54 | 245 |\r\n| grey58 | 246 |\r\n| gray58 | 246 |\r\n| grey62 | 247 |\r\n| gray62 | 247 |\r\n| grey66 | 248 |\r\n| gray66 | 248 |\r\n| grey70 | 249 |\r\n| gray70 | 249 |\r\n| grey74 | 250 |\r\n| gray74 | 250 |\r\n| grey78 | 251 |\r\n| gray78 | 251 |\r\n| grey82 | 252 |\r\n| gray82 | 252 |\r\n| grey85 | 253 |\r\n| gray85 | 253 |\r\n| grey89 | 254 |\r\n| gray89 | 254 |\r\n| grey93 | 255 |\r\n| gray93 | 255 |\r\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Sonne is a Python module that provides a lot of possibilities to make your terminal look beautiful.",
"version": "0.1.4",
"project_urls": {
"Homepage": "https://github.com/sonnelib/sonne"
},
"split_keywords": [
"terminal",
"style",
"color",
"terminal styling"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "24dd86e3ff1dc9ab50a5d240899c4c16285e7ebb0171013c8bac4f8d9505b25c",
"md5": "5e4579506cac1ed31f32d6e109689e4e",
"sha256": "3ff652874736e0a30bf1e9d1035575505099e52d0f18705a2be546ab884e4dd9"
},
"downloads": -1,
"filename": "sonne-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "5e4579506cac1ed31f32d6e109689e4e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 12791,
"upload_time": "2023-08-15T15:06:58",
"upload_time_iso_8601": "2023-08-15T15:06:58.233588Z",
"url": "https://files.pythonhosted.org/packages/24/dd/86e3ff1dc9ab50a5d240899c4c16285e7ebb0171013c8bac4f8d9505b25c/sonne-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-15 15:06:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sonnelib",
"github_project": "sonne",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "sonne"
}
JSON
