Add example inserting images

Author: timvink

.github/workflows/pythonpublish.yml

@@ -15,25 +15,16 @@ jobs:
     steps:
     - uses: actions/checkout@v4
 
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.x'
-    
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install setuptools wheel twine
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
 
     - name: Make sure unit tests succeed
       run: |
-        pip install ".[dev]"
-        pytest
+        uv run pytest
     
     - name: Build
       run: |
-        pip install build setuptools
-        python -m build
+        uv build
 
     # See https://docs.pypi.org/trusted-publishers/using-a-publisher/
     - name: Publish package distributions to PyPI

.github/workflows/workflow.yml

@@ -10,15 +10,14 @@ jobs:
     steps:
     - uses: actions/checkout@master
 
-    - name: Setup Python  
-      uses: actions/setup-python@master
+    - name: Install uv and set the python version
+      uses: astral-sh/setup-uv@v5
       with:
         python-version: ${{ matrix.python-version }}
 
     - name: Run unit tests
       run: |
-        pip install ".[dev]"
-        pytest --cov=mkdocs_table_reader_plugin --cov-report=xml
+        uv run pytest --cov=mkdocs_table_reader_plugin --cov-report=xml
 
     - name: Upload coverage to Codecov
       if: contains(env.USING_COVERAGE, matrix.python-version) && github.ref == 'refs/heads/master'

.gitignore

@@ -21,7 +21,7 @@ ipython_config.py
 .AppleDouble
 .LSOverride
 # Icon must end with two \r
-Icon
+Icon
 # Thumbnails
 ._*
 # Files that might appear in the root of a volume
@@ -128,6 +128,7 @@ share/python-wheels/
 .installed.cfg
 *.egg
 MANIFEST
+.venv/
 # PyInstaller
 #  Usually these files are written by a python script from a template
 #  before PyInstaller builds the exe, so as to inject date/other infos into it.

docs/assets/tables/html_table.csv

@@ -0,0 +1,4 @@
+"a";"b"
+iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/wcAAwAB/ayY04sAAAAASUVORK5CYII=;73
+iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/wcAAwAB/ayY04sAAAAASUVORK5CYII=;52
+iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/wcAAwAB/ayY04sAAAAASUVORK5CYII=;123,80

docs/howto/customize_tables.md

@@ -91,3 +91,28 @@ You can use [tabulate](https://pypi.org/project/tabulate/)'s [number formatting]
 
     {{ read_fwf('tables/fixedwidth_table.txt', floatfmt=".2f") | add_indentation(spaces=4) }}
 
+
+## Further customization
+
+If you use enable [`mkdocs-macros-plugin`](https://mkdocs-macros-plugin.readthedocs.io/en/latest/) (see [ Compatibility with mkdocs-macros-plugin to enable further automation](use_jinja2.md)), you can do much more.
+
+For example:
+
+{% raw %}
+```jinja
+{% for base64_image in pd_read_csv('tables/html_table.csv', sep=";")['a'] %}
+
+<img src="data:image/png;base64,{{ base64_image }}" alt="Small Red Dot">
+
+{% endfor %}
+```
+{% endraw %}
+
+Should render 3 red dots:
+
+{% for base64_image in pd_read_csv('tables/html_table.csv', sep=";")['a'] %}
+
+<img src="data:image/png;base64,{{ base64_image }}" alt="Small Red Dot">
+
+{% endfor %}
+

pyproject.toml

@@ -29,20 +29,20 @@ classifiers=[
     "License :: OSI Approved :: MIT License",
 ]
 
-dynamic = ["version","dependencies","optional-dependencies"]
+dynamic = ["version"]
+dependencies = [
+    "mkdocs>=1.0",
+    "pandas>=1.1",
+    "pyyaml>=5.4.1",
+    "tabulate>=0.8.7",
+]
 
 [project.urls]
 "Homepage" = "https://github.com/timvink/mkdocs-table-reader-plugin"
 
 [tool.setuptools.dynamic]
 version = {attr = "mkdocs_table_reader_plugin.__version__"}
 
-dependencies={file = ["requirements.txt"]}
-
-optional-dependencies.dev={file = ["requirements_dev.txt"]}
-optional-dependencies.base={file = ["requirements.txt"]}
-optional-dependencies.all={file = ["requirements.txt", "requirements_dev.txt"]}
-
 [tool.pytest.ini_options]
 markers = [
     "integration: marks tests as integration, meaning they use databases (deselect with '-m \"not integration\"')",
@@ -113,5 +113,17 @@ fix = true
 
 [tool.uv]
 dev-dependencies = [
+    "click>=8.1.8",
+    "codecov>=2.1.13",
+    "mkdocs-git-authors-plugin>=0.9.4",
+    "mkdocs-git-revision-date-localized-plugin>=1.4.5",
+    "mkdocs-macros-plugin>=1.3.7",
+    "mkdocs-markdownextradata-plugin>=0.2.6",
+    "mkdocs-material>=9.6.9",
+    "openpyxl>=3.1.5",
+    "pyarrow>=17.0.0",
+    "pytest>=8.3.5",
+    "pytest-cov>=5.0.0",
     "ruff",
+    "xlrd>=1.0.0",
 ]