Skip to content

build(deps): update dependency mkdocs-table-reader-plugin to v4 - #110

Open
renovate[bot] wants to merge 1 commit into
mainfrom
renovate/mkdocs-table-reader-plugin-4.x
Open

renovate[bot] wants to merge 1 commit into
mainfrom
renovate/mkdocs-table-reader-plugin-4.x

Conversation

@renovate

@renovate renovate Bot commented Sep 15, 2026

Copy link
Copy Markdown
Contributor

This PR contains the following updates:

Package Change Age Confidence
mkdocs-table-reader-plugin <4<5 age confidence

Warning

Some dependencies could not be looked up. Check the Dependency Dashboard for more information.


Release Notes

timvink/mkdocs-table-reader-plugin (mkdocs-table-reader-plugin)

v4.0.1

Compare Source

Bug fixes:

  • Two reader tags on the same line are now two tables. The tag pattern matched greedily, so it swallowed everything between the first and the last tag on a line, and then failed to parse the result.
  • An = inside an argument value no longer breaks parsing. {{ read_csv('a=b.csv') }}, sep='=' and na_values=['a=1'] all raised a SyntaxError before.
  • A comma inside a dict argument no longer breaks parsing, so dtype={'a': 'str', 'b': 'int'} works. Lists and tuples already worked.
  • convert_to_md_table() no longer escapes pipe characters in the DataFrame you pass in. When a mkdocs-macros-plugin user rendered the same DataFrame twice, the second table showed doubly escaped pipes.

Project maintenance:

  • The documentation site now deploys on every push to master. It was deployed by hand, and had fallen behind the readers added in 4.0.0.
  • Coverage is uploaded to Codecov again. The upload step tested an environment variable that was never set, so it never ran.
  • enabled is included in schema.json, so editors stop flagging it as an unknown option.

v4.0.0: table-reader v4.0.0

Compare Source

Breaking changes

  • Python 3.10 or newer is required. Support for Python 3.8 and 3.9 is dropped, and 3.13 and 3.14 are now tested.
  • pandas 2.1 or newer is required. convert_to_md_table() used to pick between .map() and .applymap() on a string comparison of pd.__version__. .applymap() was removed in pandas 3, so that branch is gone and the floor is now the pandas release that added pd.DataFrame.map().

New readers

Readers for every remaining file format that pandas can read, so the plugin now covers all of them (readers):

read_feather, read_parquet, read_orc, read_html, read_xml, read_hdf, read_sas, read_spss and read_stata, each also available as a pd_<reader> macro when mkdocs-macros-plugin is enabled. Some need an extra package installed, which the readers page lists per format.

Faster builds

Every reader used to run its own regex over every page, so each reader added made builds slower. All selected readers are now searched for in one pattern, and a page is scanned once no matter how many readers are selected. Scanning a 15KB page:

8 readers all 16 readers
v3, one regex per reader 1.28 ms 2.54 ms
v4, one regex 0.16 ms 0.15 ms

That is 8x faster with the readers v3 had, and 17x faster with all the readers v4 adds: about a second saved per 1000 pages. select_readers is no longer needed to keep builds fast.

Improvements

  • Multiline cells no longer break up a table. A cell containing a newline is rendered with <br> for single-line table formats like pipe and github, and left alone for formats that display multiline cells themselves, such as grid (#​83).
  • read_yaml() and read_raw() accept an encoding argument, for files that are not UTF-8. Thanks @​kirill237!

Internal

  • Test coverage is at 100%. select_readers, allow_missing_files, tag indentation and malformed tags all have tests now, and the read_hdf() and read_spss() tests actually run in CI instead of always skipping.

Full Changelog: timvink/mkdocs-table-reader-plugin@v3.1.0...v4.0.0


Configuration

📅 Schedule: (UTC)

  • Branch creation
    • At any time (no schedule defined)
  • Automerge
    • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about these updates again.


  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

@renovate

renovate Bot commented Sep 15, 2026

Copy link
Copy Markdown
Contributor Author

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

  • any of the package files in this branch needs updating, or
  • the branch becomes conflicted, or
  • you click the rebase/retry checkbox if found above, or
  • you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: uv.lock
Command failed: uv lock --upgrade-package mkdocs-table-reader-plugin
warning: The `requires-python` specifier (`~=3.13`) in `developer-friendly-blog` uses the tilde specifier (`~=`) without a patch version. This will be interpreted as `>=3.13, <4`. Did you mean `~=3.13.0` to constrain the version as `>=3.13.0, <3.14`? We recommend only using the tilde specifier with a patch version to avoid ambiguity.
Using CPython 3.13.15 interpreter at: /opt/containerbase/tools/python/3.13.15/bin/python3.13
   Updating https://github.com/developer-friendly/mkdocs-material-insiders.git (master)
error: Failed to download and build `mkdocs-material @ git+https://github.com/developer-friendly/mkdocs-material-insiders.git@master`
  cause: Git operation failed
  cause: failed to clone into: /home/ubuntu/.cache/uv/git-v0/db/05d4376fcdd5ce47
  cause: failed to fetch commit `aff252532139571a5ea3813be51e29313b307df6`
  cause: process didn't exit successfully: `/usr/bin/git fetch --force --update-head-ok 'https://github.com/developer-friendly/mkdocs-material-insiders.git' '+aff252532139571a5ea3813be51e29313b307df6:refs/commit/aff252532139571a5ea3813be51e29313b307df6'` (exit status: 128)
         --- stderr
         remote: Repository not found.
         fatal: repository 'https://github.com/developer-friendly/mkdocs-material-insiders.git/' not found

@github-actions

Copy link
Copy Markdown
Contributor

Live preview

Last updated: 2026-09-15T22:06:44
Last commit: 0f441ba
The live preview of the changes are available at the following URL:
https://6aa9c16f7521fc80d14cdcb5--developer-friendly.netlify.app

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants