.. contents:: **tabledata**
   :backlinks: top
   :depth: 2

Summary
---------
`tabledata <https://github.com/thombashi/tabledata>`__ is a Python library to represent tabular data. Used for pytablewriter/pytablereader/SimpleSQLite/etc.

.. image:: https://badge.fury.io/py/tabledata.svg
    :target: https://badge.fury.io/py/tabledata
    :alt: PyPI package version

.. image:: https://img.shields.io/pypi/pyversions/tabledata.svg
    :target: https://pypi.org/project/tabledata
    :alt: Supported Python versions

.. image:: https://img.shields.io/pypi/implementation/tabledata.svg
    :target: https://pypi.org/project/tabledata
    :alt: Supported Python implementations

.. image:: https://github.com/thombashi/tabledata/actions/workflows/ci.yml/badge.svg
    :target: https://github.com/thombashi/tabledata/actions/workflows/ci.yml
    :alt: Linux/macOS/Windows CI status

.. image:: https://coveralls.io/repos/github/thombashi/tabledata/badge.svg?branch=master
    :target: https://coveralls.io/github/thombashi/tabledata?branch=master
    :alt: Test coverage

Installation
============

Install from PyPI
------------------------------
::

    pip install tabledata

Install from PPA (for Ubuntu)
------------------------------
::

    sudo add-apt-repository ppa:thombashi/ppa
    sudo apt update
    sudo apt install python3-tabledata


Dependencies
============
- Python 3.10+
- `Mandatory Python package dependencies (automatically installed) <https://github.com/thombashi/tabledata/network/dependencies>`__

Optional Python packages
------------------------------------------------
- `loguru <https://github.com/Delgan/loguru>`__
    - Used for logging if the package installed
- `pandas <https://pandas.pydata.org/>`__
    - required to get table data as a pandas data frame

Documentation
===============
https://tabledata.rtfd.io/

