File: how-to-release.md

package info (click to toggle)
matrix-synapse-ldap3 0.1.4%2Bgit20201015%2Ba3c7a9f-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye
  • size: 148 kB
  • sloc: python: 910; makefile: 5
file content (31 lines) | stat: -rw-r--r-- 1,063 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# How to release `matrix-synapse-ldap3`

Releasing `matrix-synapse-ldap3` involves bumping the version number, creating
a new tag on Github, then uploading release packages to
[PyPi](https://pypi.org).

You will need push access to this repo as well as an account on PyPi with push
access to the
[matrix-synapse-ldap3](https://pypi.org/project/matrix-synapse-ldap3/) package.

## Git repository

1. Edit the `__version__` variable of `ldap_auth_provider.py` to the new release
version. This repository uses [Semantic Versioning](https://semver.org/).

1. Commit and push with the commit message `X.Y.Z`.

1. Create a git tag with `git tag -s vX.Y.Z`. Set the first line of the message
   to `vX.Y.Z`, and the rest to the changes since the last release (looking at
   the commit history can help).

1. Push the tag with `git push origin tag vX.Y.Z`

## Uploading to PyPi

Ensure you have access to the `twine` command.

1. Run `python setup.py sdist` to build the package

1. `twine upload dist/matrix-synapse-ldap3-X.Y.Z.tar.gz` to upload the package
   to PyPi.