Merge pull request #873 from adamtheturtle/release-process

Release process Python script

Author: adamtheturtle

admin/__init__.py

@@ -0,0 +1,3 @@
+"""
+Admin tools.
+"""

admin/release.py

@@ -0,0 +1,130 @@
+"""
+Release the next version of VWS Python Mock.
+"""
+
+import datetime
+import os
+import subprocess
+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:
+    """
+    Return 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 build() -> None:
+    """
+    Build source and binary distributions.
+    """
+    for args in (
+        ['git', 'fetch'],
+        ['rm', '-rf', 'build'],
+        ['python', 'setup.py', 'sdist', 'bdist_wheel'],
+        ['twine', 'upload', '-r', 'pypi', 'dist/*'],
+    ):
+        subprocess.run(args=args, check=True)
+
+
+def main() -> None:
+    """
+    Perform a release.
+    """
+    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,
+    )
+    build()
+
+
+if __name__ == '__main__':
+    main()

dev-requirements.txt

@@ -1,12 +1,9 @@
-PyYAML==3.13
-Pygments==2.2.0
-Sphinx==1.8.1
-VWS-Python-Mock==2018.10.02.0
 autoflake==1.2
 check-manifest==0.37
 codecov==2.0.15 # Upload coverage data
 doc8==0.8.0
 dodgy==0.1.9  # Look for uploaded secrets
+dulwich==0.19.6
 flake8-commas==2.0.0  # Require silicon valley commas
 flake8-quotes==1.0.0  # Require single quotes
 flake8==3.5.0  # Lint
@@ -15,11 +12,17 @@ mypy==0.630  # Type checking
 pip_check_reqs==2.0.3
 pydocstyle==2.1.1  # Lint docstrings
 pyenchant==2.0.0  # Bindings for a spellchecking sytem
+pygithub==1.43.2
+Pygments==2.2.0
 pylint==2.1.1  # Lint
 pyroma==2.4  # Packaging best practices checker
 pytest-cov==2.6.0  # Measure code coverage
 pytest==3.8.2  # Test runners
+PyYAML==3.13
+Sphinx==1.8.1
 sphinxcontrib-spelling==4.2.0
+twine==1.12.1
 versioneer==0.18
 vulture==0.29
+VWS-Python-Mock==2018.10.02.0
 yapf==0.24.0  # Automatic formatting for Python

setup.cfg

@@ -10,7 +10,7 @@ ignore =
     .style.yapf
     .travis.yml
     admin
-    admin/release.sh
+    admin/*
     CHANGELOG.rst
     CODE_OF_CONDUCT.rst
     CONTRIBUTING.rst