plotille 5.0.0__tar.gz → 6.0.1__tar.gz

{plotille-5.0.0 → plotille-6.0.1}/PKG-INFO

@@ -1,33 +1,27 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: plotille
-Version: 5.0.0
+Version: 6.0.1
 Summary: Plot in the terminal using braille dots.
-Home-page: https://github.com/tammoippen/plotille
-License: MIT
 Keywords: plot,scatter,histogram,terminal,braille,unicode,timeseries
 Author: Tammo Ippen
-Author-email: tammo.ippen@posteo.de
-Requires-Python: >=3.7,<4.0
+Author-email: Tammo Ippen <tammo.ippen@posteo.de>
+License-Expression: MIT
 Classifier: Environment :: Console
-Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Topic :: Terminals
+Requires-Python: >=3.10, <4
+Project-URL: Homepage, https://github.com/tammoippen/plotille
 Project-URL: Repository, https://github.com/tammoippen/plotille
 Description-Content-Type: text/markdown
 
@@ -37,14 +31,15 @@ Description-Content-Type: text/markdown
 
 [![CI](https://github.com/tammoippen/plotille/actions/workflows/CI.yml/badge.svg)](https://github.com/tammoippen/plotille/actions/workflows/CI.yml)
 [![codecov](https://codecov.io/gh/tammoippen/plotille/branch/master/graph/badge.svg?token=OGWI832JNM)](https://codecov.io/gh/tammoippen/plotille)
-[![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)
-[![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)
-[![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)
+[![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)
+[![Tested PyPy Versions](https://img.shields.io/badge/pypy-3.11-brightgreen.svg)](https://img.shields.io/badge/pypy-3.11-brightgreen.svg)
 [![PyPi version](https://img.shields.io/pypi/v/plotille.svg)](https://pypi.python.org/pypi/plotille)
 [![Downloads](https://pepy.tech/badge/plotille/month)](https://pepy.tech/project/plotille)
 [![PyPi license](https://img.shields.io/pypi/l/plotille.svg)](https://pypi.python.org/pypi/plotille)
+[![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)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
 
-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.
+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.
 
 Install:
 
@@ -59,7 +54,7 @@ Similar to other libraries:
 - like [termgraph](https://github.com/sgeisler/termgraph) (not on pypi), but very different style.
 - like [terminalplot](https://github.com/kressi/terminalplot), but with braille, X/Y-axis, histogram, linear interpolation.
 
-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`.
+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`.
 
 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
 
@@ -75,11 +70,11 @@ In [3]: X = np.sort(np.random.normal(size=1000))
 
 ### Figure
 
-To construct plots the recomended way is to use a `Figure`:
+To construct plots the recommended way is to use a `Figure`:
 
 ```python
-In [12]: plotille.Figure?
-Init signature: plotille.Figure()
+In [4]: plotille.Figure?
+Init signature: plotille.Figure() -> None
 Docstring:
 Figure class to compose multiple plots.
 
@@ -87,17 +82,16 @@ Within a Figure you can easily compose many plots, assign labels to plots
 and define the properties of the underlying Canvas. Possible properties that
 can be defined are:
 
-    width, height: int    Define the number of characters in X / Y direction
-                          which are used for plotting.
-    x_limits: float       Define the X limits of the reference coordinate system,
-                          that will be plottered.
-    y_limits: float       Define the Y limits of the reference coordinate system,
-                          that will be plottered.
-    color_mode: str       Define the used color mode. See `plotille.color()`.
-    with_colors: bool     Define, whether to use colors at all.
-    background: multiple  Define the background color.
-    x_label, y_label: str Define the X / Y axis label.
-```
+    width, height: int           Define the number of characters in X / Y direction
+                                 which are used for plotting.
+    x_limits: DataValue          Define the X limits of the reference coordinate system,
+                                 that will be plotted.
+    y_limits: DataValue          Define the Y limits of the reference coordinate system,
+                                 that will be plotted.
+    color_mode: str              Define the used color mode. See `plotille.color()`.
+    with_colors: bool            Define, whether to use colors at all.
+    background: ColorDefinition  Define the background color.
+    x_label, y_label: str        Define the X / Y axis label.```
 
 Basically, you create a `Figure`, define the properties and add your plots. Using the `show()` function, the `Figure` generates the plot using a new canvas:
 
@@ -164,44 +158,47 @@ There are some utility functions for fast graphing of single plots.
 In [4]: plotille.plot?
 Signature:
 plotille.plot(
-    X,
-    Y,
-    width=80,
-    height=40,
-    X_label='X',
-    Y_label='Y',
-    linesep=os.linesep,
-    interp='linear',
-    x_min=None,
-    x_max=None,
-    y_min=None,
-    y_max=None,
-    lc=None,
-    bg=None,
-    color_mode='names',
-    origin=True,
-    marker=None,
-)
+    X: Sequence[float | int] | Sequence[datetime.datetime],
+    Y: Sequence[float | int] | Sequence[datetime.datetime],
+    width: int = 80,
+    height: int = 40,
+    X_label: str = 'X',
+    Y_label: str = 'Y',
+    linesep: str = '\n',
+    interp: Optional[Literal['linear']] = 'linear',
+    x_min: float | int | datetime.datetime | None = None,
+    x_max: float | int | datetime.datetime | None = None,
+    y_min: float | int | datetime.datetime | None = None,
+    y_max: float | int | datetime.datetime | None = None,
+    lc: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    bg: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    color_mode: Literal['names', 'byte', 'rgb'] = 'names',
+    origin: bool = True,
+    marker: str | None = None,
+) -> str
 Docstring:
 Create plot with X , Y values and linear interpolation between points
 
 Parameters:
     X: List[float]         X values.
     Y: List[float]         Y values. X and Y must have the same number of entries.
-    width: int             The number of characters for the width (columns) of the canvas.
-    hight: int             The number of characters for the hight (rows) of the canvas.
+    width: int             The number of characters for the width (columns) of the
+                           canvas.
+    height: int            The number of characters for the hight (rows) of the
+                           canvas.
     X_label: str           Label for X-axis.
-    Y_label: str           Label for Y-axis. max 8 characters.
-    linesep: str           The requested line seperator. default: os.linesep
+    Y_label: str           Label for Y-axis. max 8 characters.    linesep: str           The requested line separator. default: os.linesep
+    linesep: str           The requested line separator. default: os.linesep
     interp: Optional[str]  Specify interpolation; values None, 'linear'
     x_min, x_max: float    Limits for the displayed X values.
     y_min, y_max: float    Limits for the displayed Y values.
-    lc: multiple           Give the line color.
-    bg: multiple           Give the background color.
-    color_mode: str        Specify color input mode; 'names' (default), 'byte' or 'rgb'
-                           see plotille.color.__docs__
+    lc: ColorDefinition           Give the line color.
+    bg: ColorDefinition           Give the background color.
+    color_mode: ColorMode        Specify color input mode; 'names' (default), 'byte' or
+                           'rgb' see plotille.color.__docs__
     origin: bool           Whether to print the origin. default: True
-    marker: str            Instead of braille dots set a marker char for actual values.
+    marker: str            Instead of braille dots set a marker char for actual
+                           values.
 
 Returns:
     str: plot over `X`, `Y`.
@@ -217,23 +214,23 @@ In [5]: print(plotille.plot(X, np.sin(X), height=30, width=60))
 In [6]: plotille.scatter?
 Signature:
 plotille.scatter(
-    X,
-    Y,
-    width=80,
-    height=40,
-    X_label='X',
-    Y_label='Y',
-    linesep='\n',
-    x_min=None,
-    x_max=None,
-    y_min=None,
-    y_max=None,
-    lc=None,
-    bg=None,
-    color_mode='names',
-    origin=True,
-    marker=None,
-)
+    X: Sequence[float | int] | Sequence[datetime.datetime],
+    Y: Sequence[float | int] | Sequence[datetime.datetime],
+    width: int = 80,
+    height: int = 40,
+    X_label: str = 'X',
+    Y_label: str = 'Y',
+    linesep: str = '\n',
+    x_min: float | int | datetime.datetime | None = None,
+    x_max: float | int | datetime.datetime | None = None,
+    y_min: float | int | datetime.datetime | None = None,
+    y_max: float | int | datetime.datetime | None = None,
+    lc: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    bg: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    color_mode: Literal['names', 'byte', 'rgb'] = 'names',
+    origin: bool = True,
+    marker: str | None = None,
+) -> str
 Docstring:
 Create scatter plot with X , Y values
 
@@ -243,17 +240,19 @@ Basically plotting without interpolation:
 Parameters:
     X: List[float]       X values.
     Y: List[float]       Y values. X and Y must have the same number of entries.
-    width: int           The number of characters for the width (columns) of the canvas.
-    hight: int           The number of characters for the hight (rows) of the canvas.
+    width: int           The number of characters for the width (columns) of the
+                         canvas.
+    height: int          The number of characters for the hight (rows) of the
+                         canvas.    X_label: str         Label for X-axis.
     X_label: str         Label for X-axis.
     Y_label: str         Label for Y-axis. max 8 characters.
-    linesep: str         The requested line seperator. default: os.linesep
+    linesep: str         The requested line separator. default: os.linesep
     x_min, x_max: float  Limits for the displayed X values.
     y_min, y_max: float  Limits for the displayed Y values.
-    lc: multiple         Give the line color.
-    bg: multiple         Give the background color.
-    color_mode: str      Specify color input mode; 'names' (default), 'byte' or 'rgb'
-                         see plotille.color.__docs__
+    lc: ColorDefinition         Give the line color.
+    bg: ColorDefinition         Give the background color.
+    color_mode: ColorMode      Specify color input mode; 'names' (default), 'byte' or
+                         'rgb' see plotille.color.__docs__
     origin: bool         Whether to print the origin. default: True
     marker: str          Instead of braille dots set a marker char.
 
@@ -273,15 +272,15 @@ Inspired by [crappyhist](http://kevinastraight.x10host.com/2013/12/28/python-his
 In [8]: plotille.hist?
 Signature:
 plotille.hist(
-    X,
-    bins=40,
-    width=80,
-    log_scale=False,
-    linesep='\n',
-    lc=None,
-    bg=None,
-    color_mode='names',
-)
+    X: Sequence[float | int] | Sequence[datetime.datetime],
+    bins: int = 40,
+    width: int = 80,
+    log_scale: bool = False,
+    linesep: str = '\n',
+    lc: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    bg: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    color_mode: Literal['names', 'byte', 'rgb'] = 'names',
+) -> str
 Docstring:
 Create histogram over `X` from left to right
 
@@ -293,11 +292,11 @@ Parameters:
     bins: int            The number of bins to put X entries in (rows).
     width: int           The number of characters for the width (columns).
     log_scale: bool      Scale the histogram with `log` function.
-    linesep: str         The requested line seperator. default: os.linesep
-    lc: multiple         Give the line color.
-    bg: multiple         Give the background color.
-    color_mode: str      Specify color input mode; 'names' (default), 'byte' or 'rgb'
-                         see plotille.color.__docs__
+    linesep: str         The requested line separator. default: os.linesep
+    lc: ColorDefinition         Give the line color.
+    bg: ColorDefinition         Give the background color.
+    color_mode: ColorMode      Specify color input mode; 'names' (default), 'byte' or
+                         'rgb' see plotille.color.__docs__
 
 Returns:
     str: histogram over `X` from left to right.
@@ -319,30 +318,32 @@ only expose access to aggregated values (counts for each bin / bucket).
 In [8]: plotille.hist_aggregated?
 Signature:
 plotille.hist_aggregated(
-    counts,
-    bins,
-    width=80,
-    log_scale=False,
-    linesep='\n',
-    lc=None,
-    bg=None,
-    color_mode='names',
-)
+    counts: list[int],
+    bins: Sequence[float],
+    width: int = 80,
+    log_scale: bool = False,
+    linesep: str = '\n',
+    lc: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    bg: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    color_mode: Literal['names', 'byte', 'rgb'] = 'names',
+    meta: plotille._data_metadata.DataMetadata | None = None,
+) -> str
 Docstring:
 Create histogram for aggregated data.
 
 Parameters:
-    counts: List[int]    Counts for each bucket.
-    bins: List[float]    Limits for the bins for the provided counts: limits for
-                         bin `i` are `[bins[i], bins[i+1])`.
-                         Hence, `len(bins) == len(counts) + 1`.
-    width: int           The number of characters for the width (columns).
-    log_scale: bool      Scale the histogram with `log` function.
-    linesep: str         The requested line seperator. default: os.linesep
-    lc: multiple         Give the line color.
-    bg: multiple         Give the background color.
-    color_mode: str      Specify color input mode; 'names' (default), 'byte' or 'rgb'
-                         see plotille.color.__docs__
+    counts: List[int]         Counts for each bucket.
+    bins: List[float]         Limits for the bins for the provided counts: limits for
+                              bin `i` are `[bins[i], bins[i+1])`.
+                              Hence, `len(bins) == len(counts) + 1`.
+    width: int                The number of characters for the width (columns).
+    log_scale: bool           Scale the histogram with `log` function.
+    linesep: str              The requested line separator. default: os.linesep
+    lc: ColorDefinition       Give the line color.
+    bg: ColorDefinition       Give the background color.
+    color_mode: ColorMode     Specify color input mode; 'names' (default), 'byte' or
+                              'rgb' see plotille.color.__docs__
+    meta: DataMetadata | None For conversion of datetime values.
 Returns:
     str: histogram over `X` from left to right.
 
@@ -365,21 +366,21 @@ There is also another more 'usual' histogram function available:
 In [10]: plotille.histogram?
 Signature:
 plotille.histogram(
-    X,
-    bins=160,
-    width=80,
-    height=40,
-    X_label='X',
-    Y_label='Counts',
-    linesep='\n',
-    x_min=None,
-    x_max=None,
-    y_min=None,
-    y_max=None,
-    lc=None,
-    bg=None,
-    color_mode='names',
-)
+    X: Sequence[float | int] | Sequence[datetime.datetime],
+    bins: int = 160,
+    width: int = 80,
+    height: int = 40,
+    X_label: str = 'X',
+    Y_label: str = 'Counts',
+    linesep: str = '\n',
+    x_min: float | int | datetime.datetime | None = None,
+    x_max: float | int | datetime.datetime | None = None,
+    y_min: float | int | datetime.datetime | None = None,
+    y_max: float | int | datetime.datetime | None = None,
+    lc: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    bg: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    color_mode: Literal['names', 'byte', 'rgb'] = 'names',
+) -> str
 Docstring:
 Create histogram over `X`
 
@@ -393,13 +394,13 @@ Parameters:
     height: int          The number of characters for the height (rows).
     X_label: str         Label for X-axis.
     Y_label: str         Label for Y-axis. max 8 characters.
-    linesep: str         The requested line seperator. default: os.linesep
+    linesep: str         The requested line separator. default: os.linesep
     x_min, x_max: float  Limits for the displayed X values.
     y_min, y_max: float  Limits for the displayed Y values.
-    lc: multiple         Give the line color.
-    bg: multiple         Give the background color.
-    color_mode: str      Specify color input mode; 'names' (default), 'byte' or 'rgb'
-                         see plotille.color.__docs__
+    lc: ColorDefinition         Give the line color.
+    bg: ColorDefinition         Give the background color.
+    color_mode: ColorMode      Specify color input mode; 'names' (default), 'byte' or
+                         'rgb' see plotille.color.__docs__
 
 Returns:
     str: histogram over `X`.
@@ -417,39 +418,42 @@ The underlying plotting area is modeled as the `Canvas` class:
 In [12]:  plotille.Canvas?
 Init signature:
 plotille.Canvas(
-    width,
-    height,
-    xmin=0,
-    ymin=0,
-    xmax=1,
-    ymax=1,
-    background=None,
-    **color_kwargs,
-)
+    width: int,
+    height: int,
+    xmin: Union[float, int] = 0,
+    ymin: Union[float, int] = 0,
+    xmax: Union[float, int] = 1,
+    ymax: Union[float, int] = 1,
+    background: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    **color_kwargs: Any,
+) -> None
 Docstring:
 A canvas object for plotting braille dots
 
 A Canvas object has a `width` x `height` characters large canvas, in which it
 can plot indivitual braille point, lines out of braille points, rectangles,...
-Since a full braille character has 2 x 4 dots (⣿), the canvas has `width` * 2, `height` * 4
-dots to plot into in total.
+Since a full braille character has 2 x 4 dots (⣿), the canvas has `width` * 2,
+`height` * 4 dots to plot into in total.
 
 It maintains two coordinate systems: a reference system with the limits (xmin, ymin)
 in the lower left corner to (xmax, ymax) in the upper right corner is transformed
-into the canvas discrete, i.e. dots, coordinate system (0, 0) to (`width` * 2, `height` * 4).
-It does so transparently to clients of the Canvas, i.e. all plotting functions
-only accept coordinates in the reference system. If the coordinates are outside
-the reference system, they are not plotted.
+into the canvas discrete, i.e. dots, coordinate system (0, 0) to (`width` * 2,
+`height` * 4). It does so transparently to clients of the Canvas, i.e. all plotting
+functions only accept coordinates in the reference system. If the coordinates are
+outside the reference system, they are not plotted.
 Init docstring:
 Initiate a Canvas object
 
 Parameters:
-    width: int            The number of characters for the width (columns) of the canvas.
-    hight: int            The number of characters for the hight (rows) of the canvas.
+    width: int            The number of characters for the width (columns) of
+                          the canvas.
+    height: int           The number of characters for the hight (rows) of the
+                          canvas.
     xmin, ymin: float     Lower left corner of reference system.
     xmax, ymax: float     Upper right corner of reference system.
     background: multiple  Background color of the canvas.
-    **color_kwargs:       More arguments to the color-function. See `plotille.color()`.
+    **color_kwargs:       More arguments to the color-function.
+                          See `plotille.color()`.
 
 Returns:
     Canvas object
@@ -461,7 +465,15 @@ _point:_
 
 ```python
 In [11]: plotille.Canvas.point?
-Signature: plotille.Canvas.point(self, x, y, set_=True, color=None, marker=None)
+Signature:
+plotille.Canvas.point(
+    self,
+    x: Union[float, int],
+    y: Union[float, int],
+    set_: bool = True,
+    color: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    marker: str | None = None,
+) -> None
 Docstring:
 Put a point into the canvas at (x, y) [reference coordinate system]
 
@@ -477,7 +489,16 @@ _line:_
 
 ```python
 In [14]: plotille.Canvas.line?
-Signature: plotille.Canvas.line(self, x0, y0, x1, y1, set_=True, color=None)
+Signature:
+plotille.Canvas.line(
+    self,
+    x0: Union[float, int],
+    y0: Union[float, int],
+    x1: Union[float, int],
+    y1: Union[float, int],
+    set_: bool = True,
+    color: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+) -> None
 Docstring:
 Plot line between point (x0, y0) and (x1, y1) [reference coordinate system].
 
@@ -492,9 +513,20 @@ _rect:_
 
 ```python
 In [15]: plotille.Canvas.rect?
-Signature: plotille.Canvas.rect(self, xmin, ymin, xmax, ymax, set_=True, color=None)
+Signature:
+plotille.Canvas.rect(
+    self,
+    xmin: Union[float, int],
+    ymin: Union[float, int],
+    xmax: Union[float, int],
+    ymax: Union[float, int],
+    set_: bool = True,
+    color: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+) -> None
 Docstring:
-Plot rectangle with bbox (xmin, ymin) and (xmax, ymax) [reference coordinate system].
+Plot rectangle with bbox (xmin, ymin) and (xmax, ymax).
+
+In the reference coordinate system.
 
 Parameters:
     xmin, ymin: float  Lower left corner of rectangle.
@@ -507,7 +539,15 @@ _text:_
 
 ```python
 In [16]: plotille.Canvas.text?
-Signature: plotille.Canvas.text(self, x, y, text, set_=True, color=None)
+Signature:
+plotille.Canvas.text(
+    self,
+    x: Union[float, int],
+    y: Union[float, int],
+    text: str,
+    set_: bool = True,
+    color: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+) -> None
 Docstring:
 Put some text into the canvas at (x, y) [reference coordinate system]
 
@@ -526,11 +566,12 @@ In [17]: plotille.Canvas.braille_image?
 Signature:
 plotille.Canvas.braille_image(
     self,
-    pixels,
-    threshold=127,
-    inverse=False,
-    set_=True,
-)
+    pixels: Sequence[int],
+    threshold: int = 127,
+    inverse: bool = False,
+    color: Union[str, int, ColorNames, tuple[int, int, int], Sequence[int], NoneType] = None,
+    set_: bool = True,
+) -> None
 Docstring:
 Print an image using braille dots into the canvas.
 
@@ -553,6 +594,7 @@ Parameters:
     threshold: float      All pixels above this threshold will be
                           drawn.
     inverse: bool         Whether to invert the image.
+    color: multiple       Color of the point.
     set_: bool            Whether to plot or remove the dots.
 ```
 
@@ -560,7 +602,12 @@ _image:_
 
 ```python
 In [18]: plotille.Canvas.image?
-Signature: plotille.Canvas.image(self, pixels, set_=True)
+Signature:
+plotille.Canvas.image(
+    self,
+    pixels: Sequence[tuple[int, int, int] | Sequence[int] | None],
+    set_: bool = True,
+) -> None
 Docstring:
 Print an image using background colors into the canvas.
 
@@ -588,12 +635,12 @@ _plot:_
 
 ```python
 In [16]: plotille.Canvas.plot?
-Signature: plotille.Canvas.plot(self, linesep='\n')
+Signature: plotille.Canvas.plot(self, linesep: str = '\n') -> str
 Docstring:
 Transform canvas into `print`-able string
 
 Parameters:
-    linesep: str  The requested line seperator. default: os.linesep
+    linesep: str  The requested line separator. default: os.linesep
 
 Returns:
     unicode: The canvas as a string.