Progress towards release process

Author: adamtheturtle

CHANGELOG.rst

@@ -0,0 +1,9 @@
+Changelog
+=========
+
+.. contents::
+
+Next
+----
+
+- Initial release

admin/release.py

@@ -0,0 +1,113 @@
+"""
+Release the next version of VWS Python Mock.
+"""
+
+import datetime
+import os
+import re
+from pathlib import Path
+
+from dulwich.porcelain import add, commit, push, tag_list
+from dulwich.repo import Repo
+from github import Github, Repository, UnknownObjectException
+
+
+def get_version() -> str:
+    """
+    Returns the next version of VWS Python Mock.
+    This is today’s date in the format ``YYYY.MM.DD.MICRO``.
+    ``MICRO`` refers to the number of releases created on this date,
+    starting from ``0``.
+    """
+    utc_now = datetime.datetime.utcnow()
+    date_format = '%Y.%m.%d'
+    date_str = utc_now.strftime(date_format)
+    local_repository = Repo('.')
+    tag_labels = tag_list(repo=local_repository)
+    tag_labels = [item.decode() for item in tag_labels]
+    today_tag_labels = [
+        item for item in tag_labels if item.startswith(date_str)
+    ]
+    micro = int(len(today_tag_labels))
+    return '{date}.{micro}'.format(date=date_str, micro=micro)
+
+
+def update_changelog(version: str) -> None:
+    """
+    Add a version title to the changelog.
+    """
+    changelog = Path('CHANGELOG.rst')
+    changelog_contents = changelog.read_text()
+    new_changelog_contents = changelog_contents.replace(
+        'Next\n----',
+        'Next\n----\n\n{version}\n------------'.format(version=version),
+    )
+    changelog.write_text(new_changelog_contents)
+
+
+def create_github_release(
+    repository: Repository,
+    version: str,
+) -> None:
+    """
+    Create a tag and release on GitHub.
+    """
+    changelog_url = (
+        'https://vws-python-mock.readthedocs.io/en/latest/changelog.html'
+    )
+    repository.create_git_tag_and_release(
+        tag=version,
+        tag_message='Release ' + version,
+        release_name='Release ' + version,
+        release_message='See ' + changelog_url,
+        type='commit',
+        object=repository.get_commits()[0].sha,
+    )
+
+
+def commit_and_push(version: str, repository: Repository) -> None:
+    """
+    Commit and push all changes.
+    """
+    local_repository = Repo('.')
+    paths = ['CHANGELOG.rst']
+    _, ignored = add(paths=paths)
+    assert not ignored
+    message = b'Update for release ' + version.encode('utf-8')
+    commit(message=message)
+    branch_name = 'master'
+    push(
+        repo=local_repository,
+        remote_location=repository.ssh_url,
+        refspecs=branch_name.encode('utf-8'),
+    )
+
+
+def get_repo(github_token: str, github_owner: str) -> Repository:
+    """
+    Get a GitHub repository.
+    """
+    github_client = Github(github_token)
+    try:
+        github_user_or_org = github_client.get_organization(github_owner)
+    except UnknownObjectException:
+        github_user_or_org = github_client.get_user(github_owner)
+
+    return github_user_or_org.get_repo('vws-python-mock')
+
+
+def main() -> None:
+    github_token = os.environ['GITHUB_TOKEN']
+    github_owner = os.environ['GITHUB_OWNER']
+    repository = get_repo(github_token=github_token, github_owner=github_owner)
+    version_str = get_version()
+    update_changelog(version=version_str)
+    commit_and_push(version=version_str, repository=repository)
+    create_github_release(
+        repository=repository,
+        version=version_str,
+    )
+
+
+if __name__ == '__main__':
+    main()