Metadata-Version: 2.1
Name: htmltable-cli
Version: 0.1.11
Summary: A command line tool to generate html tables with embedded images, videos and audio
Home-page: https://github.com/FarisHijazi/htmltable-cli
Author: Faris Hijazi
Author-email: theefaris@gmail.com
License: UNKNOWN
Keywords: html table htmltable html-table base64 report
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# htmltable cli

Command line tool to convert lists to portable HTML tables with embedded audios and images.

![](https://raw.githubusercontent.com/FarisHijazi/htmltable-cli/master/images/longexample.gif)


## Installation

### From source (latest)

```sh
pip install git+https://github.com/FarisHijazi/htmltable-cli
```

### From PyPi (table)

```sh
pip install htmltable-cli
```

## Usage

    usage:

    A command line tool to generate html tables with embedded images, videos and audio

    - Separate columns with `,` or pass all files and group by parent using `--groupy_nthparent 1`
    - The easiest way to use it is to put each column in a folder and then pass it using a wildcard `*`

    Examples:

        htmltable col1/*.* , col2/*.* , col3/*.* --title "my table" --controls controls preload autoplay loop muted --base64 --index > output.html
        htmltable col*/* --groupy_nthparent 1    --title "my table" --controls controls preload autoplay loop muted --base64 --index > output.html

        [-h] [--title TITLE] [-g GROUPY_NTHPARENT] [-c COLNAMES [COLNAMES ...]] [-b] [-x | -fx]
        [--controls [{controls,preload,autoplay,loop,muted} [{controls,preload,autoplay,loop,muted} ...]]] [-t] [--clamp]
        data [data ...]

    positional arguments:
    data                  input table data. Format: col1_item1 col1_item2 col1_item3 , col2_item1 col2_item2 col2_item3 ...

    optional arguments:
    -h, --help            show this help message and exit
    --title TITLE         title heading for the table
    -g GROUPY_NTHPARENT, --groupy_nthparent GROUPY_NTHPARENT
                            choose columns based on the nth parent, instead of separating using "," delimiter to determine
                            columns.This allows to dynamically specify folders instead of passing folders explicitly with "," in
                            between. Set to -g 1 for the direct parent of the files
    -c COLNAMES [COLNAMES ...], --colnames COLNAMES [COLNAMES ...]
                            Provide a list of column names (instead of automatically inferring column names from filepaths).
    -b, --base64          Encode all the media to a base64 URL, meaning that the html file is now portable and doesn't depend
                            on the location of the images/audios/videos
    -x, --index           add numerical index column
    -fx, --filename_index
                            Infer index (rowname) based on row filenames, instead of numerical index. All columns must have
                            identical filenames otherwise an error is raised
    --controls [{controls,preload,autoplay,loop,muted} [{controls,preload,autoplay,loop,muted} ...]]
                            HTML video and audio controls
    -t, --transpose       swap columns and rows
    --clamp               clamp number of rows to the shortest row, ensures the table is symmetric.

Assuming filestructure:

```
.
|-- col1
|   |-- audio1.wav
|   |-- ...
|   |-- image.png
|   `-- video.mp4
|-- col2
|   |-- audio1.wav
|   |-- ...
|   |-- image.png
|   `-- video.mp4
`-- col3
    |-- audio1.wav
    |-- ...
    |-- image.png
    `-- video.mp4
```

### Examples

#### Minimal example

```sh
htmltable col1/audio1.wav , col2/audio1.wav , col3/audio1.wav > output.html
```

or for dynamically choosing folders using wildcards `*`.
This will pass all files, and then will group them by parent folder, in this case `1` means the first parent folder.

```sh
htmltable col*/* --groupy_nthparent 1 > output.html
```


![](https://raw.githubusercontent.com/FarisHijazi/htmltable-cli/master/images/minimal.png)

#### More involved example

```sh
htmltable col1/*.* , \
          col2/*.* , \
          col3/*.* \
          --controls controls preload autoplay loop muted \
          --base64 --index > output.html
```

(you don't actually have to organize your arguments in a new lines :p)

![](https://raw.githubusercontent.com/FarisHijazi/htmltable-cli/master/images/longexample.gif)

##### Explanation

- `--base64` will encode all the media to a base64 URL, meaning that the html file is now portable and doesn't depend on the location of the images/audios/videos
- `col1/*.*` passes all files in `col1/` directory
- `--controls controls preload autoplay loop muted` set default video and audio attributes


#### Column and row headers

- Column headers are inferred automatically, to manually specify column names, use `-c`/`--colnames`
- Row headers options:
  - Can be left blank
  - Indexed numerically using `-x`/`--index`
  - Use the filenames, if all files have the same name across columns, using `-fx`/`--filename_index`.

    Example: *col1/audio1.wav*, *col2/audio2.wav*.

## Known issues

- Outputting files is only supported in the `.` dir. i.e `htmltable .... > some/other/path/output.html` has issues when not using `--base64`
- setting `--controls autoplay` won't work, you need to add `muted` as well

## Development

Before committing, run the test script and make sure the output *.html* files are as expected

```sh
sh test.sh; ls testoutput*.html | xargs -I{} xdg-open {}  # for linux debian
sh test.sh; ls testoutput*.html | xargs -I{} start {}     # for windows
```

For building a release and uploading it to PyPi, make and `git commit` your changes, then run

```sh
sh build.sh
```


