Metadata-Version: 2.4
Name: jtable
Version: 0.11.8
Summary: Tabulate JSON data and transform them using Jinja templates.
Home-page: https://github.com/vtougne/jtable
Author: Vincent Tougne
Author-email: vtougne@gmail.com
License: MIT
Keywords: json,table,jinja,templating,data transformation
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Provides-Extra: all
Requires-Dist: xmltodict; extra == "all"
Requires-Dist: html-to-json; extra == "all"
Provides-Extra: xmltodict
Requires-Dist: xmltodict; extra == "xmltodict"
Provides-Extra: html-to-json
Requires-Dist: html-to-json; extra == "html-to-json"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: summary

# Jtable

Jtable helps you render tables from key/value sources like JSON, YAML, and Python dictionaries.
It works as a CLI tool, a Jinja filter (usable in Ansible, Django, Flask, etc.), or a Python module.

---

## Features
- Render tables from JSON, YAML, or Python objects
- CLI usage, Jinja filter, or Python import
- Conditional coloring and formatting
- Advanced selection, filtering, and transformation with query files
- Output formats: plain, JSON, HTML, GitHub, LaTeX, etc.
- Multi-file loading and aggregation
- Integration with Ansible and other Python frameworks
- Inspect and explore nested data structures

---

## Gallery
See [Gallery]({{ doc_base_url }}/doc/gallery.md) for visual examples and screenshots.

---

## Quick Install
```bash
pip install jtable
```
Or clone and use locally:
```bash
git clone <repo_url>
cd jtable
pip install -r requirements.txt
```

---

## Basic Usage

```yaml
- hostname: host_1
  os: linux
  cost: 5000
  state: alive
  env: qua
- hostname: host_2
  os: linux
  cost: 5000
  state: alive
  env: qua
- hostname: host_3
  os: linux
  state: unreachable
  env: qua
```

```bash
cat host_dataset.yml | jtable
```

Output:
```text
hostname    os       cost  state        env
----------  -----  ------  -----------  -----
host_1      linux    5000  alive        qua
host_2      linux    5000  alive        qua
host_3      linux          unreachable  qua
```

---

## More Examples
- [Setup Guide]({{ doc_base_url }}/doc/setup/README.md)
- [Advanced Examples]({{ doc_base_url }}/doc/examples/README.md)

---

## Contributing
Pull requests and issues are welcome! For major changes, please open an issue first to discuss what you would like to change.

---

## License
See [LICENSE.txt]({{ doc_base_url }}/LICENSE.txt)

