plotille 5.0.0__tar.gz → 6.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of plotille might be problematic. Click here for more details.

Files changed (24) hide show
  1. {plotille-5.0.0 → plotille-6.0.0}/PKG-INFO +30 -31
  2. {plotille-5.0.0 → plotille-6.0.0}/README.md +21 -15
  3. {plotille-5.0.0 → plotille-6.0.0}/plotille/__init__.py +12 -16
  4. {plotille-5.0.0 → plotille-6.0.0}/plotille/_canvas.py +134 -67
  5. {plotille-5.0.0 → plotille-6.0.0}/plotille/_cmaps.py +44 -31
  6. plotille-6.0.0/plotille/_cmaps_data.py +1601 -0
  7. {plotille-5.0.0 → plotille-6.0.0}/plotille/_colors.py +175 -114
  8. plotille-6.0.0/plotille/_data_metadata.py +103 -0
  9. {plotille-5.0.0 → plotille-6.0.0}/plotille/_dots.py +48 -32
  10. plotille-6.0.0/plotille/_figure.py +982 -0
  11. plotille-6.0.0/plotille/_figure_data.py +295 -0
  12. plotille-6.0.0/plotille/_graphs.py +373 -0
  13. {plotille-5.0.0 → plotille-6.0.0}/plotille/_input_formatter.py +83 -51
  14. plotille-6.0.0/plotille/_util.py +92 -0
  15. {plotille-5.0.0 → plotille-6.0.0}/plotille/data.py +37 -28
  16. plotille-6.0.0/pyproject.toml +147 -0
  17. plotille-5.0.0/LICENSE.txt +0 -21
  18. plotille-5.0.0/plotille/_cmaps_data.py +0 -1592
  19. plotille-5.0.0/plotille/_figure.py +0 -602
  20. plotille-5.0.0/plotille/_figure_data.py +0 -218
  21. plotille-5.0.0/plotille/_graphs.py +0 -243
  22. plotille-5.0.0/plotille/_util.py +0 -131
  23. plotille-5.0.0/pyproject.toml +0 -60
  24. plotille-5.0.0/setup.py +0 -26
{plotille-5.0.0 → plotille-6.0.0}/PKG-INFO RENAMED
@@ -1,33 +1,27 @@
1
- Metadata-Version: 2.1
1
+ Metadata-Version: 2.4
2
2
  Name: plotille
3
- Version: 5.0.0
3
+ Version: 6.0.0
4
4
  Summary: Plot in the terminal using braille dots.
5
- Home-page: https://github.com/tammoippen/plotille
6
- License: MIT
7
5
  Keywords: plot,scatter,histogram,terminal,braille,unicode,timeseries
8
6
  Author: Tammo Ippen
9
- Author-email: tammo.ippen@posteo.de
10
- Requires-Python: >=3.7,<4.0
7
+ Author-email: Tammo Ippen <tammo.ippen@posteo.de>
8
+ License-Expression: MIT
11
9
  Classifier: Environment :: Console
12
- Classifier: Intended Audience :: Science/Research
13
10
  Classifier: License :: OSI Approved :: MIT License
11
+ Classifier: Intended Audience :: Science/Research
14
12
  Classifier: Programming Language :: Python
15
13
  Classifier: Programming Language :: Python :: 3
16
- Classifier: Programming Language :: Python :: 3.7
17
- Classifier: Programming Language :: Python :: 3.8
18
- Classifier: Programming Language :: Python :: 3.9
19
14
  Classifier: Programming Language :: Python :: 3.10
20
15
  Classifier: Programming Language :: Python :: 3.11
21
- Classifier: Programming Language :: Python :: 3
22
- Classifier: Programming Language :: Python :: 3.10
23
- Classifier: Programming Language :: Python :: 3.11
24
- Classifier: Programming Language :: Python :: 3.7
25
- Classifier: Programming Language :: Python :: 3.8
26
- Classifier: Programming Language :: Python :: 3.9
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Programming Language :: Python :: 3.14
27
19
  Classifier: Programming Language :: Python :: Implementation :: CPython
28
20
  Classifier: Programming Language :: Python :: Implementation :: PyPy
29
21
  Classifier: Topic :: Scientific/Engineering :: Visualization
30
22
  Classifier: Topic :: Terminals
23
+ Requires-Python: >=3.10, <4
24
+ Project-URL: Homepage, https://github.com/tammoippen/plotille
31
25
  Project-URL: Repository, https://github.com/tammoippen/plotille
32
26
  Description-Content-Type: text/markdown
33
27
 
@@ -37,14 +31,14 @@ Description-Content-Type: text/markdown
37
31
 
38
32
  [![CI](https://github.com/tammoippen/plotille/actions/workflows/CI.yml/badge.svg)](https://github.com/tammoippen/plotille/actions/workflows/CI.yml)
39
33
  [![codecov](https://codecov.io/gh/tammoippen/plotille/branch/master/graph/badge.svg?token=OGWI832JNM)](https://codecov.io/gh/tammoippen/plotille)
40
- [![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/tammoippen/plotille.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/tammoippen/plotille/context:python)
41
- [![Tested CPython Versions](https://img.shields.io/badge/cpython-3.7%2C%203.8%2C%203.9%2C%203.10%2C%203.11-brightgreen.svg)](https://img.shields.io/badge/cpython-3.7%2C%203.8%2C%203.9%2C%203.10%2C%203.11-brightgreen.svg)
42
- [![Tested PyPy Versions](https://img.shields.io/badge/pypy-3.8%2C%203.9-brightgreen.svg)](https://img.shields.io/badge/pypy-3.8%2C%203.9-brightgreen.svg)
34
+ [![Tested CPython Versions](https://img.shields.io/badge/cpython-3.10%2C%203.11%2C%203.12%2C%203.13%2C%203.14-brightgreen.svg)](https://img.shields.io/badge/cpython-3.10%2C%203.11%2C%203.12%2C%203.13%203.14-brightgreen.svg)
35
+ [![Tested PyPy Versions](https://img.shields.io/badge/3.11-brightgreen.svg)](https://img.shields.io/badge/pypy-3.11-brightgreen.svg)
43
36
  [![PyPi version](https://img.shields.io/pypi/v/plotille.svg)](https://pypi.python.org/pypi/plotille)
44
37
  [![Downloads](https://pepy.tech/badge/plotille/month)](https://pepy.tech/project/plotille)
45
38
  [![PyPi license](https://img.shields.io/pypi/l/plotille.svg)](https://pypi.python.org/pypi/plotille)
39
+ [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
46
40
 
47
- Plots, scatter plots, histograms and heatmaps in the terminal using braille dots, and foreground and background colors - with no dependancies. Make complex figures using the Figure class or make fast and simple plots using graphing function - similar to a very small sibling to matplotlib. Or use the canvas to plot dots, lines and images yourself.
41
+ Plots, scatter plots, histograms and heatmaps in the terminal using braille dots, and foreground and background colors - with no dependencies. Make complex figures using the Figure class or make fast and simple plots using graphing function - similar to a very small sibling to matplotlib. Or use the canvas to plot dots, lines and images yourself.
48
42
 
49
43
  Install:
50
44
 
@@ -59,7 +53,7 @@ Similar to other libraries:
59
53
  - like [termgraph](https://github.com/sgeisler/termgraph) (not on pypi), but very different style.
60
54
  - like [terminalplot](https://github.com/kressi/terminalplot), but with braille, X/Y-axis, histogram, linear interpolation.
61
55
 
62
- Basic support for timeseries plotting is provided with release 3.2: for any `X` or `Y` values you can also add `datetime.datetime`, `pendulum.datetime` or `numpy.datetime64` values. Labels are generated respecting the difference of `x_limits` and `y_limits`.
56
+ Basic support for timeseries plotting is provided with release 3.2: for any `X` or `Y` values you can also add `datetime.datetime` or `numpy.datetime64` values. Labels are generated respecting the difference of `x_limits` and `y_limits`.
63
57
 
64
58
  Support for heatmaps using background colors for figures and displaying images binary with braille, or in color with background colors using the canvas - provided with release 4.0
65
59
 
@@ -75,7 +69,7 @@ In [3]: X = np.sort(np.random.normal(size=1000))
75
69
 
76
70
  ### Figure
77
71
 
78
- To construct plots the recomended way is to use a `Figure`:
72
+ To construct plots the recommended way is to use a `Figure`:
79
73
 
80
74
  ```python
81
75
  In [12]: plotille.Figure?
@@ -189,10 +183,10 @@ Parameters:
189
183
  X: List[float] X values.
190
184
  Y: List[float] Y values. X and Y must have the same number of entries.
191
185
  width: int The number of characters for the width (columns) of the canvas.
192
- hight: int The number of characters for the hight (rows) of the canvas.
186
+ height: int The number of characters for the height (rows) of the canvas.
193
187
  X_label: str Label for X-axis.
194
188
  Y_label: str Label for Y-axis. max 8 characters.
195
- linesep: str The requested line seperator. default: os.linesep
189
+ linesep: str The requested line separator. default: os.linesep
196
190
  interp: Optional[str] Specify interpolation; values None, 'linear'
197
191
  x_min, x_max: float Limits for the displayed X values.
198
192
  y_min, y_max: float Limits for the displayed Y values.
@@ -244,10 +238,10 @@ Parameters:
244
238
  X: List[float] X values.
245
239
  Y: List[float] Y values. X and Y must have the same number of entries.
246
240
  width: int The number of characters for the width (columns) of the canvas.
247
- hight: int The number of characters for the hight (rows) of the canvas.
241
+ height: int The number of characters for the height (rows) of the canvas.
248
242
  X_label: str Label for X-axis.
249
243
  Y_label: str Label for Y-axis. max 8 characters.
250
- linesep: str The requested line seperator. default: os.linesep
244
+ linesep: str The requested line separator. default: os.linesep
251
245
  x_min, x_max: float Limits for the displayed X values.
252
246
  y_min, y_max: float Limits for the displayed Y values.
253
247
  lc: multiple Give the line color.
@@ -293,7 +287,7 @@ Parameters:
293
287
  bins: int The number of bins to put X entries in (rows).
294
288
  width: int The number of characters for the width (columns).
295
289
  log_scale: bool Scale the histogram with `log` function.
296
- linesep: str The requested line seperator. default: os.linesep
290
+ linesep: str The requested line separator. default: os.linesep
297
291
  lc: multiple Give the line color.
298
292
  bg: multiple Give the background color.
299
293
  color_mode: str Specify color input mode; 'names' (default), 'byte' or 'rgb'
@@ -338,7 +332,7 @@ Parameters:
338
332
  Hence, `len(bins) == len(counts) + 1`.
339
333
  width: int The number of characters for the width (columns).
340
334
  log_scale: bool Scale the histogram with `log` function.
341
- linesep: str The requested line seperator. default: os.linesep
335
+ linesep: str The requested line separator. default: os.linesep
342
336
  lc: multiple Give the line color.
343
337
  bg: multiple Give the background color.
344
338
  color_mode: str Specify color input mode; 'names' (default), 'byte' or 'rgb'
@@ -393,7 +387,7 @@ Parameters:
393
387
  height: int The number of characters for the height (rows).
394
388
  X_label: str Label for X-axis.
395
389
  Y_label: str Label for Y-axis. max 8 characters.
396
- linesep: str The requested line seperator. default: os.linesep
390
+ linesep: str The requested line separator. default: os.linesep
397
391
  x_min, x_max: float Limits for the displayed X values.
398
392
  y_min, y_max: float Limits for the displayed Y values.
399
393
  lc: multiple Give the line color.
@@ -445,7 +439,7 @@ Initiate a Canvas object
445
439
 
446
440
  Parameters:
447
441
  width: int The number of characters for the width (columns) of the canvas.
448
- hight: int The number of characters for the hight (rows) of the canvas.
442
+ height: int The number of characters for the height (rows) of the canvas.
449
443
  xmin, ymin: float Lower left corner of reference system.
450
444
  xmax, ymax: float Upper right corner of reference system.
451
445
  background: multiple Background color of the canvas.
@@ -593,7 +587,7 @@ Docstring:
593
587
  Transform canvas into `print`-able string
594
588
 
595
589
  Parameters:
596
- linesep: str The requested line seperator. default: os.linesep
590
+ linesep: str The requested line separator. default: os.linesep
597
591
 
598
592
  Returns:
599
593
  unicode: The canvas as a string.
@@ -643,3 +637,8 @@ In [29]: print(cvs.plot())
643
637
 
644
638
  [![Stargazers over time](https://starchart.cc/tammoippen/plotille.svg)](https://starchart.cc/tammoippen/plotille)
645
639
 
640
+ ## Sponsoring the project
641
+
642
+ If you like the project and want to buy me a coffee, feel free to send some coins ;)
643
+
644
+ [<img src="https://api.gitsponsors.com/api/badge/img?id=105019800" height="20">](https://api.gitsponsors.com/api/badge/link?p=gkBol1u2+g2pjgZGRaDLy4k0XbPDRXdPWJWnueCUGo/wcSsqyE8nr+n9nvqfeuqXee6JhLARGZS5bP0ZvorS7y6t4INyHLtTrprYh9c+MYkqAZeSqNIf7WL0ZRTI070RVQA3L9QW9IZNFlMbulW+BQ==)
{plotille-5.0.0 → plotille-6.0.0}/README.md RENAMED
@@ -4,14 +4,14 @@
4
4
 
5
5
  [![CI](https://github.com/tammoippen/plotille/actions/workflows/CI.yml/badge.svg)](https://github.com/tammoippen/plotille/actions/workflows/CI.yml)
6
6
  [![codecov](https://codecov.io/gh/tammoippen/plotille/branch/master/graph/badge.svg?token=OGWI832JNM)](https://codecov.io/gh/tammoippen/plotille)
7
- [![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/tammoippen/plotille.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/tammoippen/plotille/context:python)
8
- [![Tested CPython Versions](https://img.shields.io/badge/cpython-3.7%2C%203.8%2C%203.9%2C%203.10%2C%203.11-brightgreen.svg)](https://img.shields.io/badge/cpython-3.7%2C%203.8%2C%203.9%2C%203.10%2C%203.11-brightgreen.svg)
9
- [![Tested PyPy Versions](https://img.shields.io/badge/pypy-3.8%2C%203.9-brightgreen.svg)](https://img.shields.io/badge/pypy-3.8%2C%203.9-brightgreen.svg)
7
+ [![Tested CPython Versions](https://img.shields.io/badge/cpython-3.10%2C%203.11%2C%203.12%2C%203.13%2C%203.14-brightgreen.svg)](https://img.shields.io/badge/cpython-3.10%2C%203.11%2C%203.12%2C%203.13%203.14-brightgreen.svg)
8
+ [![Tested PyPy Versions](https://img.shields.io/badge/3.11-brightgreen.svg)](https://img.shields.io/badge/pypy-3.11-brightgreen.svg)
10
9
  [![PyPi version](https://img.shields.io/pypi/v/plotille.svg)](https://pypi.python.org/pypi/plotille)
11
10
  [![Downloads](https://pepy.tech/badge/plotille/month)](https://pepy.tech/project/plotille)
12
11
  [![PyPi license](https://img.shields.io/pypi/l/plotille.svg)](https://pypi.python.org/pypi/plotille)
12
+ [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
13
13
 
14
- Plots, scatter plots, histograms and heatmaps in the terminal using braille dots, and foreground and background colors - with no dependancies. Make complex figures using the Figure class or make fast and simple plots using graphing function - similar to a very small sibling to matplotlib. Or use the canvas to plot dots, lines and images yourself.
14
+ Plots, scatter plots, histograms and heatmaps in the terminal using braille dots, and foreground and background colors - with no dependencies. Make complex figures using the Figure class or make fast and simple plots using graphing function - similar to a very small sibling to matplotlib. Or use the canvas to plot dots, lines and images yourself.
15
15
 
16
16
  Install:
17
17
 
@@ -26,7 +26,7 @@ Similar to other libraries:
26
26
  - like [termgraph](https://github.com/sgeisler/termgraph) (not on pypi), but very different style.
27
27
  - like [terminalplot](https://github.com/kressi/terminalplot), but with braille, X/Y-axis, histogram, linear interpolation.
28
28
 
29
- Basic support for timeseries plotting is provided with release 3.2: for any `X` or `Y` values you can also add `datetime.datetime`, `pendulum.datetime` or `numpy.datetime64` values. Labels are generated respecting the difference of `x_limits` and `y_limits`.
29
+ Basic support for timeseries plotting is provided with release 3.2: for any `X` or `Y` values you can also add `datetime.datetime` or `numpy.datetime64` values. Labels are generated respecting the difference of `x_limits` and `y_limits`.
30
30
 
31
31
  Support for heatmaps using background colors for figures and displaying images binary with braille, or in color with background colors using the canvas - provided with release 4.0
32
32
 
@@ -42,7 +42,7 @@ In [3]: X = np.sort(np.random.normal(size=1000))
42
42
 
43
43
  ### Figure
44
44
 
45
- To construct plots the recomended way is to use a `Figure`:
45
+ To construct plots the recommended way is to use a `Figure`:
46
46
 
47
47
  ```python
48
48
  In [12]: plotille.Figure?
@@ -156,10 +156,10 @@ Parameters:
156
156
  X: List[float] X values.
157
157
  Y: List[float] Y values. X and Y must have the same number of entries.
158
158
  width: int The number of characters for the width (columns) of the canvas.
159
- hight: int The number of characters for the hight (rows) of the canvas.
159
+ height: int The number of characters for the height (rows) of the canvas.
160
160
  X_label: str Label for X-axis.
161
161
  Y_label: str Label for Y-axis. max 8 characters.
162
- linesep: str The requested line seperator. default: os.linesep
162
+ linesep: str The requested line separator. default: os.linesep
163
163
  interp: Optional[str] Specify interpolation; values None, 'linear'
164
164
  x_min, x_max: float Limits for the displayed X values.
165
165
  y_min, y_max: float Limits for the displayed Y values.
@@ -211,10 +211,10 @@ Parameters:
211
211
  X: List[float] X values.
212
212
  Y: List[float] Y values. X and Y must have the same number of entries.
213
213
  width: int The number of characters for the width (columns) of the canvas.
214
- hight: int The number of characters for the hight (rows) of the canvas.
214
+ height: int The number of characters for the height (rows) of the canvas.
215
215
  X_label: str Label for X-axis.
216
216
  Y_label: str Label for Y-axis. max 8 characters.
217
- linesep: str The requested line seperator. default: os.linesep
217
+ linesep: str The requested line separator. default: os.linesep
218
218
  x_min, x_max: float Limits for the displayed X values.
219
219
  y_min, y_max: float Limits for the displayed Y values.
220
220
  lc: multiple Give the line color.
@@ -260,7 +260,7 @@ Parameters:
260
260
  bins: int The number of bins to put X entries in (rows).
261
261
  width: int The number of characters for the width (columns).
262
262
  log_scale: bool Scale the histogram with `log` function.
263
- linesep: str The requested line seperator. default: os.linesep
263
+ linesep: str The requested line separator. default: os.linesep
264
264
  lc: multiple Give the line color.
265
265
  bg: multiple Give the background color.
266
266
  color_mode: str Specify color input mode; 'names' (default), 'byte' or 'rgb'
@@ -305,7 +305,7 @@ Parameters:
305
305
  Hence, `len(bins) == len(counts) + 1`.
306
306
  width: int The number of characters for the width (columns).
307
307
  log_scale: bool Scale the histogram with `log` function.
308
- linesep: str The requested line seperator. default: os.linesep
308
+ linesep: str The requested line separator. default: os.linesep
309
309
  lc: multiple Give the line color.
310
310
  bg: multiple Give the background color.
311
311
  color_mode: str Specify color input mode; 'names' (default), 'byte' or 'rgb'
@@ -360,7 +360,7 @@ Parameters:
360
360
  height: int The number of characters for the height (rows).
361
361
  X_label: str Label for X-axis.
362
362
  Y_label: str Label for Y-axis. max 8 characters.
363
- linesep: str The requested line seperator. default: os.linesep
363
+ linesep: str The requested line separator. default: os.linesep
364
364
  x_min, x_max: float Limits for the displayed X values.
365
365
  y_min, y_max: float Limits for the displayed Y values.
366
366
  lc: multiple Give the line color.
@@ -412,7 +412,7 @@ Initiate a Canvas object
412
412
 
413
413
  Parameters:
414
414
  width: int The number of characters for the width (columns) of the canvas.
415
- hight: int The number of characters for the hight (rows) of the canvas.
415
+ height: int The number of characters for the height (rows) of the canvas.
416
416
  xmin, ymin: float Lower left corner of reference system.
417
417
  xmax, ymax: float Upper right corner of reference system.
418
418
  background: multiple Background color of the canvas.
@@ -560,7 +560,7 @@ Docstring:
560
560
  Transform canvas into `print`-able string
561
561
 
562
562
  Parameters:
563
- linesep: str The requested line seperator. default: os.linesep
563
+ linesep: str The requested line separator. default: os.linesep
564
564
 
565
565
  Returns:
566
566
  unicode: The canvas as a string.
@@ -609,3 +609,9 @@ In [29]: print(cvs.plot())
609
609
  ## Stargazers over time
610
610
 
611
611
  [![Stargazers over time](https://starchart.cc/tammoippen/plotille.svg)](https://starchart.cc/tammoippen/plotille)
612
+
613
+ ## Sponsoring the project
614
+
615
+ If you like the project and want to buy me a coffee, feel free to send some coins ;)
616
+
617
+ [<img src="https://api.gitsponsors.com/api/badge/img?id=105019800" height="20">](https://api.gitsponsors.com/api/badge/link?p=gkBol1u2+g2pjgZGRaDLy4k0XbPDRXdPWJWnueCUGo/wcSsqyE8nr+n9nvqfeuqXee6JhLARGZS5bP0ZvorS7y6t4INyHLtTrprYh9c+MYkqAZeSqNIf7WL0ZRTI070RVQA3L9QW9IZNFlMbulW+BQ==)
{plotille-5.0.0 → plotille-6.0.0}/plotille/__init__.py RENAMED
@@ -1,9 +1,6 @@
1
- # -*- coding: utf-8 -*-
2
- from __future__ import absolute_import, division, print_function, unicode_literals
3
-
4
1
  # The MIT License
5
2
 
6
- # Copyright (c) 2017 - 2022 Tammo Ippen, tammo.ippen@posteo.de
3
+ # Copyright (c) 2017 - 2025 Tammo Ippen, tammo.ippen@posteo.de
7
4
 
8
5
  # Permission is hereby granted, free of charge, to any person obtaining a copy
9
6
  # of this software and associated documentation files (the "Software"), to deal
@@ -29,17 +26,16 @@ from ._colors import color, hsl
29
26
  from ._figure import Figure
30
27
  from ._graphs import hist, hist_aggregated, histogram, plot, scatter
31
28
 
32
-
33
29
  __all__ = [
34
- 'Canvas',
35
- 'color',
36
- 'Colormap',
37
- 'Figure',
38
- 'hist',
39
- 'hist_aggregated',
40
- 'histogram',
41
- 'hsl',
42
- 'ListedColormap',
43
- 'plot',
44
- 'scatter',
30
+ "Canvas",
31
+ "Colormap",
32
+ "Figure",
33
+ "ListedColormap",
34
+ "color",
35
+ "hist",
36
+ "hist_aggregated",
37
+ "histogram",
38
+ "hsl",
39
+ "plot",
40
+ "scatter",
45
41
  ]