Skip to main content

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

Project description

* TiddlyWeb Home Site: http://tiddlyweb.com/
* TiddlyWeb Git Repo: http://github.com/tiddlyweb/tiddlyweb

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

If you develop with TiddlyWeb and are upgrading 1.0 to 1.2 there have
been changes you should make yourself aware of. Read `UPGRADE1.0to1.2
<http://github.com/tiddlyweb/tiddlyweb/raw/master/UPGRADE1.0to1.2>`_.

Introduction
------------

TiddlyWeb, aka mo'ass, is a RESTful data store and 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
the controlled and filter-able access to dynamically created collections
of tiddlers
* clean HTTP API based on REST principles

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 that 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 <http://pip.openplans.org/>`_ to install it from `PyPI
<http://pypi.python.org>`_:

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
<http://pypi.python.org/pypi/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:

* Python 2.5, 2.6 or 2.7. (Python 3 has not yet been tested. Python
2.4 may work but is neither tested nor recommended.)
* selector: http://lukearno.com/projects/selector/
* simplejson: http://undefined.org/python/#simplejson
* html5lib (for sanitizing input which may be rendered as HTML):
http://code.google.com/p/html5lib/

Miscellaneous
-------------

See http://tiddlyweb.peermore.com/ for a TiddlyWiki generated by TiddlyWeb
and TiddlyWebWiki. That wiki contains the TiddlyWeb documentation. You can
also leave comments there to help improve the documentation.

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 this work
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

TiddlyWeb is released under the BSD License and is copyright
2008-2011 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-1.2.51.tar.gz (128.2 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for tiddlyweb-1.2.51.tar.gz
Algorithm Hash digest
SHA256 d5a554da2d3854933ca01eab87a90c2932eb3305977b5b86567da12e33d691a8
MD5 085afe7405bd9a59f96f2cb594401e20
BLAKE2b-256 af9fc46fc5940eb0c9f07483b778c6727034e1294edb2110fe0536b11d7d4e0f

See more details on using hashes here.

Provenance

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