plotext-plus 1.0.5__tar.gz → 1.0.8__tar.gz

{plotext_plus-1.0.5 → plotext_plus-1.0.8}/.gitignore

@@ -172,10 +172,10 @@ $RECYCLE.BIN/
 
 # Project specific
 examples/output/
-*.png
+#*.png
 *.jpg
-*.gif
-*.mp4
+#*.gif
+#*.mp4
 *.avi
 *.mov
 temp/

{plotext_plus-1.0.5 → plotext_plus-1.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotext_plus
-Version: 1.0.5
+Version: 1.0.8
 Summary: Modern terminal plotting library with enhanced visual features, themes, and AI integration
 Project-URL: Homepage, https://github.com/ccmitchellusa/plotext_plus
 Project-URL: Repository, https://github.com/ccmitchellusa/plotext_plus.git
@@ -42,18 +42,17 @@ Description-Content-Type: text/markdown
 # 📊 Plotext+ - Modern Terminal Plotting
 
 [![PyPi](https://badge.fury.io/py/plotext_plus.svg)](https://badge.fury.io/py/plotext_plus)
-[![GitHub stars](https://img.shields.io/github/stars/piccolomo/plotext_plus.svg)](https://github.com/ccmitchellusa/plotext_plus/stargazers)
 [![Downloads](https://pepy.tech/badge/plotext_plus/month)](https://pepy.tech/project/plotext_plus)
 [![GitHubIssues](https://img.shields.io/badge/issue_tracking-github-blue.svg)](https://github.com/ccmitchellusa/plotext_plus/issues)
 [![GitTutorial](https://img.shields.io/badge/PR-Welcome-%23FF8300.svg?)](https://github.com/ccmitchellusa/plotext_plus/pulls)
 
-![logo](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/logo.png)
+![logo](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/refs/heads/main/data/logo.png)
 
 **Plotext+ plots directly in your terminal** with stunning visuals, modern APIs, and professional styling.  Plotext+ is a redesigned version of the original [plotext](https://github.com/piccolomo/plotext) library by Savino Piccolomo. New features include an updated API with object oriented features, an MCP server to make the project easily usable with AI & LLM scenarios, new themes and integration with chuk-term to make sure it works in the awesome [mcp-cli](https://github.com/chrishayuk/mcp-cli) by Chris Hay.
 
 ## ✨ Key Features
 
-🎯 **Multiple Plot Types**: [scatter](docs/basic.md#scatter-plot), [line](docs/basic.md#line-plot), [bar](docs/bar.md), [histogram](docs/bar.md#histogram-plot), [candlestick](docs/datetime.md#candlestick-plot), [heatmap](docs/special.md), [confusion matrix](docs/special.md#confusion-matrix), and more
+🎯 **Multiple Plot Types**: [scatter](docs/basic.md#scatter-plot), [line](docs/basic.md#line-plot), [bar](docs/bar.md), [histogram](docs/bar.md#histogram-plot), [candlestick](docs/datetime.md#candlestick-plot), [heatmap](docs/special.md), [confusion matrix](docs/special.md#confusion-matrix), [pie](docs/basic.md#pie-plot), [doughnut](docs/basic.md#doughnut-charts) and more
 
 🎨 **Rich Visuals**: [Banner mode](docs/chart_classes.md), [themes](docs/themes.md), [colored text](docs/utilities.md#colored-text), automatic terminal width detection
 
@@ -65,7 +64,7 @@ Description-Content-Type: text/markdown
 
 ⚡ **Zero Dependencies**: No required dependencies (optional packages for multimedia and AI integration)
 
-![subplots](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/subplots.png)
+![subplots](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/refs/heads/main/data/subplots.png)
 
 ## 🚀 Quick Start
 

{plotext_plus-1.0.5 → plotext_plus-1.0.8}/README.md

@@ -1,18 +1,17 @@
 # 📊 Plotext+ - Modern Terminal Plotting
 
 [![PyPi](https://badge.fury.io/py/plotext_plus.svg)](https://badge.fury.io/py/plotext_plus)
-[![GitHub stars](https://img.shields.io/github/stars/piccolomo/plotext_plus.svg)](https://github.com/ccmitchellusa/plotext_plus/stargazers)
 [![Downloads](https://pepy.tech/badge/plotext_plus/month)](https://pepy.tech/project/plotext_plus)
 [![GitHubIssues](https://img.shields.io/badge/issue_tracking-github-blue.svg)](https://github.com/ccmitchellusa/plotext_plus/issues)
 [![GitTutorial](https://img.shields.io/badge/PR-Welcome-%23FF8300.svg?)](https://github.com/ccmitchellusa/plotext_plus/pulls)
 
-![logo](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/logo.png)
+![logo](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/refs/heads/main/data/logo.png)
 
 **Plotext+ plots directly in your terminal** with stunning visuals, modern APIs, and professional styling.  Plotext+ is a redesigned version of the original [plotext](https://github.com/piccolomo/plotext) library by Savino Piccolomo. New features include an updated API with object oriented features, an MCP server to make the project easily usable with AI & LLM scenarios, new themes and integration with chuk-term to make sure it works in the awesome [mcp-cli](https://github.com/chrishayuk/mcp-cli) by Chris Hay.
 
 ## ✨ Key Features
 
-🎯 **Multiple Plot Types**: [scatter](docs/basic.md#scatter-plot), [line](docs/basic.md#line-plot), [bar](docs/bar.md), [histogram](docs/bar.md#histogram-plot), [candlestick](docs/datetime.md#candlestick-plot), [heatmap](docs/special.md), [confusion matrix](docs/special.md#confusion-matrix), and more
+🎯 **Multiple Plot Types**: [scatter](docs/basic.md#scatter-plot), [line](docs/basic.md#line-plot), [bar](docs/bar.md), [histogram](docs/bar.md#histogram-plot), [candlestick](docs/datetime.md#candlestick-plot), [heatmap](docs/special.md), [confusion matrix](docs/special.md#confusion-matrix), [pie](docs/basic.md#pie-plot), [doughnut](docs/basic.md#doughnut-charts) and more
 
 🎨 **Rich Visuals**: [Banner mode](docs/chart_classes.md), [themes](docs/themes.md), [colored text](docs/utilities.md#colored-text), automatic terminal width detection
 
@@ -24,7 +23,7 @@
 
 ⚡ **Zero Dependencies**: No required dependencies (optional packages for multimedia and AI integration)
 
-![subplots](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/subplots.png)
+![subplots](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/refs/heads/main/data/subplots.png)
 
 ## 🚀 Quick Start
 

{plotext_plus-1.0.5 → plotext_plus-1.0.8}/docs/basic.md

@@ -5,6 +5,7 @@
 - [Line Plot](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/basic.md#line-plot)
 - [Log Plot](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/basic.md#log-plot)
 - [Stem Plot](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/basic.md#stem-plot)
+- [Pie Plot](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/basic.md#pie-plot)
 - [Multiple Data Sets](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/basic.md#multiple-data-sets)
 - [Multiple Axes Plot](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/basic.md#multiple-axes-plot)
 
@@ -23,7 +24,7 @@ plt.title("My First Plot")
 plt.show()
 ```
 
-### Modern Object-Oriented API 
+### Modern Object-Oriented API
 
 ```python
 import plotext_plus as plt
@@ -197,6 +198,149 @@ python3 -c "import plotext_plus as plt; y = plt.sin(); plt.plot(y, fillx = True)
 ![stem](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/stem.png)
 [Main Guide](https://github.com/ccmitchellusa/plotext_plus#guide), [Basic Plots](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/basic.md#basic-plots)
 
+## Pie Plot
+
+For a pie chart visualization use the `pie()` function. Pie charts are ideal for showing proportional data and work best with a small number of segments for better terminal readability.
+
+![pie](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/pie-chart.png)
+
+**Best Practices for Pie Charts**:
+
+- Use full terminal dimensions for optimal resolution: `plt.plotsize(terminal_width, terminal_height - 5)`
+- Limit to 4-6 data segments for clarity in terminal environment
+- Each segment will be rendered with solid block characters and proper aspect ratio
+
+Here is an example:
+
+```python
+import plotext_plus as plt
+
+# Sample data
+labels = ["Python", "JavaScript", "Go", "Rust"]
+values = [45, 30, 15, 10]
+colors = ["blue", "green", "orange", "red"]
+
+# Create pie chart using full terminal dimensions
+terminal_width, terminal_height = plt.terminal_size()
+plt.clear_figure()
+plt.plotsize(terminal_width, terminal_height - 5)
+
+plt.pie(labels, values, colors=colors, title="Programming Languages Usage")
+plt.show()
+```
+
+or directly on terminal:
+
+```console
+python3 -c "import plotext_plus as plt; labels = ['Python', 'JS', 'Go', 'Rust']; values = [45, 30, 15, 10]; w, h = plt.terminal_size(); plt.clear_figure(); plt.plotsize(w, h-5); plt.pie(labels, values, title='Languages'); plt.show()"
+```
+
+**Key Features**:
+
+- **Colored block legend**: Each data label is prefixed with a colored block (█) matching the segment
+- **Percentage display**: Shows both values and percentages in the legend
+- **Dynamic sizing**: Radius automatically adjusts to terminal dimensions
+- **Aspect ratio correction**: Ensures circular appearance across different plot sizes
+- **Gap-free rendering**: Comprehensive scanning ensures solid segment filling
+
+**Parameters**:
+
+- `labels`: List of segment labels
+- `values`: List of corresponding values (will be converted to percentages)
+- `colors`: Optional list of colors for segments (defaults to standard palette)
+- `radius`: Optional custom radius (defaults to optimal size for terminal)
+- `show_values`: Show numeric values in legend (default: True)
+- `show_percentages`: Show percentage values in legend (default: True)
+- `show_values_on_slices`: Display values directly on pie segments (default: False)
+- `title`: Chart title
+
+### Single-Value Pie Charts
+
+Single-value pie charts are perfect for progress indicators, completion rates, and other single-metric visualizations. They show a colored segment for the data value and handle the remainder specially.
+
+![pie single-value](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/multiple-single-value.png)
+
+```python
+import plotext_plus as plt
+
+# Basic single-value pie chart (remainder as spaces)
+plt.clear_figure()
+plt.plotsize(50, 12)
+plt.pie(["Progress", "Remaining"], [75, 25], colors=["green", "default"], 
+       show_values=False, show_percentages=True,
+       title="Project Progress: 75%")
+plt.show()
+
+# Single-value pie with colored remainder
+plt.clear_figure()
+plt.pie(["Complete", "Remaining"], [60, 40], colors=["blue", "default"], 
+       remaining_color="gray",  # Colors the remaining slice
+       show_values=False, show_percentages=True,
+       title="Task Completion: 60%")
+plt.show()
+```
+
+**Key Features**:
+
+- **Smart legend filtering**: Only shows the data value, hides "Remaining" entry by default
+- **Remaining area options**: 
+  - Without `remaining_color`: Remaining area stays as blank spaces
+  - With `remaining_color`: Remaining area gets colored and appears in legend
+- **Perfect for dashboards**: Progress bars, completion meters, utilization rates
+
+### Doughnut Charts
+
+Doughnut charts are pie charts with a hollow center, providing a modern aesthetic and emphasizing the ring structure of the data. The inner radius is automatically set to 1/3 of the outer radius.
+
+![doughnut](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/doughnut-chart.png)
+
+![doughnut single-values](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/doughnut-single-value-comparison.png)
+
+```python
+import plotext_plus as plt
+
+# Basic doughnut chart
+labels = ["Sales", "Marketing", "Support", "Development"]
+values = [40, 25, 15, 20]
+colors = ["blue", "orange", "green", "red"]
+
+plt.clear_figure()
+plt.plotsize(60, 15)
+plt.pie(labels, values, colors=colors, donut=True,
+       show_values=False, show_percentages=True,
+       title="Department Budget - Doughnut Chart")
+plt.show()
+
+# Single-value doughnut for progress indicator
+plt.clear_figure()
+plt.pie(["Completed", "Remaining"], [85, 15], colors=["cyan", "default"], 
+       donut=True, show_values=False, show_percentages=True,
+       title="Project Progress - 85% Complete")
+plt.show()
+
+# Quick doughnut using convenience function
+plt.quick_donut(["Task A", "Task B", "Task C"], [30, 45, 25],
+               colors=["purple", "yellow", "green"],
+               title="Task Distribution")
+```
+
+**Key Features**:
+
+- **Hollow center**: Inner circle remains completely empty (no block characters)
+- **Modern appearance**: Ring structure emphasizes proportional relationships
+- **All pie chart features**: Supports single-value, remaining_color, legends, etc.
+- **Convenience function**: `plt.quick_donut()` for rapid creation
+- **Perfect for**: Progress indicators, resource allocation, modern dashboards
+
+**Additional Parameters for Pie and Doughnut Charts**:
+
+- `donut`: Set to `True` for doughnut chart (hollow center)
+- `remaining_color`: Color for remaining slice in single-value charts (optional)
+
+More documentation can be accessed with `doc.pie()`.
+
+[Main Guide](https://github.com/ccmitchellusa/plotext_plus#guide), [Basic Plots](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/basic.md#basic-plots)
+
 ## Multiple Data Sets
 
 Multiple data sets can be plotted using consecutive plotting functions. The `label` parameter, available in most plotting function, is used to add an entry in the **plot legend**, shown in the upper left corner of the plot canvas.

{plotext_plus-1.0.5 → plotext_plus-1.0.8}/docs/chart_classes.md

@@ -9,6 +9,7 @@
 - [HeatmapChart](#heatmapchart)
 - [MatrixChart](#matrixchart)
 - [StemChart](#stemchart)
+- [PieChart](#piechart)
 - [Chart Class Methods](#chart-class-methods)
 
 [Main Guide](https://github.com/ccmitchellusa/plotext_plus#guide)
@@ -362,6 +363,77 @@ chart.show()
 
 [Main Guide](https://github.com/ccmitchellusa/plotext_plus#guide), [Chart Classes](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/chart_classes.md#chart-classes)
 
+## PieChart
+
+Specialized class for creating pie charts with segment visualization and legend support.
+
+### Constructor
+
+```python
+PieChart(labels, values, colors=None, radius=None, show_values_on_slices=False, use_banners=False, banner_title=None)
+```
+
+### Enhanced Methods
+
+- `show_values_on_slices(enabled=True)` - Display values directly on pie slices
+- `set_radius(radius)` - Adjust the pie chart radius
+
+### Usage Guidelines
+
+⚠️ **Important**: Pie charts should only be used for a **small number of data values** (typically 3-7 categories) due to the limited resolution of terminal displays. Very small segments may not render clearly.
+
+🖥️ **Best Practice**: Pie charts should be rendered using the **full terminal dimensions** whenever possible to maximize clarity and readability. Use functions like `ut.terminal_size()` to get optimal dimensions.
+
+### Example
+
+```python
+import plotext_plus as plt
+from plotext_plus import utilities as ut
+
+# Get full terminal dimensions for optimal display
+terminal_width, terminal_height = ut.terminal_size()
+
+# Market share data (small number of categories)
+companies = ["Apple", "Samsung", "Google", "Others"]
+market_share = [35, 25, 15, 25]
+colors = ["red", "blue", "green", "orange"]
+
+# Create pie chart using full terminal size
+chart = plt.PieChart(companies, market_share, colors=colors,
+                    use_banners=True, banner_title="📊 Market Analysis")
+
+# Set chart to use maximum terminal space
+chart.size(terminal_width, terminal_height - 5)
+
+chart.title("Smartphone Market Share Q3 2024")
+chart.show()
+
+# Example with values on slices
+chart2 = plt.PieChart(companies, market_share, colors=colors,
+                     show_values_on_slices=True,
+                     use_banners=True, banner_title="📊 Detailed View")
+chart2.size(terminal_width, terminal_height - 5)
+chart2.title("Market Share with Values on Slices")
+chart2.show()
+```
+
+### Features
+
+- **Colored legend**: Each legend entry is prefixed with a colored block (█) matching its pie segment
+- **Aspect ratio correction**: Pie charts automatically adjust for terminal character dimensions to appear circular
+- **Gap-free rendering**: Uses advanced sampling algorithms to minimize visual gaps between segments
+- **Full terminal support**: Optimized to use the entire terminal space for maximum clarity
+
+### Tips for Effective Pie Charts
+
+1. **Limit categories**: Use no more than 5-7 categories for best readability
+2. **Combine small values**: Group small segments into an "Others" category
+3. **Use full screen**: Always render at maximum terminal dimensions
+4. **Choose distinct colors**: Use colors that are easily distinguishable in terminal displays
+5. **Consider alternatives**: For many categories or precise comparisons, consider bar charts instead
+
+[Main Guide](https://github.com/ccmitchellusa/plotext_plus#guide), [Chart Classes](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/chart_classes.md#chart-classes)
+
 ## Chart Class Methods
 
 All chart classes inherit these methods from the base `Chart` class:

{plotext_plus-1.0.5 → plotext_plus-1.0.8}/docs/environments.md

@@ -36,7 +36,7 @@ plx.from_matplotlib(fig)
 plx.show()
 ```
 
-![matplotlib](https://raw.githubusercontent.com/ccmitchellusa/plotext/master/data/matplotlib.png)
+![matplotlib](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/matplotlib.png)
 
 These feature is under development: please report any bug or development idea.
 
@@ -131,7 +131,7 @@ Integration with the package `tkinter`, where a test image is downloaded in the
 ```python
 import tkinter as tk
 import plotext_plus as plt
-from plotext._utility import to_rgb, uncolorize
+from plotext_plus._utility import to_rgb, uncolorize
 import tkinter.font as tkfont
 
 image_path = 'cat.jpg'

{plotext_plus-1.0.5 → plotext_plus-1.0.8}/docs/image.md

@@ -23,7 +23,7 @@ To plot an image use the `image_plot(path)` function.
 
 - To save the result **in colors**, as an `html` page, use the function `plt.savefig()`, described [here](https://github.com/ccmitchellusa/plotext_plus/blob/master/docs/utilities.md#useful-functions).
 
-In this example, a [test image](https://raw.githubusercontent.com/ccmitchellusa/plotext/master/data/cat.jpg) is downloaded in the home folder, visualized and finally removed:
+In this example, a [test image](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/refs/heads/main/data/hist.png) is downloaded in the home folder, visualized and finally removed:
 
 ```python
 import plotext_plus as plt
@@ -41,7 +41,7 @@ or directly on terminal:
 python3 -c "import plotext_plus as plt; path = 'cat.jpg'; plt.download(plt.test_image_url, path); plt.image_plot(path); plt.title('A very Cute Cat'); plt.show(); plt.delete_file(path)"
 ```
 
-![image](https://raw.githubusercontent.com/ccmitchellusa/plotext/master/data/image.png)
+![image](https://raw.githubusercontent.com/ccmitchellusa/plotext_plus/master/data/image.png)
 
 More documentation can be accessed with `doc.image_plot()`.
 

{plotext_plus-1.0.5 → plotext_plus-1.0.8}/docs/mcp-server.md

@@ -85,7 +85,9 @@ Available tools:
 - line_plot: Create line plots
 - bar_chart: Create bar charts
 - matrix_plot: Create matrix/heatmap plots
-- quick_scatter/line/bar: Quick chart creation
+- image_plot: Display images as ASCII art
+- play_gif: Play animated GIFs
+- quick_scatter/line/bar/pie: Quick chart creation
 - theme management tools
 - utility functions
 
@@ -147,6 +149,29 @@ async def matrix_plot(
 
 Creates a matrix/heatmap plot from 2D data.
 
+#### image_plot
+
+```python
+async def image_plot(
+    image_path: str, 
+    title: Optional[str] = None, 
+    marker: Optional[str] = None, 
+    style: Optional[str] = None, 
+    fast: bool = False, 
+    grayscale: bool = False
+) -> str
+```
+
+Display an image in the terminal using ASCII art. Supports various image formats and styling options.
+
+#### play_gif
+
+```python
+async def play_gif(gif_path: str) -> str
+```
+
+Play a GIF animation in the terminal. The animation runs automatically without requiring additional show() calls.
+
 ### Chart Class Tools
 
 #### quick_scatter
@@ -188,6 +213,22 @@ async def quick_bar(
 
 Creates a quick bar chart using the chart classes API.
 
+#### quick_pie
+
+```python
+async def quick_pie(
+    labels: List[str], 
+    values: List[Union[int, float]], 
+    colors: Optional[List[str]] = None, 
+    title: Optional[str] = None, 
+    show_values: bool = True, 
+    show_percentages: bool = True,
+    show_values_on_slices: bool = False
+) -> str
+```
+
+Creates a quick pie chart using the chart classes API. Best for small numbers of categories (3-7).
+
 ### Theme Tools
 
 #### get_available_themes
@@ -277,12 +318,20 @@ The plotext_plus MCP server provides ready-to-use prompts via the MCP prompt API
 - **basic_scatter**: Simple scatter plot example
 - **basic_bar_chart**: Bar chart with sample data  
 - **line_plot_with_theme**: Line plot with theme application
+- **basic_pie_chart**: Simple pie chart example with market share data
 
 #### Advanced Plotting Prompts
 
 - **matrix_heatmap**: Correlation matrix visualization
 - **multi_step_workflow**: Complex multi-step analysis workflow
 - **professional_bar_chart**: Styled bar chart with banner mode
+- **pie_chart_styling**: Advanced pie chart with values on slices
+- **pie_chart_comparison**: Multiple pie charts for quarterly comparison
+- **pie_chart_best_practices**: Educational example for data grouping
+- **image_display**: Basic image plotting workflow
+- **gif_animation**: GIF playback example
+- **image_styling**: Advanced image rendering with custom markers
+- **multimedia_showcase**: Complete multimedia demonstration
 
 #### Theme and Styling Prompts
 
@@ -320,6 +369,39 @@ The server provides a configuration resource at `config://plotext` containing:
 }
 ```
 
+### info://plotext
+
+The server also provides comprehensive tool information at `info://plotext` containing:
+
+```python
+{
+    "server_info": {
+        "name": "Plotext Plus MCP Server",
+        "description": "Model Context Protocol server for plotext_plus terminal plotting library",
+        "version": "1.0.0",
+        "capabilities": ["plotting", "theming", "multimedia", "charts"]
+    },
+    "plotting_tools": {
+        "scatter_plot": "Create scatter plots with x/y data points",
+        "line_plot": "Create line plots for time series and continuous data",
+        "bar_chart": "Create bar charts for categorical data", 
+        "matrix_plot": "Create heatmaps from 2D matrix data",
+        "image_plot": "Display images in terminal using ASCII art",
+        "play_gif": "Play animated GIFs in the terminal"
+    },
+    "quick_chart_tools": {
+        "quick_scatter": "Quickly create scatter charts with theming",
+        "quick_line": "Quickly create line charts with theming",
+        "quick_bar": "Quickly create bar charts with theming",
+        "quick_pie": "Quickly create pie charts with custom colors and options"
+    },
+    "usage_tips": {
+        "pie_charts": "Best for 3-7 categories, use full terminal dimensions",
+        "images": "Use fast=True for better performance with large images"
+    }
+}
+```
+
 ## Implementation Details
 
 ### Architecture
@@ -836,6 +918,12 @@ Make a bar chart showing sales data: categories=["Q1","Q2","Q3","Q4"] and values
 Plot a line chart of temperature data over time: x=[1,2,3,4,5,6,7] and y=[20,22,25,28,26,24,21] using the "dark" theme with title "Weekly Temperature".
 ```
 
+**Create a Simple Pie Chart**
+
+```text
+Create a pie chart showing mobile OS market share: categories=['iOS', 'Android', 'Windows', 'Other'], values=[35, 45, 15, 5], colors=['blue', 'green', 'orange', 'gray'] with title 'Mobile OS Market Share'.
+```
+
 ### Advanced Plotting Examples
 
 **Matrix Heatmap Visualization**
@@ -864,6 +952,32 @@ Create a professional-looking bar chart with:
 - Set appropriate plot dimensions
 ```
 
+**Pie Chart with Advanced Features**
+
+```text
+Create a budget pie chart with show_values_on_slices=True: categories=['Housing', 'Food', 'Transport', 'Entertainment'], values=[1200, 400, 300, 200], custom colors, and title 'Monthly Budget Breakdown'.
+```
+
+**Display Image as ASCII Art**
+
+```text
+Display an image in the terminal:
+1. Download a test image using utilities.download()
+2. Display it using image_plot with title 'ASCII Art Demo'
+3. Try both normal and grayscale versions
+4. Clean up the file afterward
+```
+
+**Play Animated GIF**
+
+```text
+Play a GIF animation in terminal:
+1. Download a test GIF file
+2. Play the animation using play_gif
+3. Clean up the file afterward
+Note: The GIF will play automatically
+```
+
 ### Theme and Styling Examples
 
 **Theme Exploration**