Skip to main content

Allows TiddlyWeb users to create alias usernames, deliberately without validation.

Project description

[![Build Status](https://travis-ci.org/pads/tiddlywebplugins.mapuser.png)](https://travis-ci.org/pads/tiddlywebplugins.mapuser)
[![Coverage Status](https://coveralls.io/repos/pads/tiddlywebplugins.mapuser/badge.png)](https://coveralls.io/r/pads/tiddlywebplugins.mapuser)
[![Latest Release](https://pypip.in/v/tiddlywebplugins.mapuser/badge.png)](https://crate.io/packages/tiddlywebplugins.mapuser/)
About
=====

Allows TiddlyWeb users to create alias usernames, deliberately without validation.
This is ideal in a scenario where you control the user authentication journey but want to use different usernames
than those expected by the user authentication source.
Any username string can be used as long as it contains valid alphanumeric characters and no spaces.

Essentially, what is being mapped is user ID -> username.

Upon a successful POST, the plugin creates a tiddler in a bag called MAPUSER.
This data is used when a user logs in so that they can be mapped to their username.

Requirements
============

* [Python](http://www.python.org/).
* [pip](http://www.pip-installer.org/en/latest/).
* make.
* A working TiddlyWeb instance to test against.
* [py.test](http://pytest.org/latest/) to run the tests.

Modifying
=========

The best way to figure out how to work with this project is to look at the `.travis.yml` file.

`setup.py` is used to package up the plugin, install and distribute.

Plugin code lives in the `tiddlywebplugins` directory.

Tests live in the `test` directory.

* `make install` installs the plugin as a package on your system
* `make install_dev` installs packages necessary to run tests, check style and provide test coverage
* `make test` runs the tests.
* `make test_with_coverage` runs the tests with code coverage reporting from `pytest-cov`
* `make pep8` runs pep8 over the code to check for style compliance.
(you may need sudo for this.)
* `make release` packages and uploads the plugin to [PyPI](http://pypi.python.org/pypi) for distribution.

Plugin Installation
===================

Install tiddlywebplugins.mapuser:

pip install -U tiddlywebplugins.mapuser

TiddlyWeb Configuration
=======================

Reference the plugin from your TiddlyWeb configuration as a system plugin e.g:

`'system_plugins': ['tiddlywebplugins.mapuser']`

Usage
=====

The URL to send POSTs to will be:

map_user/<userid>

Where `<userid>` is the same as the one used to authenticate. The body will contain the mapped username:

mapped_user: <username>

Project details


Download files

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

Source Distribution

tiddlywebplugins.mapuser-0.1.0.tar.gz (4.2 kB view hashes)

Uploaded Source

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