Skip to main content

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

Project description

TiddlyWeb Home Site: http://tiddlyweb.com/ See also: http://tiddlywiki.org/wiki/TiddlyWeb

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

TiddlyWeb, aka mo’ass, is a RESTful data store which forms the core of a reference implementation of an ideal server side implementation for TiddlyWiki. It attempts to provide a tested, documented, and clear implementation of several facets that make up a good server side:

  • transparent system and code suitable for porting to other languages (where use specific optimizations will hopefully occur)

  • an abstract model for authentication and authorization

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

  • clean HTTP API based on REST principles

  • test driven description and development

The initial implementation is not designed to be highly performant nor especially scalable. The system is designed so that parts that are not optimal for a particular installation can be easily improved or swapped out.

Throughout the process of development TiddlyWeb has evolved from being specifically a TiddlyWiki server-side to a generic data store 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.

REQUIREMENTS

If you wish to use TiddlyWeb as a server-side for TiddlyWiki to generate a multi-user TiddlyWiki system, you will also need:

If you have downloaded a tarball of TiddlyWeb and you have Python’s setuptools, running the following command will automatically install TiddlyWeb and its requirements to the usual locations (you most likely will need to be an administrative user for this to work):

python setup.py install

If you are using TiddlyWeb from source checked out from the http://github.com/tiddlyweb/tiddlyweb repository, you can install the necessary requirements by hand:

Selector and simplejson can be installed with easy_install, which either comes with your python distribution and should be on your path, or is part of setuptools which you can install. See

http://peak.telecommunity.com/DevCenter/EasyInstall

and

http://peak.telecommunity.com/DevCenter/setuptools

for more information on easy_install and setuptools if you are not familiar with them.

For more information on what to do with TiddlyWeb see:

docs/TESTING:

Information about the tests located in the test directory.

index.cgi:

A sample of how to make TiddlyWeb run as a CGI with a web server such as Apache.

apache.py:

A sample of how to make TiddlyWeb run under mod_wsgi or mod_python and Apache.

See http://tiddlyweb.peermore.com/ for a TiddlyWiki generated by TiddlyWeb and TiddlyWebWiki, a TiddlyWeb plugin that provides TidldyWiki server-side functionality. That wiki contains the TiddlyWeb documentation. You can also leave comments there to help improve the documentation.

See http://github.com/tiddlyweb/tiddlyweb-plugins for some samples of plugins that TiddlyWeb can use with itself.

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 Chris Dent <cdent@peermore.com>.

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-0.9.88.tar.gz (131.1 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for tiddlyweb-0.9.88.tar.gz
Algorithm Hash digest
SHA256 da307d27113a7aaf570c7241b6c502283bb68b962ac6ec1c668401c6263827cc
MD5 b8914db7aa1582030ec5580a43e6f5bc
BLAKE2b-256 61f1ba0badb70f7a6934dc6aea1cface3c8c5b21c6887ebf7ab1fcd824ca86c2

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