DEEPWELL

Wikidot-like storage and maintenance system. Tracks wikis, users, passwords, pages, files, and manages a Postgres database. Its schema and migrations are handled by Diesel.

DEEPWELL provides logical operations for handling low-level abstracted data such as individual page revisions. Verification and permissions checking needs to be handled by the consumer.

Currently, the following services are provided:

• Page creation and modification: the primary feature is the ability to make pages and set their content.
• Wikis and multitenancy: all pages are created in a separate, namespaced "wiki", which has its own domain and separate pages from other wikis in the same database.
• Revisions and page history: Tracks all changes made to a page and provides views like diffs and blames. This is implemented using a git repository, with database entries pointing to commits storing revision information.
• Tracking authorship: a page may have an arbitrary number of writers, translators, etc. See also the current attribution metadata workaround.
• Page locks: allows setting and clearing page locks, which the consumer can require for editing pages.
• Rating: tracks votes cast by users, including the ability to "neutral-vote" (vote with a value of 0). Currently uses a ups - downs algorithm for scoring like Wikidot.
• Password management: hashes passwords with scrypt with configurable iteration times, as well as a delay on failed attempts to limit bruteforcing. Also blocks passwords in a specified blacklist to prevent users from using overused or weak passwords (e.g. letmein, password, etc.)
• Login attempts: provides a method to validate the user's password and log the attempt.

You will need the diesel_cli crate installed. For all commands you will need to the DATABASE_URL environment variable set.

Compilation

This library targets the latest stable Rust. At time of writing, that is 1.40.0

sh $ diesel migration run $ cargo build --release

See diesel.rs for how to use the diesel cli tool.

Testing

sh $ cargo test

Add -- --nocapture to the end if you want to see test output.

Available under the terms of the GNU Affero General Public License. See LICENSE.md.