Skip to main content

An optionally headless, extensible HTTP datastore for tiddlers: bits of stuff.

Project description

build status Package Version Package Downloads

For additional installation instructions see http://tiddlyweb.tiddlyspace.com/

With the 2.0.0 release of TiddlyWeb versions 2.7 and 3.3 and beyond of Python are supported. Earlier versions may work but are not explicitly tested. Note that tiddlywebwiki and most plugins have not yet been ported to work with Python 3 but will work with 2.7. Work to bring them up to date is in progress.

Introduction

TiddlyWeb is an open source HTTP API for storing and accessing flexible and composable microcontent. It is also a toolkit for tiddlers on the web. Tiddlers are small chunks of optionally structured content with their own URI. The concept comes from TiddlyWiki. TiddlyWeb can provide the basis of a server side for TiddlyWiki. TiddlyWeb provides:

  • an abstract model (with default implementations) for:

    • authentication and authorization

    • entity storage

    • entity and collection serialization

  • a straightforward extension model via plugins

  • an implementation of authenticated recipes and bags allowing access to dynamically created and filtered collections of tiddlers

  • a clean and pragmatic HTTP API

The system is designed so that parts that are not optimal for a particular installation can be easily improved or swapped out via plugins.

While TiddlyWeb was initially designed as a TiddlyWiki server-side it can also be used as a generic data store and platform. The platform builds on concepts learned from TiddlyWiki, primarily the concept of the tiddler: a small chunk of data used to build up a greater whole.

TiddlyWeb includes a command line tool called twanager. Run twanager without arguments for a list of available commands.

Installation

The easiest way to install TiddlyWeb and all its dependencies is by using pip to install it from PyPI::

pip install -U tiddlyweb

If you wish to use TiddlyWeb as a server-side for TiddlyWiki to generate a multi-user TiddlyWiki system, you will also need tiddlywebwiki. This too can be installed via pip. Installing tiddlywebwiki will install tiddlyweb for you::

pip install -U tiddlywebwiki

Or you can install by hand, you will need the following requirements:

Building

Tests are run using PyTest:

make test

Coverage support with:

https://pypi.python.org/pypi/coverage https://pypi.python.org/pypi/pytest-cov

Miscellaneous

See http://pypi.python.org/pypi?%3Aaction=search&term=tiddlywebplugins for plugins that TiddlyWeb can use with itself.

See http://tiddlyspace.com/ for a shared hosting service built on TiddlyWeb.

If you have questions or contributions on making TiddlyWeb work for you, please post to the TiddlyWeb group at google groups:

http://groups.google.com/group/tiddlyweb

or contact the primary author, Chris Dent <cdent@peermore.com>.

Please report bugs and issues at the github issue tracker:

https://github.com/tiddlyweb/tiddlyweb/issues

There are a few tools that make exploring TiddlyWeb a bit easier:

License

TiddlyWeb is released under the BSD License and is copyright 2008-2014 UnaMesa Association.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

tiddlyweb-2.1.4.tar.gz (147.3 kB view details)

Uploaded Source

File details

Details for the file tiddlyweb-2.1.4.tar.gz.

File metadata

  • Download URL: tiddlyweb-2.1.4.tar.gz
  • Upload date:
  • Size: 147.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for tiddlyweb-2.1.4.tar.gz
Algorithm Hash digest
SHA256 e137fa433f5c818f1e1ee55937175440e2e719761bec2e9539baf6cec1512a97
MD5 f4cf36843312153b0f3575a06bfb979f
BLAKE2b-256 d2ccaf6ed758573f0af189d9c2ade1b80aef407d93972ce8cdf68863fd275daa

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page