ChurchSong 0.5.0__tar.gz

churchsong-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Stefan Bellon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

churchsong-0.5.0/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.1
+Name: ChurchSong
+Version: 0.5.0
+Summary: Download the event agenda from ChurchTool and instantiate a PowerPoint slide template with the names and portraits of service staff.
+Author: Stefan Bellon
+License: MIT License
+        
+        Copyright (c) 2024 Stefan Bellon
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/sbellon/ChurchSong
+Project-URL: Repository, https://github.com/sbellon/ChurchSong.git
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: alive-progress>=3.2.0
+Requires-Dist: platformdirs>=4.3.6
+Requires-Dist: prettytable>=3.12.0
+Requires-Dist: psutil>=6.1.0; sys_platform == "win32"
+Requires-Dist: pydantic>=2.9.2
+Requires-Dist: python-pptx>=1.0.2
+Requires-Dist: requests>=2.32.3
+
+# ChurchSong
+
+## Introduction
+
+The main purpose of this tool is to download the event agenda from ChurchTool as well
+as the names of the service staff, preparing a PowerPoint slide with the names and
+portraits to be presented at the beginning of the event.
+
+Additionally, the SongBeamer agenda can be modified by placing slides at the opening
+or closing, or after specific keywords. Colors of the SongBeamer captions can also be
+changed.
+
+The ChurchTools song database can also be checked for consistency regarding metadata
+as well as present .sng files to contain a background image.
+
+## Prerequisites
+
+Python package manager [uv](https://docs.astral.sh/uv/) must be installed and
+accessible via PATH. Easiest way is to follow the steps listed as
+[Standalone Installer](https://docs.astral.sh/uv/getting-started/installation/).
+
+## Installation
+
+Simply install ChurchSong by executing `uv install ChurchSong`. Tool `ChurchSong` is
+then available from the command line.
+
+You may place `ChurchSong.bat` together with `ChurchSong.ico` somewhere for
+convenience as you can just double-click it to load the upcoming agenda and start
+SongBeamer.
+
+## Configuration
+
+### Config file
+
+You need to copy the `config.toml.example` to `%LOCALAPPDATA%\ChurchSong\config.toml`
+and adjust the content accordingly.
+
+### PowerPoint template
+
+You need to prepare a PowerPoint template with a slide master which contains
+placeholders for pictures and names for the team members. The ChurchTool's service
+team name has to be put at the PowerPoint base placeholder via the Select Pane
+(Alt-F10).
+
+## Usage
+
+### SongBeamer agenda download
+
+To download the upcoming agenda you can just execute `ChurchSong` without any
+switches (e.g. double-click it). To specify a starting date to look for the next event,
+you can specify additional command line arguments `agenda FROM_DATE` as positional
+parameter with `FROM_DATE` in the form `YYYY-MM-DD`.
+
+If everything goes well, the agenda is downloaded into the `temp_dir`, the slide is
+created from the template, SongBeamer's `Schedule.col` is adjusted and finally
+SongBeamer itself is launched with the prepared `Schedule.col`.
+
+You can keep the `temp_dir` as is (it is added to and overwritten in future
+invocations), but there is also no harm in deleting the `temp_dir` as it is
+automatically re-created.
+
+### ChurchTools song verification
+
+With the additional command `songs verify` you can check the songs in the
+ChurchTools song database for specific properties like CCLI number, song name, tags,
+arrangement source, duration and a SongBeamer `.sng` file with the `#BackgroundImage`
+property set.
+
+With optional positional argument `FROM_DATE` in the form `YYYY-MM-DD` you can select
+to only check the songs of the next event agenda after `FROM_DATE`.
+
+Using command options `--exclude_tags` and/or `--include_tags` you can filter out
+songs with specific tags or only include songs with specific tags in the check.

churchsong-0.5.0/README.md

@@ -0,0 +1,73 @@
+# ChurchSong
+
+## Introduction
+
+The main purpose of this tool is to download the event agenda from ChurchTool as well
+as the names of the service staff, preparing a PowerPoint slide with the names and
+portraits to be presented at the beginning of the event.
+
+Additionally, the SongBeamer agenda can be modified by placing slides at the opening
+or closing, or after specific keywords. Colors of the SongBeamer captions can also be
+changed.
+
+The ChurchTools song database can also be checked for consistency regarding metadata
+as well as present .sng files to contain a background image.
+
+## Prerequisites
+
+Python package manager [uv](https://docs.astral.sh/uv/) must be installed and
+accessible via PATH. Easiest way is to follow the steps listed as
+[Standalone Installer](https://docs.astral.sh/uv/getting-started/installation/).
+
+## Installation
+
+Simply install ChurchSong by executing `uv install ChurchSong`. Tool `ChurchSong` is
+then available from the command line.
+
+You may place `ChurchSong.bat` together with `ChurchSong.ico` somewhere for
+convenience as you can just double-click it to load the upcoming agenda and start
+SongBeamer.
+
+## Configuration
+
+### Config file
+
+You need to copy the `config.toml.example` to `%LOCALAPPDATA%\ChurchSong\config.toml`
+and adjust the content accordingly.
+
+### PowerPoint template
+
+You need to prepare a PowerPoint template with a slide master which contains
+placeholders for pictures and names for the team members. The ChurchTool's service
+team name has to be put at the PowerPoint base placeholder via the Select Pane
+(Alt-F10).
+
+## Usage
+
+### SongBeamer agenda download
+
+To download the upcoming agenda you can just execute `ChurchSong` without any
+switches (e.g. double-click it). To specify a starting date to look for the next event,
+you can specify additional command line arguments `agenda FROM_DATE` as positional
+parameter with `FROM_DATE` in the form `YYYY-MM-DD`.
+
+If everything goes well, the agenda is downloaded into the `temp_dir`, the slide is
+created from the template, SongBeamer's `Schedule.col` is adjusted and finally
+SongBeamer itself is launched with the prepared `Schedule.col`.
+
+You can keep the `temp_dir` as is (it is added to and overwritten in future
+invocations), but there is also no harm in deleting the `temp_dir` as it is
+automatically re-created.
+
+### ChurchTools song verification
+
+With the additional command `songs verify` you can check the songs in the
+ChurchTools song database for specific properties like CCLI number, song name, tags,
+arrangement source, duration and a SongBeamer `.sng` file with the `#BackgroundImage`
+property set.
+
+With optional positional argument `FROM_DATE` in the form `YYYY-MM-DD` you can select
+to only check the songs of the next event agenda after `FROM_DATE`.
+
+Using command options `--exclude_tags` and/or `--include_tags` you can filter out
+songs with specific tags or only include songs with specific tags in the check.

churchsong-0.5.0/pyproject.toml

@@ -0,0 +1,74 @@
+[project]
+name = "ChurchSong"
+version = "0.5.0"
+authors = [{ name = "Stefan Bellon" }]
+description = "Download the event agenda from ChurchTool and instantiate a PowerPoint slide template with the names and portraits of service staff."
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.13"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+]
+dependencies = [
+    "alive-progress>=3.2.0",
+    "platformdirs>=4.3.6",
+    "prettytable>=3.12.0",
+    "psutil>=6.1.0; sys_platform == 'win32'",
+    "pydantic>=2.9.2",
+    "python-pptx>=1.0.2",
+    "requests>=2.32.3",
+]
+
+[project.urls]
+Homepage = "https://github.com/sbellon/ChurchSong"
+Repository = "https://github.com/sbellon/ChurchSong.git"
+
+[project.scripts]
+ChurchSong = "churchsong.__main__:main"
+
+[dependency-groups]
+dev = []
+lint = ["pyright>=1.1.387", "ruff>=0.7.2"]
+
+[tool.uv]
+package = true
+
+[tool.setuptools]
+license-files = []
+
+[tool.pyright]
+venvPath = "."
+venv = ".venv"
+typeCheckingMode = "basic"
+
+[tool.ruff]
+line-length = 88
+
+[tool.ruff.lint]
+select = ["ALL"]
+
+fixable = [
+    "I", # isort
+]
+
+ignore = [
+    "D",      # docstring
+    "COM812", # missing-trailing-comma
+]
+
+[tool.ruff.lint.flake8-quotes]
+inline-quotes = "single"
+
+[tool.ruff.format]
+quote-style = "single"
+
+[tool.ruff.lint.pep8-naming]
+# Allow Pydantic's `@validator` decorator to trigger class method treatment.
+classmethod-decorators = [
+    "classmethod",
+    "pydantic.validator",
+    "pydantic.root_validator",
+]

churchsong-0.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

churchsong-0.5.0/src/ChurchSong.egg-info/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.1
+Name: ChurchSong
+Version: 0.5.0
+Summary: Download the event agenda from ChurchTool and instantiate a PowerPoint slide template with the names and portraits of service staff.
+Author: Stefan Bellon
+License: MIT License
+        
+        Copyright (c) 2024 Stefan Bellon
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/sbellon/ChurchSong
+Project-URL: Repository, https://github.com/sbellon/ChurchSong.git
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: alive-progress>=3.2.0
+Requires-Dist: platformdirs>=4.3.6
+Requires-Dist: prettytable>=3.12.0
+Requires-Dist: psutil>=6.1.0; sys_platform == "win32"
+Requires-Dist: pydantic>=2.9.2
+Requires-Dist: python-pptx>=1.0.2
+Requires-Dist: requests>=2.32.3
+
+# ChurchSong
+
+## Introduction
+
+The main purpose of this tool is to download the event agenda from ChurchTool as well
+as the names of the service staff, preparing a PowerPoint slide with the names and
+portraits to be presented at the beginning of the event.
+
+Additionally, the SongBeamer agenda can be modified by placing slides at the opening
+or closing, or after specific keywords. Colors of the SongBeamer captions can also be
+changed.
+
+The ChurchTools song database can also be checked for consistency regarding metadata
+as well as present .sng files to contain a background image.
+
+## Prerequisites
+
+Python package manager [uv](https://docs.astral.sh/uv/) must be installed and
+accessible via PATH. Easiest way is to follow the steps listed as
+[Standalone Installer](https://docs.astral.sh/uv/getting-started/installation/).
+
+## Installation
+
+Simply install ChurchSong by executing `uv install ChurchSong`. Tool `ChurchSong` is
+then available from the command line.
+
+You may place `ChurchSong.bat` together with `ChurchSong.ico` somewhere for
+convenience as you can just double-click it to load the upcoming agenda and start
+SongBeamer.
+
+## Configuration
+
+### Config file
+
+You need to copy the `config.toml.example` to `%LOCALAPPDATA%\ChurchSong\config.toml`
+and adjust the content accordingly.
+
+### PowerPoint template
+
+You need to prepare a PowerPoint template with a slide master which contains
+placeholders for pictures and names for the team members. The ChurchTool's service
+team name has to be put at the PowerPoint base placeholder via the Select Pane
+(Alt-F10).
+
+## Usage
+
+### SongBeamer agenda download
+
+To download the upcoming agenda you can just execute `ChurchSong` without any
+switches (e.g. double-click it). To specify a starting date to look for the next event,
+you can specify additional command line arguments `agenda FROM_DATE` as positional
+parameter with `FROM_DATE` in the form `YYYY-MM-DD`.
+
+If everything goes well, the agenda is downloaded into the `temp_dir`, the slide is
+created from the template, SongBeamer's `Schedule.col` is adjusted and finally
+SongBeamer itself is launched with the prepared `Schedule.col`.
+
+You can keep the `temp_dir` as is (it is added to and overwritten in future
+invocations), but there is also no harm in deleting the `temp_dir` as it is
+automatically re-created.
+
+### ChurchTools song verification
+
+With the additional command `songs verify` you can check the songs in the
+ChurchTools song database for specific properties like CCLI number, song name, tags,
+arrangement source, duration and a SongBeamer `.sng` file with the `#BackgroundImage`
+property set.
+
+With optional positional argument `FROM_DATE` in the form `YYYY-MM-DD` you can select
+to only check the songs of the next event agenda after `FROM_DATE`.
+
+Using command options `--exclude_tags` and/or `--include_tags` you can filter out
+songs with specific tags or only include songs with specific tags in the check.

churchsong-0.5.0/src/ChurchSong.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+LICENSE
+README.md
+pyproject.toml
+src/ChurchSong.egg-info/PKG-INFO
+src/ChurchSong.egg-info/SOURCES.txt
+src/ChurchSong.egg-info/dependency_links.txt
+src/ChurchSong.egg-info/entry_points.txt
+src/ChurchSong.egg-info/requires.txt
+src/ChurchSong.egg-info/top_level.txt
+src/churchsong/__init__.py
+src/churchsong/__main__.py
+src/churchsong/configuration.py
+src/churchsong/powerpoint.py
+src/churchsong/utils.py
+src/churchsong/churchtools/__init__.py
+src/churchsong/churchtools/events.py
+src/churchsong/churchtools/song_verification.py
+src/churchsong/songbeamer/__init__.py
+src/churchsong/songbeamer/windows.py

churchsong-0.5.0/src/ChurchSong.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

churchsong-0.5.0/src/ChurchSong.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ChurchSong = churchsong.__main__:main

churchsong-0.5.0/src/ChurchSong.egg-info/requires.txt

@@ -0,0 +1,9 @@
+alive-progress>=3.2.0
+platformdirs>=4.3.6
+prettytable>=3.12.0
+pydantic>=2.9.2
+python-pptx>=1.0.2
+requests>=2.32.3
+
+[:sys_platform == "win32"]
+psutil>=6.1.0

churchsong-0.5.0/src/ChurchSong.egg-info/top_level.txt

@@ -0,0 +1 @@
+churchsong

churchsong-0.5.0/src/churchsong/__main__.py

@@ -0,0 +1,205 @@
+from __future__ import annotations
+
+import argparse
+import datetime
+import functools
+import importlib.metadata
+import shutil
+import subprocess
+import sys
+
+from churchsong.churchtools import ChurchToolsAPI
+from churchsong.churchtools.events import ChurchToolsEvent
+from churchsong.churchtools.song_verification import ChurchToolsSongVerification
+from churchsong.configuration import Configuration
+from churchsong.powerpoint import PowerPoint
+from churchsong.songbeamer import SongBeamer
+
+
+def get_app_version() -> str:
+    try:
+        return importlib.metadata.version('ChurchSong')
+    except (importlib.metadata.PackageNotFoundError, AssertionError):
+        return 'unknown'
+
+
+def cmd_self_info(_args: argparse.Namespace, config: Configuration) -> None:
+    sys.stderr.write(f'Config file: {config.config_toml}\n')
+    sys.stderr.write(f'Data directory: {config.data_dir}\n')
+
+
+def cmd_self_update(_args: argparse.Namespace, config: Configuration) -> None:
+    config.log.info('Starting ChurchSong update')
+    uv = shutil.which('uv')
+    if not uv:
+        err_msg = 'Cannot find "uv", aborting self update'
+        config.log.fatal(err_msg)
+        sys.stderr.write(f'{err_msg}\n')
+        sys.exit(1)
+    try:
+        subprocess.run([uv, 'self', 'update'], check=True)  # noqa: S603
+        subprocess.run([uv, 'tool', 'upgrade', 'ChurchSong'], check=True)  # noqa: S603
+    except subprocess.CalledProcessError as e:
+        config.log.fatal(f'"uv self update" failed: {e}')
+        raise
+
+
+def cmd_agenda(args: argparse.Namespace, config: Configuration) -> None:
+    if args.command is None:
+        args.from_date = None
+
+    config.log.info('Starting ChurchSong with FROM_DATE=%s', args.from_date)
+    cta = ChurchToolsAPI(config)
+    event = cta.get_next_event(args.from_date, agenda_required=True)
+    cte = ChurchToolsEvent(cta, event, config)
+    service_leads = cte.get_service_leads()
+    event_files = cte.download_and_extract_agenda_zip()
+
+    pp = PowerPoint(config)
+    pp.create(service_leads)
+    pp.save()
+
+    sb = SongBeamer(config)
+    sb.modify_and_save_agenda(event.start_date, service_leads, event_files)
+    sb.launch()
+
+
+def cmd_songs_verify(args: argparse.Namespace, config: Configuration) -> None:
+    config.log.info('Starting song verification')
+    cta = ChurchToolsAPI(config)
+    ctsv = ChurchToolsSongVerification(cta, config)
+    ctsv.verify_songs(
+        from_date=args.from_date,
+        include_tags=args.include_tags,
+        exclude_tags=args.exclude_tags,
+        execute_checks=args.execute_checks,
+    )
+
+
+def main() -> None:
+    sys.stderr.write('\r\033[2K\r')
+    config = Configuration()
+    try:
+        config.log.debug('Parsing command line with args: %s', sys.argv)
+        parser = argparse.ArgumentParser(
+            prog='ChurchSong',
+            description='Download ChurchTools event agenda and import into SongBeamer.',
+            allow_abbrev=False,
+        )
+        parser.set_defaults(func=functools.partial(cmd_agenda, config=config))
+        subparsers = parser.add_subparsers(
+            dest='command',
+            help='possible commands, use --help to get detailed help',
+        )
+        parser_agenda = subparsers.add_parser(
+            'agenda',
+            help='create SongBeamer agenda',
+            allow_abbrev=False,
+        )
+        parser_agenda.add_argument(
+            'from_date',
+            metavar='FROM_DATE',
+            type=datetime.date.fromisoformat,
+            nargs='?',
+            help='search in ChurchTools for next event >= FROM_DATE (YYYY-MM-DD)',
+        )
+        parser_agenda.set_defaults(func=functools.partial(cmd_agenda, config=config))
+        parser_songs = subparsers.add_parser(
+            'songs',
+            help='operate on the ChurchTools songs',
+            allow_abbrev=False,
+        )
+        subparser_songs = parser_songs.add_subparsers(
+            dest='subcommand',
+            help='commands to execute on the ChurchTools song database',
+            required=True,
+        )
+        parser_songs_verify = subparser_songs.add_parser(
+            'verify',
+            help='check all songs for inconsistent and incomplete data and then exit',
+            allow_abbrev=False,
+        )
+        parser_songs_verify.add_argument(
+            '--exclude_tags',
+            metavar='TAG',
+            action='extend',
+            nargs='+',
+            help='list of song tags that should be excluded from verification',
+        )
+        parser_songs_verify.add_argument(
+            '--include_tags',
+            metavar='TAG',
+            action='extend',
+            nargs='+',
+            help='list of song tags that should be included in verification',
+        )
+        parser_songs_verify.add_argument(
+            '--execute_checks',
+            metavar='CHECK_NAME',
+            action='extend',
+            nargs='+',
+            help=(
+                'list of checks that should be performed (header names of result table)'
+            ),
+        )
+        parser_songs_verify.add_argument(
+            'from_date',
+            metavar='FROM_DATE',
+            type=datetime.date.fromisoformat,
+            nargs='?',
+            help='verify only songs of next event >= FROM_DATE (YYYY-MM-DD)',
+        )
+        parser_songs_verify.set_defaults(
+            func=functools.partial(cmd_songs_verify, config=config)
+        )
+        parser_self = subparsers.add_parser(
+            'self',
+            help='operate on the ChurchSong application itself',
+            allow_abbrev=False,
+        )
+        subparser_self = parser_self.add_subparsers(
+            dest='subcommand',
+            help='commands to execute on the ChurchSong application itself',
+            required=True,
+        )
+        parser_self_update = subparser_self.add_parser(
+            'info',
+            help='info about the ChurchSong application',
+            allow_abbrev=False,
+        )
+        parser_self_update.set_defaults(
+            func=functools.partial(cmd_self_info, config=config)
+        )
+        parser_self_update = subparser_self.add_parser(
+            'update',
+            help='updates the ChurchSong application',
+            allow_abbrev=False,
+        )
+        parser_self_update.set_defaults(
+            func=functools.partial(cmd_self_update, config=config)
+        )
+        parser_self_version = subparser_self.add_parser(
+            'version',
+            help="show program's version number and exit",
+            allow_abbrev=False,
+        )
+        parser_self_version.set_defaults(
+            func=lambda _: sys.stdout.write(f'{get_app_version()}\n')
+        )
+        parser.add_argument(
+            '-v', '--version', action='version', version=get_app_version()
+        )
+        args = parser.parse_args()
+        try:
+            args.func(args)
+        except KeyboardInterrupt:
+            sys.stdout.write('Aborted.\n')
+            sys.exit(1)
+
+    except Exception as e:
+        config.log.fatal(e, exc_info=True)
+        raise
+
+
+if __name__ == '__main__':
+    main()