| Name | announcer JSON |
| Version |
5.0.0
JSON |
| download |
| home_page | |
| Summary | Announce changes in keepachangelog-style CHANGELOG.md files to Slack and Microsoft Teams |
| upload_time | 2023-06-06 16:44:06 |
| maintainer | |
| docs_url | None |
| author | Max Dymond |
| requires_python | >=3.8.1,<4.0.0 |
| license | MIT |
| keywords |
slack
teams
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://github.com/Metaswitch/announcer)
[](https://pypi.org/project/announcer/)
[](https://hub.docker.com/r/metaswitch/announcer)
# announcer
This tool:
* takes an [keepachangelog](https://keepachangelog.com/en/1.0.0/)-style CHANGELOG.md file
* extracts all changes for a particular version
* and sends a formatted message to a Slack or Microsoft Teams webhook.
It is available as a Python package, or as a Docker container for use in CI.
## Installation
Install this tool using pip:
```
pip install announcer
```
## Tool usage
```
usage: announce [-h] (--webhook WEBHOOK | --slackhook WEBHOOK) [--target {slack,teams}] --changelogversion CHANGELOGVERSION --changelogfile CHANGELOGFILE --projectname PROJECTNAME
[--username USERNAME] [--compatibility-teams-sections] [--iconurl ICONURL | --iconemoji ICONEMOJI]
Announce CHANGELOG changes on Slack and Microsoft Teams
optional arguments:
-h, --help show this help message and exit
--webhook WEBHOOK The incoming webhook URL
--slackhook WEBHOOK The incoming webhook URL. (Deprecated)
--target {slack,teams}
The type of announcement that should be sent to the webhook
--changelogversion CHANGELOGVERSION
The changelog version to announce (e.g. 1.0.0)
--changelogfile CHANGELOGFILE
The file containing changelog details (e.g. CHANGELOG.md)
--projectname PROJECTNAME
The name of the project to announce (e.g. announcer)
--username USERNAME The username that the announcement will be made as (e.g. announcer). Valid for: Slack
--compatibility-teams-sections
Compatibility option - sends Teams messages in multiple sections
--iconurl ICONURL A URL to use for the user icon in the announcement. Valid for: Slack
--iconemoji ICONEMOJI
An emoji code to use for the user icon in the announcement (e.g. party_parrot). Valid for: Slack
```
## Gitlab Usage
Announcer builds and publishes a Docker image that you can integrate into your `.gitlab-ci.yml`:
```
announce:
stage: announce
image: metaswitch/announcer:5.0.0
script:
- announce --webhook <webhook address>
--changelogversion $CI_COMMIT_REF_NAME
--changelogfile <CHANGELOG.md file>
--projectname <Project name>
--iconemoji party_parrot
only:
- tags
```
Raw data
{
"_id": null,
"home_page": "",
"name": "announcer",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.1,<4.0.0",
"maintainer_email": "",
"keywords": "slack,teams",
"author": "Max Dymond",
"author_email": "max.dymond@metaswitch.com",
"download_url": "https://files.pythonhosted.org/packages/79/14/41cdf073d8fa618ebbbc9c8042f1880ffff93cd7bbb8a94da8fa1ac145f8/announcer-5.0.0.tar.gz",
"platform": null,
"description": "[](https://github.com/Metaswitch/announcer)\n[](https://pypi.org/project/announcer/)\n[](https://hub.docker.com/r/metaswitch/announcer)\n\n# announcer\n\nThis tool:\n* takes an [keepachangelog](https://keepachangelog.com/en/1.0.0/)-style CHANGELOG.md file\n* extracts all changes for a particular version\n* and sends a formatted message to a Slack or Microsoft Teams webhook.\n\nIt is available as a Python package, or as a Docker container for use in CI.\n\n## Installation\n\nInstall this tool using pip:\n\n```\npip install announcer\n```\n\n## Tool usage\n\n```\nusage: announce [-h] (--webhook WEBHOOK | --slackhook WEBHOOK) [--target {slack,teams}] --changelogversion CHANGELOGVERSION --changelogfile CHANGELOGFILE --projectname PROJECTNAME\n [--username USERNAME] [--compatibility-teams-sections] [--iconurl ICONURL | --iconemoji ICONEMOJI]\n\nAnnounce CHANGELOG changes on Slack and Microsoft Teams\n\noptional arguments:\n -h, --help show this help message and exit\n --webhook WEBHOOK The incoming webhook URL\n --slackhook WEBHOOK The incoming webhook URL. (Deprecated)\n --target {slack,teams}\n The type of announcement that should be sent to the webhook\n --changelogversion CHANGELOGVERSION\n The changelog version to announce (e.g. 1.0.0)\n --changelogfile CHANGELOGFILE\n The file containing changelog details (e.g. CHANGELOG.md)\n --projectname PROJECTNAME\n The name of the project to announce (e.g. announcer)\n --username USERNAME The username that the announcement will be made as (e.g. announcer). Valid for: Slack\n --compatibility-teams-sections\n Compatibility option - sends Teams messages in multiple sections\n --iconurl ICONURL A URL to use for the user icon in the announcement. Valid for: Slack\n --iconemoji ICONEMOJI\n An emoji code to use for the user icon in the announcement (e.g. party_parrot). Valid for: Slack\n```\n\n## Gitlab Usage\n\nAnnouncer builds and publishes a Docker image that you can integrate into your `.gitlab-ci.yml`:\n\n```\nannounce:\n stage: announce\n image: metaswitch/announcer:5.0.0\n script:\n - announce --webhook <webhook address>\n --changelogversion $CI_COMMIT_REF_NAME\n --changelogfile <CHANGELOG.md file>\n --projectname <Project name>\n --iconemoji party_parrot\n only:\n - tags\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Announce changes in keepachangelog-style CHANGELOG.md files to Slack and Microsoft Teams",
"version": "5.0.0",
"project_urls": null,
"split_keywords": [
"slack",
"teams"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "08c6595e2d24bf5f904c898321a07883016f7e0179fcc5ef525fecd1ff309173",
"md5": "0b8a97bac465ae6fea3e6f76a8c2ad52",
"sha256": "39f9e39f2da828bc3ab535136e931638b6644257d3acf414d262a6110a9012a9"
},
"downloads": -1,
"filename": "announcer-5.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0b8a97bac465ae6fea3e6f76a8c2ad52",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1,<4.0.0",
"size": 9501,
"upload_time": "2023-06-06T16:44:04",
"upload_time_iso_8601": "2023-06-06T16:44:04.543206Z",
"url": "https://files.pythonhosted.org/packages/08/c6/595e2d24bf5f904c898321a07883016f7e0179fcc5ef525fecd1ff309173/announcer-5.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "791441cdf073d8fa618ebbbc9c8042f1880ffff93cd7bbb8a94da8fa1ac145f8",
"md5": "8fab77533c17a8ff8dc20618f7baf6c1",
"sha256": "7559644c55c09461748183339013faa6491a4c2cece953987d85844ea14c571c"
},
"downloads": -1,
"filename": "announcer-5.0.0.tar.gz",
"has_sig": false,
"md5_digest": "8fab77533c17a8ff8dc20618f7baf6c1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1,<4.0.0",
"size": 7810,
"upload_time": "2023-06-06T16:44:06",
"upload_time_iso_8601": "2023-06-06T16:44:06.177284Z",
"url": "https://files.pythonhosted.org/packages/79/14/41cdf073d8fa618ebbbc9c8042f1880ffff93cd7bbb8a94da8fa1ac145f8/announcer-5.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-06 16:44:06",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "announcer"
}
