Skip to main content

Testing GitHub actions, Cirrus CI, documentation, and publishing releases of Python packages.

Project description

workflow-sandbox

Build Status Code style: black License PyPI Python Version

Testing GitHub actions, Cirrus CI, documentation, and publishing releases of Python packages.

This will be a Python package on test PyPI in its own right, with package name workflow-sandbox and module name workflow_sandbox (yes, the mixing of hyphenation and underscores is inelegant but deliberate).

Inception

This repository was created on GitHub using the following settings.

GitHub Create a new repository settings

Development environment

To develop this package, I first cloned the repository (others would fork on GitHub then clone their fork):

$ git clone https://github.com/<origin>/workflow-sandbox.git
$ cd workflow-sandbox

where <origin> is the GitHub account of the fork.

For now, I'm going to use <origin>=rpanderson and not work on a fork.

If you are developing on a fork, set the upstream remote:

$ git remote add upstream https://github.com/<upstream>/workflow-sandbox.git

where <upstream> is the base repository used for pull requests and publishing releases and documentation. If you forked your development repository from https://github.com/rpanderson/workflow-sandbox for example, you'd use <upstream>=rpanderson.

Create a virtual environment:

$ python -m venv .venv
$ .venv\Scripts\activate
$ python -m pip install --upgrade pip setuptools wheel

Roadmap

The first port of call will be to test:

CirrusCI

  • Formatting using black.
  • Linting using flake8.
  • Hosting documentation using GitHub pages (on an orphaned gh-pages branch).

GitHub actions

  • Create release using actions/create_release: :
jobs:
  release:
    name: Release
    env:
      VERSION: ${${{ github.ref }}//v}
    ...
    steps:
      ...
      # Only publish tagged merges elsewhere
      - name: Create GitHub Release
        if: startsWith(github.event.ref, 'refs/tags') && startsWith(github.ref, 'v')
        id: create_release
        uses: actions/create-release@latest
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          tag_name: ${{ github.ref }}
          release_name: ${{ env.VERSION }}
          draft: true
          prerelease: ${{ contains(github.ref, 'rc') }}
  • Publish release on GitHub using actions/upload-release-asset with the body above extracted from the appropriate release notes based on git tags, similar to napari/napari#1138.

  • Using pypa/gh-action-pypi-publish:

    • Publish releases (and release candidates) on PyPI.
    • Publish merges into master branch (including untagged development versions) to TestPyPI with an appropriate dev version suffix.

Acknowledgements

Much of this is guided by the practices of other development communities—especially napari (and, increasingly, labscript-suite)—and many helpful conversations with @chrisjbillington and @philipstarkey.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

workflow-sandbox-0.3.0.tar.gz (55.0 kB view hashes)

Uploaded Source

Built Distribution

workflow_sandbox-0.3.0-py3-none-any.whl (4.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page