added version 5.2.2

piccolomo · Sep 24, 2022 · 63125c9 · 63125c9
1 parent b080e23
commit 63125c9
Show file tree

Hide file tree

Showing 73 changed files with 3,802 additions and 2,549 deletions.
diff --git a/README.md b/README.md
@@ -1,45 +1,54 @@
 <p align="left">  <img src="https://raw.githubusercontent.com/piccolomo/plotext/master/data/logo.png" /></p>
 
-`plotext` plots **directly on terminal**
-- it allows for [scatter](https://github.com/piccolomo/plotext/blob/master/readme/basic.md#scatter-plot), [line](https://github.com/piccolomo/plotext/blob/master/readme/basic.md#line-plot), [bar](https://github.com/piccolomo/plotext/blob/master/readme/bar.md#simple-bar-plot), [histogram](https://github.com/piccolomo/plotext/blob/master/readme/bar.md#histogram-plot), [error](https://github.com/piccolomo/plotext/blob/master/readme/other.md#error-plot) and [date-time](https://github.com/piccolomo/plotext/blob/master/readme/datetime.md#datetime-plot) plots (including [candlestick](https://github.com/piccolomo/plotext/blob/master/readme/datetime.md#candlestick-plot)),
-- it can also [plot images](https://github.com/piccolomo/plotext/blob/master/readme/image.md#image-plot) (including [GIFs](https://github.com/piccolomo/plotext/blob/master/readme/image.md#gif-plot)) and [stream video](https://github.com/piccolomo/plotext/blob/master/readme/video.md#video-plot) with audio (including [YouTube](https://github.com/piccolomo/plotext/blob/master/readme/video.md#play-youtube)),
+`plotext` **plots directly on terminal**
+- it allows for [scatter](https://github.com/piccolomo/plotext/blob/master/readme/basic.md#scatter-plot), [line](https://github.com/piccolomo/plotext/blob/master/readme/basic.md#line-plot), [bar](https://github.com/piccolomo/plotext/blob/master/readme/bar.md#simple-bar-plot), [histogram](https://github.com/piccolomo/plotext/blob/master/readme/bar.md#histogram-plot) and [date-time](https://github.com/piccolomo/plotext/blob/master/readme/datetime.md#datetime-plot) plots (including [candlestick](https://github.com/piccolomo/plotext/blob/master/readme/datetime.md#candlestick-plot)),
+- it can also plot [error bars](https://github.com/piccolomo/plotext/blob/master/readme/other.md#error-plot), [confusion matrices](https://github.com/piccolomo/plotext/blob/master/readme/matrix.md#confusion-matrix), and add extra [text](https://github.com/piccolomo/plotext/blob/master/readme/other.md#text-plot), [lines](https://github.com/piccolomo/plotext/blob/master/readme/other.md#line-plot) and [shapes](https://github.com/piccolomo/plotext/blob/master/readme/other.md#shape-plot) to the plot, 
+- you could use it to [plot images](https://github.com/piccolomo/plotext/blob/master/readme/image.md#image-plot) (including [GIFs](https://github.com/piccolomo/plotext/blob/master/readme/image.md#gif-plot)) and [stream video](https://github.com/piccolomo/plotext/blob/master/readme/video.md#video-plot) with audio (including [YouTube](https://github.com/piccolomo/plotext/blob/master/readme/video.md#play-youtube)),
 - it has **no dependencies** (except for optional dependencies for image/video plotting),
 - it provides a simple [command line tool](https://github.com/piccolomo/plotext/blob/master/readme/utilities.md#command-line-tool),
 - it can [save plots](https://github.com/piccolomo/plotext/blob/master/readme/utilities.md#useful-functions) as text or as colored `html`,
-- it provides a tool to [color strings](https://github.com/piccolomo/plotext/blob/master/readme/utilities.md#colored-text)
+- it provides a tool to [color strings](https://github.com/piccolomo/plotext/blob/master/readme/utilities.md#colored-text).
 
 ![subplots](https://raw.githubusercontent.com/piccolomo/plotext/master/data/subplots.png)
-image code [here](https://github.com/piccolomo/plotext/blob/master/readme/subplots.md)
+image code [here](https://github.com/piccolomo/plotext/blob/master/readme/subplots.md#subplots)
 
 
 ## Install
 - `pip install plotext` for normal installation,
-- `pip install plotext --upgrade` to upgrade to the latest version,
+- `pip install plotext --upgrade` to upgrade to the latest PyPi version,
 - `pip install "plotext[image]"` to install the optional dependency for **image plotting** (including GIFs),
 - `pip install "plotext[video]"` to install the optional dependencies for **video rendering**, which will also allow to plot images,
+- `pip install "plotext[completion]"` to allow TAB completion in the [command line tool](https://github.com/piccolomo/plotext/blob/master/readme/utilities.md#command-line-tool) (under development),
 - `pip install git+https://github.com/piccolomo/plotext`, to install the [GitHub version](https://github.com/piccolomo/plotext), if more updated and you feel courageous,
    - `pip install "plotext[image] @ git+https://github.com/piccolomo/plotext.git"` to include image plotting dependencies,
    - `pip install "plotext[video] @ git+https://github.com/piccolomo/plotext.git"` to include video plotting dependencies,
-- the optional packages are `pillow` (for image plotting), `opencv-python` (for video rendering), `ffpyplayer` (to stream audio), `pafy` and `youtube-dl` (to stream YouTube),
--  use the function `test()` to quickly test (up to image rendering) your newly installed version of `plotext`.
+   - `pip install "plotext[completion] @ git+https://github.com/piccolomo/plotext.git"` to include the TAB completion dependency,
+- the optional packages are `pillow` (for image plotting), `opencv-python` (for video rendering), `ffpyplayer` (to stream audio), `pafy` and `youtube-dl` (to stream YouTube), `shtab` (for TAB completion),
+- use the function `test()` to quickly test (up to image rendering) your newly installed version of `plotext`: any issue report is very welcomed. This function will download and finally remove a test image.
+- created and tested in Ubuntu 22.04 and Python 3.10,
+
+
 
 ## Guide
 
+
 #### Main Plots
 - [Basic Plots](https://github.com/piccolomo/plotext/blob/master/readme/basic.md)
 - [Bar Plots](https://github.com/piccolomo/plotext/blob/master/readme/bar.md)
 - [Datetime Plots](https://github.com/piccolomo/plotext/blob/master/readme/datetime.md)
 - [Other Plots](https://github.com/piccolomo/plotext/blob/master/readme/other.md)
 
-#### 2D Plots
-- [Image Plots](https://github.com/piccolomo/plotext/blob/master/readme/image.md)
-- [Play Videos](https://github.com/piccolomo/plotext/blob/master/readme/video.md)
-
 #### Plotting Utilities
 - [Settings](https://github.com/piccolomo/plotext/blob/master/readme/settings.md)
 - [Aspect](https://github.com/piccolomo/plotext/blob/master/readme/aspect.md)
 - [Subplots](https://github.com/piccolomo/plotext/blob/master/readme/subplots.md)
 
+#### 2D Plots
+- [Matrix Plots](https://github.com/piccolomo/plotext/blob/master/readme/matrix.md)
+- [Image Plots](https://github.com/piccolomo/plotext/blob/master/readme/image.md)
+- [Play Videos](https://github.com/piccolomo/plotext/blob/master/readme/video.md)
+
+
 #### Other Resources
 - [Utilities](https://github.com/piccolomo/plotext/blob/master/readme/utilities.md)
 - [Environments](https://github.com/piccolomo/plotext/blob/master/readme/environments.md)

diff --git a/data/bar_data.txt b/data/bar_data.txt
diff --git a/data/candlestick.png b/data/candlestick.png
diff --git a/data/cat.jpg b/data/cat.jpg
diff --git a/data/cmatrix.png b/data/cmatrix.png
diff --git a/data/color-codes.png b/data/color-codes.png
diff --git a/data/command-tool.png b/data/command-tool.png
diff --git a/data/data.txt b/data/data.txt
diff --git a/data/error.png b/data/error.png
diff --git a/data/eventplot.png b/data/eventplot.png
diff --git a/data/homer-rendered.gif b/data/homer-rendered.gif
diff --git a/data/homer.gif b/data/homer.gif
diff --git a/data/image.png b/data/image.png
diff --git a/data/indicator.png b/data/indicator.png
diff --git a/data/integer-codes.png b/data/integer-codes.png
diff --git a/data/labelled-bar.png b/data/labelled-bar.png
diff --git a/data/extralines.png → data/line.png b/data/extralines.png → data/line.png
diff --git a/data/markers.png b/data/markers.png
diff --git a/data/matplotlib.png b/data/matplotlib.png
diff --git a/data/matrix.png b/data/matrix.png
diff --git a/data/moonwalk.mp4 b/data/moonwalk.mp4
diff --git a/data/rich.gif b/data/rich.gif
diff --git a/data/scatter-tool.png b/data/scatter-tool.png
diff --git a/data/shapes.png b/data/shapes.png
diff --git a/data/simple-bar.png b/data/simple-bar.png
diff --git a/data/simple-multiple-bar.png b/data/simple-multiple-bar.png
diff --git a/data/simple-stacked-bar.png b/data/simple-stacked-bar.png
diff --git a/data/stream.gif b/data/stream.gif
diff --git a/data/styles.png b/data/styles.png
diff --git a/data/subplots.png b/data/subplots.png
diff --git a/data/text.png b/data/text.png
diff --git a/data/themes.png b/data/themes.png
diff --git a/data/ticks.png b/data/ticks.png
diff --git a/data/tkinter.png b/data/tkinter.png
diff --git a/plotext/__init__.py b/plotext/__init__.py
@@ -1,58 +1,7 @@
 """\nplotext plots directly on terminal"""
 
 __name__ = "plotext"
-__version__ = "5.1.0"
-
-from plotext._core import *
-from plotext._test import test
-
-
-def themes():
-    import plotext as plt
-    from plotext._utility import themes
-    from math import sqrt, ceil
-    themes = list(themes.keys())[::]
-    l = len(themes)
-    rows = int(sqrt(l))
-    cols = ceil(l / rows)
-    y1 = plt.sin(periods = 1)
-    y2 = [-el for el in plt.sin(periods = 1)]
-    plt.clf()
-    plt.subplots(rows, cols)
-    for row in range(1, rows + 1):
-        for col in range(1, cols + 1):
-            i = (row - 1) * cols + col - 1
-            if i < l:
-                plt.subplot(row, col)
-                plt.theme(themes[i])
-                plt.title(themes[i])
-                plt.scatter(y1); plt.scatter(y2)
-    plt.show()
-    plt.clf()
-
-def markers():
-    import plotext as plt
-    from plotext._utility import marker_codes, hd_symbols
-    from math import sqrt, ceil
-    markers = list(hd_symbols.keys())[::-1] + list(marker_codes.keys())
-    l = len(markers)
-    rows = int(sqrt(l))
-    cols = ceil(l / rows)
-    y = plt.sin(1)
-    plt.clf(); plt.theme('pro'); plt.xfrequency(0); plt.yfrequency(0); plt.frame(1)
-    plt.subplots(rows, cols)
-    plt.frame(0)
-    for row in range(1, rows + 1):
-        for col in range(1, cols + 1):
-            i = (row - 1) * cols + col - 1
-            if i < l:
-                plt.subplot(row, col)
-                plt.frame(1)
-                default = ' [default]' if markers[i] == 'hd' else ''
-                plt.title(markers[i] + default)
-                plt.scatter(y, marker = markers[i])
-                plt.ticks_style('bold')
-                #plt.ticks_color(plt._utility.title_color)
-    plt.show()
-    plt.clf()
+__version__ = "5.2.2"
 
+from ._core import *
+from .plotext_cli import build_parser
diff --git a/plotext/__main__.py b/plotext/__main__.py
@@ -0,0 +1,2 @@
+from .plotext_cli import main
+main()