Metadata-Version: 2.4
Name: speedtable
Version: 1.0.5
Summary: Ultra-fast terminal table renderer written in C
Home-page: https://github.com/canadaluke888/speedtable
Author: Luke Canada
Author-email: canadaluke888@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: C
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENCE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# âš¡ speedtable

**speedtable** is an ultra-fast, C-based terminal table renderer for Python.  
Designed for large datasets and low-latency rendering â€” with beautiful Rich-style Unicode output.

> ðŸ’¡ Perfect for CLI tools, dataset previews, or any place you need fast + styled tables.

---

## ðŸš€ Features

- Blazing-fast C implementation ðŸ”¥  
- Unicode box-style table formatting (like Richâ€™s `HEAVY_HEAD`)  
- Bold, colored headers with optional column type labels  
- Customizable:
  - Header color  
  - Border color  
  - Body text color  
  - Type label color  
  - Title text and color (italicized, centered above the table)

---

## ðŸ“¦ Installation

```bash
pip install speedtable
```

---

## ðŸ§ª Example Usage

```python
import speedtable

table_data = {
    "columns": [
        {"name": "ID", "type": "int"},
        {"name": "Name", "type": "str"},
        {"name": "Age", "type": "int"}
    ],
    "rows": [
        {"ID": 1, "Name": "Luke", "Age": 21},
        {"ID": 2, "Name": "Joe", "Age": 45},
        {"ID": 3, "Name": "Alice", "Age": 56}
    ]
}

print(speedtable.render_table(
    table_data,
    header_color="green",
    border_color="magenta",
    body_color="white",
    type_color="red",
    title_text="Test Table",
    title_color="cyan"
))
```

---
## ðŸ“· Output
![SpeedTable Demo](https://raw.githubusercontent.com/canadaluke888/speedtable/master/assets/speedtable-demo.png)

---

## ðŸŽ¨ Supported Color Names

| Name             | Description               |
|------------------|---------------------------|
| `black`          | Standard black            |
| `red`            | Standard red              |
| `green`          | Standard green            |
| `yellow`         | Standard yellow           |
| `blue`           | Standard blue             |
| `magenta`        | Standard magenta          |
| `cyan`           | Standard cyan             |
| `white`          | Standard white            |

> âœ¨ Headers are always bold, and titles are always italicized.

---

## ðŸ’¡ Why speedtable?

The Python `rich` library is beautiful, but may be too slow for rendering large tables in CLI environments.  
`speedtable` gives you the same polished aesthetic â€” at native speed.

---

## ðŸ“„ License

MIT Â© [Luke Canada](https://github.com/canadaluke888)
