Skip to main content

Map a single RDBMS table to a bag.

Project description

mappingsql is TiddlyWeb StorageInterface implementation that maps an RDBMS table as a bag, with each row representing a tiddler.

It has many limitations (on purpose):

  • It is READ ONLY
  • It only supports one bag.
  • It has no support for recipes.
  • It has no support revisions.
  • It has limited support for search.

You tell what database you want to look at, what table you want to map, and what bag name you want that table to think of itself as. The column name ‘id’ is mapped to tiddler.title unless overridden by the configuration setting of ‘mappingsql.id_column’. Any column names that map to Tiddler attributes are applied. Otherwise, columns are mapped into tiddler.fields.

Search support is used primarily with MySQL and its full text indexing system. You may turn on this support with ‘mappingsql.full_text’ set to True.

This is experimental alpha software, reading and understanding the code is recommending before using. There is additional information in the module docstring.


  • Make mapping of columns to tiddler attributes optional.
  • Cast column data to unicode with flair.

This work was created by Chris Dent <> for Peermore Limited, working for Yellowcar Limited, under the auspices of the wiki-data project of Avox.

It is license under the BSD license. See COPYRIGHT for more information.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tiddlywebplugins.mappingsql, version 1.2
Filename, size File type Python version Upload date Hashes
Filename, size tiddlywebplugins.mappingsql-1.2.tar.gz (8.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page