This Synapse module derives usernames from third party identifiers (i.e. email addresses and phone numbers) when registering users.
From the virtual environment that you use for Synapse, install this module with:
pip install synapse-username-from-threepid
(If you run into issues, you may need to upgrade pip
first, e.g. by running
pip install --upgrade pip
)
Then alter your homeserver configuration, adding to your modules
configuration:
modules:
- module: username_from_threepid.UsernameFromThreepid
config:
# Which third-party identifier to look for. Can either be "email" (for email
# addresses), or "msisdn" (for phone numbers).
# Required.
threepid_to_use: "email"
# Whether to fail the registration if no third-party identifier was provided during
# the registration process.
# Optional, defaults to false.
fail_if_not_found: true
In a virtual environment with pip ≥ 21.1, run
pip install -e .[dev]
To run the unit tests, you can either use:
tox -e py
or
trial tests
To run the linters and mypy
type checker, use ./scripts-dev/lint.sh
.
The exact steps for releasing will vary; but this is an approach taken by the Synapse developers (assuming a Unix-like shell):
-
Set a shell variable to the version you are releasing (this just makes subsequent steps easier):
version=X.Y.Z
-
Update
setup.cfg
so that theversion
is correct. -
Stage the changed files and commit.
git add -u git commit -m v$version -n
-
Push your changes.
git push
-
When ready, create a signed tag for the release:
git tag -s v$version
Base the tag message on the changelog.
-
Push the tag.
git push origin tag v$version
-
If applicable: Create a source distribution and upload it to PyPI:
python -m build twine upload dist/username_from_threepid-$version*