Add sphinx-copybutton to allow copying code blocks with a single clic… #756
Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
name: tests | |
on: | |
push: | |
branches: | |
- main | |
tags: | |
- v* | |
pull_request: | |
schedule: | |
- cron: '14 7 * * 0' # run once a week on Sunday | |
workflow_dispatch: | |
jobs: | |
run-tests: | |
strategy: | |
matrix: | |
config: | |
# [Python version, tox env] | |
- ["3.8", "py38"] | |
- ["3.8", "nopytz"] | |
- ["3.9", "py39"] | |
- ["3.10", "py310"] | |
- ["pypy-3.9", "pypy3"] | |
# - ["3.10", "docs"] # disable as readthedocs builds it | |
- ["3.11", "py311"] | |
- ["3.12", "py312"] | |
runs-on: ubuntu-latest | |
name: ${{ matrix.config[1] }} | |
steps: | |
- uses: actions/checkout@v4 | |
- name: Set up Python | |
uses: actions/setup-python@v5 | |
with: | |
python-version: ${{ matrix.config[0] }} | |
# for caching, see | |
# https://github.com/actions/setup-python/blob/main/docs/advanced-usage.md#caching-packages | |
cache: 'pip' | |
cache-dependency-path: | | |
setup.* | |
tox.ini | |
requirements*.txt | |
- name: Install dependencies | |
run: | | |
python -m pip install --upgrade pip | |
pip install tox coveralls coverage-python-version | |
- name: Test | |
run: tox -e ${{ matrix.config[1] }} | |
- name: Coveralls Parallel | |
uses: coverallsapp/github-action@v2 | |
with: | |
flag-name: run-${{ matrix.config[1] }} | |
parallel: true | |
file: coverage.xml | |
allow-empty: true | |
coverage: | |
# parallel test coverage upload | |
# see https://coveralls-python.readthedocs.io/en/latest/usage/configuration.html#github-actions-support | |
name: Submit test coverage | |
needs: run-tests | |
# always finalize coverage aftest tests ran | |
# see https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#example-not-requiring-successful-dependent-jobs | |
if: ${{ always() }} | |
runs-on: ubuntu-latest | |
steps: | |
- name: Coveralls Finished | |
uses: coverallsapp/github-action@v2 | |
with: | |
parallel-finished: true | |
format: cobertura | |
deploy-tag-to-pypi: | |
# only deploy on tags, see https://stackoverflow.com/a/58478262/1320237 | |
if: startsWith(github.ref, 'refs/tags/v') | |
needs: | |
- run-tests | |
runs-on: ubuntu-latest | |
# This environment stores the TWINE_USERNAME and TWINE_PASSWORD | |
# see https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment | |
environment: | |
name: PyPI | |
url: https://pypi.org/project/icalendar/ | |
# after using the environment, we need to make the secrets available | |
# see https://docs.github.com/en/actions/security-guides/encrypted-secrets#example-using-bash | |
env: | |
TWINE_USERNAME: ${{ secrets.TWINE_USERNAME }} | |
TWINE_PASSWORD: ${{ secrets.TWINE_PASSWORD }} | |
steps: | |
- uses: actions/checkout@v4 | |
- name: Set up Python | |
uses: actions/setup-python@v5 | |
with: | |
python-version: "3.9" | |
- name: Install dependencies | |
run: | | |
python -m pip install --upgrade pip | |
pip install wheel twine | |
- name: Check the tag | |
run: | | |
PACKAGE_VERSION=`python setup.py --version` | |
TAG_NAME=v$PACKAGE_VERSION | |
echo "Package version $PACKAGE_VERSION with possible tag name $TAG_NAME on $GITHUB_REF_NAME" | |
# test that the tag represents the version | |
# see https://docs.github.com/en/actions/learn-github-actions/environment-variables | |
if [ "$TAG_NAME" != "$GITHUB_REF_NAME" ]; then | |
echo "ERROR: This tag is for the wrong version. Got \"$GITHUB_REF_NAME\" expected \"$TAG_NAME\"." | |
exit 1 | |
fi | |
- name: remove old files | |
run: rm -rf dist/* | |
- name: build distribution files | |
run: python setup.py bdist_wheel sdist | |
- name: deploy to pypi | |
run: | | |
# You will have to set the variables TWINE_USERNAME and TWINE_PASSWORD | |
# You can use a token specific to your project by setting the user name to | |
# __token__ and the password to the token given to you by the PyPI project. | |
# sources: | |
# - https://shambu2k.hashnode.dev/gitlab-to-pypi | |
# - http://blog.octomy.org/2020/11/deploying-python-pacakges-to-pypi-using.html?m=1 | |
if [ -z "$TWINE_USERNAME" ]; then | |
echo "WARNING: TWINE_USERNAME not set!" | |
fi | |
if [ -z "$TWINE_PASSWORD" ]; then | |
echo "WARNING: TWINE_PASSWORD not set!" | |
fi | |
twine check dist/* | |
twine upload dist/* | |
deploy-github-release: | |
# only deploy on tags, see https://stackoverflow.com/a/58478262/1320237 | |
if: startsWith(github.ref, 'refs/tags/v') | |
needs: | |
- run-tests | |
runs-on: ubuntu-latest | |
environment: | |
name: github-release | |
steps: | |
- uses: actions/checkout@v4 | |
- name: Create GitHub release from tag | |
uses: ncipollo/release-action@v1 | |
with: | |
allowUpdates: true | |
body: "To view the changes, please see the [Changelog](https://icalendar.readthedocs.io/en/latest/changelog.html). This release can be installed from [PyPI](https://pypi.org/project/icalendar/#history)." | |
generateReleaseNotes: false |